Cómo configurar la forma de transformación

Transformar la forma

Las transformaciones solo se usan al construir mensajes, por lo que la forma Transform siempre aparece dentro de una forma Construir Mensaje. Puede colocar la forma Construir mensaje en la superficie de diseño y luego colocar la forma Transformar dentro de ella, o de forma añadida colocar la forma Transformar en la superficie de diseño y el Diseñador de orquestaciones creará la forma Construir mensaje para ti.

Nota:

Cualquier mensaje de origen o destino de una transformación debe basarse en un esquema.

Procedimiento

Para configurar una forma de transformación

1. En la ventana Propiedades, haga clic en el botón Puntos suspensivos (...) de la propiedad Mensajes de entrada, Mensajes de salida o Nombre de mapa .

2. Utilice el cuadro de diálogo Configuración de Transformación para configurar la forma Transform.

Nota:

Una forma Transform solo puede existir dentro de una forma Construir Mensaje. Si arrastra una forma Asociación de Mensajes a cualquier otro lugar de la superficie de diseño, se creará una nueva forma Construcción de Mensaje.

Consideraciones importantes sobre el rendimiento

BizTalk Server optimiza la capacidad de realizar transformaciones en mensajes grandes al transmitir el documento a la memoria mientras se aplica la transformación en lugar de cargar todo el documento en memoria a la vez. Esta optimización permite el mapeo y la transformación de documentos mucho más grandes que lo que era posible con versiones anteriores de BizTalk Server. Una limitación de esta optimización se produce cuando una orquestación acepta varias entradas o salidas para transformar formas.

Si una orquestación acepta varias entradas o salidas para transformar formas, el streaming de documentos no se realiza y el uso de memoria aumenta considerablemente. Una posible solución alternativa a este problema sería aplicar la transformación o las transformaciones en una canalización de recepción para que la orquestación nunca acepte más de una sola entrada o una salida única en una forma de transformación.

¿Archivo de mapa nuevo o existente?

En esta sección, puede hacer clic en el botón de opción Nuevo mapa o Mapa existente para seleccionar un mapa que se va a asignar a la forma Transformar .

Use el campo Nombre debajo del botón de opción seleccionado para especificar un mapa. Si seleccionó Nuevo mapa, puede escribir una designación para el mapa que desea asignar. Al usar la opción Nuevo mapa , debe especificar el nombre completo del mapa en el cuadro de texto. El cuadro de texto muestra un ejemplo de dicho nombre de forma predeterminada, ya que está pre-rellenado con un nombre de identificador único basado en el espacio de nombres del proyecto y el nombre de la forma Transform: <Espacio de nombres del proyecto>.<nombre de forma Transform>_Map (por ejemplo, MyProject.Transform3_Map).

Si seleccionó Mapa existente, haga clic en la flecha Abajo en el campo Nombre para seleccionar qué archivo de mapa se va a usar. Este cuadro de lista muestra una lista ordenada alfabéticamente de todos los mapas existentes disponibles en el proyecto. En esta lista, si hace clic en el texto <Seleccionar del ensamblado> al que se hace referencia, se muestra el cuadro de diálogo Seleccionar tipo de artefacto . Para obtener más información sobre las selecciones que pone a disposición, vea Cómo usar el cuadro de diálogo Seleccionar tipo de artefacto.

Seleccionar mensajes de origen y destino

Utilice esta parte del cuadro de diálogo Configuración de transformación para configurar el mapa seleccionado en la sección Archivo de mapa nuevo/existente?. Si seleccionó Nuevo mapa en esa sección, creará ese mapa configurándolo en esta sección.

Si seleccionó Mapa existente, puede usar esta sección para realizar una de estas dos acciones:

• Seleccione un mapa existente para reutilizar as-is en la transformación actual.

• Seleccione un mapa existente para cambiarlo (volver a configurarlo) y después úselo en su nueva configuración en la transformación actual.

  Especifique los mensajes de origen y destino mediante los controles de cuadrícula Mensajes de origen y mensajes de destino . Puede usar estos controles de cuadrícula para cambiar el archivo de mapa de varias maneras. Si elimina un mensaje (una fila en cualquier control de cuadrícula), agregue un mensaje o seleccione un mensaje de otro tipo, modifique la estructura del mapa. Al modificar la estructura de un mapa, todas las demás transformaciones que la usan deben cambiarse para que coincidan con la nueva estructura del mapa. Otros cambios, como quitar un mensaje e insertar en su lugar un mensaje del mismo tipo, no modifiquen la estructura del mapa.

  Los controles de cuadrícula Mensajes de origen y Mensajes de destino son idénticos en apariencia y comportamiento. Cada control de cuadrícula tiene dos columnas: Mensaje y Tipo. Para rellenar los controles de cuadrícula, seleccione mensajes en la columna Mensaje. (Solo se agregan datos a la columna Mensaje, ya que la columna Tipo es de solo lectura). Las celdas de la columna Mensaje tienen listas desplegables rellenadas con instancias de mensaje que están dentro del ámbito de la orquestación actual.

  Puede seleccionar una fila en cualquier control de cuadrícula haciendo clic en el botón de flecha derecha (>) situado en el lado izquierdo del control de cuadrícula. Después de seleccionar una fila, puede eliminarla presionando la tecla DELETE. Al eliminar una fila (un mensaje) se modifica la estructura del archivo de mapa que lo contenía. Solo puede modificar los archivos de mapas que son locales al proyecto.

Cuando hago clic en Aceptar, se lanza el asignador de BizTalk.

Hacer clic en Cuando haga clic en Aceptar, inicie el asignador de BizTalk abre el asignador de BizTalk automáticamente al hacer clic en Aceptar para cerrar el cuadro de diálogo Configuración de transformación y guardar los cambios. Sin embargo, no puede guardar los cambios si falta información necesaria. En este caso, termine de rellenar los campos en el cuadro de diálogo y, a continuación, haga clic en Aceptar.

Véase también

Acerca de Mapas
Construcción de mensajes
Cómo usar expresiones para transformar mensajes dinámicos