組織の詳細の取得

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

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

このセクションでは、組織の詳細の取得に関する以下のトピックについて説明します。

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

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

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

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

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

成功したトランザクションで返される要素の詳細については、listEmailTypeResponse レスポンスメッセージに関する情報が記載されている表を参照してください。エラーがある場合は、付録「エラーコード」を参照してください。