Archive

  1. Update

    Kommentare deaktiviert für Update
    #### 3. Update
    **Durch die Methoden PUT oder PATCH an der URL /api/serviceLevels/{id} können Details eines bestimmten Service Levels aktualisiert werden. Bei Erfolg wird der Status 200 OK mit einer Bestätigungsmeldung zurückgegeben. Wenn der Service Level nicht gefunden wird, resultiert dies in einem 404 Not Found Status, bei Validierungsfehlern in einem 422 Unprocessable Entity und bei Serverproblemen in einem 500 Internal Server Error.**
    
    - **Methode**: PUT/PATCH
    - **URL**: /api/serviceLevels/{id}
    - **Beschreibung**: Aktualisiert die Details eines spezifischen Service Levels.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "updated",
    "serviceLevel": {...}
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service level not found"
    }
    ```
    - Status: 422 Unprocessable Entity
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Validation failed"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to update service level"
    }
    ```
    
  2. Show

    Kommentare deaktiviert für Show
    #### 2. Show
    **Über die Methode GET und die URL /api/serviceLevels/{id} können Details zu einem spezifischen Service Level abgerufen werden. Die erfolgreiche Abfrage resultiert in einem 200 OK Status mit den Details des Service Levels. Fehlt der Service Level, gibt es einen 404 Not Found Status, und bei Serverproblemen einen 500 Internal Server Error.**
    
    - **Methode**: GET
    - **URL**: /api/serviceLevels/{id}
    - **Beschreibung**: Ruft die Details eines spezifischen Service Levels ab.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "fetched",
    "serviceLevel": {...}
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service level not found"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to fetch service level"
    }
    ```
    
  3. Index

    Kommentare deaktiviert für Index
    #### 1. Index
    **Diese Funktion wird über die Methode GET und die URL /api/serviceLevels aufgerufen und holt eine Liste aller Service Levels, die nach ihrem Erstellungsdatum in aufsteigender Reihenfolge sortiert sind. Bei Erfolg gibt der Server den Status 200 OK mit einer Erfolgsmeldung und den Service Level-Daten zurück. Bei einem Serverfehler wird der Status 500 Internal Server Error ausgegeben.**
    
    - **Methode**: GET
    - **URL**: /api/serviceLevels
    - **Beschreibung**: Ruft eine Liste aller Service Levels ab, sortiert nach Erstellungsdatum in aufsteigender Reihenfolge.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "fetched",
    "serviceLevels": [...]
    }
    ```
    - **Fehlerantwort**:
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to fetch service levels"
    }
    ```
    
  4. Validierung Update

    Kommentare deaktiviert für Validierung Update
    ## Validierung für Update (Service)
    **Für die Aktualisierung von Services existiert eine Validierungslogik, die diverse optionale Felder wie Name, Kategorie, Beschreibung und viele andere überprüft, um sicherzustellen, dass die eingereichten Daten innerhalb definierter Grenzen liegen (z. B. maximale Zeichenlänge, Wertebereich bei numerischen Daten).**
    Die folgenden Felder können im Update-Endpunkt validiert werden:
    
    - `name`: optional, string, max. 255 Zeichen
    - `category_id`: optional,
    - `short_description`: optional, string, max. 255 Zeichen
    - `status`: optional, string, max. 255 Zeichen
    - `statuspercent`: optional, integer, min. 0, max. 100
    - `servicetype`: optional, string, max. 255 Zeichen
    - `content`: optional, string
    - `description`: optional, string
    - `advantages`: optional, string
    - `art_nr`: optional, string, max. 255 Zeichen
    - `user`: optional, string, max. 255 Zeichen
    - `booking`: optional, string
    - `restriction`: optional, string
    - `cancelling`: optional, string
    - `delivery_time`: optional, string, max. 255 Zeichen
    - `delivery_point`: optional, string, max. 255 Zeichen
    - `reporting`: optional, string
    - `servicelevel`: optional, string
    - `servicelevelvalues`: optional, string
    - `serviceprovidercontract`: optional, string
    - `customerspecific`: optional, string
    - `serviceart`: optional, string
    - `plannedchanges`: optional, string
    - `processingpersonaldata`: optional, string
    - `personaldata`: optional, string
    - `processingsensitivpersonaldata`: optional, string
    - `processingpersonaldatalaw`: optional, string
    - `personaldatastorageduration`: optional, string
    - `personaldatatransfer`: optional, string
    - `costs`: optional, integer, min. 0
    
  5. Destroy

    Kommentare deaktiviert für Destroy
    #### 4. Destroy
    **Über die Methode DELETE an der URL /api/services/{id} kann ein Service gelöscht werden. Bei Erfolg wird der Status 200 OK zurückgegeben. Wenn der Service nicht gefunden wird, gibt es einen 404 Not Found Status und bei Serverfehlern einen 500 Internal Server Error.**
    
    - **Methode**: DELETE
    - **URL**: /api/services/{id}
    - **Beschreibung**: Löscht einen spezifischen Service.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "deleted"
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service not found"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to delete service"
    }
    ```
    
  6. Update

    Kommentare deaktiviert für Update
    #### 3. Update
    **Dieser Vorgang erlaubt die Aktualisierung eines Services mittels PUT oder PATCH an der URL /api/services/{id}. Erfolg resultiert in einem 200 OK Status mit der Bestätigung der Aktualisierung. Fehlschläge aufgrund nicht auffindbarer Services führen zu einem 404 Not Found, Validierungsfehler zu einem 422 Unprocessable Entity und Serverfehler zu einem 500 Internal Server Error.**
    
    - **Methode**: PUT/PATCH
    - **URL**: /api/services/{id}
    - **Beschreibung**: Aktualisiert die Details eines spezifischen Services.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "updated",
    "service": {...}
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service not found"
    }
    ```
    - Status: 422 Unprocessable Entity
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Validation failed"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to update service"
    }
    ```
    
  7. Show

    Kommentare deaktiviert für Show
    #### 2. Show
    ** Ebenfalls über GET, aber an der URL /api/services/{id}, können Details eines spezifischen Services abgerufen werden. Bei Erfolg liefert dies ebenfalls einen 200 OK Status. Bei einem nicht auffindbaren Service wird ein 404 Not Found Status zurückgegeben, und bei Serverfehlern ein 500 Internal Server Error.**
    
    - **Methode**: GET
    - **URL**: /api/services/{id}
    - **Beschreibung**: Ruft die Details eines spezifischen Services ab.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "fetched",
    "service": {...}
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service not found"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to fetch service"
    }
    ```
    
  8. Index

    Kommentare deaktiviert für Index
    #### 1. Index
    **Über die Methode GET an der URL /api/services können Benutzer eine Liste aller Services abrufen, die nach dem Erstellungsdatum in absteigender Reihenfolge sortiert ist. Bei Erfolg liefert die API einen 200 OK Status mit einer entsprechenden Erfolgsmeldung und der Liste der Services. Bei einem Serverfehler gibt die API einen 500 Internal Server Error aus.**
    
    - **Methode**: GET
    - **URL**: /api/services
    - **Beschreibung**: Ruft eine Liste aller Services ab, sortiert nach Erstellungsdatum in absteigender Reihenfolge.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "fetched",
    "services": [...]
    }
    ```
    - **Fehlerantwort**:
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to fetch services"
    }
    ```
    
  9. Neue Attribute erstellen

    Kommentare deaktiviert für Neue Attribute erstellen

    Wenn Sie auf der Übersicht auf „ Erstellen“ klicken, können Sie neue Attribute erstellen.

    Hier gibt es zwei Verschiedene Arten von Attributen zur Auswahl. Sie können ein Attribut entweder als Textfeld oder als Dropdown-Menü erstellen.

    Hinweis: Der Text für das Text-Attribut wird erst auf der Übersicht eines Services, individuell erstellt. Beim Dropdown-Menü lassen sich im Vorfeld Optionen erstellen, die später ausgewählt werden.

     

    Wenn Sie nun zurück auf einen Service gehen, sehen Sie die neu erstellten Attribute.

    Mit einem Klick auf den Stift lassen sich nun Text einfügen oder Dropdown-Optionen auswählen.

    Textfeld

    Dropdown-Menü

     

  10. Attribute aktivieren -/ deaktivieren

    Kommentare deaktiviert für Attribute aktivieren -/ deaktivieren

    Wenn Sie ein Attribut öffnen, können Sie mit einem Klick auf den Stift im Bereich „Aktiv“, das Attribut aktiv oder inaktiv stellen. Dadurch wird das Attribut ein- oder ausgeblendet.