Comment utiliser des types de messages en plusieurs parties

Chaque message a un type de message multiparties, une description de la structure du message qui se compose de zéro ou de plusieurs segments de message. Les parties sont définies par des schémas de langage XSD (XML Schema Definition) ou des classes .NET. Vous pouvez définir vos propres types de messages en plusieurs parties, ou vous pouvez utiliser des classes et schémas .NET existants.

Vous pouvez accéder ou affecter des parties de message directement dans votre orchestration, ou vous pouvez utiliser des éléments individuels de parties de message qui sont exposées en tant que champs ou champs de propriété distingués. Pour plus d’informations, consultez Utilisation des champs distingués et des propriétés de message.

Remarque

Un type de message en plusieurs parties ne contient pas nécessairement plusieurs parties.

Remarque

Une partie de message peut être définie par le type .NET XmlDocument, qui peut être utilisé pour contenir un document XML arbitraire, par n’importe quel type .NET sérialisable XML ou par n’importe quel type .NET prenant en charge la sérialisation personnalisée.

Ajouter un type de message en plusieurs parties

1. Dans la fenêtre Vue Orchestration, développez le nœud Types.

2. Cliquez avec le bouton droit sur Types de messages en plusieurs parties , puis cliquez sur Nouveau type de message en plusieurs parties.

   Le dossier Types de messages en plusieurs parties se développe, s’il est réduit, et un nouveau type de message en plusieurs parties est ajouté avec une partie de message par défaut.

3. Nommez le type de message en plusieurs parties et la partie de message fournie.

   Si votre type de message à plusieurs parties nécessite plusieurs parties de message, vous pouvez ajouter des parties supplémentaires en affectant un nom à la <> nouvelle partie de message.

4. Associez chaque partie de message à un type, tel qu’une classe ou un schéma .NET.

Supprimer un type de message en plusieurs parties

• Dans la fenêtre Affichage Orchestration , cliquez avec le bouton droit sur le type de message en plusieurs parties que vous souhaitez supprimer, puis cliquez sur Supprimer.

  Remarque

  La suppression d’un type de message en plusieurs parties de votre orchestration supprime également les informations de type des messages qui l’utilisent.

  Remarque

  Les éléments qui apparaissent en lecture seule sont définis dans une autre orchestration.

Supprimer une partie d’un type de message à plusieurs parties

• Dans la fenêtre Affichage Orchestration , cliquez avec le bouton droit sur la partie à supprimer, puis cliquez sur Supprimer.

  Remarque

  Vous ne pouvez pas supprimer la partie du message d’un type de message si la propriété Corps de message est définie sur vrai. Vous devez d’abord définir la propriété De corps du message sur True pour les parties d’un autre type de message.

Définir le modificateur de type pour un type de message en plusieurs parties

• Dans la fenêtre Propriétés , définissez la propriété suivante :

  Propriété	Descriptif
  Modificateur de type	Détermine l’étendue du type de message en plusieurs parties : - Privé —L’accès à ce type de message en plusieurs parties est limité au module conteneur. - Public —L’accès à ce type de message en plusieurs parties n’est pas limité. - Interne :L’accès à ce type de message en plusieurs parties est limité aux modules du même projet.

Ajouter des parties à un message multipart existant

• BizTalk Server permet d’ajouter des parties à un message XLANG en plusieurs parties et de faire également référence à une partie de message par un index supérieur au nombre de parties déclarée à l’origine si la partie existe. Cette fonctionnalité peut être utile pour envoyer ou recevoir des messages SMTP avec un nombre variable de pièces jointes. Cette fonctionnalité est implémentée comme suit :

• À partir de votre projet, ajoutez une référence à Microsoft.XLANGs.BaseTypes.

• Créez une variable (par exemple xlangPart) de type Microsoft.XLANGs.BaseTypes.XLANGMessage.

• Utilisez xlangPart.AddPart(...) en utilisant les arguments appropriés d'une forme Expression.

  Remarque

  Les parties ajoutées sont de type XmlDocument afin que vous ne puissiez pas ajouter une partie de message mise en forme personnalisée à l’aide de la méthode AddPart().

Remarque

Si un message à plusieurs parties qui contient plus que le nombre de parties déclarées est reçu, le moteur d’orchestration lit le nombre de parties présentes dans le message, puis construit les types de parties appropriés pour les parties qui correspondent au nombre de parties dans le type de message déclaré, puis construit des parties XmlDocument pour les parties restantes.

Voir aussi

IBaseMessage.AddPart, méthode (COM) dans les instructions de l’interface utilisateur et les informations de référence sur l’espace de noms d’API des développeurs
Ressources XSD sur le web
Utilisation de champs distingués et de champs de propriété
Utilisation de messages dans les orchestrations