組織の詳細の取得

組織の詳細を読み取るには、retrieveOrg 操作を使用します。

注：一度に複数の組織の詳細を取得する場合は、listOrgs 操作を使用します。この操作の使用方法の詳細については、「組織の検索」を参照してください。

このセクションでは、組織の詳細を取得するための以下の手順について説明します。

組織の詳細を取得するには、retrieveOrgRequest メッセージを使用します。以下の表に、このリクエストメッセージの要素のリストを示します。

要素	必須	説明
orgName	はい	組織を識別する一意の名前。
clientTxId	いいえ	呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。この識別子は、関連するトランザクションの追跡に役立ちます。

組織の詳細を取得する方法

（オプション） retrieveOrg 操作のヘッダに認証および許可の詳細を含めます。ヘッダ要素の詳細については、「Web サービスセキュリティの管理」を参照してください。
retrieveOrgRequest 要素を使用して、この表に記載されている組織の詳細を取得します。
retrieveOrgRequest メッセージを使用して、前の手順で指定した詳細に従って入力メッセージを作成します。
ArcorUserRegistryMgmtSvc サービスの retrieveOrg 操作を呼び出して、組織の詳細を取得します。
この操作では、トランザクション識別子、認証トークン、および組織の詳細が含まれる retrieveOrgResponse メッセージが返されます。レスポンスメッセージの詳細については、以下のセクションを参照してください。

retrieveOrgResponse レスポンスメッセージでは、SOAP エンベロープヘッダでトランザクション識別子および認証トークンが返されます。 SOAP 本文には、成功したトランザクションでは組織の詳細が含まれ、エラーがある場合はエラーレスポンスが含まれます。

成功したトランザクションで返される要素の詳細については、「デフォルト組織の詳細の取得」の 2 番目の表を参照してください。エラーがある場合は、付録「例外コードおよびエラーコード」を参照してください。