Cómo usar tipos de mensajes de varias partes
Cada mensaje tiene un tipo de mensaje de varias partes, una descripción de la estructura del mensaje que se compone de cero o más partes de mensaje. Las partes se definen en el lenguaje de definición de esquemas XML (XSD) mediante esquemas o clases .NET. Puede definir sus propios tipos de mensaje de varias partes o usar los esquemas y las clases .NET existentes.
Puede obtener acceso a las partes de mensaje o asignarlas directamente dentro de la orquestación, o bien usar elementos individuales de partes de mensaje que se exponen como campos distintivos o campos de propiedades. Para obtener más información, vea Usar campos distintivos y propiedades de mensaje.
Nota
Un tipo de mensaje de varias partes no tiene que contener necesariamente varias partes.
Nota
Un elemento de mensaje se puede definir mediante el tipo XmlDocument de .NET, que se puede usar para contener un documento XML arbitrario, por cualquier tipo de .NET que sea serializable XML o por cualquier tipo de .NET que admita la serialización personalizada.
Agregar un tipo de mensaje de varias partes
En la ventana Vista de orquestación , expanda el nodo Tipos .
Haga clic con el botón derecho en Tipos de mensajes de varias partes y, a continuación, haga clic en Nuevo tipo de mensaje de varias partes.
La carpeta Tipos de mensajes de varias partes se expande, si se contrae y se agrega un nuevo tipo de mensaje de varias partes con una parte de mensaje predeterminada.
Asigne un nombre al tipo de mensaje de varias partes y a la parte de mensaje proporcionada.
Si el tipo de mensaje de varias partes requiere más de una parte de mensaje, puede agregar elementos adicionales asignando un nombre al <elemento Nuevo> mensaje.
Asocie cada parte de mensaje a un tipo; por ejemplo, esquema o clase .NET.
Quitar un tipo de mensaje de varias partes
En la ventana Vista de orquestación , haga clic con el botón derecho en el tipo de mensaje de varias partes que desea quitar y, a continuación, haga clic en Eliminar.
Nota
Al quitar un tipo de mensaje de varias partes de la orquestación también se quitará la información de tipo de los mensajes que lo utilicen.
Nota
Los elementos que aparecen como de solo de lectura se definen en otra orquestación.
Quitar un elemento de un tipo de mensaje de varias partes
En la ventana Vista de orquestación , haga clic con el botón derecho en el elemento que desea quitar y haga clic en Eliminar.
Nota
No se puede eliminar la parte del mensaje del tipo de mensaje si la propiedad Elemento cuerpo del mensaje está establecida en true. Primero debe establecer la propiedad Elemento del cuerpo del mensaje en True para otra de las partes del tipo de mensaje.
Establecer el modificador de tipo para un tipo de mensaje de varias partes
En la ventana Propiedades , establezca la siguiente propiedad:
Propiedad Descripción Modificador de tipo Determina el ámbito del tipo de mensaje de varias partes:
- Privado:El acceso a este tipo de mensaje de varias partes se limita al módulo contenedor.
- Público:El acceso a este tipo de mensaje de varias partes no está limitado.
- Interno:El acceso a este tipo de mensaje de varias partes se limita a los módulos del mismo proyecto.
Agregar elementos a un mensaje de varias partes existente
BizTalk Server proporciona la capacidad de agregar elementos a un mensaje XLANG de varias partes y también hacer referencia a una parte de mensaje por un índice mayor que el número declarado originalmente de partes si la parte existe. Esta funcionalidad puede ser útil para enviar o recibir mensajes SMTP con un número variable de datos adjuntos. Esta funcionalidad se implementa del modo siguiente:
En el proyecto, agregue una referencia a Microsoft.XLANGs.BaseTypes.
Cree una variable (por ejemplo , xlangPart) de tipo Microsoft.XLANGs.BaseTypes.XLANGMessage.
Llame a xlangPart. AddPart(...) utilizando los argumentos adecuados de una forma expresión.
Nota
Las partes agregadas son de tipo XmlDocument, por lo que no se puede agregar un elemento de mensaje con formato personalizado mediante el método AddPart().
Nota
Si se recibe un mensaje de varias partes que contiene mayor que el número de partes declaradas, el motor de orquestación lee cuántas partes hay en el mensaje, construye los tipos de pieza adecuados para los elementos que coinciden con el número de partes del tipo de mensaje declarado y, a continuación, construye elementos XmlDocument para las partes restantes.
Consulte también
Método IBaseMessage.AddPart (COM) en la guía de interfaz de usuario y referencia del espacio de nombres de api de desarrolladores
Recursos XSD en la Web
Uso de campos distintivos y campos de propiedades
Uso de mensajes en orquestaciones