Comment utiliser des types de messages en plusieurs parties
Chaque message possède un type de message à parties multiples (description de la structure du message qui est composée de zéro partie ou plus). Les parties sont déterminées par les schémas de langage XSD (XML Schema Definition) ou les classes .NET. Vous avez la possibilité de définir vos propres types de messages à parties multiples ou d'utiliser les classes .NET et schémas existants.
Vous pouvez accéder directement à des parties de messages ou les affecter à partir de votre orchestration. Vous avez également la possibilité d'utiliser des éléments distincts des parties de message exposées en tant que champs distinctifs ou champs de propriété. Pour plus d’informations, consultez Utilisation de champs distingués et de propriétés de message.
Notes
Un type de message à parties multiples ne contient pas forcément plusieurs parties.
Notes
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
Dans la fenêtre Vue d’orchestration , développez le nœud Types .
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 à parties multiples 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.
Nommez ce type ainsi que la partie du message fournie.
Si votre type de message en plusieurs parties nécessite plusieurs parties de message, vous pouvez ajouter des parties supplémentaires en affectant un nom à la <partie Nouveau> message.
Associez chaque partie du message à un type, comme une classe .NET ou un schéma.
Supprimer un type de message en plusieurs parties
Dans la fenêtre Vue d’orchestration , cliquez avec le bouton droit sur le type de message en plusieurs parties à supprimer, puis cliquez sur Supprimer.
Notes
La suppression d'un type de message à parties multiples de votre orchestration supprime également les informations sur le type dans les messages qui l'utilisent.
Notes
Les éléments apparaissant en lecture seule sont définis dans une autre orchestration.
Supprimer un composant d’un type de message en plusieurs parties
Dans la fenêtre Vue d’orchestration , cliquez avec le bouton droit sur la partie à supprimer, puis cliquez sur Supprimer.
Notes
Vous ne pouvez pas supprimer la partie de message d’un type de message si la propriété Composant corps du message a la valeur true. Vous devez d’abord définir la propriété Composant corps du message sur True pour une autre partie du 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é Description Modificateur de type Détermine l'étendue du type de message à parties multiples :
- 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 en plusieurs parties existant
BizTalk Server permet d’ajouter des parties à un message XLANG en plusieurs parties et de faire référence à une partie de message par un index supérieur au nombre de parties initialement déclaré si la partie existe. Cette fonction peut s'avérer particulièrement utile pour l'envoi et la réception de messages SMTP ayant un nombre variable de pièces jointes. Cette fonctionnalité est implémentée comme indiqué ci-dessous :
À 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.
Appelez xlangPart. AddPart(...) à l’aide des arguments appropriés d’une forme Expression.
Notes
Les parties ajoutées étant de type XmlDocument, vous ne pouvez pas ajouter une partie de message mise en forme personnalisée à l’aide de la méthode AddPart().
Notes
Si un message en plusieurs parties contenant une valeur supérieure au nombre de parties déclarées est reçu, le moteur d’orchestration lit le nombre de parties contenues dans le message, puis construit les types de pièces appropriés pour les parties qui correspondent au nombre de parties dans le type de message déclaré, puis construit des composants XmlDocument pour les parties restantes.
Voir aussi
IBaseMessage.AddPart, méthode (COM) dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API pour les développeurs
Ressources XSD sur le web
Utilisation des champs distinctifs et des champs de propriété
Utilisation de messages passant par des orchestrations