Filtrage par propriété d'inclusion

Vous pouvez indiquer qu'un noeud sera inclus dans un abonnement ou exclu en configurant une propriété d'inclusion sur le noeud.

Par exemple, vous pouvez utiliser cette propriété d'inclusion pour ajouter un noeud dans un point de vue source sans l'ajouter immédiatement aux points de vue cible. Ensuite, lorsque vous êtes prêt à ajouter le noeud aux points de vue cible, vous pouvez modifier la valeur de la propriété d'inclusion dans le point de vue source pour générer les actions de demande d'abonnement afin d'ajouter ce noeud aux points de vue cible d'abonnement.

Une propriété d'inclusion est une propriété de type de données Booléen ou Liste qui détermine si un noeud dans un point de vue source est envoyé au point de vue cible dans le cadre d'un abonnement.

• Si la propriété d'inclusion est un type de données Booléen, le noeud est ajouté aux points de vue cible lorsque la valeur de Booléen est True et enlevé des points de vue cible lorsque la valeur est False. Généralement, vous utilisez une propriété d'inclusion de type Booléen lorsqu'il existe un seul point de vue cible d'abonnement et que vous voulez indiquer si un noeud doit être inclus ou non dans cet abonnement.
• Si la propriété d'inclusion est un type de données Liste, vous devez indiquer la valeur d'inclusion (soit en saisissant la valeur, soit en la sélectionnant dans la liste des valeurs autorisées). Utilisez une propriété de type de données Liste lorsque vous avez plusieurs points de vue cible d'abonnement et que vous voulez indiquer ceux pour lesquels le noeud doit être inclus dans les abonnements.

Lorsque la propriété d'inclusion est définie dans le point de vue source de sorte à inclure le noeud (c'est-à-dire qu'elle a une valeur True pour Booléen ou contient la valeur d'inclusion pour une liste), les actions de demande relatives au noeud sont générées pour le point de vue cible par l'abonnement. Si le noeud n'existe pas déjà dans le point de vue cible, il est ajouté ou inséré.

Lorsque la propriété d'inclusion est définie dans le point de vue source de sorte à exclure un noeud (c'est-à-dire qu'elle a une valeur False pour Booléen ou ne contient pas la valeur d'inclusion pour une liste), le noeud est enlevé ou supprimé s'il existe dans le point de vue cible. S'il n'existe pas, aucune action de demande n'est générée pour le noeud exclu.

Remarques

• Vous pouvez configurer un filtre de propriété d'inclusion en utilisant une propriété de type de données Booléen ou Liste de n'importe quel type de noeud dans le point de vue source.

  Note:

  Vous pouvez configurer une propriété existante en tant que propriété d'inclusion ou créer une propriété à utiliser en tant que propriété d'inclusion pour cet abonnement. Reportez-vous à la section Création manuelle de propriétés.
• La propriété d'inclusion peut avoir le type par défaut Aucun ou Spécifié. Le type par défaut Spécifié peut être utile dans les scénarios suivants :
  • Par défaut, vous voulez inclure tous les noeuds dans un abonnement et vous indiquerez explicitement ceux à ne pas inclure. Vous pouvez définir la valeur par défaut de sorte à inclure le noeud (a une valeur True pour Booléen ou contient la valeur d'inclusion pour une liste), puis modifier la propriété uniquement pour les noeuds à exclure.
  • Par défaut, vous voulez exclure tous les noeuds dans un abonnement et vous indiquerez explicitement ceux à inclure. Vous pouvez définir la valeur par défaut de sorte à exclure le noeud (a une valeur False pour Booléen ou ne contient pas la valeur d'inclusion pour une liste), puis modifier la propriété uniquement pour les noeuds à inclure.

  Si le type par défaut est Aucun, vous devrez indiquer la valeur de la propriété d'inclusion pour chaque noeud.

• Le type par défaut ne peut pas être Dérivé ni Hérité. Après avoir désigné une propriété en tant que propriété d'inclusion, vous ne pouvez pas modifier le type par défaut de cette propriété pour qu'il soit dérivé ou hérité.

• Les filtres d'expression de noeud, de noeud supérieur et d'action sont appliqués aux actions de demande générées. Par exemple, si la propriété d'inclusion sur un noeud est définie pour une inclusion mais que le noeud se trouve sous un noeud supérieur qui a été filtré hors de l'abonnement, les actions de demande ne sont pas générées pour ce noeud.

• Certaines actions de demande dans le point de vue source sont converties en actions équivalentes dans le point de vue cible :

  • Si vous modifiez la valeur d'inclusion dans le point de vue source de sorte à passer de False à True (ou à contenir la valeur d'inclusion, pour une liste), le noeud est ajouté (ou inséré, dans un ensemble de hiérarchies) dans le point de vue source s'il n'existe pas déjà.

  • Si vous modifiez la valeur d'inclusion dans le point de vue source de sorte à passer de True à False (ou à ne pas contenir la valeur d'inclusion, pour une liste), le noeud est supprimé (ou enlevé, dans un ensemble de hiérarchies) s'il existe dans le point de vue cible.

  • Si vous ne modifiez pas la valeur d'inclusion dans le point de vue source, les actions de demande effectuées dans celui-ci sont propagées vers le point de vue cible si la propriété d'inclusion est définie sur True (ou définie de sorte à contenir la valeur d'inclusion, pour une liste).

• Pour les noeuds partagés lorsque le point de vue cible est une hiérarchie, tenez compte des points suivants :
  • Si la propriété d'inclusion est mise à jour pour inclure ou exclure un noeud dans le point de vue source, les actions de demande sont générées pour toutes les instances du noeud.
  • Si la propriété d'inclusion n'est pas mise à jour et que le noeud est défini pour être inclus, les actions de demande sont générées uniquement pour les instances où l'action a été effectuée.
  • Si la propriété d'inclusion n'est pas mise à jour et que le noeud est défini pour être exclu, les actions de demande ne sont pas générées pour les instances du noeud.

  Par exemple, supposons que vous disposiez d'un noeud partagé sous les parents A, B et C dans le point de vue source.

  • Si vous mettez à jour la propriété d'inclusion de sorte à inclure un noeud sous le parent A dans le point de vue source, des actions de demande sont générées pour ajouter le noeud sous le parent A et pour l'insérer sous les parents B et C dans le point de vue cible. De même, si vous mettez à jour la propriété d'inclusion de sorte à exclure un noeud sous le parent A dans le point de vue source, des actions de demande sont générées pour supprimer le noeud sous le parent A et pour l'enlever des parents B et C dans le point de vue cible.
  • Si vous ne mettez pas à jour la propriété d'inclusion et que le noeud est défini de sorte à être inclus, les actions de demande sont générées uniquement pour les instances du noeud où vous avez effectué l'action. Ainsi, si vous avez modifié une propriété pour le noeud sous le parent B dans le point de vue source, une action de demande est générée afin de modifier cette propriété uniquement pour le noeud sous le parent B dans le point de vue cible.
  • Si vous ne mettez pas à jour la propriété d'inclusion et que le noeud est défini de sorte à être exlcu, les actions de demande ne sont pas générées pour les noeuds, quelle que soit l'instance dans le point de vue source sur laquelle vous effectuez l'action.