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 consta de cero o más partes del mensaje. Las partes se definen mediante esquemas de lenguaje de definición de esquema XML (XSD) o clases de .NET. Puede definir sus propios tipos de mensajes de varias partes o puede usar las clases y esquemas de .NET existentes.

Puede acceder o asignar partes del mensaje directamente dentro de la orquestación, o puede usar elementos individuales de estas partes del mensaje que se exponen como campos distinguidos o campos de propiedad. Para obtener más información, vea Usar campos distintivos y propiedades de mensaje.

Nota:

Un tipo de mensaje de varias partes no contiene 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, cualquier tipo de .NET que sea serializable XML o cualquier tipo de .NET que admita la serialización personalizada.

Agregar un tipo de mensaje de varias partes

1. En la ventana Vista de orquestación , expanda el nodo Tipos .

2. 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 está contraída, y se agrega un nuevo tipo de mensaje de varias partes con un apartado de mensaje predeterminado.

3. Asigne un nombre al tipo de mensaje de varias partes y al elemento de mensaje proporcionado.

   Si el tipo de mensaje de varias partes requiere más de una parte de mensaje, puede agregar partes adicionales asignando un nombre a la <Nueva> parte de mensaje.

4. Asocie cada elemento de mensaje a un tipo, como una clase o esquema de .NET.

Eliminar un tipo de mensaje multitramo

• 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 multipartes de la orquestación, también se quitará la información de tipo de los mensajes que lo usan.

  Nota:

  Los elementos que aparecen como de solo lectura se definen en otra orquestación.

Quitar una parte de un tipo de mensaje de varias partes

• En la ventana Vista de orquestación , haga clic con el botón derecho en la parte que desea quitar y haga clic en Eliminar.

  Nota:

  No se puede eliminar la parte del mensaje de un tipo de mensaje si la propiedad Elemento del 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 un elemento de mensaje por un índice mayor que el número declarado originalmente de partes si existe la parte. Esta funcionalidad puede ser útil para enviar o recibir mensajes SMTP con un número variable de datos adjuntos. Esta funcionalidad se implementa de la siguiente manera:

• En el proyecto, agregue una referencia a Microsoft.XLANGs.BaseTypes.

• Cree una variable (por ejemplo , xlangPart) de tipo Microsoft.XLANGs.BaseTypes.XLANGMessage.

• Use xlangPart.AddPart(…) utilizando los argumentos apropiados de una forma de expresión.

  Nota:

  Las partes agregadas son de tipo XmlDocument, por lo que no se puede agregar una parte 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.

Véase también

Método IBaseMessage.AddPart (COM) en la guía de interfaz de usuario y referencia del espacio de nombres de la API de desarrolladores
Recursos XSD en la Web
Uso de campos distintivos y campos de propiedad
Uso de mensajes en orquestaciones