GetDownloadQue API¶

Returns the list of documents and folders that the current authenticated user has added to their download queue. The download queue is a personal per-user collection of items staged for bulk download. The response uses the same full-detail folder and document element format as GetFoldersAndDocuments. Optional flags control whether additional detail (folder rules, property sets, security, owner, version history) is included for each item.

Endpoint¶

/srv.asmx/GetDownloadQue

Methods¶

GET /srv.asmx/GetDownloadQue?AuthenticationTicket=...&withrules=...&withpropertysets=...&withsecurity=...&withOwner=...&withVersions=...
POST /srv.asmx/GetDownloadQue (form data)
SOAP Action: http://tempuri.org/GetDownloadQue

Parameters¶

Parameter	Type	Required	Description
`AuthenticationTicket`	string	Yes	Authentication ticket obtained from `AuthenticateUser`.
`withrules`	bool	Yes	`true` to include folder rules (`<Rules>` child element) for each folder in the queue. `false` to omit. Has no effect on document items.
`withpropertysets`	bool	Yes	`true` to include applied custom property set data (`<PropertySets>` child element) for each item. `false` to omit.
`withsecurity`	bool	Yes	`true` to include the access control list (`<AccessList>` child element) for each item. `false` to omit.
`withOwner`	bool	Yes	`true` to include owner user information as a child element for each item. `false` to omit.
`withVersions`	bool	Yes	`true` to include document version history (`<Versions>` child element) for each document. `false` to omit. Has no effect on folder items.

Performance tip: Set all boolean flags to false for the fastest, most compact response. Only enable the flags your application actually needs.

Response¶

Success Response¶

Returns a <root> element with <folder> and <document> child elements -" folders first, then documents sorted by name ascending. If the download queue is empty, the root element is returned with no children.

<root success="true">

  <!-- Folder items in the download queue -->

  <folder FolderID="42"

          ParentID="10"

          Name="Q1 Reports"

          Path="/Finance/Reports/Q1 Reports"

          Description="First quarter reports"

          CreationDate="2024-01-15"

          OwnerName="jsmith"

          DomainId="3"

          ClassificationLevel="NoMarkings"

          ClassificationLevelId="0"

          DeclassifyOn=""

          DowngradeOn=""

          RDDefId="0"

          RetentionDate=""

          DispositionDate=""

          CutoffDate="">

    <!-- Included only when withrules=true -->

    <Rules>

      <Rule Name="AllowableFileTypes"  Value="*" />

      <Rule Name="Checkins"            Value="allows" />

      <Rule Name="Checkouts"           Value="allows" />

      <Rule Name="DocumentDeletes"     Value="allows" />

      <Rule Name="FolderDeletes"       Value="allows" />

      <Rule Name="NewDocuments"        Value="allows" />

      <Rule Name="NewFolders"          Value="allows" />

      <Rule Name="ClassifiedDocuments" Value="disallows" />

    </Rules>

    <!-- Included only when withpropertysets=true -->

    <PropertySets> ... </PropertySets>

    <!-- Included only when withsecurity=true -->

    <AccessList DateApplied="2024-01-15" AppliedBy="admin" InheritedSecurity="false"> ... </AccessList>

    <!-- Included only when withOwner=true -->

    <User UserID="7" UserName="jsmith" FullName="John Smith" ... />

  </folder>

  <!-- Document items in the download queue -->

  <document DocumentID="1051"

            Name="Q1-2024-Report.pdf"

            Path="\Finance\Reports"

            Description="Q1 financial summary"

            CreationDate="2024-03-01"

            ModificationDate="2024-06-15"

            Size="204800"

            Type="PDF Document"

            VersionNumber="3"

            PublishedVersionNumber="3"

            OwnerName="jsmith"

            ...>

    <!-- Included only when withpropertysets=true -->

    <PropertySets> ... </PropertySets>

    <!-- Included only when withsecurity=true -->

    <AccessList DateApplied="2024-03-01" AppliedBy="jsmith" InheritedSecurity="true"> ... </AccessList>

    <!-- Included only when withOwner=true -->

    <User UserID="7" UserName="jsmith" FullName="John Smith" ... />

    <!-- Included only when withVersions=true -->

    <Versions> ... </Versions>

  </document>

</root>

Folder Element Attributes¶

See GetFoldersAndDocuments for the full list of folder attributes and their descriptions. The folder element structure is identical.

Document Element Attributes¶

See GetFoldersAndDocuments for the full list of document attributes and their descriptions. The document element structure is identical, including the UserViewStatus attribute (0 = never viewed, 1 = viewed but changed, 2 = viewed current version).

Optional Child Elements¶

Element	Enabled by	Applies to
`<Rules>`	`withrules=true`	Folders only
`<PropertySets>`	`withpropertysets=true`	Folders and documents
`<AccessList>`	`withsecurity=true`	Folders and documents
`<User>`	`withOwner=true`	Folders and documents
`<Versions>`	`withVersions=true`	Documents only

Documents come back as the full <document> element. Since 9.0 it also carries AIEnhanced and AIExtractConfidence. The first says which of the document's attributes infoRouter Connect produced, as a set of bits - 0 when none did; the second how sure it was about the weakest value it put in a property set, as a percentage. See AIEnhanced and AIExtractConfidence.

Error Response¶

<root success="false" error="[901] Session expired or Invalid ticket" />

Required Permissions¶

Any authenticated user may call this API. The response always reflects the download queue of the currently authenticated user -" callers cannot query another user's download queue. Items in the queue that the user no longer has access to may be excluded from the response.

Example¶

GET Request -" minimal (no extra detail)¶

GET /srv.asmx/GetDownloadQue

  ?AuthenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301

  &withrules=false

  &withpropertysets=false

  &withsecurity=false

  &withOwner=false

  &withVersions=false

HTTP/1.1

GET Request -" with full detail¶

GET /srv.asmx/GetDownloadQue

  ?AuthenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301

  &withrules=true

  &withpropertysets=true

  &withsecurity=true

  &withOwner=true

  &withVersions=true

HTTP/1.1

POST Request¶

POST /srv.asmx/GetDownloadQue HTTP/1.1

Content-Type: application/x-www-form-urlencoded

AuthenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301

&withrules=false

&withpropertysets=false

&withsecurity=false

&withOwner=false

&withVersions=false

SOAP Request¶

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

               xmlns:tns="http://tempuri.org/">

  <soap:Body>

    <tns:GetDownloadQue>

      <tns:AuthenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:AuthenticationTicket>

      <tns:withrules>false</tns:withrules>

      <tns:withpropertysets>false</tns:withpropertysets>

      <tns:withsecurity>false</tns:withsecurity>

      <tns:withOwner>false</tns:withOwner>

      <tns:withVersions>false</tns:withVersions>

    </tns:GetDownloadQue>

  </soap:Body>

</soap:Envelope>

JavaScript¶

Every call answers XML with HTTP 200, success or not, so success is the thing to branch on and errorCode is the number to report.

async function call(action, params) {
  const response = await fetch(`/srv.asmx/${action}?${new URLSearchParams(params)}`);
  const root = new DOMParser()
    .parseFromString(await response.text(), 'text/xml')
    .documentElement;

  if (root.getAttribute('success') !== 'true') {
    throw new Error(`${root.getAttribute('errorCode')}: ${root.getAttribute('error')}`);
  }
  return root;
}

Lists what the calling user has put in their download queue with AddToDownloadQueue.

const root = await call('GetDownloadQue', {
  authenticationTicket: ticket,
  withrules: false,
  withpropertysets: false,
  withsecurity: false,
  withOwner: false,
  withVersions: false
});

for (const document of root.querySelectorAll(':scope > document')) {
  console.log(document.getAttribute('Path'), document.getAttribute('Name'));
}

An empty queue is a success with an empty root rather than an error.

These three answer for the calling user only - there is no userName - so a caller with no ticket is refused rather than answered for the anonymous user. The refusal says that the list belongs to the signed-in user and there is not one; it used to say "User has been deleted.", about nobody in particular.

Notes¶

The download queue belongs to the currently authenticated user only. There is no parameter to specify a different user.
Folders appear before documents in the response. Documents within the queue are sorted alphabetically by name in ascending order.
If the download queue is empty, the response is <root success="true" /> with no child elements.
withrules applies only to folder items -" it has no effect on document elements.
withVersions applies only to document items -" it has no effect on folder elements.
Items are returned with their current properties at the time of the call. Items added to the queue from documents or folders that have since been deleted or moved may no longer appear in the response.
Setting all boolean flags to false returns only the core attributes for each item, which is the fastest and most compact response.

GetFavorites - Returns the current user's favorites list (documents and folders)
GetRecentDocuments - Returns recently accessed documents for the current user
GetFoldersAndDocuments - Returns folders and documents within a specific folder path
DownloadZip - Download multiple documents and folders as a zip archive
DownloadZipWithHandler - Stage a zip archive of multiple items for chunked download

Error Codes¶

The errorCode values this operation returns, checked against a running server:

`errorCode`	When
`4010`	the caller has no ticket; the list is about the signed-in user and there is not one
`4010`	the ticket is expired or unknown

Error	Description
`[900] Authentication failed`	Invalid or missing authentication ticket.
`[901] Session expired or Invalid ticket`	The ticket has expired or does not exist.
This list belongs to the signed-in user...	There is no signed-in user: the call arrived with no ticket.
`SystemError:...`	An unexpected server-side error occurred.