Cómo agregar functoids de bucle de tabla y de extractor de tablas a una asignación
Los functoids Bucle de tabla y Extractor de tablas se usan juntos. El functoid Bucle de tabla tiene una tabla interna que se configura. Para cada registro o campo de entrada, el functoid Bucle de tabla genera las filas de la tabla, de una en una. El functoid Extractor de tablas extrae el elemento deseado de una fila y lo pasa al mensaje de instancia de salida.
Para obtener información conceptual sobre los functoids De bucle de tabla y Extractor de tablas , vea Bucles de tabla y Functoids extractor de tablas.
Para agregar functoids de bucle de tabla y de extractor de tablas a fin de asignarlos y configurarlos
Con el cuadro de herramientas de Visual Studio activo, haga clic en la pestaña Functoids avanzados para seleccionar esa categoría de functoids.
Aparece la lista de functoids avanzados de la categoría seleccionada.
Arrastre el functoid Bucle de tabla (
) desde el Cuadro de herramientas hasta la ubicación adecuada en una página de cuadrícula.Nota
El functoid se colocará en la página de cuadrícula mostrada. Si desea colocar el functoid en una página de cuadrícula diferente, necesitará mostrar en primer lugar la página de cuadrícula.
Nota
Dado que la salida del functoid Bucle de tabla actúa como entrada a uno o varios functoids extractores de tabla asociados, asegúrese de dejar espacio a la derecha del functoid Bucle de tabla para los functoids Extractor de tablas .
Arrastre un registro o campo desde el esquema de origen al functoid Bucle de tabla recién agregado. Como primer parámetro de entrada para el functoid Bucle de tabla , el número de repeticiones de este registro o campo en un mensaje de instancia controlará el número de veces que este functoid genera la salida. Por ejemplo, si se arrastra un registro de bucle al functoid y se procesa un mensaje de instancia que tiene 10 repeticiones de este registro y la cuadrícula de tabla se ha configurado con una fila de orígenes de datos de columna, el functoid Bucle de tabla itera 10 veces, lo que genera 10 filas de salida para la extracción por un functoid extractor de tablas, y permiten construir fácilmente 10 registros de destino.
Nota
Si configura varias filas en la cuadrícula de tabla, cada fila se generará para cada iteración del functoid Bucle de tabla. Por lo tanto, el número de apariciones de un registro de entrada por el número de filas configuradas en la cuadrícula de tabla equivale al número de filas de tabla de salida disponibles para la extracción de datos.
Arrastre un registro o campo desde el esquema de destino al functoid Bucle de tabla . Este vínculo garantiza la creación del nodo en el esquema de destino.
Seleccione el functoid Bucle de tabla recién agregado y, en la ventana Propiedades , haga clic en el botón de puntos suspensivos (...) asociado a su propiedad Parámetros de entrada .
Nota
Como alternativa, puede seleccionar el functoid y presionar CTRL+M, CTRL+T del teclado. Para obtener una lista de métodos abreviados de teclado del asignador, vea Métodos abreviados de teclado del asignador de BizTalk.
En el cuadro de diálogo Configurar functoid bucle de tabla, haga clic en el botón
para crear el segundo parámetro de entrada. Escriba un número que represente el número de columnas que estarán disponibles en la tabla que va a crear para este functoid bucle de tabla.Nota
El número máximo columnas en la tabla es 228.
En el cuadro de diálogo Configurar functoid bucle de tabla, haga clic en el botón
para especificar los valores constantes que aparecen en la cuadrícula de tabla configurada. El orden en que cree estas constantes no es importante en este cuadro de diálogo, dado que los valores del primer y del segundo parámetros, el número de filas y columnas respectivamente, mantienen sus posiciones al comienzo de la lista de parámetros de entrada. Cuando haya terminado, haga clic en Aceptar.Se cierra el cuadro de diálogo Configurar functoid de bucle de tabla .
Arrastre cero o más nodos de registro o campo desde el esquema de origen al functoid Bucle de tabla que ha agregado recientemente. Todos estos nodos de registro o de campo se agregan al final de la lista de parámetros de entrada y, por lo tanto, estarán disponibles cuando la cuadrícula de tabla esté configurada en un paso posterior. Al igual que ocurría con las constantes de datos de tabla agregadas previamente (no las constantes de números de filas y columnas), el orden en que se agregan estos nodos de registros y de campos no es importante en última instancia.
Para etiquetar un vínculo, siga estos pasos:
Seleccione un vínculo en la página de cuadrícula mostrada.
En el ventana Propiedades de Visual Studio, proporcione un nombre descriptivo para la propiedad Label. Por ejemplo, puede dar un nombre como "link2ndAuthor" a un vínculo procedente de un campo llamado "Segundo autor".
Seleccione el functoid Bucle de tabla recién agregado y, en la ventana Propiedades , haga clic en el botón de puntos suspensivos (...) asociado a la propiedad Table Looping Grid asociada a ese functoid.
Aparece el cuadro de diálogo Configurar functoid de bucle de tabla con la pestaña Cuadrícula de bucle de tabla seleccionada.
Nota
Como alternativa, puede hacer clic con el botón derecho en el functoid y, a continuación, hacer clic en Configurar cuadrícula de bucle de tabla en el menú contextual. Aparece el cuadro de diálogo Configurar functoid de bucle de tabla con la pestaña Cuadrícula de bucle de tabla seleccionada.
Use las listas desplegables asociadas a cada celda de la tabla para configurar al menos una (o quizá varias) de las filas de la cuadrícula. Las opciones disponibles en las listas desplegables son las constantes y vínculos que ha configurado en los pasos 6-8 como parámetros de entrada 3 y hasta el functoid Bucle de tabla . (Los parámetros de entrada 1 y 2 no aparecen en estas listas desplegables). Cuando haya terminado, haga clic en Aceptar.
Se cierra el cuadro de diálogo Configurar functoid de bucle de tabla .
Nota
Cada fila constituye una iteración de la estructura de salida, en combinación con el número de repeticiones del registro o campo especificado como el primer parámetro de entrada del functoid Bucle de tabla . Para más información, consulte el paso 3.
Nota
Debe seleccionar un valor para cada columna a la que quiera tener acceso mediante un functoid Extractor de tablas . Si un functoid Extractor de tablas no usa una columna, debe considerar la posibilidad de quitar esa columna, en lugar de mantenerla.
Nota
El orden en que se rellene la cuadrícula de tabla no tiene importancia.
Arrastre tantos functoids Extractor de tablas (
) desde el Cuadro de herramientas hasta la página de cuadrícula mostrada según sea necesario.Nota
Dado que la entrada de estos functoids Extractor de tablas procede del functoid Bucle de tabla agregado en un paso anterior, asegúrese de colocar los functoids Extractor de tablas a la derecha del functoid Bucle de tabla en la página de cuadrícula mostrada.
Para crear el primer parámetro de entrada para uno de los functoids Extractor de tablas agregados en el paso 9, arrástrelo al functoid Bucle de tabla correspondiente a su izquierda.
Para crear el segundo parámetro de entrada para el mismo functoid Extractor de tablas, seleccione el functoid y, en la ventana Propiedades , haga clic en el botón de puntos suspensivos (...) asociado a su propiedad Parámetros de entrada .
Aparece el cuadro de diálogo Configurar functoid Extractor de tablas.
Haga clic en el botón
para crear el segundo parámetro de entrada. Escriba el número de la columna de la cuadrícula de tabla del functoid bucle de tabla correspondiente del que desea extraer datos. Haga clic en OK.Se cierra el cuadro de diálogo Configurar functoid Extractor de tablas .
Nota
Los números de columna empiezan en 1.
Para usar la salida del functoid Extractor de tablas, arrastre el functoid Extractor de tablas a un registro o nodo de campo en el esquema de destino, o arrastre un registro o nodo de campo en el esquema de destino al functoid Extractor de tablas. El valor de atributo o elemento de un mensaje de instancia de destino correspondiente a este nodo de registro o de campo del esquema de destino se completará con el valor de la celda especificada en la cuadrícula de tabla (en el caso de constantes) o con el valor indicado también en esa celda (en el caso de vínculos).
Repita los pasos 12, 13, 14 y 15 para cada uno de los functoids extractores de tabla agregados en el paso 11.