Get User

Description

Retrieve information about a user.

If the combination of userLogonReference (user id) and password is valid, return the user name.

If not, return the not authorised error.

Update the lastSignOnTimestamp property with the current timestamp.

This service is used to sign the user on. To get details of other users, use the GetUserDetails service.

Input

<GetUser>
<userLogonReference>userid</userLogonReference>
<password>password</password>
</GetUser>

Output

<User>
<errorNumber>0</errorNumber> <userLogonReference>userid</userLogonReference>
<userName>The User Name</userName>
<userEmailAddress>email address</userEmailAddress>
<userCapabilities>token1 token2 etc</userCapabilities>
<acceptMarketingIndicator>true|false</acceptMarketingIndicator>
<acceptThirdPartyMarketingIndicator>true|false</acceptThirdPartyMarketingIndicator> <forcePasswordChangeIndicator>true|false</forcePasswordChangeIndicator> <clientIdentificationString>client id string</clientIdentificationString> <signOnURL>sign on URL</signOnURL>
</User>

userLogonReference is returned because the service may be called using a session token.

userCapabilities is a list of permission types references that the user has, separated by spaces. The purpose of userCapabilities is to allow the user interface to be tailored to different users.  The services called from the user interface should still check that the user is authorised.

clientIdentificationString and signOnURL are only returned if the service is called with a session token in place of userLogonReference and password. Only non-blank fields are returned.

Errors

101 - Not authorised

When error 101 is returned, the service will also return signOnURL if available. This is the URL to which the user should be redirected in order to sign on.

Class

com.metrici.xerula.GetUserService