Cómo configurar la forma Transformación
Forma Transformación
Las transformaciones solo se usan al construir mensajes, por lo que la forma Transformar siempre aparece dentro de una forma De mensaje de construcción . Puede quitar la forma Construir mensaje en la superficie de diseño y, a continuación, colocar la forma Transformar dentro de ella, o simplemente colocar la forma Transformar en la superficie de diseño, y orchestration Designer creará la forma De construcción de mensaje envolvente automáticamente.
Nota
Cualquier mensaje de origen o destino de una transformación debe basarse en un esquema.
Procedimiento
Para configurar una forma de transformación
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 .
Use el cuadro de diálogo Transformar configuración para configurar la forma Transformar .
Nota
Una forma Transform solo puede existir dentro de una forma De mensaje de construcción. Si arrastra una forma de asignación de mensajes en cualquier otro lugar de la superficie de diseño, se creará una nueva forma De mensaje de construcción.
Consideraciones importantes de rendimiento
BizTalk Server optimiza la capacidad de realizar transformaciones en mensajes de gran tamaño al transmitir el documento a la memoria mientras se aplica la transformación en lugar de cargar todo el documento en la memoria a la vez. Esta optimización permite la asignación/transformación de documentos mucho más grandes que los que permitían versiones anteriores de BizTalk Server. Se produce una limitación de esta optimización cuando una orquestación acepta varias entradas o salidas para formas de transformación.
Si una orquestación acepta varias entradas o salidas para formas de transformación, no se realiza la transmisión del documento y el uso de la memoria aumenta considerablemente. Una posible solución para este problema sería aplicar las transformaciones en una canalización de recepción, de manera que la orquestación nunca acepte más de una única entrada o una única salida para una forma de transformación.
¿Archivo de asignación nueva 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 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. Cuando use 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 este nombre de forma predeterminada, ya que se rellena previamente con un nombre de identificador único basado en el espacio de nombres del proyecto y Transformar nombre de forma: <Espacio de nombres> del proyecto.<Transforme el nombre> de la forma_Map (por ejemplo, MyProject.Transform3_Map).
Si seleccionó Mapa existente, haga clic en la flecha Abajo en el campo Nombre para seleccionar el archivo de mapa que se va a usar. Este cuadro de lista muestra una lista ordenada alfabéticamente de todas las asignaciones 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 destino y de origen
Use esta parte del cuadro de diálogo Transformar configuración para configurar el mapa seleccionado en la sección Nuevo o existente de archivo de mapa. 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:
Seleccionar una asignación existente para volverla a utilizar tal cual en la transformación actual.
Seleccionar una asignación existente para modificarla (volverla a configurar) y, a continuación, utilizarla con 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 utilizar estos controles de cuadrícula para modificar el archivo de asignación de varias maneras. Si elimina un mensaje (una fila de cualquier control de cuadrícula), agrega un mensaje o selecciona un mensaje de un tipo diferente, se altera la estructura de la asignación. Cuando altera la estructura de una asignación, el resto de las transformaciones que la utilizan se tienen que modificar para que coincidan con la nueva estructura de la asignación. Otros cambios, como quitar un mensaje e insertar otro del mismo tipo en su lugar, no altera la estructura de la asignación.
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: Message y Type. Seleccione mensajes de la columna Mensaje para rellenar los controles de cuadrícula. (Solo se agregan datos a la columna Mensaje, porque 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.
Para seleccionar una fila en cualquier control de cuadrícula, haga clic en el botón de flecha derecha (>) situado en el lado izquierdo del control de cuadrícula. Tras seleccionar una fila, puede eliminarla al presionar la tecla Supr. Eliminar una fila (un mensaje) altera la estructura del archivo de asignación que la contiene. Solo puede modificar archivos de asignación que sean locales del proyecto.
Iniciar el Asignador de BizTalk al hacer clic en Aceptar
Al hacer 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 Transformar configuración y guardar los cambios. Sin embargo, no puede guardar 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.
Consulte también
Acerca de las asignaciones
Construcción de mensajes
Cómo usar expresiones para transformar mensajes de forma dinámica