CMIS-Plugin

Plugin-Download (erfordert Anmeldung)

Mit dem kostenpflichtigen CMIS Plugin haben Sie die Möglichkeit, ein Content Management System, welches über eine CMIS-Schnittstelle verfügt, anzubinden. Im Umfang dieses Plugins ist das Anlegen einer Verbindung und das Erstellen von Ordnern und Dokumenten über die Schnittstelle enthalten.

Konfiguration der CMIS-Verbindungen

Nach der Installation des Plugins wird ein Aus- und wieder Einloggen an formcycle benötigt, um den Menüpunkt CMIS-Verbindungen zu sehen. Über den Menüpunkt CMIS-Verbindungen besteht die Möglichkeit eine Verbindung für eine bestehende CMIS-Schnittstelle einzurichten.

Verbindungseinstellungen

Name

Der Name, welche die konfigurierte Verbindung haben soll.

Verbindungstyp

Unter dem Verbindungstyp der Schnittstelle ist des Protokoll der Schnittstelle zu verstehen, welche für die Datenübertragung verwendet wird.
  Die 3 zur Verfügung stehende Möglichkeiten sind:
  - AtomPub
  - Webservice (SOAP)
  - Browser (Zugriff über die HTTP-Methoden GET und POST im Format JSON)

Server URL

Die URL, unter welcher die anzubindende Schnittstelle erreichbar ist.

Repository-ID

Die Kennung des anzusprechenden Repositories. Diese Einstellung ist nur relevant, falls unter einer Server-URL mehrere Repositories liegen. Kann in den meisten Fällen leer     bleiben.

Verbindungsparameter

Weitere Parameter, welche für die Verbindung relevant sind. Bei diesen Parametern handelt es sich um OpenCMIS Verbindungsparametern.

Authentifizierung

Authentifizierungstyp

Gibt an, wie die Authentifizierung stattfinden soll.
  Die zur Verfügung stehenden Typen sind:
  - Keiner
  - Basic Auth
  - Bearer Token

Benutzername und Passwort

Der Benutzername und das Passwort für Basic Auth.

Bearer Token

Der Token für die Authentifizierung über eine Bearer Token.

Proxyeinstellungen

Proxy verwenden

Gibt an, ob die Verbindung nur über einen Proxy-Server stattfinden soll.

Proxy-Host

Die URL, unter welcher sich der Proxy-Server befindet.

Proxy-Port

Der Port, unter welchem sich der Proxy-Server befindet.

Benutzername und Passwort

Falls für den Proxy eine Authentifizierung über Basic Auth notwendig ist, können die Credentials hier angegeben werden.

Es ist ebenfalls möglich die konfigurierte Verbindung gegen die Schnittstelle zu testen. Dies ist jedoch nur möglich, falls alle für die Verbindung relevanten Felder ausgefüllt wurden. Grundlegend relevant sind hierbei die Server-URL und die Konfiguration der Authentifizierung. Weiterhin, falls ein Proxy verwendet werden soll, ist dementsprechend dessen Konfiguration notwendig.

Workflow-Aktion

Die konfigurierten CMIS-Verbindungen können nun in der Workflow-Aktion CMIS-Objekt anlegen verwendet werden. Die Aktion ermöglicht es Ordner und Dokumente auf dem DMS, welches über eine CMIS-Schnittstelle verfügt, anzulegen.

Objekteinstellungen

Objekt-Typ

Gibt an welchen Basis-Typ das Objekt habe soll. Die Unterstützen Typen sind Ordner und Dokument.

Objekt-Typ-ID

Gibt den Idententifikator des Objekt-Typen an, welcher verwendet werden soll. Wird kein spezifischer Identifikator angegeben wird der Basis Identifikator des Objekt-Typen genommen.

Objekt-Name

Der Name, welches das zu erstellende Objekt haben soll.

Zielordnerpfad

Der Pfad unter dem das Objekt angelegt werden soll.

Objekt-Properties

Weitere Eigenschaften die für das Objekt festgelegt werden sollen. Hierbei kann jede Eigenschaft einen speziellen Datentyp besitzen, welche von der CMIS-Schnittstelle definiert ist (siehe hier). Der Datentyp kann über die Auswahl selektiert werden. Wenn es sich um den Datentyp DATETIME handelt ist es wichtig, dass die übergebenen Werte für die jeweilige Eigenschaft und für alle anderen Eigenschaften vom Typ DATETIME, das gleiche und richtige Datumformat besitzt. Das Standardformat ist hier dd.MM.yyyy (z.B. 26.04.2023). Falls es sich bei den übergebenen Werten um ein anderes Datumformat handelt als der Standardwert, kann es im Eingabefeld für das Datumformat eingegeben werden. Die Syntax zur Formatierung ist detailliert beschrieben in der Dokumentation für Java DateTimeFormatter.

Mögliche Fehler

CONNECTION_FAILED

Der Versuch ein Verbindung aufzugbauen ist gescheitert.

FILE_SYSTEM_ERROR

Es gab einen Fehler beim Erhalt der Datei.

INVALID_PATH

Der angegeben Pfad ist ungültig. Gibt das Pfadsegmente zurück, welches den Fehler ausgelöst hat.

AUTHENTICATION_FAILED

Es war nicht möglich an der Schnittstelle zu Authentifizieren.

NOT_AUTHORIZED

Die Autorisierung für der Schnittstelle reicht nicht aus

REPOSITORY_NOT_FOUND

Falls ein Repository durch die Repository-ID angegeben wurde, konnte dieses nicht gefunden werden.

TYPE_NOT_SUPPORTED

Der durch das Feld Objekt-Typ-ID angegebene Typ wird nicht von der Schnittstelle unterstützt.

OBJECT_PROPERTY_CREATION_FAILED

Bei der Erstellung einer Objekt-Eigenschaft ist ein Fehler aufgetreten. Dies könnte bspw. bei falscher Konfiguration des Datentyps auftreten.

Versionshistorie

1.2.2

• Auswahl von Datentypen für Objekt-Eigenschaften

1.2.1

• Fehlerbehebungen

1.2.0

• Auswahl von mehreren Dateien und wiederholten Upload-Elementen in Workflow-Aktion möglich

1.1.1

• Rollenrecht für die Verwaltung von CMIS-Verbindungen hinzugefügt

1.1.0

• Datenbankänderung für CMIS-Connection Entitäten
• Fehlerbehebungen

1.0.0

• Initialer Release