Software AG Products 10.11 | CentraSite for Developers | Web Service Interfaces | Approval Service | Invoking Operations from the Approval Service
 
Invoking Operations from the Approval Service
You can perform the invoking operations from the approval service by specifying the authenticated user or by specifying the location of the approval log.
Specifying the Authenticated User
The Approval service returns results that are specific to the authenticated user (that is, the user who invokes the operation). For example, when a client application invokes the getPendingApprovals operation, the operation returns the set of approval requests that require the authenticated user's approval.
The authenticated user is identified by the basic http authentication credentials that the client application provides when it invokes an operation in the Approval service. The supplied credentials must identify an active user account on the instance of CentraSite to which the client application is connecting. If the client application submits invalid credentials, the Approval service returns a SOAP fault.
Specifying the Location of the Approval Log
All of the operations provided by the Approval service have an input parameter called locationCentraSite. This parameter identifies the address of the CentraSite registry or repository whose approval log is to be queried. A client application must specify the locationCentraSite parameter if the registry or repository is running anywhere other than its default location (that is, port 53307 on the machine where the Approval service is running).
If the registry or repository is running at its default location, a client does not have to specify the locationCentraSite parameter.