Nodos de Bucle¶
Introducción¶
Nodo de bucle las líneas de iterador, que indican los nodos de origen y de destino cuyos campos mapeados se repetirá una transformación, se generan automáticamente durante el proceso de mapeo, ya sea cuando se usa mapping automático o cuando asignar manualmente objetos de origen a campos de destino.
Normalmente, la generación automática de nodos de bucle durante el mapeo es apropiada para el conjunto de datos. Sin embargo, cuando los datos son tales que hay múltiples conjuntos de valores de datos repetidos (o múltiples nodos de bucle), es posible que necesite definir manualmente un nodo de bucle para forzar que los datos se repitan en un nodo diferente. También puede, si es necesario, eliminar nodos de bucle, tanto los que se han definido manualmente como los que se han generado automáticamente.
Definir un Nodo de Bucle Manualmente¶
Los nodos de bucle se pueden definir manualmente en los nodos de destino que cumplan ambas condiciones:
- La cardinalidad del nodo objetivo debe ser
0+
o1+
. - No debe haber asignaciones en campos de hoja directos dentro del nodo de destino.
Además, la cardinalidad del nodo de origen que se utiliza para crear el nodo de bucle de destino debe ser 0+
o 1+
.
Para definir un nodo de bucle manualmente, en modo de mapeo, arrastre un nodo de origen calificado a un nodo de destino calificado:
Al colocar el nodo de origen en el nodo de destino, aparece un menú. Seleccione la opción Definir nodo de bucle:
El nodo de bucle ahora está definido y se muestra la línea del iterador, que indica cómo la transformación recorrerá el conjunto de datos de origen. (La línea se muestra incluso si todavía no hay asignaciones de hojas directas en los campos debajo del nodo). Complete la asignación de campos debajo del nodo de bucle como de costumbre:
Eliminar un Nodo de Bucle y Asignaciones¶
Las opciones para eliminar un nodo de bucle definido manualmente o para eliminar cualquier nodo de bucle y sus asignaciones están disponibles en el menú de acciones de un nodo.
Desde cualquier modo de mapeo o modo secuencia de comandos, coloque el cursor sobre el nombre de un nodo y haga clic en el icono del menú de acciones para abrir el menú de acciones. En el menú, seleccione una de estas opciones de eliminación de mapeo:
Opción del menú | Descripción |
---|---|
![]() | Eliminar nodo de bucle elimina la definición del nodo de bucle. Esta acción solo está disponible en nodos que tienen un definido manualmente nodo de bucle. Para eliminar una definición de nodo de bucle en un generado automáticamente nodo de bucle, elimine todas sus asignaciones de hojas directas como se describe en Eliminar una asignación en Asignación de objetos de origen. Nota Si elimina todas las asignaciones de hojas directas de un nodo de bucle definido manualmente, la definición del nodo de bucle aún existe. |
![]() | Eliminar nodos de bucle y asignaciones elimina la definición del nodo de bucle debido a las asignaciones que son hojas secundarias directas asociadas con el nodo de bucle y elimina esas asignaciones. Cualquier otra asignación dentro de los nodos de bucle secundarios debajo del nodo de bucle principal se conservan y el nodo conserva su definición de nodo de bucle si se asigna al menos un nieto. Esta acción está disponible solo en nodos que tienen un nodo de bucle definido (ya sea manualmente o por generación automática). |
Ejemplo¶
Esta sección describe un ejemplo que emplea el conector de HubSpot, ese es un caso de uso en el que es necesaria la redefinición de los nodos del bucle. En este ejemplo, una transformación de solicitud proporciona filtros para usar en una actividad de búsqueda de HubSpot para consultar los registros de la empresa. A continuación, primero mostramos la salida cuando utilizamos el nodo de bucle generado automáticamente y luego mostramos cómo cambia la salida cuando el nodo de bucle se redefine manualmente.
Generación Automática de Nodos de Bucle¶
Después del mapeo automático y la generación automática de un nodo de bucle, el mapeo de transformación muestra un bucle de datos en el segundo nodo del objetivo. item
nodo:
Cuando el mapeo anterior se procesa utilizando los datos de entrada siguientes, se obtiene este resultado, que aplana la estructura de entrada en una única lista de filtros: