エレメントのデータ検証コントロール

最終公開日 : Sep 16, 2026
エレメントを最初に作成した後、その定義を完了するために追加のコントロールを設定できます。
以下も参照してください。:

単純なコンテンツ検証

フィールドで次の静的コントロールを使用すると、そのコンテンツに単純な検証ルールを確立できます。特定のフィールドで使用できるコントロールは、そのデータ型によって異なります。
固定長
このフィールドに必要な正確な文字数。
最小の長さ
このフィールドに許可される最小文字数。
最大長
このフィールドに許可される最大文字数。
パターン
フィールドの値が一致する必要がある正規表現パターン。フィールドとそのデータ型の両方のパターンを同時に定義することはできません。
小数点以下の桁数
このフィールドに許可される小数点以下の最大桁数。
最大桁数
この整数または 10 進フィールドに許可される最大合計桁数。
列挙型
このフィールドに事前定義された可能な値のリストを定義します。列挙型がフィールドとそのタイプの両方で定義されている場合、関連するデータセット内のこのフィールドの列挙型は、これら2つの列挙型の共通部分に置き換えられます。
より大きい [定数]
このフィールドに許可される最小値を定義します。
より小さい [定数]
このフィールドに許可される最大値を定義します。

高度なコンテンツ検証

エレメントに対して次の動的およびコンテキストコントロールを使用して、そのコンテンツの高度な検証ルールを確立できます。特定のエレメントで使用できるコントロールは、エレメントのタイプとそのデータ型 (存在する場合) によって異なります。
以下も参照してください。:
外部キー制約
       テーブル
外部キーによって参照されるテーブルを定義します。外部キーは、デフォルトで同じデータセット内のテーブルを参照します。また、同じデータスペース内の別のデータセット内のテーブル、または別のデータセット内のデータセットを参照することもできます。
              モード
外部キーによって参照されるテーブルの場所。
「デフォルト」:現在のデータモデル。
「その他のデータセット」:同じデータスペース内の異なるデータセット。
「その他のデータスペース」:別のデータスペースのデータセット。
              参照テーブル
テーブルのを場所記述する XPath 式。たとえば、/root/MyTable です。
              参照データセット
テーブルが別のデータセットにある場合は必須です。参照されるテーブルを含むデータセットの一意の名前。
              参照データスペース
テーブルが別のデータスペースにある場合は必須です。参照されるテーブルを含むデータスペースの一意の名前。
       ラベル
テーブル内のレコードのデフォルトおよびローカライズされたラベルを提供するフィールドを定義します。階層リンクで指定されたラベルの表示をカスタマイズすることもできます。
[XPath 式] が [いいえ] に設定されている場合、プログラムでラベルを設定する Java クラスを指定することもできます。この Java クラスは、JavaAPI の TableRefDisplay インターフェイスを実装する必要があります。
注意:レコードラベルを表示する場合、関連するデータセットで定義されたアクセス権限は適用されません。アクセス権限の制限のために通常非表示になっているフィールドは、ラベルに表示されます。
       フィルター
XPath 式を使用して外部キーフィルターを定義します。
JavaAPI の TableRefFilter インターフェイスを実装する Java クラスを指定することもできます。
より大きい [動的]
このフィールドに許可される最小値を提供するフィールドを定義します。
より小さい [動的]
このフィールドに許可される最大値を提供するフィールドを定義します。
固定長 [動的]
このフィールドに必要な正確な文字数を提供するフィールドを定義します。
最小の長さ [動的]
このフィールドに許可される最小文字数を提供するフィールドを定義します。
最大長 [動的]
このフィールドに許可される最大文字数を提供するフィールドを定義します。
除外された値
このフィールドで許可されていない値のリストを定義します。
除外されたセグメント
このフィールドで許可されていない値の包括的範囲を定義します。
最小除外値:このフィールドに許可されていない最小値。
最大除外値:このフィールドに許可されていない最大値。
特定の制約 (コンポーネント)
Java API の Constraint インターフェイスを実装する 1 つ以上の Java クラスを指定します。詳細については、プログラムによる制約 を参照してください。
特定の列挙 (コンポーネント)
列挙を定義する Java クラスを指定します。クラスは、Java API の ConstraintEnumeration インターフェイスを実装して、順序付けられた値のリストを定義する必要があります。
別のノードより入力される列挙型
別のリストまたは列挙型エレメントへの参照を使用して、この列挙型の可能な値を定義します。
データスペースセットの構成
タイプデータスペース識別子 (osd:dataspaceKey) のフィールドで参照できるデータスペースを定義します。構成が設定されていない場合、デフォルトでは、開いているブランチのみをこのフィールドで参照できます。
  • 包含
    このフィールドで参照できるデータスペースを指定します。
    パターン:データスペースをフィルタリングするパターンを指定します。パターンは、データスペースの名前と照合されます。
    タイプ:このフィールドで参照できるデータスペースのタイプを指定します。定義されていない場合、この制限はブランチに適用されます。
    子孫を含める:指定されたパターンに一致するデータスペースの子または子孫をセットに含めるかどうかを指定します。定義されていない場合、この制限は子データスペースには適用されません。[なし] の場合、指定されたパターンに一致するデータスペースの子も子孫も含まれません。[すべての子孫] の場合、指定されたパターンに一致するデータスペースのすべての子孫が含まれます。[すべての子孫ブランチ] の場合、指定されたパターンに一致するデータスペースのすべての子孫ブランチが含まれます。[すべての子孫スナップショット] の場合、指定されたパターンに一致するデータスペースのすべての子孫スナップショットが含まれます。[子ブランチ] の場合、指定されたパターンに一致するデータスペースの直接ブランチのみが含まれます。現在のデータスペースがバージョンの場合、このバージョンの直接の子であるブランチが含まれます。現在のデータスペースがブランチの場合、このブランチの子であるバージョンの直接の子であるブランチが含まれます。[子スナップショット] の場合、指定されたパターンに一致するデータスペースの直接スナップショットのみが含まれます。現在のデータスペースがブランチの場合、このブランチの直接の子であるスナップショットが含まれます。現在のデータスペースがバージョンの場合、このバージョンの子であるブランチの直接の子であるバージョンが含まれます。
  • 除外
    このフィールドで参照できないデータスペースを指定します。包含が定義されていない場合、除外は無視されます。
    パターン:データスペースをフィルタリングするパターンを指定します。パターンは、データスペースの名前と照合されます。
    タイプ:このフィールドで参照できるデータスペースのタイプを指定します。定義されていない場合、この制限はブランチに適用されます。
    子孫を含める:指定されたパターンに一致するデータスペースの子または子孫をセットに含めるかどうかを指定します。定義されていない場合、この制限は子データスペースには適用されません。[なし] の場合、指定されたパターンに一致するデータスペースの子も子孫も含まれません。[すべての子孫] の場合、指定されたパターンに一致するデータスペースのすべての子孫が含まれます。[すべての子孫ブランチ] の場合、指定されたパターンに一致するデータスペースのすべての子孫ブランチが含まれます。[すべての子孫スナップショット] の場合、指定されたパターンに一致するデータスペースのすべての子孫スナップショットが含まれます。[子ブランチ] の場合、指定されたパターンに一致するデータスペースの直接ブランチのみが含まれます。現在のデータスペースがバージョンの場合、このバージョンの直接の子であるブランチが含まれます。現在のデータスペースがブランチの場合、このブランチの子であるバージョンの直接の子であるブランチが含まれます。[子スナップショット] の場合、指定されたパターンに一致するデータスペースの直接スナップショットのみが含まれます。現在のデータスペースがブランチの場合、このブランチの直接の子であるスナップショットが含まれます。現在のデータスペースがバージョンの場合、このバージョンの子であるブランチの直接の子であるバージョンが含まれます。
  • データスペースフィルター
    データセットまたはレコードのコンテキストでデータスペースを受け入れるか拒否するかを指定するフィルターを指定します。このフィルターは、このフィールドに関連付けられている専用の入力コンポーネントでのみ使用されます。つまり、このフィルターは、このフィールドを検証するときには使用されません。特定の制約を使用して、このフィールドで特定の制御を実行できます。フィルターは、Java API の DataspaceSetFilter インターフェイスを実装する Java クラスによって定義されます。
データセットセットの構成
データセット識別子 (osd:datasetName) タイプのフィールドで参照できるデータセットを定義します。
  • 包含
    このフィールドで参照できるデータセットを指定します。
    パターン:データセットをフィルタリングするパターンを指定します。パターンは、データセットの名前と照合されます。
    子孫を含める:指定されたパターンに一致するデータセットの子または子孫をセットに含めるかどうかを指定します。
  • 除外
    このフィールドで参照できないデータセットを指定します。包含が定義されていない場合、除外は無視されます。
    パターン:データセットをフィルタリングするパターンを指定します。パターンは、データセットの名前と照合されます。
    子孫を含める:指定されたパターンに一致するデータセットの子または子孫をセットに含めるかどうかを指定します。
  • フィルター
    データセットまたはレコードのコンテキストでデータセットを受け入れるか拒否するかを指定するフィルターを指定します。このフィルターは、このフィールドに関連付けられている専用の入力コンポーネントでのみ使用されます。つまり、このフィルターはこのフィールドを検証するときには使用されません。特定の制約を使用して、このフィールドで特定のコントロールを実行できます。フィルターは、Java API の DatasetSetFilter インターフェイスを実装する Java クラスによって定義されます。

検証プロパティ

特定の Java クラスを使用しない各制約は、次のプロパティを使用して、重大度のあるローカライズされた検証メッセージを定義できます。
検証
ユーザー定義の重大度レベルでローカライズされた検証メッセージを定義します。
       重大度
検証メッセージの重大度レベルを定義します。可能な値は、[エラー]、[警告]、[情報] です。
              エラー管理ポリシー
検証エラーが発生したときの制約の動作を指定します。操作 (データセットの更新、レコードの作成、更新または削除) の後、またはユーザーがフォームを送信したときに、制約が常に有効である必要があることを指定できます。この場合、制約に違反する入力または操作は拒否され、値は変更されません。指定しない場合、制約は、デフォルトですべての操作でエラーが防止されるリレーショナルデータモデルの外部キー制約を除いて、デフォルトでフォーム送信時にエラーをブロックするだけです。このオプションは、静的制御、値の除外、セグメントおよび外部キーの制約の除外でのみ使用できます。外部キー制約では、エラー管理ポリシーはフィルターに関係しません。つまり、参照レコードが存在するが外部キーフィルタを満たさない場合、外部キー制約はブロックされません。この場合、更新は拒否されず、検証エラーが発生します。テーブル履歴またはレプリケーションがアクティブ化されている場合、リレーショナルデータモデルで定義されている構造上の制約にエラー管理ポリシーを指定することはできません。つまり、このプロパティを固定長、最大長、最大桁数、および小数点以下の桁数の制約に設定すると、基になる RDBMS ブロッキング制約検証ポリシーのために、データモデルのコンパイル時にエラーが発生します。アーカイブをインポートする場合、このプロパティは無効です。つまり、アーカイブをインポートするときは、構造上の制約を除くすべてのブロック制約が常に無効になります。
       メッセージ
データセット内のこのフィールドの値がこの制約に準拠していない場合に表示するメッセージを定義します。カスタムメッセージを指定する場合は、オプションでローカライズされたバリアントを提供できます。
関連する概念:
ユーザーガイド 目次