Zum Inhalt springen

CMIS-Plugin

Plugin-Download (erfordert Anmeldung)

Information

7.4.0+  Das Plugin benötigt mindestend die formcycle Version 7.4.0.

Mit dem kostenpflichtigen CMIS Plugin haben Sie die Möglichkeit, ein Document 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
  - 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. Wird das Feld leer gelassen, wird beim Verbindungsaufbau das erste gefundene Repository verwendet. Über die Schaltfläche "Repositories suchen" werden alle auswählbaren Repositories der konfigurierten Verbindung durchsucht. Sobald Repositories gefunden wurden, sind alle IDs in einer Auswahl sichtbar und können ausgewählt werden. Informationen zum ausgewählten Repository werden über das Informationssymbol oben rechts angezeigt. 1.3.0+ 
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
Benutzername und Passwort
Der Benutzername und das Passwort für Basic Auth.

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.

Vorhandene Ordner und Dokumente der CMIS-Verbindung 1.3.0+ 

Über den Knopf CMIS-Objekte laden wird in diesem Bereich die Ordner- und Dateistruktur der CMIS-Verbindung angezeigt. Sichtbar sind nur die CMIS-Objekte für Nutzer, die über entsprechende Berechtigungen gemäß der konfigurierten Authentifizierung verfügen. Die angezeigte Struktur ermöglicht die Überprüfung, ob die Workflow-Aktion Ordner und Dokumente korrekt angelegt hat. Durch das Klicken auf das Kopier-Symbol wird dessen Pfad in die Zwischenablage kopiert.

CMIS-Abfragen 1.3.0+ 

Über den Editor können CMIS-Abfragen eingegeben werden, die auf der konfigurierten CMIS-Verbindung ausgeführt werden. Die Ergebnisse werden in einer Tabelle angezeigt. Die maximale Anzahl der Ergebnisse kann angegeben werden, um die Abfrage einzuschränken und die Abfragezeit zu verkürzen.

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.

Verbindungseinstellungen

Verbindung
Hier muss eine der vorhandenen CMIS-Verbindungen ausgewählt werden, um die Workflow-Aktion zu konfigurieren.
URL
Die konfigurierte Server-URL der ausgewählten CMIS-Verbindung.
Verbindung testen 1.3.0+ 
Dieser Button überprüft die CMIS-Verbindungskonfiguration und prüft, ob eine Verbindung hergestellt werden kann.

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 Identifikator des Objekt-Typen an, welcher verwendet werden soll. Wird kein spezifischer Identifikator angegeben wird der Basis Identifikator des Objekt-Typen genommen (Dokumente: "cmis:document",  Ordner: "cmis:folder"). Über die Auswahl oder Eingabe werden falls vorhanden mögliche IDs der CMIS-Verbindung angezeigt. Dabei handelt es sich um IDs der Basis Identifikatoren "cmis:document" bzw. "cmis:folder".
Objekt-Name
Der Name, welches das zu erstellende Objekt haben soll. Falls es sich um ein Dokument handelt und keine Eingabe für den Objekt-Namen erfolgte, wird der Dateiname für den Objekt-Namen verwendet. Für Ordner ist der Standardwert "output".
Bestehenden Ordner zurückgeben 1.3.0+ 
Diese Option gibt einen Ordner zurück, wenn im angegebenen Zielordnerpfad bereits ein Ordner mit dem im Textfeld "Objekt-Name" angegebenen Objektnamen existiert. In diesem Fall wird kein neues CMIS-Objekt erzeugt, sondern das vorhandene CMIS-Objekt zurückgegeben. Diese Option kann nur aktiviert werden, wenn der Objekttyp "Ordner" ausgewählt wurde. Außerdem ist die Option "Automatische Versionsnummer hinzufügen" nicht verfügbar, wenn diese Option aktiviert ist.
Versionsnummer zu Objektnamen hinzufügen 1.3.0+ 
Durch Anhaken dieser Option wird beim Anlegen eines CMIS-Objekts überprüft, ob der gewünschte Name des Objekts an dem konfigurierten Speicherort bereits existiert. Falls ja, erhält das Objekt stattdessen eine Versionsnummer im Namen. Ein Beispiel hierfür wäre: der konfigurierte Objekt-Name "Objekt" wird zu "Objekt (1)" angepasst oder für Dateien mit der Endung, wird "Datei.pdf" zu "Datei (1).pdf" umbenannt.
Endung der verwendeten Datei(en) nutzen
Diese Einstellung kann für die Erstellung von CMIS-Dokumenten ausgewählt werden. Wenn sie aktiviert ist und ein Objekt-Name für das Dokument konfiguriert wurde, wird die Dateiendung des Dokuments als Teil des Objekt-Namen verwendet. Diese Option ist hilfreich, falls ein eigener Objekt-Name mit Dateiendung verwendet werden soll, der nicht identisch mit dem Dateinamen ist.
Dokumentenversionierung aktivieren 1.3.0+ 
Aktivieren Sie diese Option, um für jedes neu erstellte Dokument eine Hauptversion (Major-Version) im CMIS-Repository zu erstellen. Beachten Sie, dass diese Funktion von den Fähigkeiten des verwendeten CMIS-Repositories abhängig ist und nur funktioniert, wenn das Repository Versionierung unterstützt. Bei Deaktivierung erfolgt keine Versionierung.
Speichern im dynamischen Verzeichnis 1.3.0+ 
Aktivieren Sie diese Option, um das Dokument ohne Zuweisung zu einem Ordner zu erstellen. Es wird in einem virtuellen, nicht sichtbaren Verzeichnis abgelegt. Voraussetzung für diese Funktion ist, dass das CMIS-Repository 'Unfiling' unterstützt. Bei Aktivierung dieser Option ist keine Eingabe eines Zielordnerpfades erforderlich.
Zielordnerpfad
Der Pfad, unter dem das Objekt erstellt werden soll. Bei der Angabe eines Zielordnerpfades ist darauf zu achten, dass der verwendete Pfad das Ablegen von Ordnern bzw. Dokumenten zulässt bzw. die Berechtigungen auf der CMIS-Schnittstelle vorhanden sind. Über die Schaltfläche mit dem Ordnersymbol kann die Ordnerstruktur der Verbindung angezeigt werden. Hier werden alle relevanten Information zum selektierten CMIS-Objekt angezeigt. Dies ist zum einen eine allgemeine Übersicht über die Metadaten eines CMIS-Objekts, die Objekteigenschaften des Objekts und eine Angabe der Objekttyp-IDs, die im ausgewählten Ordner angelegt werden können. Über das Kopiersymbol kann der Pfad zum ausgewählten Ordner automatisch in das Textfeld für den Zielordnerpfad kopiert werden. 1.3.0+ 
Objekt-Properties
Hier können die Objekteigenschaften für das zu erstellende CMIS-Objekt konfiguriert werden. Hierbei muss zusätzlich festgelegt werden, welchen Datentyp die verwendete Objekt-Eigenschaft besitzt, welche von der CMIS-Schnittstelle definiert ist. Der Standardwert ist String. Bei Verwendung des Datentyp Datum muss ein Datumsformat angegeben werden. Alle verwendeten Objekt-Properties mit dem Datentyp Datum müssen das gleiche Datumsformat besitzen. Beim Betätigen des Hinzufügen-Buttons rechts oben öffnet sich ein Dialog, welcher alle möglichen Eigenschaften des ausgewählten Objekt-Typ-IDs sowie bereits konfigurierten Eigenschaften anzeigt. Hier sind die ID, der Name und der Datentyp der Objekt-Eigenschaft aufgeführt. Im Tabellenkopf kann nach dem jeweiligen Attribut gefiltert werden. Die ausgewählten Eigenschaften werden durch das Auswählen und Klicken auf den Aktualisieren-Button den bereits bestehenden Eigenschaften hinzugefügt. 1.3.0+ 

Werte bei Erfolg 1.3.0+ 

[%$<Aktionsname>.RESULT.objectPath%]
Der Ordnerpfad eines Ordner-Objekts. Für Dokumente wird ein Leerstring zurückgegeben.
[%$<Aktionsname>.RESULT.createdCount%]
Anzahl der erzeugten CMIS-Objekte. Dieser Wert ist bspw. sinnvoll wenn die Option "Bestehenden Ordner zurückgeben" aktiviert und überprüft werden soll, ob ein CMIS-Objekt erzeugt wurde oder ein bereits bestehendes Objekt gefunden wurde.

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.
OBJECT_CREATION_FAILED
Das Erzeugen des Objekts auf der CMIS-Schnittstelle ist fehlgeschlagen.
OBJECT_ALREADY_EXISTS
Falls das Objekt am konfigurierten Ordnerpfad mit diesem Namen bereits existiert.

Versionshistorie

1.3.1

  • Maximale Länge des Zielordnerpfad erhöht

1.3.0

  • Anzeige von Ordnerstruktur der CMIS-Verbindung
  • Ausführen von CMIS-Abfragen
  • Unterstützung von Unfiling-Funktion und Dokumentenversionierung
  • Anpassungen in Workflow-Aktion-Oberfläche
  • Fehlerbehebungen

1.2.3

  • Fehlerbehebungen in CMIS-Verbindung Konfigurationsoberfläche

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