包含プロパティによるフィルタリング

ノードで包含プロパティを構成することにより、ノードをサブスクリプションに含めるか、サブスクリプションから除外するかを指定できます。

この包含プロパティを使用すると、たとえば、ターゲット・ビューポイントにノードをただちに追加せずに、ソース・ビューポイントのノードを追加できます。次に、ターゲット・ビューポイントにノードを追加する準備ができたら、ソース・ビューポイントの包含プロパティ値を変更して、サブスクライブしているターゲット・ビューポイントにそのノードを追加するサブスクリプション要求アクションを生成できます。

包含プロパティは、サブスクリプションの一環としてソース・ビューポイントのノードをターゲット・ビューポイントに送信するかどうかを制御するブールまたはリストのデータ型プロパティです。

• 包含プロパティがブール・データ型の場合は、ブール値がTrueのときにノードがターゲット・ビューポイントに追加され、値がFalseのときにターゲット・ビューポイントから除去されます。通常、サブスクライブしている単一のターゲット・ビューポイントがあり、そのサブスクリプションにノードを含めるかどうかを指定する場合は、ブール包含プロパティを使用します。
• 包含プロパティがリスト・データ型の場合は、値を入力するか、または「許容値」リストから値を選択して、包含値を指定する必要があります。サブスクライブしている複数のターゲット・ビューポイントがあり、ノードをサブスクリプションに含める必要があるターゲット・ビューポイントを指定する場合は、リスト・データ型プロパティを使用します。

ノードを含めるように包含プロパティがソース・ビューポイントに設定されている場合は(つまり、ブールの値がTrueであるか、またはリストの包含値が含まれている場合)、サブスクリプションによってターゲット・ビューポイントに対してノードの要求アクションが生成されます。ノードがターゲット・ビューポイントにすでに存在しない場合は、追加または挿入されます。

ノードを除外するように包含プロパティがソース・ビューポイントに設定されている場合(つまり、ブールの値がFalseであるか、またはリストの包含値が含まれていない場合)、ターゲット・ビューポイントにノードが存在すると、そのノードは除去または削除されます。存在しない場合、除外されたノードに対する要求アクションは生成されません。

考慮事項

• ソース・ビューポイントのノード・タイプからブールまたはリストのデータ型プロパティを使用して、包含プロパティ・フィルタを構成できます。

  Note:

  既存のプロパティを包含プロパティとして構成したり、新規プロパティを作成してこのサブスクリプションの包含プロパティとして使用できます。プロパティの手動での作成を参照してください。
• 包含プロパティには、「なし」または「指定済」のデフォルト・タイプを設定できます。次のシナリオでは、「指定済」デフォルト・タイプが役立ちます:
  • デフォルトで、サブスクリプションのすべてのノードを含め、含めないノードを明示的に指定します。ノードを含めるようにデフォルト値を設定して(ブールの値がTrueであるか、またはリストの包含値を含める)、除外するノードのプロパティのみを変更できます。
  • デフォルトで、サブスクリプションのすべてのノードを除外し、含めるノードを明示的に指定します。ノードを除外するようにデフォルト値を設定して(ブールの値がFalseであるか、またはリストの包含値を含めない)、含めるノードのプロパティのみを変更できます。

  デフォルト・タイプが「なし」の場合は、すべてのノードの包含プロパティ値を指定する必要があります。

• 「派生」または「継承」はデフォルト・タイプにできません。プロパティを包含プロパティとして指定した後は、そのプロパティのデフォルト・タイプを「派生」または「継承」のいずれかに変更できません。

• ノード式、最上位ノードおよびアクション・フィルタは、生成された要求アクションに適用されます。たとえば、ノードの包含プロパティは含めるように設定されているが、そのノードがサブスクリプションからフィルタリングで除外された最上位ノードの下にある場合、そのノードに対して要求アクションは生成されません。

• ソース・ビューポイントの要求アクションの中には、ターゲット・ビューポイント内の同等のアクションに変換されるものがあります。

  • ソース・ビューポイントの包含値をFalseからTrueに変更する場合(またはリストの包含値を含める場合)、ノードがまだ存在しないと、そのノードはターゲット・ビューポイントに追加(または階層セットに挿入)されます。

  • ソース・ビューポイントの包含値をTrueからFalseに変更する場合(またはリストの包含値を含めない場合)、ノードがターゲット・ビューポイントに存在すると、そのノードは削除(または階層セットから除去)されます。

  • ソース・ビューポイントの包含値を変更しない場合、包含プロパティがTrueに設定されていると(またはリストの包含値を含めると)、ソース・ビューポイントで実行する要求アクションはターゲット・ビューポイントに伝播されます。

• 共有ノードの場合(ターゲット・ビューポイントが階層のとき):
  • ソース・ビューポイントのノードを含めるまたは除外するように包含プロパティが更新された場合は、ノードのすべてのインスタンスに対して要求アクションが生成されます。
  • 包含プロパティが更新されず、ノードを含めるように設定された場合は、アクションが実行されたインスタンスに対してのみ要求アクションが生成されます。
  • 包含プロパティが更新されず、ノードを除外するように設定された場合、ノードのすべてのインスタンスに対して要求アクションは生成されません。

  たとえば、ソース・ビューポイントの親A、BおよびCの下に共有ノードがあるとします。

  • ソース・ビューポイントの親Aの下にノードを含めるように包含プロパティを更新する場合は、親Aの下にノードを追加し、ターゲット・ビューポイントの親BおよびCの下にノードを挿入するための要求アクションが生成されます。同様に、ソース・ビューポイントの親Aの下からノードを除外するように包含プロパティを更新する場合は、親Aの下からノードを削除し、ターゲット・ビューポイントの親BおよびCからノードを除去するための要求アクションが生成されます。
  • 包含プロパティを更新せず、ノードを含めるように設定された場合は、アクションを実行したノードのインスタンスに対してのみ要求アクションが生成されます。したがって、ソース・ビューポイントの親Bの下にあるノードのプロパティを編集した場合は、ターゲット・ビューポイントの親Bの下にあるノードの当該プロパティのみを変更するための要求アクションが生成されます。
  • 包含プロパティを更新せず、ノードを除外するように設定された場合、アクションを実行したソース・ビューポイントのインスタンスに関係なく、要求アクションは生成されません。