Systinet Account API is used to query and manage user accounts in BEA AquaLogic Service Registry.
The following structures are used by the Systinet Account API:
The userAccount element is container that holds the attributes of a user account in the BEA AquaLogic Service Registry. The required elements are:
loginName
fullName
languageCode
All other elements are optional.
Element | Description |
loginName | contains the login name of the user account |
password | contains the password used to authorize the user |
holds the user's email address | |
fullName | holds the user's full name |
description | use for describing the user or the user's role |
languageCode | the language the user speaks |
businessName | name of organization where the user is employed |
phone | telephone number used to contact the user |
alternatePhone | second telephone number used to contact the user |
address | |
city | |
stateProvince | |
country | |
zip | |
expiration | may hold the time when the user account expires |
expires | indicates whether the account may expire over time |
external | a flag indicating whether the user account is external or stored in the UDDI registry |
blocked | a flag indicating whether the user is blocked |
account:property | an unspecified string; its meaning depends on UserStore type |
businessesLimit | specifies how many business entities the user account may save |
servicesLimit | specifies maximum number of business services within a single business entity that the user account may own |
bindingsLimit | specifies how many bindingTemplates the user account may save within a single businessService |
tModelsLimit | specifies the number of tModels the user account may save |
assertionsLimit | specifies the number of publisherAssertions the user account may save |
subscriptionsLimit | specifies the number of subscriptions the user account may save |
lastLoginTime | contains information regarding when the user last logged into the registry |
This element serves as a container for short information about single userAccount. It contains the required element loginName, and the optional elements fullName, description, and email.
The find_userAccount API call is used to find user accounts in BEA AquaLogic Service Registry that match given criteria.
authInfo - This optional argument is an element that contains an authentication token.
name - Name to be searched.
account:findQualifier - The collection of findQualifier used to alter default behavior.
The following findQualifiers affect behavior of the call:
The findByLoginName findQualifier (default) is used to specify that user accounts shall be searched by loginName.
With the findByFullName findQualifier, user accounts are searched by the fullName property.
If the exactMatch findQualifier is present, an exact match is required.
The default approximateMatch findQualifier enables SQL wildcard queries.
If the findBlockedAccount findQualifier is present, only blocked accounts are returned.
The sortByNameAsc (default) and sortByNameDesc findQualifiers controls the order in which the data is returned.
This API call requires the API user permission for org.systinet.uddi.account.AccountApi and the action find_userAccount.
The get_userAccount API call returns userAccount structure of selected user.
authInfo - This optional argument is an element that contains an authentication token.
loginName - This required argument uniquely identifies the user account.
This API call returns userAccount upon success.
This API call requires the API user permission for org.systinet.uddi.account.AccountApi and the action get_userAccount to get user's own account detail and API manager permission for org.systinet.uddi.account.AccountApi and the action get_userAccount to get other users' accounts.
The save_userAccount API call is used to save or update userAccount in BEA AquaLogic Service Registry. Whether public registration is allowed or not depends on the BEA AquaLogic Service Registry configuration. It may be also configured to block registered account until it is enabled by code sent by email.
authInfo - This optional argument is an element that contains an authentication token.
account:userAccount - The user account to be saved.
This API call returns userAccount upon success.
This API call requires the API user permission for org.systinet.uddi.account.AccountApi and the action save_userAccount to save user's own account or register new account and API manager permission for org.systinet.uddi.account.AccountApi and the action save_userAccount to save other users' accounts.
The delete_userAccount API call causes selected user account to be removed from BEA AquaLogic Service Registry.
authInfo - This optional argument is an element that contains an authentication token.
loginName - This required argument uniquely identifies the user account.
This API call returns UserAccount upon success.
This API call requires the API user permission for org.systinet.uddi.account.AccountApi and the action delete_userAccount to delete user's own account and API manager permission for org.systinet.uddi.account.AccountApi and the action delete_userAccount to delete other users' accounts.
The enable_userAccount API call is used to activate user account identified by loginName argument in BEA AquaLogic Service Registry.
loginName - This required argument uniquely identifies the user account.
account:enableCode - Confirmation string.
You can find the WSDL specification in the file account.wsdl.
You can find the Account API endpoint at http://<host name>:<port>/uddi/account .
The Systinet Java API is generated from Account WSDL. You are encouraged to browse org.systinet.uddi.account.AccountApi and to read and try Account demos.