Uso de ámbito en un bucle: Cómo

Actualizado: agosto de 2015

En este tema se describe el uso de ámbitos en Servicios de BizTalk de Microsoft Azure.

Superficie de diseño de ámbito

En la parte inferior de la superficie de diseño de Transformación, se muestra la jerarquía de ámbitos del bucle MapEach en el rastro de la ruta de navegación. El ámbito actual del bucle MapEach es el último elemento en el rastro de la ruta de navegación. Cuando se define un ámbito en un bucle MapEach, el rastro de la ruta de navegación se actualiza para reflejar la jerarquía actual. En el siguiente ejemplo, Asignación de empleados es el último bucle MapEach del rastro de la ruta de navegación, por tanto es el ámbito establecido actual.

Rastro de la ruta de navegación

Las operaciones de bucles ForEach y MapEach y Crear lista disponen de un contenedor. Los objetos secundarios se agrupan conjuntamente en el contenedor. Los elementos del contenedor se encuentran dentro del ámbito del contenedor y se ejecutan dentro del ámbito del contenedor. Un contenedor interno es un elemento secundario del contenedor externo. Cuando se selecciona un contenedor, se muestra una línea continua alrededor del contenedor. En el ejemplo siguiente, se selecciona Asignación de departamento para que su contenedor disponga de la línea continua:

Contenedor

Cada contenedor se puede contraer y expandir de dos maneras:

  • Seleccione el contenedor y presione la barra espaciadora.

  • Haga clic en el signo menos (-) para contraer y en el signo más (+) para expandir.

Si se contrae el contenedor automáticamente se cancela el ajuste del ámbito del bucle MapEach. Solamente se pueden agregar Operación de asignación a un contenedor con este expandido. La modificación de vínculos se puede llevar a cabo cuando el contenedor está contraído o expandido. En el ejemplo siguiente, Asignación de empleados está contraído y la propiedad Ámbito contenedor accede automáticamente a su nodo principal, que es Asignación de departamento:

Minimizado

Encabezado de contenedor

Cuando el ámbito MapEach se encuentra establecido, el encabezado del contenedor se resalta. Estos colores se modifican mediante los siguientes pasos:

  1. Vaya al menú Herramientas y seleccione Opciones.

  2. Expanda el Diseñador Transformación y seleccione Colores & Fuentes.

  3. Seleccione Fondo del encabezado del ámbito de trabajo para cambiar el color.

  4. Seleccione Aceptar.

Cuando se vincula un registro repetido en el documento de origen con un registro repetido en el documento de destino, se necesita un bucle MapEach. Crear estos vínculos desde cada nodo de origen en el nodo de destino a menudo requiere mucho tiempo. Como resultado, Servicios de BizTalk incluye funcionalidad de vínculo directo.

Establecer vínculos directos es simplemente copiar desde un nodo de entrada en uno de salida, sin ninguna otra tarea de procesamiento. El vínculo directo también se usa para vincular registros no repetitivos, lo cual no requiere un bucle MapEach.

Operaciones de asignación en bucle: uso y ejemplos describe la funcionalidad Vínculo directo.

El ámbito del contenedor se establece por página. Si el ámbito está establecido en un bucle MapEach en la página 1, al seleccionar la página 2 se establece el ámbito en la página de inicio de la página 2.

Al seleccionar un contenedor, los vínculos del nodo de origen y de destino aparecen resaltados en verde. En el ejemplo siguiente, se establecen los ámbitos Asignación de compañía, Asignación de departamento y Asignación de empleado. El rastro de la ruta de navegación muestra la jerarquía del bucle MapEach. Asignación de empleados es el último elemento en el rastro de la ruta de navegación y es por lo tanto el ámbito actual. El nodo Asignación de empleado se resalta en verde:

Vínculos de indicación de ámbito

  1. En el menú Herramientas, seleccione Opciones.

  2. Seleccione Diseñador de transformaciones.

  3. Para desactivar la función de resaltar, seleccione General y desactive la opción Propagación destacada.

  4. Para modificar los colores de resaltado, seleccione Colores & Fuentes.

Cuando se selecciona un bucle secundario, la propiedad Ámbito contenedor se actualiza con el nombre de la etiqueta del ámbito principal. En el ejemplo siguiente, Asignación de departamento se encuentra seleccionada y la propiedad Ámbito contenedor muestra Asignación de compañía, que es el nodo principal:

Contiene propiedad de ámbito

Al seleccionar Página principal en el rastro de la ruta de navegación se coloca el ámbito en la página. No se ha establecido ningún ámbito y la propiedad Ámbito contenedor muestra Ninguno:

Inicio en rastro de la ruta de navegación

Toda Operación de asignación se puede mover mediante las operaciones Cortar/Copiar y Pegar. Los vínculos no se pueden mover mediante las operaciones Cortar/Copiar y Pegar. Si mueve una Operación de asignación mediante las operaciones de Cortar/Copiar y Pegar, los vínculos se eliminarán.

Para mover operaciones de asignación y sus vínculos, use Ctrl + Clic para seleccionar los elementos que desea mover. Ctrl + Clic corta los elementos y, a continuación, puede pegarlos en la ubicación deseada. Las operaciones de asignación y los vínculos no se pueden arrastrar y colocar.

Para salir del ámbito de un bucle MapEach, lleve a cabo una de las siguientes acciones:

  • Ámbito sin establecer Ámbito desanclado. Esta opción desplaza el foco un ámbito de bucle MapEach hacia arriba en la jerarquía.

    En el ejemplo siguiente, el ámbito está establecido:

    Contiene propiedad de ámbito

    A continuación, se cancela el ajuste del ámbito del bucle MapEach Asignación de empleados. El ámbito del bucle MapEach Asignación de departamento es el último elemento en el rastro de la ruta de navegación y es el ámbito actual.

    Elemento en ámbito y siguiente elemento en ámbito sin establecer
  • Seleccione cualquier ámbito principal del rastro de la ruta de navegación. Por ejemplo, seleccione Asignación de departamento en el rastro de la ruta de navegación.

    Rastro de la ruta de navegación de salida de ámbito
  • Establezca un ámbito diferente.

Para obtener información acerca de las prácticas recomendadas a la hora de trabajar con un ámbito de contenedor y un ejemplo de ámbito, consulte los siguientes temas:

Prácticas recomendadas de transformaciones/asignaciones

Ejemplos de bucles y ámbitos en asignaciones o transformaciones

Vea también

Mostrar: