Traitement des messages d'instance à l'aide de la promotion de propriétés
La promotion de propriétés à l’aide de la méthode Property Field nécessite la création d’un schéma de propriété. Pour plus d’informations sur la création d’un schéma de propriété, consultez Comment créer des schémas de propriété. Comme pour toute promotion de propriétés, vous utilisez la boîte de dialogue Promouvoir les propriétés , qui est accessible à l’aide de la propriété Propriétés de promotion du nœud Schéma dans les schémas de message.
Notes
Vous devez choisir un pipeline qui promeut les propriétés afin de pouvoir accéder à et utiliser les propriétés promues. Par exemple, si vous utilisez le pipeline PassthruReceive, aucune propriété ne sera promue et le routage basé sur le contenu ainsi que d'autres fonctionnalités ne fonctionneront pas comme prévu.
Dans la boîte de dialogue Promouvoir les propriétés , vérifiez que l’onglet Champs de propriété est sélectionné dans le côté droit de la boîte de dialogue. Ensuite, vérifiez que le schéma de propriété approprié est inclus dans la liste des schémas de propriétés en haut de l’onglet Champs de propriété. Si nécessaire, utilisez le bouton dossier pour sélectionner le schéma de propriété approprié à l’aide de la boîte de dialogue Sélecteur de type BizTalk . Ensuite, développez les nœuds dans l’arborescence de schéma à gauche de la boîte de dialogue pour rechercher et sélectionner le nœud Élément champ ou Attribut de champ que vous souhaitez promouvoir en tant que champ de propriété, puis cliquez sur Ajouter. Enfin, utilisez la liste déroulante de la colonne Property de la table de dictionnaire Property-Fields pour sélectionner un nœud Élément Field dans un schéma de propriétés auquel associer la propriété promue. Pour obtenir des instructions pas à pas sur la promotion de propriétés dans des champs de propriété à l’aide de la boîte de dialogue Promouvoir les propriétés ox, consultez Comment copier des données dans le contexte de message en tant que champs de propriété.
Notes
Vous pouvez également promouvoir un nœud Record en nœud Field Element dans le schéma de propriété, mais uniquement si la propriété Type de contenu du nœud Record est définie sur SimpleContent.
Notes
Une même propriété peut être promue plusieurs fois dans un schéma tant que les promotions sont effectuées sous différents nœuds racine. En effet, le message est validé par rapport à un nœud racine unique et seules les propriétés promues sous ce nœud racine sont évaluées lors de l'exécution.
Pour supprimer un nœud Élément de champ ou un nœud Attribut de champ de l’ensemble de propriétés promues en tant que champs de propriété, sélectionnez la propriété promue dans la table du dictionnaire Property-Fields sous l’onglet Champs de propriété, puis cliquez sur Supprimer.
La colonne Chemin du nœud dans la table du dictionnaire Property-Fields affiche le XPath vers le nœud de schéma correspondant à la propriété promue. Vous pouvez modifier cette valeur directement à l’aide de la boîte de dialogue Modifier l’instance XPath . Vous pouvez ouvrir cette boîte de dialogue en cliquant sur le bouton de sélection (...) qui s’affiche à l’extrémité droite de la cellule correspondante lorsque vous sélectionnez cette cellule. La modification directe de valeurs XPath doit se faire avec discernement, car les XPath qui ne peuvent pas être résolus par l'Éditeur BizTalk empêchent le bon déroulement des opérations de validation.
L’éditeur BizTalk fournit également une commande simplifiée pour la promotion des propriétés à l’aide du mécanisme De champ de propriété . Cette commande est appelée Promotion rapide, et elle est disponible à l’aide de La promotion | Commande Promotion rapide dans les menus BizTalk et raccourcis. Cette commande promeut le nœud Champ (ou Nœud Enregistrement ) sélectionné en champ de propriété créé automatiquement dans le schéma de propriété spécifié par la propriété Nom du schéma de propriété par défaut dans la boîte de dialogue Pages de propriétés pour le schéma contenant. Pour obtenir des instructions pas à pas sur la promotion de propriétés dans des champs de propriétés à l’aide de la commande Promotion rapide, consultez Comment copier des données dans le contexte du message en tant que champs de propriété.
Lorsque vous assurez la promotion d'une propriété à l'aide du mécanisme des champs de propriété, deux fragments de langage XSD (XML Schema Definition) sont ajoutés à la représentation XSD du schéma de message. Le premier fragment XSD est un fragment d’annotation associé à l’élément de schéma qui identifie le schéma de propriété correspondant, comme dans l’exemple suivant :
<xs:annotation>
<xs:appinfo>
<b:imports>
<b:namespace prefix="ns0"
uri="http://BizTalk_Server_Project1.PropertySchema1"
location=".\propertyschema1.xsd" />
</b:imports>
</xs:appinfo>
</xs:annotation>
Le deuxième fragment XSD est un fragment d’annotation associé à l’élément Root (qu’il ait été renommé ou non) qui identifie les valeurs de nœud Field Element ou Field Attribute qui ont été promues à l’aide du mécanisme de champ de propriété, comme dans l’exemple suivant :
<xs:annotation>
<xs:appinfo>
<b:properties>
<b:property name="ns0:PromProp1"
xpath="/*[local-name()='Root' and namespace-
uri()='http://BizTalk_Server_Project1.Schema2']/
*[local-name()='MyRec1']/@*[local-
name()='Field_x0020_1']" />
<b:property name="ns0:PromProp2"
xpath="/*[local-name()='Root' and namespace-
uri()='http://BizTalk_Server_Project1.Schema2']/
*[local-name()='MyRec1']/*[local-
name()='ProgramManager']/*[local-name()='Name']" />
</b:properties>
</xs:appinfo>
</xs:annotation>
Voir aussi
Utilisations du contenu de message pour contrôler le traitement de message
Comment copier des données dans le contexte de message en tant que champs de propriété