XKI.getDRNList

Retrieves a list of message item DRNs. You can specify new, modified, or all items. The request can, optionally, specify a folder to which to restrict the DRN list.

Parameters

User.context (Required)

Specifies the context identifier for this user's session.

XKI.getDRNList (Required)

Specifies the required action.

XKI.getDRNList.type (Required)

Specifies the type of list to return:

getDRNList.new

Returns all new items after XKI.getDRNList.startTime

getDRNList.modified

Returns all modified items after XKI.getDRNList.startTime

getDRNList.all

Returns all items.

XKI.getDRNList.startTime (Required for getDRNList.new and getDRNList.modified)

Specifies the start time (the number of seconds since 12:00:00 a.m. on January 1, 1970) from which to search for new and modified items.

Folder.drn (Optional)

Specifies the identifier or DRN of the folder to retrieve the DRN list from. Trash, Query, or Contacts folders cannot be specified. The Sent Items folder cannot be specified with getDRNList.new.

Return Values

XKI.Item.count

Total number of items in the list.

XKI.Item[n].drn

GroupWise specific identifier of the nth returned item.

Remarks

You cannot access XKI.getDRNList as a proxy user.

Also, shared folders are not included when querying across all folders.

Example

/servlet/webacc?User.context=xyz&action=XKI.getDRNList& XKI.getDRNList.type=XKI.getDRNList.modified&XKI.getDRNList.startTime=1091170800