dms.GetObjectsByDigest

Dieser Job liefert Objektinformationen auf Basis eines Hashwertes (Fingerprint) für eine beliebige Datei. Er kann dazu benutzt werden, zu bestimmen, ob eine Datei schon im System abgelegt wurde. Der Job benutzt seinerseits den Job 'std.FindDocumentDigest' führt allerdings anschließend noch eine Überprüfung auf Validität aus. Der Eingabeparameter Digest ist ein über alle Dateien des Dokuments gebildeter Fingerabdruck, der zweistufig mit SHA-256 bestimmt wird (siehe Bildung des Digest-Werts). In den jeweiligen Clientbibliotheken stehen Hilfsfunktionen zur Verfügung, um aus einer Datei den Digest bestimmen zu können, ohne die Datei an den Server übertragen zu müssen.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Name	Typ	Pflicht	Beschreibung
`Flags`	INT	Ja	Flags muss 0 sein
`Digest`	String	Ja	Digest-Wert des Dokuments, dessen Vorhandensein überprüft werden soll (SHA-256, zweistufig über alle Dateien — siehe Bildung des Digest-Werts). Die Suche ist unabhängig von der Schreibweise des Hex-Strings.

Flags

INT

Flags muss 0 sein

Digest

String

Digest-Wert des Dokuments, dessen Vorhandensein überprüft werden soll (SHA-256, zweistufig über alle Dateien — siehe Bildung des Digest-Werts). Die Suche ist unabhängig von der Schreibweise des Hex-Strings.

2. Ausgabeparameter

Name Typ Abhängigkeit Beschreibung

Name	Typ	Abhängigkeit	Beschreibung
`TotalHits`	INT	—	Anzahl der Treffer
`ObjectIds`	String	—	Kommaseparierte Liste der Objekt IDs der gefundenen Dokumente.
`TypeIds`	String	—	Kommasepariererte Liste der Objekt Typen.

TotalHits

INT

—

Anzahl der Treffer

ObjectIds

String

—

Kommaseparierte Liste der Objekt IDs der gefundenen Dokumente.

TypeIds

String

—

Kommasepariererte Liste der Objekt Typen.

3. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode
Vollständige Fehlerliste