Filtrado por propiedad de inclusión

Puede especificar que se vaya a incluir un nodo en una suscripción o que se excluya de esta mediante la configuración de una propiedad de inclusión en el nodo.

Puede usar esta propiedad de inclusión para, por ejemplo, agregar un nodo en un punto de vista de origen sin agregarlo de forma inmediata a los puntos de vista de destino. A continuación, cuanto esté listo para agregar el nodo a los puntos de vista de destino, puede cambiar el valor de la propiedad de inclusión en el punto de vista de origen para generar las acciones de solicitud de suscripción y agregar ese nodo a cualquier punto de vista de destino de suscripción.

Note:

La propiedad de inclusión debe ser una propiedad de nivel de nodo.

Una propiedad de inclusión es una propiedad de tipo de datos Booleano o Lista que controla si un nodo de un punto de vista de origen se envía al punto de vista de destino como parte de una suscripción.

Si la propiedad de inclusión es un tipo de datos Booleano, el nodo se agrega a los puntos de vista de destino cuando el valor de Booleano sea True, mientras que se elimina de los puntos de vista de destino cuando el valor sea False. Normalmente, se usa una propiedad de inclusión Booleana cuando hay un solo punto de vista de destino de suscripción y se desea especificar si se va a incluir o no un nodo en esa suscripción.
Si la propiedad de inclusión es un tipo de datos Lista, debe especificar el valor de inclusión (introduciendo el valor o seleccionando el valor en una lista Valores permitidos). Utilice una propiedad de tipo de datos Lista cuando tenga varios puntos de vista de destino de suscripción y desee especificar en qué puntos de vista de destino se debe incluir el nodo en las suscripciones.

Cuando la propiedad de inclusión se establece en el punto de vista de origen para incluir el nodo (es decir, tiene un valor True para Booleano o contiene el valor de inclusión para una lista), la suscripción genera acciones de solicitud para el nodo para el punto de vista de destino. Si aún no existe el nodo en el punto de vista de destino, se agrega o inserta.

Cuando la propiedad de inclusión se establece en el punto de vista de origen para excluir un nodo (es decir, tiene un valorFalse para Booleano o no contiene el valor de inclusión para una lista), el nodo se elimina o suprime si existe en el punto de vista de destino. Si no existe, no se generan acciones de solicitud para el nodo excluido.

Mejores prácticas

Si desea conservar los valores de propiedad y las relaciones de hijo para los nodos que esté excluyendo del punto de vista de destino, recomendamos eliminar la acción Suprimir del filtro Acciones incluidas en la suscripción para que el nodo solo se elimine. Consulte Filtrado por acciones.

Consideraciones

Puede configurar un filtro de propiedad de inclusión con cualquier propiedad de tipo de datos Booleano o Lista de cualquier tipo de nodo en el punto de vista de origen.

Note:
Puede configurar una propiedad existente como propiedad de inclusión, o bien puede crear una nueva propiedad para usarla como propiedad de inclusión para esta suscripción. Consulte Creación manual de propiedades.
La propiedad de inclusión puede tener un tipo predeterminado None o Specified. El tipo predeterminado Specified puede ser útil en estos escenarios:
- De forma predeterminada, desea incluir todos los nodos en una suscripción. Además, va a especificar explícitamente los nodos que no desea incluir. Puede establecer el valor predeterminado para incluir el nodo (tiene un valor True para Booleano o contiene el valor de inclusión para una lista) y, a continuación, cambiar la propiedad solo para los nodos que desee excluir.
- De forma predeterminada, desea excluir todos los nodos en una suscripción. Además, va a especificar explícitamente los nodos que desea incluir. Puede establecer el valor predeterminado para excluir el nodo (tiene un valor False para Booleano o no contiene el valor de inclusión para una lista) y, a continuación, cambiar la propiedad solo para los nodos que desee incluir.
Si tiene un tipo predeterminado None, tendrá que especificar el valor de propiedad de inclusión para cada uno de los nodos.
El tipo predeterminado no puede ser Derived ni Inherited. Después de designar una propiedad como propiedad de inclusión, no puede cambiar el tipo predeterminado de esa propiedad a Derived ni Inherited.
La expresión de nodo, el nodo superior y los filtros de acción se aplican a las acciones de solicitud generadas. Por ejemplo, si la propiedad de inclusión de un nodo se establece para incluir, pero el nodo se encuentra bajo un nodo superior que se ha eliminado de la suscripción, no se generan acciones de solicitud para ese nodo.
Algunas acciones de solicitud del punto de vista de origen se han traducido en acciones equivalentes en el punto de vista de destino:
- Si modifica el valor de inclusión en el punto de vista de origen de False a True (o para que contenga el valor de inclusión, para una lista), el nodo se agrega (o inserta, en un conjunto de jerarquías) en el punto de vista de destino si aún no existe.
- Si modifica el valor de inclusión en el punto de vista de origen de True a False (o para que no contenga el valor de inclusión, para una lista), el nodo se suprime (o elimina, en un conjunto de jerarquías) si existe en el punto de vista de destino.
- Si no modifica el valor de inclusión en el punto de vista de origen, las acciones de solicitud que realice en el punto de vista de origen se propagan al punto de vista de destino si la propiedad de inclusión se establece en True (o para contener el valor de inclusión, para una lista).
En el caso de nodos compartidos cuando el punto de vista de destino sea una jerarquía:
- Si la propiedad de inclusión se actualiza para incluir o excluir un nodo en el punto de vista de origen, se generan acciones de solicitud para todas las instancias del nodo.
- Si la propiedad de inclusión no está actualizada y el nodo se establece para incluirse, solo se generan acciones de solicitud para las instancias en las que se haya realizado la acción.
- Si la propiedad de inclusión no está actualizada y el nodo se establece para excluirse, no se generan acciones de solicitud para cualquier instancia del nodo.
Por ejemplo, suponga que tiene un nodo compartido bajo los padres A, B y C en el punto de vista de origen.
- Si actualiza la propiedad de inclusión para que incluya un nodo bajo el padre A en el punto de vista de origen, se generan acciones de solicitud para agregar el nodo bajo el padre A e insertar el nodo bajo los padres B y C en el punto de vista de destino. De la misma forma, si actualiza la propiedad de inclusión para que excluya un nodo bajo el padre A en el punto de vista de origen, se generan acciones de solicitud para suprimir el nodo bajo el padre A y eliminarlo de los padres B y C en el punto de vista de destino.
- Si no actualiza la propiedad de inclusión y el nodo se establece para incluirse, solo se generan acciones de solicitud para la instancia del nodo en la que se haya realizado la acción. Por tanto, si ha editado una propiedad para el nodo bajo el padre B en el punto de vista de origen, se genera una acción de solicitud para modificar esa propiedad solo para el nodo situado bajo el padre B en el punto de vista de destino.
- Si no actualiza la propiedad de inclusión y el nodo se establece para excluirse, no se generan acciones de solicitud para los nodos, con independencia de la instancia del punto de vista de origen en la que se haya realizado una acción.

Tip:

Cuando tenga varios puntos de vista de suscripción, puede usar una propiedad de inclusión de tipo de datos Lista si solo hay un usuario, como un administrador del servicio, que determinará qué puntos de vista recibirán qué nodos. Si hay distintos usuarios, donde cada uno determina si se envía o no una propiedad al punto de vista que administre, puede configurar varias propiedades de tipo de datos Booleano y usar el acceso a los datos de nivel de propiedad para controlar qué usuarios pueden ver o editar la propiedad Booleana para su punto de vista.

Por ejemplo, puede configurar el acceso a los datos para que solo el administrador de Planning pueda editar la propiedad "Include in Planning?", y solo el administrador de Consolidation pueda editar la propiedad "Include in Consol?" en el punto de vista de origen. Consulte Ejemplo de propiedad de inclusión de tipo de datos Booleano en Ejemplos de propiedad de inclusión.

Note:

Si ya está usando una condición de nodo para extraer los nodos de las suscripciones según el valor de una propiedad de nivel de nodo de tipo de datos Booleano o Lista (consulte Definición de condiciones de nodo), debería reemplazar el filtro de condición de nodo por un filtro de propiedad de inclusión.

Si está usando un filtro de condición de nodo en una propiedad de nivel de relación, debería mantener el filtro de condición de nodo existente porque no puede crear un filtro de propiedad de inclusión en una propiedad de nivel de relación.

Configuración de la propiedad de inclusión

Inspeccione el punto de vista que contenga la suscripción para la que desea configurar la propiedad de inclusión y haga clic en el separador Suscripciones.
Cree una nueva suscripción o edite una existente. Consulte Suscripción a puntos de vista.
En el separador Filtros, haga clic en Editar.
En el menú desplegable Propiedad de inclusión, seleccione una propiedad para configurarla como propiedad de inclusión. Solo se pueden seleccionar las propiedades de nodo con el tipo de datos Booleano o Lista.
Si la propiedad que ha seleccionado tiene el tipo de datos Lista, en Valor de inclusión, introduzca un valor de inclusión (o seleccione el valor si la propiedad usa Valores permitidos).

Note:
Si la propiedad tiene reemplazos de aplicación o tipo de nodo para Valores permitidos, se podrán seleccionar todos los valores permitidos de todos los reemplazos como valores de inclusión.
Haga clic en Guardar.