Änderungen von Dokument CMIS-Plugin

Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

...	...	@@ -1,13 +1,14 @@
	1	+[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/CMIS%20DMS%20System%20Anbindung%20(fc-plugin-cmis)&fileid=54831||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung)
	2	+
1	1	{{info}}
2		-Das Plugin benötigt mindesten die formcycle Version 7.4.0.
	4	+{{version major="7" minor="4" patch="0"/}} Das Plugin benötigt mindestend die formcycle Version 7.4.0.
3	3	{{/info}}
4	4
5		-Mit dem 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.
	7	+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.
6	6
7	7	== Konfiguration der CMIS-Verbindungen ==
8	8
9		-Nach der Installation des Plugins wird ein Aus- und wieder Einloggen an formcycle benötigt, um den Menüpunkt CMIS-Verbindungen zu sehen
10		-Über den Menüpunkt CMIS-Verbindungen besteht die Möglichkeit eine Verbindung für eine bestehende CMIS-Schnittstelle einzurichten.
	11	+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.
11	11
12	12	=== Verbindungseinstellungen ===
13	13
...	...	@@ -17,16 +17,14 @@
17	17	: Unter dem Verbindungstyp der Schnittstelle ist des Protokoll der Schnittstelle zu verstehen, welche für die Datenübertragung verwendet wird.
18	18	Die 3 zur Verfügung stehende Möglichkeiten sind:
19	19	- AtomPub
20		- - Webservice (SOAP)
21	21	- Browser (Zugriff über die HTTP-Methoden GET und POST im Format JSON)
22	22	; Server URL
23	23	: Die URL, unter welcher die anzubindende Schnittstelle erreichbar ist.
24	24	; Repository-ID
25		-: 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.
	25	+: 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. {{version major="1" minor="3" patch="0"/}}
26	26	; Verbindungsparameter
27	27	: Weitere Parameter, welche für die Verbindung relevant sind. Bei diesen Parametern handelt es sich um OpenCMIS Verbindungsparametern.
28	28
29		-
30	30	=== Authentifizierung ===
31	31
32	32	; Authentifizierungstyp
...	...	@@ -34,14 +34,11 @@
34	34	Die zur Verfügung stehenden Typen sind:
35	35	- Keiner
36	36	- Basic Auth
37		- - Bearer Token
38	38	; Benutzername und Passwort
39	39	: Der Benutzername und das Passwort für Basic Auth.
40		-; Bearer Token
41		-: Der Token für die Authentifizierung über eine Bearer Token.
42	42
43		-
44	44	=== Proxyeinstellungen ===
	40	+
45	45	; Proxy verwenden
46	46	: Gibt an, ob die Verbindung nur über einen Proxy-Server stattfinden soll.
47	47	; Proxy-Host
...	...	@@ -53,24 +53,59 @@
53	53
54	54	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.
55	55
	52	+=== Vorhandene Ordner und Dokumente der CMIS-Verbindung {{version major="1" minor="3" patch="0"/}} ===
56	56
	54	+Ü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.
	55	+
	56	+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.
	57	+
	58	+=== CMIS-Abfragen {{version major="1" minor="3" patch="0"/}} ===
	59	+
	60	+Ü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.
	61	+
57	57	== Workflow-Aktion ==
58	58
59	59	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.
60	60
	66	+=== Verbindungseinstellungen ===
	67	+
	68	+; Verbindung
	69	+: Hier muss eine der vorhandenen CMIS-Verbindungen ausgewählt werden, um die Workflow-Aktion zu konfigurieren.
	70	+; URL
	71	+: Die konfigurierte Server-URL der ausgewählten CMIS-Verbindung.
	72	+; Verbindung testen {{version major="1" minor="3" patch="0"/}}
	73	+: Dieser Button überprüft die CMIS-Verbindungskonfiguration und prüft, ob eine Verbindung hergestellt werden kann.
	74	+
61	61	=== Objekteinstellungen ===
62	62
63	63	; Objekt-Typ
64	64	: Gibt an welchen Basis-Typ das Objekt habe soll. Die Unterstützen Typen sind Ordner und Dokument.
65	65	; Objekt-Typ-ID
66		-: Gibt den Idententifikator des Objekt-Typen an, welcher verwendet werden soll. Wird kein spezifischer Identifikator angegeben wird der Basis Identifikator des Objekt-Typen genommen.
	80	+: 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".
67	67	; Objekt-Name
68		-: Der Name, welches das zu erstellende Objekt haben soll.
69		-; Zielordnerpfag
70		-: Der Pfad unter dem das Objekt angelegt werden soll.
	82	+: 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".
	83	+; Bestehenden Ordner zurückgeben {{version major="1" minor="3" patch="0"/}}
	84	+: 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.
	85	+; Versionsnummer zu Objektnamen hinzufügen {{version major="1" minor="3" patch="0"/}}
	86	+: 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.
	87	+; Endung der verwendeten Datei(en) nutzen
	88	+: 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.
	89	+; Dokumentenversionierung aktivieren {{version major="1" minor="3" patch="0"/}}
	90	+: 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.
	91	+; Speichern im dynamischen Verzeichnis {{version major="1" minor="3" patch="0"/}}
	92	+: 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.
	93	+; Zielordnerpfad
	94	+: 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. {{version major="1" minor="3" patch="0"/}}
71	71	; Objekt-Properties
72		-: Weitere Eigenschaften die für das Objekt festgelegt werden sollen.
	96	+: 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. {{version major="1" minor="3" patch="0"/}}
73	73
	98	+=== Werte bei Erfolg {{version major="1" minor="3" patch="0"/}} ===
	99	+
	100	+; [%$<Aktionsname>.RESULT.objectPath%]
	101	+: Der Ordnerpfad eines Ordner-Objekts. Für Dokumente wird ein Leerstring zurückgegeben.
	102	+; [%$<Aktionsname>.RESULT.createdCount%]
	103	+: 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.
	104	+
74	74	=== Mögliche Fehler ===
75	75
76	76	; CONNECTION_FAILED
...	...	@@ -87,3 +87,48 @@
87	87	: Falls ein Repository durch die Repository-ID angegeben wurde, konnte dieses nicht gefunden werden.
88	88	; TYPE_NOT_SUPPORTED
89	89	: Der durch das Feld Objekt-Typ-ID angegebene Typ wird nicht von der Schnittstelle unterstützt.
	121	+; OBJECT_PROPERTY_CREATION_FAILED
	122	+: Bei der Erstellung einer Objekt-Eigenschaft ist ein Fehler aufgetreten. Dies könnte bspw. bei falscher Konfiguration des Datentyps auftreten.
	123	+; OBJECT_CREATION_FAILED
	124	+: Das Erzeugen des Objekts auf der CMIS-Schnittstelle ist fehlgeschlagen.
	125	+; OBJECT_ALREADY_EXISTS
	126	+: Falls das Objekt am konfigurierten Ordnerpfad mit diesem Namen bereits existiert.
	127	+
	128	+== Versionshistorie ==
	129	+
	130	+=== 1.3.0 ===
	131	+
	132	+* Anzeige von Ordnerstruktur der CMIS-Verbindung
	133	+* Ausführen von CMIS-Abfragen
	134	+* Unterstützung von Unfiling-Funktion und Dokumentenversionierung
	135	+* Anpassungen in Workflow-Aktion-Oberfläche
	136	+* Fehlerbehebungen
	137	+
	138	+=== 1.2.3 ===
	139	+
	140	+* Fehlerbehebungen in CMIS-Verbindung Konfigurationsoberfläche
	141	+
	142	+=== 1.2.2 ===
	143	+
	144	+* Auswahl von Datentypen für Objekt-Eigenschaften
	145	+
	146	+=== 1.2.1 ===
	147	+
	148	+* Fehlerbehebungen
	149	+
	150	+=== 1.2.0 ===
	151	+
	152	+* Auswahl von mehreren Dateien und wiederholten Upload-Elementen in Workflow-Aktion möglich
	153	+
	154	+=== 1.1.1 ===
	155	+
	156	+* Rollenrecht für die Verwaltung von CMIS-Verbindungen hinzugefügt
	157	+
	158	+=== 1.1.0 ===
	159	+
	160	+* Datenbankänderung für CMIS-Connection Entitäten
	161	+* Fehlerbehebungen
	162	+
	163	+=== 1.0.0 ===
	164	+
	165	+* Initialer Release