Fetching User Profile Information

RiskMinder Web Services Developer's Guide › Performing Selected Administration Tasks › Fetching User Profile Information

Fetching User Profile Information

To view the details of a specified user, you must use the ArcotRiskFortAdminSvc service (available through ArcotRiskFortAdminWebService.wsdl). This section covers the following topics:

Preparing the Request Message
Invoking the Web Service
Interpreting the Response Message

Preparing the Request Message

You must use the getUserProfileRequest message to view detailed information about the specified user. The following table lists the elements of this request message.

Element	Mandatory	Description
userName	Yes	The name of the user whose details you want to see.
groupName	Yes	The name of the organization to which the user belongs.
callerId	No	Unique transaction identifier that your calling application can include. This identifier helps in tracking related transactions.

Invoking the Web Service

To view a user’s information:

(Optional) Include the authentication and authorization details in the header of the getUserProfile operation. See "Managing Web Services Security" for more information on the header elements.
Use the getUserProfileRequest elements to set the required information, as listed in the table.
Use the getUserProfileRequest message and construct the input message by using the details specified in preceding step.
Invoke the getUserProfile operation of the ArcotRiskFortAdminSvc service to fetch the user information.
This operation returns the getUserProfileResponse message that includes the status of the operation, user details, and success result. See the following section for more information on the response message.

Interpreting the Response Message

The response message, getUserProfileResponse, returns the status of the operation, user details, and the success result in the SOAP envelope header. These elements are explained in the following table. The SOAP body returns a success message if the operation was performed successfully. If there are any errors, then the AdminFault response is returned. See appendix, "Exceptions and Error Codes" for more information on the SOAP error messages.

Element	Description
code	The status of the operation: 0: Indicates that the user details were successfully fetched from the database. 1: Indicates that the operation failed.
message	Contains the string that indicates whether the information was successfully retrieved from the database or not.
transactionID	The unique transaction identifier.
userName	The name of the specified user.
firstName	The first name of the specified user.
lastName	The last name of the specified user.
emailAddress	The email ID of the specified user.
isExceptionUser	Indicates whether the user is an exception user or not: true: The user is an exception user. false: The user is not an exception user.