This action retrieves documents from a repository and sends the documents to a specified location. You can save the documents to disk or add them to the ingest queue. You must specify the documents that you want to collect by their identifiers.


Type: Asynchronous

Parameter Name Description
Config An optional Base64 encoded configuration file. If this parameter is set, then the encoded configuration options are used instead of the options in the connector configuration file.
failedDirectory The directory in which the action reports failures.
Identifiers A comma-separated list of identifiers to specify the documents to collect.

This parameter can be specified in addition to the Identifiers parameter. It specifies additional identifiers to collect, along with a set of custom metadata to be associated with each collected document.

The data must be provided in XML format as below:

  <identifier value="[AUTN_IDENTIFIER1]">
     <metadata name="[CustomField1]"  value="[CustomFieldValue1_1]"/>
     <metadata name="[CustomField1]"  value="[CustomFieldValue1_2]"/>
     <!-- ... -->
  <identifier value="[AUTN_IDENTIFIER2]">
     <metadata name="[CustomField1]"  value="[CustomFieldValue2_1]"/>
     <!-- ... -->
  <!-- ... -->

Output destination as UNC Path. If this is blank, the documents are added to the ingest queue.

The parameter can use fields from the document or identifier to construct the resulting destination for each document.

To add a document field value as part of the destination, use the tag <DOC:FIELDNAME> within the string. To add an identifier field value as part of the destination, use the tag <ID:FIELDNAME> within the string. For example:


Where a field can have multiple values or is a comma-separated list, multiple destinations are created and each gets a copy of the document. You can specify a comma-separated list by preceding the colon with the comma-separated list separator character. For example: <ID,:SOURCE>.


A list of actions to perform on documents before they are transferred to their destination. The list is processed from left to right. Specify the actions in the form action:parameters. The available actions are:

  • META. Add a custom field to the document.
  • ZIP. Add the document to a zip file.
  • LUA. Run a Lua script on the document.

For example, to add a field CATEGORY=FILESYSTEM to every document, zip all documents with a password and add a field COLLECTTIME=1234567890 to the zip, specify the collect action as:


Escape any commas in the action parameters with a backslash (\).




As this is an asynchronous action, you receive a token in response to the request. A sample response to the action (as retrieved using the QueueInfo action) appears below.

In this example, the identifiers for both documents appear between <success> tags showing that they were collected successfully. The documents were output to C:\Autonomy\collected along with stub files containing their metadata.

       added="0"          collected="2"       deleted="0"
	errors="0"         holds="0"           ingestadded="0"
	ingestdeleted="0"  ingestfailed="0"    ingestupdated="0"
	inserted="0"       releasedholds="0"   seen="0"
	task="DIR1"        unchanged="0"       updated="0"/>
  <queued_time>2009-Oct-15 16:02:53</queued_time>
  <process_start_time>2009-Oct-15 16:02:53</process_start_time>
  <process_end_time>2009-Oct-15 16:02:53</process_end_time>

If a document cannot be collected successfully, the document identifier appears between <failed> tags and a message explains the reason for the failure:

  <failed message="Error message">