getApprovalRequests

Parameter Name

Description

locationCentraSite

String Optional. The address of the CentraSite registry/repository from which you want to retrieve the approval requests. The registry/repository runs at the following URL:

http://server:port/CentraSite/CentraSite

Where server is the machine on which the CentraSite registry/repository is running and port is the port on which Apache is configured to listen for requests (port 53307 if CentraSite is configured to use the default Apache port number).

If you do not specify locationCentraSite, the Approval service will use the following default URL:

http://localhost:53307/CentraSite/CentraSite

status

String Optional. If you want to retrieve only requests with a specified approval status, specify one of the following values shown here:

Specify...

To retrieve...

In Progress

Approval requests that are pending (awaiting approval).

Approved

Approval request that have been approved (excluding requests that were auto-approved).

Rejected

Approval requests that have been rejected.

No Action

Approval requests that were auto-approved.

objectType

String Array Optional. If you want to retrieve approval requests for only certain object types, specify the types by name in this element.

Note:

You must specify the type's "schema name", not its display name. You can find the schema name on the type's Asset Type Details page in CentraSite Control.

submittedAfter

DateTime Optional. If you want to retrieve requests after a particular date, specify that date in this element.

submittedBefore

DateTime Optional. If you want to retrieve requests before a particular date, specify that date in this element.

locale

String Optional. The locale in which you want the results returned.

scroll

Scroll Optional. If you want to return a particular block of entries from the result set, specify the following values in the scroll element. For information about using the scroll element, see Scrolling Through the List of Returned Approval Requests.

start

Integer The first entry that you want to include in the returned block of approval requests (where 1 represents the first entry in the entire result set).

number

Integer Optional. The number of entries to be returned in the block of approval requests.

If you specify a start value, but no number value, the remainder of the result set is returned.