1. REST API for Content Capture
  2. Tasks
  3. Auditing

Get a Document Audit Detail

get

/capture/api/v1.1/audit/documents/{docId}

This operation will return the audit details for the document specified by the docId parameter.

The expand parameter can used, which will include child resources/collections inline. The child resource of runtime is supported. When used, if the document is presently in Capture, it's runtime state information will be returned in the response.

Request

Supported Media Types
Path Parameters
Query Parameters

  • The expand parameter provides the option of getting child resources/collections inline with the response. It accepts a comma-separated list of attribute names or all. When expand is specified as all (with all in lower case), all child resources/collections of the requested batch audit detail are expanded.

    When the expand parameter contains a non-defined child resource, the request operation results in an error. The available child resources/collections are:

    • runtime

    Example : ?expand=runtime
    Expands the runtime object of this document audit detail, if any.

  • The locale parameter is used to specify the language translations used for messages in the audit events. The value must be in the form of standard language tags as defined by RFC 4647.

    If this is not specified, the default language settings locale will be used.

Back to Top

Response

Supported Media Types

200 Response

The document audit detail specified by docId.

Body ()
Root Schema : Document Audit Detail
Type: object
Title: Document Audit Detail

A Document Audit Detail in Capture is a set of events that occurred for a given document. These are events such as the document was created, the document was converted, the document was committed, etc.

A Document Audit Detail is independent in Capture, but is associated with a given Batch Audit Detail resource as documents are contained in batches.

Show Source
  • batch

    The Capture Batch that contains (or contained) this document.

  • This identifies when the document was created. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

  • If this audit detail represents an attachment of a docuument, this is the unique identifier of the document.

    This only applies to audit details on attachments of a document. It does not apply to audit details on documents. It will not be present if the audit details applies to a document.

  • events

    This array contains all individual events that pertain to this document, in eventDate ascending order.

  • The unique identifier of the document in Capture.

  • This identifies the date/time of the last event that occurred for this document. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

  • links
  • runtime

    If the document is presently part of the Capture system, this object will contain its current runtime information. However, if the document has been committed, or has otherwise been deleted from the Capture system, there will be no runtime information.

  • The title of the document. This is generally the filename used during document import.

Nested Schema : batch
Type: object

The Capture Batch that contains (or contained) this document.

Match All
Show Source
  • Capture Batch
    Title: Capture Batch

    A collection of documents in Capture that represent a unit of work in a procedure.

Nested Schema : events
Type: array

This array contains all individual events that pertain to this document, in eventDate ascending order.

Show Source
Nested Schema : runtime
Type: object

If the document is presently part of the Capture system, this object will contain its current runtime information. However, if the document has been committed, or has otherwise been deleted from the Capture system, there will be no runtime information.

Show Source
  • createdBy

    The user that created the document.

  • This identifies when the document was created. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

  • This represents the media type of the document. That is the two-part identifier for file formats and format contents transmitted on the Internet.

  • profile

    If this audit detail represents a docuument, this is the document profile that has been assigned.

    This only applies to audit details on documents. It does not apply to events on audit details of an attachment. It will not be present if the audit details applies to an attachment of a document.

    .

  • The size, in bytes, of the document.

  • The filename of the document when imported.

  • A generated string value that represents a particular state of the document.

    In general, it is used to allow modifications of the document to proceed. It is essentially saying ... modify this document if its current stateToken matches this value. If the values do not match, the modification is not permitted and the operation results in an error.

  • step

    The current processing step, if any, this document is undergoing.

  • type

    If this audit detail represents an attachment to a docuument, this is the attachment type that has been assigned.

    This only applies to audit details on attachments of a document. It does not apply to audit details on documents. It will not be present if the audit details applies to a document.

    .
  • updatedBy

    The last user that updated the document.

  • This identifies when the last time the document was updated. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

Nested Schema : Capture Batch
Type: object
Title: Capture Batch

A collection of documents in Capture that represent a unit of work in a procedure.

Show Source
  • createdBy

    The user that created the batch.

  • This identifies when the batch was created. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

  • The current error message of the batch, if any.

    If the batch is in the ERROR state, this will contain the error message detailing why the batch failed processing. This message will remain until the batch re-enters processing.

  • The unique identifier of the batch.

  • links
  • lock

    If the batch is locked (by a user creating/editing the batch or if Capture is currently processing the batch), this object will contain information about the lock. The state of the batch determines if this object exists.

  • The name given to the batch.

    When Capture creates a batch, the name is some defined prefix and a sequence number. For example, inv_4781

  • User supplied general notes associated with a batch.

  • Minimum Value: 0
    Maximum Value: 10
    Default Value: 0

    A user specified priority of the batch.

    This value is used prioritize the batch for a user's attention. Its used to filter and sort batches for viewing in the client.

  • procedure

    The Capture Procedure associated with this batch.

  • Default Value: READY

    The current state of the batch.

    • READY - The standard resting state of a batch. It is available to be locked by a client.
    • LOCKED - The batch is locked by a client for editing, such as adding/removing documents and setting metadata field values.
    • ERROR - An error occurred during processing. It is available to be locked by a client for edits to correct processing errors.
    • PROCESSING - Capture is presently processing the batch. The batch is in one of the jobs defined in the Capture procedure.

  • The current status assigned to the batch.

    The status values are defined in the procedure and can be assigned during batch creation, and during transitions between processing jobs.

  • updatedBy

    The last user that updated the batch. This can be the Capture system.

  • This identifies when the last time the batch was updated. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

Nested Schema : createdBy
Type: object

The user that created the batch.

Match All
Show Source
  • User Information
    Title: User Information

    This object contains information about a given user of Capture.

    Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Nested Schema : lock
Type: object

If the batch is locked (by a user creating/editing the batch or if Capture is currently processing the batch), this object will contain information about the lock. The state of the batch determines if this object exists.

Show Source
Nested Schema : procedure
Type: object

The Capture Procedure associated with this batch.

Match All
Show Source
Nested Schema : updatedBy
Type: object

The last user that updated the batch. This can be the Capture system.

Match All
Show Source
  • User Information
    Title: User Information

    This object contains information about a given user of Capture.

    Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Nested Schema : User Information
Type: object
Title: User Information

This object contains information about a given user of Capture.

Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Show Source
Nested Schema : lockedBy
Type: object

If the batch is locked within a Capture Client instance, this attribute will contain the user that locked the batch.

Match All
Show Source
  • User Information
    Title: User Information

    This object contains information about a given user of Capture.

    Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Nested Schema : step
Type: object

If Capture is currently processing the batch, this object will contain current processing step the batch is undergoing.

Match All
Show Source
Nested Schema : Procedure Step
Type: object
Title: Procedure Step

A step in a procedure flow.

Show Source

  • The unique identifier of the step within the procedure.

  • The name given to the step when created. For instance, the name of the processing job or commit profile.

  • The type of step. Some example include: External Processor, TIFF Conversion Processor, Asset Lookup Processor, etc.

Nested Schema : Capture Procedure
Type: object
Title: Capture Procedure

A Capture Procedure defines metadata and procesing steps of a flow.

Show Source
Nested Schema : Audit Event
Type: object
Title: Audit Event

This represents a given action that occurred within Capture that has been tracked.

Show Source

  • A simple description of the event, generally a verb, such as CREATED, UPDATED, PROCESSED, etc.

  • A correlation identifier of the event. It is important to note that this value is not unique.

    An event may cause other events to occur. This identifier is used express a causal relationships between events, particulally between batches and documents.

  • Detail information about the the event.

  • eventBy

    The user that trigged/caused the event.

    This is only present if the event was triggered by a user of Capture. It is not present when events are triggered by Capture.

  • This identifies when the event occurred. The date/time in ISO-8601 Date Time format (yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTC, governed by RFC 3339.

  • The locale that was used to produce the message. The value will be in the form of standard language tags as defined by RFC 4647.

  • The simple message the describes the event.

  • The unique key that correlates to the message pattern used to generate the detail message.

  • messageProperties

    An array of individual property keys and values that are attributes of the event, and used to produce the message. The order of the array is determined by the order of the argument indexes in the message pattern.

    The specific keys and values are dependent on the type of event. Also, the event type could allow for more complex object definition than just simple key/value pairs. Some examples are:

    Document Committed Events

    [
    { "documentId": "58be0662-a758-491a-9eed-cc6f56124acf" },
    { "documentTitle": "Sales Invoice [58be0662-a758-491a-9eed-cc6f56124acf]" },
    { "repositoryName": "Plumbing Invoice Type" },
    { "assetType": "Plumbing Invoice Type" }
]

    Email Events

    [
    { "emailFromName": "Joe Smith" },
    { "emailFromAddress": "joe.smith@someplace.com" },
    { "emailSubject": "Sales Invoice" }
]

  • The unique identifer of the kind of event.

Nested Schema : eventBy
Type: object

The user that trigged/caused the event.

This is only present if the event was triggered by a user of Capture. It is not present when events are triggered by Capture.

Match All
Show Source
  • User Information
    Title: User Information

    This object contains information about a given user of Capture.

    Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Nested Schema : messageProperties
Type: array

An array of individual property keys and values that are attributes of the event, and used to produce the message. The order of the array is determined by the order of the argument indexes in the message pattern.

The specific keys and values are dependent on the type of event. Also, the event type could allow for more complex object definition than just simple key/value pairs. Some examples are:

Document Committed Events

[
    { "documentId": "58be0662-a758-491a-9eed-cc6f56124acf" },
    { "documentTitle": "Sales Invoice [58be0662-a758-491a-9eed-cc6f56124acf]" },
    { "repositoryName": "Plumbing Invoice Type" },
    { "assetType": "Plumbing Invoice Type" }
]

Email Events

[
    { "emailFromName": "Joe Smith" },
    { "emailFromAddress": "joe.smith@someplace.com" },
    { "emailSubject": "Sales Invoice" }
]
Show Source
  • Any Object
    Title: Any Object

    This represents any kind of object. The object may or may not have a defined schema.

    This is used by parts of the Content Capture REST API that could vary, or are not known during design time.

Nested Schema : Any Object
Type: object
Title: Any Object

This represents any kind of object. The object may or may not have a defined schema.

This is used by parts of the Content Capture REST API that could vary, or are not known during design time.

Nested Schema : createdBy
Type: object

The user that created the document.

Match All
Show Source
  • User Information
    Title: User Information

    This object contains information about a given user of Capture.

    Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Nested Schema : profile
Type: object

If this audit detail represents a docuument, this is the document profile that has been assigned.

This only applies to audit details on documents. It does not apply to events on audit details of an attachment. It will not be present if the audit details applies to an attachment of a document.

.
Match All
Show Source
  • Document Profile
    Title: Document Profile

    A Document Profile associates a collection of custom metadata fields defined in a Capture procedure with a document. Additionally, it can have associated attachment types.

    These are used in Capture to help categorize and process documents. While a document profile does relate custom metadata fields and attachment types from the procedure to a document, it does not restrict metadata to just those fields or attachments to just those types. It they are used for display/management within the Capture Client.

Nested Schema : step
Type: object

The current processing step, if any, this document is undergoing.

Match All
Show Source
Nested Schema : type
Type: object

If this audit detail represents an attachment to a docuument, this is the attachment type that has been assigned.

This only applies to audit details on attachments of a document. It does not apply to audit details on documents. It will not be present if the audit details applies to a document.

.
Match All
Show Source
  • Attachment Type
    Title: Attachment Type

    An Attachment Type can be used to categorize, and provides process filtering, of attachents of documents.

Nested Schema : updatedBy
Type: object

The last user that updated the document.

Match All
Show Source
  • User Information
    Title: User Information

    This object contains information about a given user of Capture.

    Models use this object to denote some relation between a user and some other object. For instance, a model of the API may define the attribute updatedBy that is a user object. This indicates it was last updated by that given user.

Nested Schema : Document Profile
Type: object
Title: Document Profile

A Document Profile associates a collection of custom metadata fields defined in a Capture procedure with a document. Additionally, it can have associated attachment types.

These are used in Capture to help categorize and process documents. While a document profile does relate custom metadata fields and attachment types from the procedure to a document, it does not restrict metadata to just those fields or attachments to just those types. It they are used for display/management within the Capture Client.

Show Source
Nested Schema : Attachment Type
Type: object
Title: Attachment Type

An Attachment Type can be used to categorize, and provides process filtering, of attachents of documents.

Show Source

400 Response

Bad Request

The request could not be processed because it contains missing or invalid information, such as a validation error on an input field or a missing required value. The response will be an Error Detail object.

404 Response

Not Found

The request includes a resource URI that does not exist. The response will be an Error Detail object.

500 Response

Internal Server Error

The server encountered an unexpected condition that prevented it from fulfilling the request. The response will be an Error Detail object.

Back to Top