データ型

このタイプは、テキスト情報を表します。 EBX®のデフォルトのユーザーインターフェイスは、入力と表示用に数行の専用エディターで構成されています。

このデータ型の使用は、非常に長いテキストを対象としています。これが、'Text'検索戦略がこのタイプに関連付けられており、変更できない理由です。結果として、タイプosd:textのフィールドはソートの恩恵を受けることができません。さらに、それらのインデックス作成戦略と検索結果は、xs:stringタイプのものとは異なります。詳細については、文字列フィールドのデフォルト戦略を参照してください。

<xs:simpleType name="text">
	<xs:restriction base="xs:string" />
</xs:simpleType>

これは、HTML形式の文字列を表します。 WYSIWYGエディターはEBX®で提供されます。

<xs:simpleType name="html">
	<xs:restriction base="xs:string" />
</xs:simpleType>

これは、RFC822標準で指定されている電子メールアドレスを表します。

<xs:simpleType name="email">
	<xs:restriction base="xs:string" />
</xs:simpleType>

これは、ハッシュまたは暗号化されたパスワードを表します。 EBX®には特定のエディターが用意されています。

<xs:element name="password" type="osd:password" />

デフォルトのエディターは、SHA-512アルゴリズムを使用してハッシュ計算を実行します。この暗号化関数は、メソッドDirectoryDefault.encryptStringを使用してJavaクライアントからも使用できます。

インターフェイス暗号化を実装するクラスを指定することにより、デフォルトのエディターで別の暗号化メカニズムを使用することもできます。

<xs:element name="password" type="osd:password">
	<xs:annotation>
		<xs:appinfo>
			<osd:uiBean class="com.orchestranetworks.ui.UIPassword">
				<encryptionClass>package.EncryptionClassName</encryptionClass>
			</osd:uiBean>
		</xs:appinfo>
	</xs:annotation>
</xs:element>

別のフィールドへのパスを参照することでソルトを指定することができ、クラスを使用することで、インターフェイスHashComputationを実装します。

<xs:element name="password" type="osd:password">
	<xs:annotation>
		<xs:appinfo>
			<osd:uiBean class="com.orchestranetworks.ui.UIPassword">
				<encryptionClass>package.HashClassName</encryptionClass>
				<saltPath>../login</saltPath>
			</osd:uiBean>
		</xs:appinfo>
	</xs:annotation>
</xs:element>

これは、地理的、政治的、または文化的な場所を表します。

ロケール タイプは、クラス java.util.Localeによって Java に変換されます。

<xs:simpleType name="locale">
	<xs:restriction base="xs:string">
		<xs:enumeration value="ar" osd:label="Arabic" />
		<xs:enumeration value="ar_AE" osd:label="Arabic (United Arab Emirates)" />
		<xs:enumeration value="ar_BH" osd:label="Arabic (Bahrain)" />
		<xs:enumeration value="ar_DZ" osd:label="Arabic (Algeria)" />
		<xs:enumeration value="ar_EG" osd:label="Arabic (Egypt)" />
		<xs:enumeration value="ar_IQ" osd:label="Arabic (Iraq)" />
			...
		<xs:enumeration value="vi_VN" osd:label="Vietnamese (Vietnam)" />
		<xs:enumeration value="zh" osd:label="Chinese" />
		<xs:enumeration value="zh_CN" osd:label="Chinese (China)" />
		<xs:enumeration value="zh_HK" osd:label="Chinese (Hong Kong)" />
		<xs:enumeration value="zh_TW" osd:label="Chinese (Taiwan)" />
	</xs:restriction>
</xs:simpleType>

これは、16進数のRGBカラーフォーマットの文字列を表します。 EBX®には、カラーピッカーUIComponentが用意されています。

<xs:simpleType name="color">
	<xs:restriction base="xs:string" />
</xs:simpleType>

これは、モジュールにパッケージ化されたリソースを表します。詳細については、パッケージ化されたリソースを参照してください。このタイプには、ファセットFacetOResourceの定義が必要です。

<xs:simpleType name="resource">
	<xs:restriction base="xs:anyURI" />
</xs:simpleType>

このタイプは、データスペースへの参照を表します。

<xs:element name="dataspaceField" type="osd:dataspaceKey" />

EBX®には、参照可能なデータスペースを表示する特定のエディターが用意されています。

xs:annotation/xs:appInfoの下のエレメント osd:dataspaceSetを使用して参照できるデータスペースを指定することができます。エレメント osd:dataspaceSetが定義されていない場合、デフォルトでは、開いているブランチのみを参照できます。

<xs:element name="dataspaceField" type="osd:dataspaceKey">
	<xs:annotation>
		<xs:appinfo>
			<osd:dataspaceSet>
				<include>
					<pattern>a pattern</pattern>
					<type>all | branch | version</type>
					<includeDescendants>none | allDescendants | allBranchDescendants | allSnapshotDescendants | branchChildren | snapshotChildren</includeDescendants>
				</include>
				<exclude>
					<pattern>a pattern</pattern>
					<type>all | branch | version</type>
					<includeDescendants>none | allDescendants | allBranchDescendants | allSnapshotDescendants | branchChildren | snapshotChildren</includeDescendants>
				</include>
				<filter osd:class="com.foo.MyDataspaceFilter">
					<param1>...</param1>
					<param2>...</param2>
				</filter>
			</osd:dataspaceSet>
		</xs:appinfo>
	</xs:annotation>
</xs:element>

• includes

  このフィールドで参照できるデータスペースを指定します。 includeを少なくとも定義する必要があります。

  pattern：データスペースをフィルタリングするパターンを指定します。パターンは、データスペースの名前と照合されます。このプロパティは必須です。

  type：このフィールドで参照できるデータスペースのタイプを指定します。定義されていない場合、この制限はブランチに適用されます。 allの場合、ブランチとスナップショットが含まれます。 branchの場合、ブランチのみが含まれます。 スナップショットの場合、スナップショットのみが含まれます。設定されていない場合、このプロパティはデフォルトでbranchになります。

  includeDescendants：指定されたパターンに一致するデータスペースの子または子孫をセットに含めるかどうかを指定します。 noneの場合、指定されたパターンに一致するデータスペースの子も子孫も含まれません。 allDescendantsの場合、指定されたパターンに一致するデータスペースのすべての子孫が含まれます。 allBranchDescendantsの場合、指定されたパターンに一致するデータスペースのすべての子孫ブランチが含まれます。 allSnapshotDescendantsの場合、指定されたパターンに一致するデータスペースのすべての子孫スナップショットが含まれます。 directBranchChildrenの場合、指定されたパターンに一致するデータスペースの直接ブランチのみが含まれます。 directSnapshotChildrenの場合、指定されたパターンに一致するデータスペースの直接スナップショットのみが含まれます。設定されていない場合、このプロパティはデフォルトでnoneになります。

• excludes

  このフィールドで参照できないデータスペースを指定します。Includes（含む）が定義されていない場合、Excludes（除外）は無視されます。

  pattern：データスペースをフィルタリングするパターンを指定します。パターンは、データスペースの名前と照合されます。このプロパティは必須です。

  type：このフィールドで参照できるデータスペースのタイプを指定します。定義されていない場合、この制限はブランチに適用されます。 allの場合、ブランチとスナップショットは除外されます。 branchの場合、ブランチのみが除外されます。 snapshotの場合、スナップショットのみが除外されます。設定されていない場合、このプロパティはデフォルトでbranchになります。

  includeDescendants：指定されたパターンに一致するデータセットの子または子孫をセットから除外するかどうかを指定します。 noneの場合、指定されたパターンに一致するデータスペースの子も子孫も除外されません。 allDescendantsの場合、指定されたパターンに一致するデータスペースのすべての子孫が除外されます。 allBranchDescendantsの場合、指定されたパターンに一致するデータスペースのすべての子孫ブランチが除外されます。 allSnapshotDescendantsの場合、指定されたパターンに一致するデータスペースのすべての子孫スナップショットが除外されます。 directBranchChildrenの場合、指定されたパターンに一致するデータスペースの直接ブランチのみが除外されます。 directSnapshotChildrenの場合、指定されたパターンに一致するデータスペースの直接スナップショットのみが除外されます。設定されていない場合、このプロパティはデフォルトでnoneになります。

• filter

  データセットまたはレコードのコンテキストでデータスペースを受け入れるか拒否するフィルターを指定します。このフィルターは、このフィールドに関連付けられている専用の入力コンポーネントでのみ使用されます。つまり、このフィールドを検証するとき、このフィルターは使用されません。特定の制約を使用して、このフィールドで特定の制御を実行できます。

  属性osd:classは、インターフェイスDataspaceSetFilterを実装するJavaBeanを指定します。

xs:annotation/xs:appInfo/osd:dataspaceSetの下のエレメントvalidationを使用して、このタイプに関連付けられた検証メッセージと制御ポリシーをカスタマイズすることもできます。詳細については、重大度のあるファセット検証メッセージおよび制御ポリシーを参照してください。

このタイプは、データセットへの参照を表します。

<xs:element name="dataset" type="osd:datasetName" />

EBX®で提供される特定のエディターは、参照可能なデータセットを表示します。

xs:annotation/xs:appInfoの下のエレメント osd:datasetSetを使用して参照できるデータセットを指定することもできます。

<xs:element name="datasetField" type="osd:datasetName">
	<xs:annotation>
		<xs:appinfo>
			<osd:datasetSet>
				<branch>productsBranch</branch>
				<version>productsVersion</version>
				<dataspaceSelector>../dataspaceField</dataspaceSelector>
				<pattern>a pattern</pattern>
				<filter osd:class="com.foo.MyDatasetFilter">
					<param1>...</param1>
					<param2>...</param2>
				</filter>
			</osd:datasetSet>
		</xs:appinfo>
	</xs:annotation>
</xs:element>

• branch

  ソースブランチを指定します。このブランチに含まれるデータセットのみが、データセット識別子（osd:datasetName）タイプのフィールドで選択できます。

• version

  ソーススナップショットを指定します。このスナップショットに含まれるデータセットのみが、データセット識別子（osd:datasetName）タイプのフィールドで選択できます。

• dataspaceSelector

  参照できるデータセットを含むデータスペースを定義する同じデータモデル内のフィールドを指定します。指定されたフィールドは xs:string または osd:dataspaceKey 型でなければなりません。このフィールドの値は、データスペースまたはスナップショットの永続的な識別子の表現に準拠する必要があります。

  参照されるノードは、動的ファセットに存在する制限に従う必要があります。

  以下も参照してください。

  • HomeKey.format
  • 動的制約

• includes

  このフィールドで参照できるデータセットを指定します。

  pattern：データセットをフィルタリングするパターンを指定します。パターンは、データセットの名前と照合されます。このプロパティは必須です。

  includeDescendants：指定されたパターンに一致するデータセットの子または子孫をセットに含めるかどうかを指定します。 noneの場合、指定されたパターンに一致するデータセットの子も子孫も除外されません。 directChildrenの場合、指定されたパターンに一致するデータセットの直接の子のみが除外されます。 allDescendantsの場合、指定されたパターンに一致するデータセットのすべての子孫が除外されます。設定されていない場合、このプロパティはデフォルトでnoneになります。

• excludes

  このフィールドで参照できないデータセットを指定します。Includes（含む）が定義されていない場合、Excludes（除外）は無視されます。

  pattern：データセットをフィルタリングするパターンを指定します。パターンは、データセットの名前と照合されます。このプロパティは必須です。

  includeDescendants：指定されたパターンに一致するデータセットの子または子孫をセットに含めるかどうかを指定します。 noneの場合、指定されたパターンに一致するデータセットの子も子孫も除外されません。 directChildrenの場合、指定されたパターンに一致するデータセットの直接の子のみが除外されます。 allDescendantsの場合、指定されたパターンに一致するデータセットのすべての子孫が除外されます。設定されていない場合、このプロパティはデフォルトでnoneになります。

• filter

  データセットまたはレコードのコンテキストでデータセットを受け入れるか拒否するフィルターを指定します。このフィルターは、このフィールドに関連付けられている専用の入力コンポーネントでのみ使用されます。つまり、このフィールドを検証するとき、このフィルターは使用されません。特定の制約を使用して、このフィールドで特定の制御を実行できます。

  属性osd:classは、インターフェイスDatasetSetFilterを実装するJavaBeanを指定します。入力データスペース参照がこのフィルターと一致しない場合、検証メッセージが関連フィールドに追加されます。

エレメントbranch、version、またはdataspaceSelectorのいずれかを定義する必要があります。

xs:annotation/xs:appInfo/osd:datasetSetの下のエレメントvalidationを使用して、このタイプに関連付けられた検証メッセージと制御ポリシーをカスタマイズすることもできます。詳細については、重大度のあるファセット検証メッセージおよび制御ポリシーを参照してください。

ユーザー定義属性（UDA）は、minOccurs属性とmaxOccurs属性の両方、および対応するカタログのパスを指定する属性osd:UDACatalogPathもサポートします。

<xs:element name="firstUDA" type="osd:UDA" minOccurs="0"
	maxOccurs="unbounded" osd:UDACatalogPath="//insuranceCatalog" />
<xs:element name="secondUDA" type="osd:UDA" minOccurs="1" maxOccurs="1"
	osd:UDACatalogPath="/root/userCatalog" />
<xs:element name="thirdUDA" type="osd:UDA" minOccurs="0" maxOccurs="1"
	osd:UDACatalogPath="//userCatalog" />

マネージャーでは、UDAを操作するときに、エディターは選択した属性のタイプに適応します。

内部的には、カタログはテーブルとして表されます。パラメーターminOccursおよびmaxOccursを指定する必要があります。

同じデータモデルで複数のカタログを定義できます。

<xs:element name="insuranceCatalog" type="osd:UDACatalog" minOccurs="0" maxOccurs="unbounded">
	<xs:annotation>
		<xs:documentation xml:lang="en-US">Insurance Catalog.</xs:documentation>
		<xs:documentation xml:lang="fr-FR">Catalog assurance.</xs:documentation>
	</xs:annotation>
</xs:element>
<xs:element name="userCatalog" type="osd:UDACatalog" minOccurs="0" maxOccurs="unbounded">
	<xs:annotation>
		<xs:documentation xml:lang="en-US">User catalog.</xs:documentation>
		<xs:documentation xml:lang="fr-FR">Catalogue utilisateur.</xs:documentation>
	</xs:annotation>
</xs:element>

新しい属性の作成に使用できるのは、次のタイプのみです。

• xs:string

• xs:boolean

• xs:decimal

• xs:dateTime

• xs:time

• xs:date

• xs:anyURI

• xs:Name

• xs:int

• osd:html

• osd:email

• osd:password

• osd:locale

• osd:text