Allgemeines zu ecoDMS Aktivitäten

Dokumente und Klassifikation

Um die ecoDMS Aktivitäten richtig nutzen zu können, ist es wichtig zu verstehen, wie die Daten innerhalb von ecoDMS strukturiert sind.

Physische Dokumente bzw. Dateien werden in ecoDMS durch eine fortlaufende und eindeutige DocId voneinander unterschieden. Das gilt sowohl für Ursprungsdokumente, als auch für weitere Versionen, welche einem Ursprungsdokument zu einem späteren Zeitpunkt hinzugefügt werden können.

Jedes Dokument erhält mindestens eine Klassifikation, über welche dem Dokument weitere Daten in Form von Attributen zugeordnet werden können. Die einzelnen Klassifikationen werden in der Datenbank durch eine Klassifikations-ID (= ClassifyDocId) dargestellt. Jede Klassifikations-ID ist innerhalb des ecoDMS Archivs einmalig, so dass über die Klassifikations-ID das dazu gehörende Hauptdokument eindeutig ermittelt werden kann.

Beim Zugriff auf Dokumente ist es daher wichtig sowohl die DocId als auch die ClassifyDocId zu berücksichtigen. Beide IDs werden in ecoDMS durch einen einfachen Integer-Wert (Int64) abgebildet. Stellen Sie daher immer sicher, dass sie die den richtigen Typ von IDs in den jeweiligen Argumenten der Aktivitäten verwenden, da eine fehlerhafte Anwendung insbesondere bei Schreibzugriffen, zu Datenverlusten führen können!

Dokument (Klassifizierungs-)Attribute

Die Attribute von Dokumenten werden von der ecoDMS API, bis auf wenige Ausnahme der vom System vorgegebenen Attributen wie z. B. den DocIds oder ClassifyDocIds, als Zeichenfolgen behandelt. Um Attribute, wie z. B. Datum und Zeit, Zahlenwerte oder Checkboxen sinnvoll weiter verarbeiten zu können, müssen diese zuerst in den jeweiligen Typ konvertiert werden. Die ecoDMS Aktivitäten stellen speziell für den Umgang mit Attributen passende Get- und Set-Methoden zur Verfügung, um die Konvertierung der Variablentypen zu erleichtern. Kann eine Konvertierung aufgrund fehlerhaft formatierter Daten nicht vorgenommen werden, findet ein Fallback auf Standardwerte statt.

Die Standard-Werte für nicht konvertierbare Attribute lauten:

Feld	Datentyp	Standard-Wert
Datum / Datum und Zeit	DateTime	01.01.0001 00:00
Numerisches Feld	int, Int64, double	0
Checkbox (bool)	bool	false