====== Fehlerbehebung mit Postman ======

Wenn Sie eine Fehlermeldung von der SAP Business One Service Layer API erhalten,
obwohl scheinbar alles korrekt konfiguriert ist, kann das kostenlose Tool **Postman** dabei helfen,
auszuschließen, dass das Problem von COBI.wms verursacht wird:

https://www.postman.com/downloads/

Nach der Installation und dem ersten Start können Sie die **Kontoerstellung überspringen**,
über den kleinen Button am unteren Rand des Login-Fensters von Postman.

===== Import der Service Layer Collection =====

Anschließend kann die folgende Service-Layer-**Collection** in Postman importiert werden:

{{COBI.wms:servicelayer.postman_collection.json}}

→ Import öffnen über: **File → Import** oder **Strg + O**

===== Environment für Service Layer anlegen =====

Damit die Collection funktioniert, muss in Postman ein **Environment** (Umgebung) erstellt werden.  
Dazu den Reiter **Environments** auf der linken Seite öffnen und eine neue Umgebung anlegen.

Name kann frei gewählt werden, z. B. **Service Layer**.  
Folgende Variablen müssen angelegt werden:

^ Name     ^ Wert                                                                          ^
| SLROOT   | Basis-URL des Service Layer, z. B.: **http://sbo-server:50001/b1s/v1**        |
| COMPANY  | Name der gewünschten SAP Business One Company-Datenbank                       |
| USERNAME | Benutzername eines gültigen SAP Business One Benutzers                        |
| PASSWORD | Passwort des SAP Business One Benutzers                                      |

**Hinweis:**  
Falls ein Wert einen **Backslash “\”** enthält, muss dieser **verdoppelt** werden:  
Beispiel: Benutzer MyDomain\testuser → als Wert eintragen: **MyDomain\\testuser** (Dies gilt **nur** in Postman, **nicht** in der COBI.wms App.  
Forward-Slashes “/” bleiben unverändert. \\
Nach dem Speichern das Environment **aktivieren**: oben rechts → Auswahlfeld (standardmäßig: No Environment)).

===== Login am Service Layer testen =====

Über den **Collections**-Reiter links die **Service Layer**-Collection öffnen.

Dort die Anfrage **Login** auswählen → **Send** klicken.

Bei erfolgreichem Login erscheint z. B.:

  {
    "@odata.context": "http://192.168.178.254:50001/b1s/v2/$metadata#B1Sessions/$entity",
    "SessionId": "878d6bfc-e06e-11eb-8000-000c29fb30d8",
    "Version": "1000150",
    "SessionTimeout": 60
  }

===== Upload von Anhängen testen =====

Manchmal schlägt das Hochladen von Anhängen über den Service Layer fehl,
auch wenn das Anhängen in SAP Business One selbst funktioniert.

Wenn beim Hochladen aus COBI.wms ein Fehler auftritt,
sollte überprüft werden, ob Service Layer korrekt funktioniert.

Zum Test:

→ In der Collection **Attachment Upload** auswählen  
→ Anfrage unverändert senden

Bei Erfolg erscheint z. B.:

  {
    "@odata.context": "http://192.168.178.254:50001/b1s/v2/$metadata#Attachments2/$entity",
    "AbsoluteEntry": 7,
    "Attachments2_Lines": [
        {
            "SourcePath": "C:\\Windows\\TEMP\\ServiceLayer\\Attachments2/",
            "FileName": "my_photo",
            "FileExtension": "png",
            "AttachmentDate": "2021-07-09",
            "Override": "tNO",
            "FreeText": null,
            "CopyToTargetDoc": "tNO"
        }
    ]
  }

Wenn stattdessen ein Fehler erscheint:
→ Upload funktioniert **nicht** über Service Layer  
→ Das Problem liegt **nicht** bei COBI.wms

In diesem Fall bitte:
  * SAP-Partner kontaktieren **oder**
  * SAP-Ticket eröffnen