Account  目次

Account APIは、Oracle Service Registryでユーザー・アカウントの問合せおよび管理を行う場合に使用します。

データ構造  目次

Account APIでは、次の構造が使用されます。

userAccount  目次

userAccount要素は、Oracle Service Registryでユーザー・アカウントの属性を保持するコンテナです。必須の要素は、次のとおりです。

  • loginName

  • email

  • fullName

  • languageCode

その他のすべての要素はオプションです。

要素説明
loginNameユーザー・アカウントのログイン名が含まれます。
passwordユーザーの認可に使用するパスワードが含まれます。
emailユーザーの電子メールが保持されます。
fullNameユーザーのフルネームが保持されます。
descriptionユーザーまたはユーザーのロールの記述に使用されます。
languageCodeユーザーが使用する言語。
businessNameユーザーが所属する組織の名前。
phoneユーザーへの連絡に使用する電話番号。
alternatePhoneユーザーへの連絡に使用する2番目の電話番号。
address 
city 
stateProvince 
country 
zip 
expirationユーザー・アカウントの有効期限が保持されます。
expires時間の経過とともにアカウントが期限切れになっているかどうかを示します。
externalユーザー・アカウントが外部にあるか、UDDIリポジトリに保存されているかを示すフラグ。
blockedユーザーがブロックされているかどうかを示すフラグ。
account:property未指定の文字列(UserStoreタイプによって意味が異なります)。
businessesLimitユーザー・アカウントが保存できるビジネス・エンティティの数が指定されます。
servicesLimitユーザー・アカウントが所有できる単一のビジネス・エンティティ内のビジネス・サービスの最大数が指定されます。
bindingsLimitユーザー・アカウントが単一のビジネス・サービス内に保存できるbindingTemplateの数が指定されます。
tModelsLimitユーザー・アカウントが保存できるtModelの数が指定されます。
assertionsLimitユーザー・アカウントが保存できるpublisherAssertionの数が指定されます。
subscriptionsLimitユーザー・アカウントが保存できるサブスクリプションの数が指定されます。
lastLoginTimeユーザーが最後にレジストリにログインしたときの情報が含まれます。

userInfo  目次

この要素は、単一のuserAccountに関する概要を含むコンテナとして機能します。この要素には、必須のloginName要素、オプションのfullNamedescriptionおよびemail要素が含まれています。

userInfos  目次

この要素には、1つ以上のuserInfo要素が保持されます。

userList  目次

この要素には、オプションのlistDescription要素およびuserInfos要素が含まれています。

操作  目次
find_userAccount  目次

find_userAccount APIコールは、特定の条件と一致したOracle Service Registry内のユーザー・アカウントを検索する場合に使用します。

構文  目次
引数  目次
  • authInfo: このオプションの引数は、認証トークンを含む要素です。

  • name: 検索される名前。

  • account:findQualifier: デフォルトの動作の変更に使用するfindQualifierの集合。

動作  目次

次のfindQualifierは、コールの動作に影響を与えます。

  • findByLoginName findQualifier(デフォルト)は、loginNameでユーザー・アカウントを検索するように指定する場合に使用します。

  • findByFullName findQualifierを使用すると、fullNameプロパティでユーザー・アカウントが検索されます。

  • exactMatch findQualifierが存在する場合は、完全一致が必要となります。

  • デフォルトのapproximateMatch findQualifierによって、SQLワイルド・カード問合せが有効になります。

  • findBlockedAccount findQualifierが存在する場合は、ブロックされたアカウントのみが戻されます。

  • sortByNameAsc findQualifier(デフォルト)およびsortByNameDesc findQualifierは、データが戻される順序を制御します。

戻り値  目次

このAPIコールは、成功時にuserListを戻します。

パーミッション  目次

このAPIコールには、org.systinet.uddi.account.AccountApiおよびアクションfind_userAccountに対するAPIマネージャ・パーミッションが必要です。

get_userAccount  目次

get_userAccount APIコールは、選択したユーザーのuserAccount構造を戻します。

構文  目次
引数  目次
  • authInfo: このオプションの引数は、認証トークンを含む要素です。

  • loginName: この必須引数は、ユーザー・アカウントを一意に識別します。

戻り値  目次

このAPIは、成功時にuserAccountを戻します。

パーミッション  目次

このAPIコールには、ユーザー独自のアカウントの詳細を取得するために、org.systinet.uddi.account.AccountApiおよびアクションget_userAccountに対するAPIユーザー・パーミッションが必要です。また、他のユーザーのアカウントを取得するために、org.systinet.uddi.account.AccountApiおよびアクションget_userAccountに対するAPIマネージャ・パーミッションが必要です。

save_userAccount  目次

save_userAccount APIコールは、Oracle Service RegistryにuserAccountを保存または更新する場合に使用します。 公開登録が許可されるかどうかは、Oracle Service Registry構成によって異なります。また、電子メールで送信されるコードによって有効にされるまで、登録したアカウントをブロックするように構成することもできます。

構文  目次
引数  目次
  • authInfo: このオプションの引数は、認証トークンを含む要素です。

  • account:userAccount: 保存されるユーザー・アカウント。

戻り値  目次

このAPIは、成功時にuserAccountを戻します。

パーミッション  目次

このAPIには、ユーザー独自のアカウントを保存したり、新しいアカウントを登録するために、org.systinet.uddi.account.AccountApiおよびアクションsave_userAccountに対するAPIユーザー・パーミッションが必要です。また、他のユーザーのアカウントを保存するために、org.systinet.uddi.account.AccountApiおよびアクションsave_userAccountに対するAPIマネージャ・パーミッションが必要です。

delete_userAccount  目次

delete_userAccount APIコールによって、選択したユーザー・アカウントがOracle Service Registryから削除されます。

構文  目次
引数  目次
  • authInfo: このオプションの引数は、認証トークンを含む要素です。

  • loginName: この必須引数は、ユーザー・アカウントを一意に識別します。

戻り値  目次

このAPIコールは、成功時にUserAccountを戻します。

パーミッション  目次

このAPIには、ユーザー独自のアカウントを削除するために、org.systinet.uddi.account.AccountApiおよびアクションdelete_userAccountに対するAPIユーザー・パーミッションが必要です。また、他のユーザーのアカウントを削除するために、org.systinet.uddi.account.AccountApiおよびアクションdelete_userAccountに対するAPIマネージャ・パーミッションが必要です。

enable_userAccount  目次

enable_userAccount APIコールは、loginName引数によって識別されるユーザー・アカウントをOracle Service Registryでアクティブ化する場合に使用します。

構文  目次
引数  目次
  • loginName: この必須引数は、ユーザー・アカウントを一意に識別します。

  • account:enableCode: 構成文字列。

WSDL  目次

WSDL仕様は、ファイルaccount.wsdlで確認できます。

APIエンドポイント  目次

Account APIエンドポイントは、http://<ホスト名>:<ポート>/<コンテキスト>/uddi/accountで確認できます。

Java  目次

Java APIは、Account WSDLから生成されます。詳細は、「org.systinet.uddi.account.AccountApi」を参照してください。また、Accountのデモを参照および試行することをお薦めします。