Übersicht über die Eigenheiten des d.velop d.3ecm-Moduls

In diesem Artikel lernen Sie die Besonderheiten und Eigenheiten des Moduls d.velop d.3ecm (ID=d3) in edoc content services kennen. Sie verwenden das Modul immer dann, wenn Sie Funktionen in Verbindung mit d.3 server (d.velop documents (On-Premises)) verwenden möchten.

API des d.velop d.3ecm-Moduls

Das Modul verwendet für die Kommunikation mit dem ECM-System von d.velop die d.3-API-Schnittstelle, auch bekannt unter dem Namen Java-API.

Für die Kommunikation zwischen der d.3-API wird der Service d3-rest-api verwendet, der automatisch mit edoc content services ausgeliefert wird. Bei dem Service d3-rest-api handelt es sich um einen PHP-Wrapper, der eine REST-API für die Datei JavaBridge.jar bietet.

Der Service d3-rest-api verfügt über eine eigene Swagger-Benutzeroberfläche. Die URL zu Swagger für d3-rest-api ist abhängig von der jeweiligen Installation. Sie können in Swagger zusätzlich nach Lösungen bei Problemen suchen.

Verwendete Authentifizierungsmethode im d.velop d.3ecm-Modul

Die d.3-API unterstützt lediglich die Standardauthentifizierung Basic Auth (Basic Authentication), also eine Anmeldung mit Benutzernamen und Passwort.

Was passiert bei der Aktion “ConnectionTest”?

Wenn Sie den Endpunkt GET /ConnectionTest ansprechen, wird eine Anmeldung beim Modul durchgeführt und eine Suche nach einem fiktivem Dokument gestartet. Auf diese Weise wird sichergestellt, dass sowohl die Parameter user und password als auch der Parameter repositoryid korrekt sind.

Automatische Freigabe beim Ändern von Dokumenteigenschaften

Wenn sich ein Dokument im Status Bearbeitung befindet, können die Eigenschaften nicht geändert werden. Um dieses Problem zu umgehen, werden Dokumente im Status Bearbeitung zunächst automatisch freigegeben und anschließend deren Eigenschaften geändert.