IdentifierType は、Virtual member manager
エンティティーの ID を表します。
IdentifierType DataObject の構造は、以下のものから構成されます。
- uniqueName
- 人が判別しやすい名前です。
これは、Virtual member manager のエンティティーを一意的に識別するために使用されます。
LDAP 識別名の形式です。
識別名は Virtual member manager 階層内におけるエンティティーの場所を含むストリングであり、エンティティーの相対識別名と、
ルートまでにある各祖先とを連結することで形成されます。
例えば、コンテナー「cn=users,dc=yourco,dc=com」内の個人の識別名は「uid=userA,cn=users,dc=yourco,dc=com」になります。
- uniqueId
- マシンが判別しやすい ID です。
これは、Virtual member manager のエンティティーを一意的に識別するために使用されます。
Virtual member manager または基礎となるリポジトリーによって生成される、グローバルに固有な ID です。
Virtual member manager のクライアント・アプリケーションは、uniqueId の内容を解釈しません。
uniqueId は不変であり、再利用されないので、エンティティーが名前変更されたり移動されたりしても、その uniqueId は変わりません。
- externalId
- リポジトリーがオブジェクトに提供する固有 ID です。
例えば、LDAP リポジトリー内のオブジェクトの externalId は、そのオブジェクトの UUID です。
Virtual member manager の SPI は、externalId を使用して、リポジトリー・アダプターと対話します。
- externalName
- リポジトリーがオブジェクトに提供する固有名です。例えば、LDAP リポジトリー内のオブジェクトの externalName は、そのオブジェクトの識別名 (DN) です。
externalName は、アプリケーションが API を通じて使用できます。
- repositoryId
- リポジトリーの Virtual member manager
構成の一部としてリポジトリーに割り当てられる ID です。
repositoryId は、アプリケーションが API を通じて使用できます。
Virtual member manager は、プロパティー拡張リポジトリーに格納されているデータを、
メイン・リポジトリー内の同じオブジェクトのデータに関連付けるために、repositoryId と externalId を一緒に使用します。
- changeType
- は、変更済みエンティティーの検索に対する応答としてのみ設定されるオプションのプロパティーです。このプロパティーは、発生した変更のタイプを示します。変更には、新規エンティティーの追加、既存のエンティティーの変更、エンティティーの削除、エンティティーの名前変更があります。changeType プロパティーの有効な値とストリング定数は、add (CHANGETYPE_ADD)、delete (CHANGETYPE_DELETE)、modify (CHANGETYPE_MODIFY)、および rename (CHANGETYPE_RENAME) です。
注: Virtual member manager の呼び出し側は、uniqueName と uniqueId プロパティーのみを使用します。
XML スキーマ定義
次に、IdentifierType DataObject の XML スキーマ定義を示します。
<xsd:complexType name="IdentifierType">
<xsd:attribute name="uniqueId" type="xsd:token"/>
<xsd:attribute name="uniqueName" type="xsd:token"/>
<xsd:attribute name="externalId" type="xsd:token"/>
<xsd:attribute name="externalName" type="xsd:token"/>
<xsd:attribute name="repositoryId" type="xsd:token"/>
</xsd:complexType>
サンプル・データ・オブジェクト
次に、uniqueID と uniqueName を含む IdentifierType DataObject のサンプルを示します。
<wim:identifier uniqueId="afdbaa77-2160-4c26-b899-11fa366595ac"
uniqueName="uid=persona,cn=users,dc=yourco,dc=com"/>