GetUri

This action accepts a document identifier and returns a URI to the document in the repository.

Some applications can move or archive documents. In place of the original document they can leave a stub, which points to the new location of the document. If the original document is requested, the application instead finds the stub. The stub contains the name of a connector group that can access the document in the new location, and the document's new identifier. The application sends the information contained in the stub to a Distributed Connector (using this action). The Distributed Connector then queries a suitable connector to resolve the identifier into a URI.

/action=GetUri&Identifier=...
             [&AUTN_GROUP=ConnectorGroup]
             [&Redirect=true]

Type: Synchronous

Parameter Name Description Required
AUTN_GROUP The connector group to send the action to. If you do not specify a connector group, the Distributed Connector queries IDOL to find the connector group that can retrieve the document. No
Identifier The identifier of a document. The connector returns a URI that can be used to access this document in the repository. Yes
Redirect A Boolean value (default false) that can be used to redirect a browser directly to the document, instead of returning the ACI response. This parameter should be used only for testing. No

Example

http://connector:1234/action=GetUri&Identifier=...

Response

An example response for this action appears below:

<autnresponse>
  <action>GETURI</action>
  <response>SUCCESS</response>
  <responsedata>
    <uri>https://host/resource</uri>
  </responsedata>
</autnresponse>