dms.GetObjectsByDigest

This job returns object information based on a hash value (fingerprint) for any file. It can be used to determine whether a file has already been stored in the system. The job uses the 'std.FindDocumentDigest' job internally, but performs an additional validity check afterwards. The input parameter Digest is a fingerprint calculated over all files of the document using SHA-256 in two stages (see Calculating the digest value). Helper functions are available in the respective client libraries to determine the digest from a file without having to transfer the file to the server.

1. Input Parameters

Name Type Required Description

Name	Type	Required	Description
`Flags`	INT	Yes	Flags must be 0
`Digest`	String	Yes	Digest value of the document whose presence is to be checked (SHA-256, two-stage over all files — see Calculating the digest value). The search is case-insensitive.

Flags

INT

Yes

Flags must be 0

Digest

String

Yes

Digest value of the document whose presence is to be checked (SHA-256, two-stage over all files — see Calculating the digest value). The search is case-insensitive.

2. Output Parameters

Name Type Dependency Description

Name	Type	Dependency	Description
`TotalHits`	INT	—	Number of hits
`ObjectIds`	String	—	Comma-separated list of object IDs of the found documents.
`TypeIds`	String	—	Comma-separated list of object types.

TotalHits

INT

—

Number of hits

ObjectIds

String

—

Comma-separated list of object IDs of the found documents.

TypeIds

String

—

Comma-separated list of object types.

3. Return Value

(INT): 0 = Job successful, otherwise error code
Complete list of error codes