ノードで包含プロパティを構成することにより、ノードをサブスクリプションに含めるか、サブスクリプションから除外するかを指定できます。
この包含プロパティを使用すると、たとえば、ターゲット・ビューポイントにノードをただちに追加せずに、ソース・ビューポイントのノードを追加できます。次に、ターゲット・ビューポイントにノードを追加する準備ができたら、ソース・ビューポイントの包含プロパティ値を変更して、サブスクライブしているターゲット・ビューポイントにそのノードを追加するサブスクリプション要求アクションを生成できます。
Note:
包含プロパティは、ノード・レベル・プロパティである必要があります。包含プロパティは、サブスクリプションの一環としてソース・ビューポイントのノードをターゲット・ビューポイントに送信するかどうかを制御するブールまたはリストのデータ型プロパティです。
ノードを含めるように包含プロパティがソース・ビューポイントに設定されている場合は(つまり、ブールの値がTrue
であるか、またはリストの包含値が含まれている場合)、サブスクリプションによってターゲット・ビューポイントに対してノードの要求アクションが生成されます。ノードがターゲット・ビューポイントにすでに存在しない場合は、追加または挿入されます。
ノードを除外するように包含プロパティがソース・ビューポイントに設定されている場合(つまり、ブールの値がFalse
であるか、またはリストの包含値が含まれていない場合)、ターゲット・ビューポイントにノードが存在すると、そのノードは除去または削除されます。存在しない場合、除外されたノードに対する要求アクションは生成されません。
ベスト・プラクティス
ターゲット・ビューポイントから除外するノードのプロパティ値および子関係を保持する場合は、サブスクリプションで「含まれるアクション」フィルタから「削除」アクションを除去して、ノードが除去されるのみにすることをお薦めします。アクションによるフィルタリングを参照してください。
考慮事項
Note:
既存のプロパティを包含プロパティとして構成したり、新規プロパティを作成してこのサブスクリプションの包含プロパティとして使用できます。プロパティの手動での作成を参照してください。「なし」
または「指定済」
のデフォルト・タイプを設定できます。次のシナリオでは、「指定済」デフォルト・タイプが役立ちます:
True
であるか、またはリストの包含値を含める)、除外するノードのプロパティのみを変更できます。False
であるか、またはリストの包含値を含めない)、含めるノードのプロパティのみを変更できます。デフォルト・タイプが「なし」
の場合は、すべてのノードの包含プロパティ値を指定する必要があります。
「派生」
または「継承」
はデフォルト・タイプにできません。プロパティを包含プロパティとして指定した後は、そのプロパティのデフォルト・タイプを「派生」または「継承」のいずれかに変更できません。
ソース・ビューポイントの要求アクションの中には、ターゲット・ビューポイント内の同等のアクションに変換されるものがあります。
ソース・ビューポイントの包含値をFalseからTrueに変更する場合(またはリストの包含値を含める場合)、ノードがまだ存在しないと、そのノードはターゲット・ビューポイントに追加(または階層セットに挿入)されます。
ソース・ビューポイントの包含値をTrueからFalseに変更する場合(またはリストの包含値を含めない場合)、ノードがターゲット・ビューポイントに存在すると、そのノードは削除(または階層セットから除去)されます。
ソース・ビューポイントの包含値を変更しない場合、包含プロパティがTrueに設定されていると(またはリストの包含値を含めると)、ソース・ビューポイントで実行する要求アクションはターゲット・ビューポイントに伝播されます。
たとえば、ソース・ビューポイントの親A、BおよびCの下に共有ノードがあるとします。
Tip:
サブスクライブしている複数のビューポイントがある場合、どのノードをどのビューポイントが受け取るかを判断するユーザーが1名のみ(サービス管理者など)のときは、リスト・データ型の包含プロパティを使用できます。複数の異なるユーザーが存在し、それぞれが管理するビューポイントにプロパティが送信されるかどうかを判断する場合は、複数のブール・データ型の包含プロパティを設定し、プロパティ・レベルのデータ・アクセスを使用して、ビューポイントのブール・プロパティを表示または編集できるユーザーを制御できます。
たとえば、Planning管理者のみが「Planningに含める?」プロパティを編集でき、連結管理者のみがソース・ビューポイントの「連結に含める?」プロパティを編集できるように、データ・アクセスを構成できます。包含プロパティの例のブール・データ型の包含プロパティの例を参照してください。
Note:
ブールまたはリストのデータ型のノード・レベル・プロパティの値に基づき、すでにノード条件を使用してサブスクリプションからノードをフィルタリングで除外している場合は(ノード条件の定義を参照)、ノード条件フィルタを包含プロパティ・フィルタに置換する必要があります。
関係レベル・プロパティに対してノード条件フィルタを使用している場合、関係レベル・プロパティに対して包含プロパティ・フィルタは作成できないため、既存のノード条件フィルタを保持する必要があります。
包含プロパティの構成
Note:
プロパティに許容値のアプリケーションまたはノード・タイプ・オーバーライドがある場合は、すべてのオーバーライドからすべての許容値を包含値として選択可能です。