Filtragem por Propriedade de Inclusão

Você pode especificar que um nó será incluído ou excluído de uma assinatura configurando uma propriedade de inclusão no nó.

É possível usar essa propriedade de inclusão para, por exemplo, adicionar um nó em um ponto de vista de origem sem adicioná-lo imediatamente aos pontos de vista de destino. Em seguida, quando estiver pronto para adicionar o nó aos pontos de vista de destino, você poderá alterar o valor da propriedade de inclusão no ponto de vista de origem para gerar as ações de solicitação de assinatura a fim de adicionar esse nó a qualquer ponto de vista de destino em assinatura.

Note:

A propriedade de inclusão deve ser uma propriedade no nível de nó.

Uma propriedade de inclusão é uma propriedade do tipo de dados Booliano ou Lista que controla se um nó em um ponto de vista de origem é enviado para o ponto de vista de destino como parte de uma assinatura.

Se a propriedade de inclusão for um tipo de dados Booliano, o nó será adicionado aos pontos de vista de destino quando o valor de Booliano for True, e removido dos pontos de vista de destino quando o valor for False. Normalmente, você usa uma propriedade de inclusão Booliano quando há um único ponto de vista de destino de assinatura e deseja especificar se inclui ou não um nó nessa assinatura.
Se a propriedade de inclusão for um tipo de dados Lista, será preciso especificar o valor da inclusão (ou inserindo o valor, ou selecionando o valor em uma lista de Valores Permitidos). Use uma propriedade de tipo de dados Lista quando houver vários pontos de vista de destino de assinatura e você desejar especificar para quais pontos de vista de destino o nó deverá ser incluído nas assinaturas.

Quando a propriedade de inclusão estiver definida no ponto de vista de origem para incluir o nó (isto é, tiver um valor de True para Booliano ou contiver o valor de inclusão para uma lista), serão geradas pela assinatura ações de solicitação para o nó do ponto de vista de destino. Se o nó ainda não existir no ponto de vista de destino, ele será adicionado ou inserido.

Quando a propriedade de inclusão estiver definida no ponto de vista de origem para excluir um nó (isto é, tiver um valor de False para Booliano ou não contiver o valor de inclusão para uma lista), o nó será removido ou excluído se ele existir no ponto de vista de destino. Se ele não existir, nenhuma ação de solicitação será gerada para o nó excluído.

Melhor Prática

Se desejar reter os valores de propriedade e os relacionamentos filho para nós que você está excluindo do ponto de vista de destino, é uma boa prática remover a ação Excluir do filtro Ações Incluídas na assinatura para que o nó seja apenas removido. Consulte Filtragem por ações.

Considerações

É possível configurar um filtro de propriedade de inclusão usando qualquer propriedade de tipo de dados Booliano ou Lista de qualquer tipo de nó no ambiente de origem.

Note:
Você pode configurar uma propriedade existente como uma propriedade de inclusão ou criar uma propriedade para usar como a propriedade de inclusão para essa assinatura. Consulte Criação Manual de Propriedades.
A propriedade de inclusão pode ter um Tipo Padrão de None ou Specified. O tipo padrão Specified pode ser útil nestes cenários:
- Por padrão, é conveniente incluir todos os nós em uma assinatura e, explicitamente, especificar quais nós não deseja incluir. É possível definir o valor padrão para incluir o nó (tem um valor de True para Booliano ou contém o valor de inclusão para uma lista) e, em seguida, alterar apenas a propriedade para os nós que deseja excluir.
- Por padrão, é conveniente excluir todos os nós em uma assinatura e, explicitamente, especificar quais nós deseja incluir. Você pode definir o valor padrão para excluir o nó (tem um valor de False para Booliano ou não contém o valor de inclusão para uma lista) e, em seguida, alterar apenas a propriedade para os nós que deseja incluir.
Se o tipo padrão None estiver definido, você terá que especificar o valor da propriedade de inclusão para cada nó.
O Tipo Padrão não pode ser Derived nem Inherited. Após designação de uma propriedade como uma propriedade de inclusão, não será possível alterar o tipo padrão dessa propriedade para ser derived ou inherited.
Expressão do nó, nó superior e filtros de ação são aplicados às ações de solicitação geradas. Por exemplo, se a propriedade de inclusão em um nó for definida para inclusão, mas o nó estiver sob um nó superior que foi filtrado da assinatura, as ações de solicitação não serão geradas para esse nó.
Algumas ações de solicitação no ponto de vista de origem são convertidas em ações equivalentes no ponto de vista de destino:
- Se você modificar o valor de inclusão no ponto de vista de origem, de False para True (ou para conter o valor de inclusão, para uma lista), o nó será adicionado (ou inserido, em um conjunto de hierarquias) no ponto de vista de destino, caso ele ainda não exista.
- Se você modificar o valor de inclusão no ponto de vista de origem, de True para False (ou para não conter o valor de inclusão, para uma lista), o nó será excluído (ou removido, em um conjunto de hierarquias) caso ele exista no ponto de vista de destino.
- Se você não modificar o valor de inclusão no ponto de vista de origem, as ações de solicitação que são executadas no ponto de vista de origem serão propagadas para o ponto de vista de destino se a propriedade de inclusão for definida como True (ou para conter o valor de inclusão, para uma lista).
Para nós compartilhados, quando o ponto de vista de destino for uma hierarquia:
- Se a propriedade de inclusão for atualizada para incluir ou excluir um nó no ponto de vista de origem, as ações de solicitação serão geradas para todas as instâncias do nó.
- Se a propriedade de inclusão não for atualizada e o nó for definido para ser incluído, as ações de solicitação serão geradas apenas para as instâncias em que a ação foi realizada.
- Se a propriedade de inclusão não for atualizada e o nó for definido para ser excluído, as ações de solicitação não serão geradas para nenhuma instância do nó.
Por exemplo, suponha que você tenha um nó compartilhado sob os pais A, B e C no ponto de vista de origem.
- Se você atualizar a propriedade de inclusão para incluir um nó sob o pai A no ponto de vista de origem, as ações de solicitação serão geradas para adicionar o nó sob o pai A e inseri-lo sob os pais B e C no ponto de vista de destino. Da mesma forma, se você atualizar a propriedade de inclusão para excluir um nó sob o pai A no ponto de vista de origem, as ações de solicitação serão geradas para excluir o nó sob o pai A e removê-lo dos pais B e C no ponto de vista de destino.
- Se você não atualizar a propriedade de inclusão e o nó for definido para ser incluído, as ações de solicitação serão geradas apenas para a instância do nó em que a ação foi executada. Portanto, se uma propriedade foi editada para o nó sob o pai B no ponto de vista de origem, uma ação de solicitação será gerada para modificar essa propriedade apenas para o nó sob o pai B no ponto de vista de destino.
- Se a propriedade de inclusão não for atualizada e o nó for definido para ser excluído, as ações de solicitação não serão geradas para os nós, não importa em qual instância no ponto de vista de origem uma ação foi executada.

Tip:

Quando existirem vários pontos de vista de assinatura, você poderá usar uma propriedade de inclusão do tipo de dados Lista, se houver apenas um usuário, como o Administrador de Serviço, que determinará quais pontos de vista receberão quais nós. Se houver usuários diferentes, e cada um deles determina se uma propriedade é enviada ou não ao ponto de vista que eles administram, você poderá configurar várias propriedades de inclusão do tipo de dados Booliano e usar o acesso de dados no nível de propriedade para controlar quais usuários podem exibir ou editar a propriedade Booliano para o respectivo ponto de vista.

Por exemplo, é possível configurar o acesso a dados para que apenas o administrador do Planning possa editar a propriedade "Include for Planning?" e apenas o administrador do Consolidation possa editar a propriedade "Include for Consolidation?" no ponto de vista de origem. Consulte Exemplo de Propriedade de Inclusão do Tipo de Dados Booliano em Exemplos de Propriedade de Inclusão.

Note:

Se já estiver usando uma condição de nó para filtrar nós das assinaturas com base no valor de uma propriedade no nível de nó do tipo de dados Booliano ou Lista (consulte Definição de Condições de Nó), você deverá substituir o filtro de condição de nó por um filtro de propriedade de inclusão.

Se estiver usando um filtro de condição de nó em uma propriedade no nível de relacionamento, você deverá manter o filtro de condição de nó existente, pois não é possível criar um filtro de propriedade de inclusão em uma propriedade no nível de relacionamento.

Configuração da Propriedade de Inclusão

Inspecione o ponto de vista que contém a assinatura para a qual deseja configurar a propriedade de inclusão e clique na guia Assinaturas.
Crie uma assinatura ou edite uma assinatura que já existe. Consulte Assinatura em Pontos de Vista.
Na guia Filtros, clique em Editar.
No menu suspenso Propriedade de Inclusão, selecione uma propriedade para configurar como a propriedade de inclusão. Apenas as propriedades de nó com o tipo de dados Booliano ou Lista estão disponíveis para seleção.
Se a propriedade que você selecionou tiver o tipo de dados Lista, em Valor de Inclusão, insira um valor de inclusão (ou selecione o valor se a propriedade usar Valores Permitidos).

Note:
Se a propriedade tiver substituições de tipo de nó ou aplicativo para Valores Permitidos, todos os valores permitidos de todas as substituições estarão disponíveis para serem selecionados como valores de inclusão.
Clique em Salvar.