| ... |
... |
@@ -16,7
+16,7 @@ |
| 16 |
16 |
{{/figure}} |
| 17 |
17 |
|
| 18 |
18 |
In diesem Bereich besteht die Möglichkeit die global am Plugin-Bundle registrierten Eigenschaften für den anzubindenden d.3 Server und deren Authentifizierungs-Informationen formular-prozess-spezifisch zu übersteuern. |
| 19 |
|
-Wenn für eine Eigenschaft kein Wert festgelegt ist, werden die [[global am Plugin-Bundle hinterlegten Einstellungen>>doc:||anchor="plugin_bundle_props"]] verwendet. |
|
19 |
+Wenn für eine Eigenschaft kein Wert festgelegt ist, werden die [[global am Plugin-Bundle hinterlegten Einstellungen>>doc:||anchor="plugin_bundle_props" target="_blank"]] verwendet. |
| 20 |
20 |
Es können Platzhalter (Auswahlmöglichkeit über Button [[image:icon_placeholder.png]]) für einzelne Einstellungen verwendet werden. |
| 21 |
21 |
|
| 22 |
22 |
; IP-Adresse |
| ... |
... |
@@ -49,21
+49,61 @@ |
| 49 |
49 |
|
| 50 |
50 |
; Zu importierende(s) Dokument(e) (Pflichtfeld) |
| 51 |
51 |
: In diesem Auswahlfeld werden alle (datei)-bereitstellenden Aktionen, welche dem Import-Plugin vorangestellt sind, aufgeführt. Die hier getroffene Auswahl bestimmt die Medien (Dokument(e) oder Bild(er)) welches ins d.3 DMS übermittelt werden sollen. |
|
52 |
+{{id name="doc_type"/}} |
| 52 |
52 |
; Dokument-Typ (Pflichtfeld) |
| 53 |
53 |
: In diesem Auswahlfeld werden alle durch den d.3 Systembetreuer definierten und für einen Import aus {{formcycle/}} bestimmten d.3 Objekt-Typen aufgeführt. |
| 54 |
54 |
; Dokument Metadaten |
| 55 |
|
-: In dieser Liste werden die Dokument Metadaten zum jeweiligen d.3 //Dokument-Typ// verwaltet. Die Dokument Metadaten können dabei manuell durch den Nutzer angelegt oder aus dem d.3 System ermittelt werden. Dafür muss im Vorfeld durch einen d.3 Systembetreuer eine entsprechende Möglichkeit dazu getroffen werden. |
| 56 |
|
-: Die Werte, die den einzelnen Metadaten zugeordnet werden, können dabei über die {{formcycle/}}-[[Platzhalter>>doc:Formcycle.UserInterface.Variables]]-Logik oder als fest vorgegeben Werte hinterlegt werden. Zu beachten ist dabei, dass der übergebene Wert dem vorgegebenen Datentyp entspricht. Die Tabelle //Unterstützte Eingabeformate für Datentypen// listet die verfügbaren Datentypen und deren Eingabeformate auf. |
|
56 |
+: In dieser Konfigurations-Tabelle werden die Dokument Metadaten zum jeweiligen //d.3 Dokument-Typ// verwaltet. Die Metadaten können dabei manuell durch den Nutzer angelegt oder aus dem d.3 System bezogen werden. Für eine automatische Ermittlung muss im Vorfeld durch einen d.3 Systembetreuer eine entsprechende Definition der Metadaten im d.3 System durchgeführt werden. |
| 57 |
57 |
|
| 58 |
|
-{{info title="**Weiterführende Erläuterungen:**"}} |
|
58 |
+{{info title="**Was sind Dokument Metadaten im Zusammenhang mit d.3?**"}} |
| 59 |
59 |
Mit der Definition von Dokument-Typen im d.3 DMS ist meist die Definition von zusätzlichen Eigenschaften an diesen Objekten (sogenannten Metadaten) verbunden. Diese Metadaten werden im d.3 System benötigt um verschiedene Prozesse zu steuern (z.B.: interne Verarbeitung, Suche, Verschlagwortung von Objekten etc.). Ein Teil dieser Metadaten muss bereits beim Neuanlegen von Objekten bekannt sein, weshalb sich an dieser Stelle die Notwendigkeit zur Definition der Metadaten in der {{formcycle/}} Oberfläche erklärt. |
| 60 |
60 |
{{/info}} |
| 61 |
61 |
|
| 62 |
|
-* **[%%FILE_NAME%%]**: Liefert den Dateinamen der aktuell in Bearbeitung befindlichen Datei |
|
62 |
+==== Interaktionsmöglichkeiten für Konfigurations-Tabelle //Dokument Metadaten// ==== |
|
63 |
+ |
|
64 |
+ |
|
65 |
+Über die Schaltfläche [[image:icon_add.png]] kann ein neues Dokument Metadatum in die Konfigurations-Tabelle eingefügt werden. |
|
66 |
+Anschließend muss für dieses Metadatum der Datentyp, der mit dem Metadatum zu übertragene Wert und gegebenenfalls eine Bedeutung (dient als Erläuterung) definiert werden. |
|
67 |
+ |
|
68 |
+Die zu übertragenen Werte, die den einzelnen Metadaten zugeordnet werden, können dabei über die {{formcycle/}}-[[Platzhalter>>doc:Formcycle.UserInterface.Variables||target="_blank"]]-Logik oder als fest vorgegeben Werte hinterlegt werden. Zu beachten ist dabei, dass der übergebene Wert dem vorgegebenen Datentyp entspricht. Die Tabelle //[[Unterstützte Eingabeformate für Datentypen>>doc:||anchor="metadata_types"]]// listet die verfügbaren Datentypen und deren Eingabeformate auf. |
|
69 |
+ |
|
70 |
+Zusätzlich zu den in {{formcycle/}} standardmäßig vorhandenen Platzhaltern gibt es die nachfolgend aufgeführten Platzhalter, die nur in diesem Plugin verwendet werden können. Diese Platzhalter sind dafür gedacht, auf spezielle Dateieigenschaften einzelner Dateien zuzugreifen, wenn durch das Feld //Zu importierende(s) Dokument(e)// **mehrere** Dateien gleichzeitig ins DMS überführt werden. |
|
71 |
+ |
|
72 |
+* **[%%FILE_NAME%%]**: Liefert den Dateinamen der aktuell in Bearbeitung befindlichen Datei |
| 63 |
63 |
* **[%%FILE_SIZE%%]**: Liefert die Dateigröße (in Byte) der aktuell in Bearbeitung befindlichen Datei |
| 64 |
64 |
|
| 65 |
|
-: Zusätzlich zu den in {{formcycle/}} standardmäßig vorhandenen Platzhaltern gibt es die nachfolgend aufgeführten Platzhalter, die nur in diesem Plugin verwendet werden können. Diese Platzhalter sind dafür gedacht, auf spezielle Dateieigenschaften einzelner Dateien zuzugreifen, wenn durch das Feld //Zu importierende(s) Dokument(e)// mehrere Dateien gleichzeitig ins DMS überführt werden. |
| 66 |
66 |
|
|
76 |
+{{id name="metadata_update"/}} |
|
77 |
+Über die Schaltfläche [[image:icon_update.png]] können, anhand des ausgewählten Dokument-Typs (oder einer [[initialen Vorgabe>>doc:||anchor="init_docfield_config"]]), Metadaten aus dem d.3 System ermittelt und in die Konfigurations-Tabelle eingefügt werden. |
|
78 |
+Sollte ein Metadatum bereits in der Tabelle existieren, so wird dieses als Pflichtfeld ausgewiesen und kann nicht mehr gelöscht werden. |
|
79 |
+Ein Metadatum gilt dabei als bereits existent, wenn es die gleiche Datenfeldnummer bzw. Datenbank-Position, wie ein einzufügendes Feld besitzt. |
|
80 |
+ |
|
81 |
+ |
|
82 |
+Über den Button [[image:icon_del.png]] wird das selektierte Metadatum aus der Konfigurations-Tabelle entfernt. |
|
83 |
+Metadaten, welche aus dem d.3 System als Pflichtfelder ermittelt wurden, können nicht gelöscht werden. |
|
84 |
+ |
|
85 |
+{{id name="metadata_types"/}} |
|
86 |
+==== Unterstützte Eingabeformate für Datentypen ==== |
|
87 |
+ |
|
88 |
+ |
|
89 |
+Die nachfolgende Tabelle listet alle Datentypen, welche für die Ablage von Metadaten im d.3 System zur Auswahl stehen und deren gefordertes Eingabeformat, auf. |
|
90 |
+(% summary="Unterstützte Eingabeformate für Datentypen" %) |
|
91 |
+|=Datentyp|=Erläuterung zum Eingabeformat |
|
92 |
+|Alphanumerisch|Unterstützt werden alle Eingabezeichen (Buchstaben, Ziffern, Sonderzeichen) |
|
93 |
+|Datum|((( |
|
94 |
+Unterstützt werden Datumseingaben der Form **dd.MM.yyyy** (z.B.: //01.01.1970//) |
|
95 |
+ |
|
96 |
+* **dd:** Tag, zweistellig |
|
97 |
+* **MM:** Monatsangabe, zweistellig |
|
98 |
+* **yyyy:** Jahresangabe, vierstellig |
|
99 |
+))) |
|
100 |
+|Tabelle|((( |
|
101 |
+Beim Datentyp Tabellenfeld werden dynamische Formulareingaben, vom Typ **Alphanumerisch **unterstützt. |
|
102 |
+Für jeden Wert aus einem [[dynamischen Eingabefeld>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.DynamicElements||target="_blank"]] wird im d.3 System ein Wert hinterlegt. |
|
103 |
+))) |
|
104 |
+|Geld|Unterstützt werden zweistellige Fließkommazahlen. Als Dezimaltrennzeichen muss ein Komma angegeben werden. (z.B.: //123,50//) |
|
105 |
+|Numerisch|Unterstützt werden positive und negative Fließkommazahlenwerte. Als Dezimaltrennzeichen muss ein Komma angegeben werden. (z.B. //-123,45//) |
|
106 |
+ |
| 67 |
67 |
== Globale Plugin-Einstellungen == |
| 68 |
68 |
|
| 69 |
69 |
{{info}} |
| ... |
... |
@@ -88,6
+88,7 @@ |
| 88 |
88 |
|
| 89 |
89 |
==== Einstellungen für die Anbindung des d.3 Webservice ==== |
| 90 |
90 |
|
|
131 |
+ |
| 91 |
91 |
; dms.webservice.url (Pflichtfeld) |
| 92 |
92 |
: Endpoint-URL zum d.3 SOAP-Webservice. Die Angabe muss in der Form |
| 93 |
93 |
|
| ... |
... |
@@ -103,6
+103,7 @@ |
| 103 |
103 |
|
| 104 |
104 |
==== Einstellungen für den verwendeten d.3 Server ==== |
| 105 |
105 |
|
|
147 |
+ |
| 106 |
106 |
; d3.server.ip (Pflichtfeld) |
| 107 |
107 |
: IP-Adresse des anzubinden d.3 Systems. |
| 108 |
108 |
; d3.server.port (Pflichtfeld) |
| ... |
... |
@@ -130,6
+130,7 @@ |
| 130 |
130 |
|
| 131 |
131 |
==== Einstellungen für das Statusverarbeitungs-Plugin "Dokument importieren" ==== |
| 132 |
132 |
|
|
175 |
+ |
| 133 |
133 |
; d3.import.doc.types |
| 134 |
134 |
: Definiert eine Auflistung von d.3 Objekt-Typen, welche als Auswahl innerhalb des Aktions-Plugins dargestellt werden. |
| 135 |
135 |
: Ein Objekttyp definiert sich über sein, im d.3 DMS festgelegtes, Dokument-Kürzel. |
| ... |
... |
@@ -138,8
+138,14 @@ |
| 138 |
138 |
: **//<Dokument-Kürzel aus d.3>//~://<Anzeigename in Auswahlliste>//,...** |
| 139 |
139 |
|
| 140 |
140 |
: Einzelne Listenwerte sind durch Komma zu trennen. |
|
184 |
+{{id name="init_docfield_config"/}} |
| 141 |
141 |
; d3.initial.docfield.config.doc.type |
| 142 |
|
-: Definiert ein d.3 Dokumenttyp-Kürzel, welches Daten für die initiale Erstellung von Dokument-Metadaten-Feldern enthält. |
|
186 |
+: Definiert ein //d.3 Dokument-Typ//-Kürzel, welches Definitionen für eine automatisierte Erstellung von //[[Dokument Metadaten>>doc:||anchor="metadata_update"]]// Feldern enthält. |
|
187 |
+ |
|
188 |
+{{info title="Hinweis für {{formcycle/}} Systembetreuer:"}} |
|
189 |
+Wurde für diese Plugin-Einstellung **kein** Wert hinterlegt, greift bei der automatisierten Metadaten Ermittlung im [[Aktions-Plugin>>doc:||anchor="metadata_update"]] eine Rückfall-Logik welche untersucht, ob am gewählten [[Dokument-Typ>>doc:||anchor="doc_type"]], innerhalb des d.3 Systems, Pflichtfelder (sogenannte "DocFields") definiert sind. Ist dies der Fall, werden diese als Metadaten in die Konfigurations-Tabelle übernommen. |
|
190 |
+{{/info}} |
|
191 |
+ |
| 143 |
143 |
; d3.initial.docfield.config.mapping |
| 144 |
144 |
: Definiert die Auflistung der Zuordnungen, welche für die Definition eines Metadatums in der Plugin-Oberfläche herangezogen werden. |
| 145 |
145 |
: Es ist immer eine //Eigenschaft// zu einer d.3 //Datenfeld-Nummer// zuzuordnen, welche die Eigenschaft auf dem angebundenen d.3 System enthält. |
| ... |
... |
@@ -157,4
+157,9 @@ |
| 157 |
157 |
: **//<Eigenschaft>//~://<d.3 DocField-Nummer, in der die Eigenschaft definiert ist>//,...** |
| 158 |
158 |
|
| 159 |
159 |
: (Standardwert: //Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5//) |
| 160 |
|
-~{~{/info}} |
|
209 |
+ |
|
210 |
+ |
|
211 |
+ |
|
212 |
+ |
|
213 |
+ |
|
214 |
+ |