Schémas de propriété
Propriétés promues
Dans Microsoft BizTalk Server, les propriétés promues permettent à différents composants BizTalk Server d’accéder à des éléments clés de données, appelés dans ce contexte champs et champs de propriétés distingués qui arrivent dans un message instance sans avoir besoin de savoir comment les rechercher dans le message lui-même. Vous pouvez déterminer les éléments de données qui requièrent la promotion à un niveau plus visible pour des types de messages différents. Selon la manière dont vous choisissez de promouvoir ces champs, vous pourrez avoir besoin de créer et de définir un schéma de propriété associé.
Notes
Les propriétés promues sont limitées à des éléments/attributs non répétés.
Les champs distinctifs ne sont accessibles que dans les orchestrations et ne nécessitent pas la création d'un schéma de propriété correspondant. Si vous avez uniquement besoin d'accéder à des données de message promues à partir d'une orchestration, vous pouvez les promouvoir sous la forme d'un ou de plusieurs champs distinctifs.
Les champs de propriété sont accessibles à partir de divers composants BizTalk Server et notamment à partir de pipelines et d'orchestrations. Les champs de propriétés peuvent également être utilisés pour le routage des messages. Si vous avez besoin d'accéder à des données de message promues à partir de contextes autres que des orchestrations, vous devez créer un ou plusieurs schémas de propriété pour décrire les données dont vous assurez la promotion.
Un schéma de propriété est un schéma spécial que l'on associe à un schéma de message. On l'utilise pour la promotion de valeurs spécifiques à partir d'un message d'instance vers le contexte de message. La promotion de propriété fournit un mécanisme centralisé pour extraire des éléments d'information clés que vous définissez à partir d'un message d'instance et pour rendre ces éléments plus accessibles aux composants BizTalk Server qui gèrent le message lors de sa transmission via BizTalk Server.
Vue d’ensemble de créer un schéma de propriété
Vous pouvez automatiquement créer un schéma de propriété par défaut en utilisant la fonctionnalité de promotion rapide de BizTalk Server. C'est la méthode la plus aisée pour créer le schéma de propriété requis par la promotion de champ de propriété. Pour plus d’informations sur la façon d’effectuer des promotions rapides, consultez Comment copier des données dans le contexte de message en tant que champs de propriété.
Vous pouvez également créer un schéma de propriété. Lorsqu’un projet BizTalk est ouvert, sélectionnez le projet BizTalk, cliquez avec le bouton droit sur Ajouter, cliquez sur Nouvel élément, puis cliquez sur Schéma.
Notes
Si un schéma de propriété est associé à un schéma de message, ils doivent tous deux faire partie du même projet BizTalk. Séparer un schéma de propriété de son schéma de message associé dans divers projets BizTalk n'est pas pris en charge.
Si vous disposez de deux schémas de propriété ayant le même espace de noms, bien qu'ils soient définis dans des assemblys différents, les schémas ne seront pas résolus correctement lors de l'exécution. Vous obtiendrez une erreur de routage lors de l'exécution.
Champs distingués et champs de propriété
Il existe deux types de promotion de propriétés : les champs distingués et les champs de propriété. Le deuxième cité utilise des schémas de propriété. Dans l’Éditeur BizTalk, vous gérez ces deux types de promotion de propriétés à l’aide de la boîte de dialogue Promouvoir les propriétés , à laquelle vous accédez à l’aide de la propriété Promote Properties du nœud Schéma .
Notes
Il existe certaines restrictions concernant les valeurs qu'il est possible de promouvoir. Pour plus d’informations, consultez le tableau dans Promotion des propriétés.
Les champs distinctifs n'apparaissent pas dans les expressions de filtre. C'est uniquement le cas des champs de propriété.
Les schémas de propriété sont simples comparés aux schémas de message. Dans l’arborescence de schéma, vous êtes uniquement autorisé à insérer des nœuds d’élément Field en tant que nœuds enfants immédiats du nœud schéma , créant ainsi une structure à deux niveaux de profondeur. Pour la plupart, vous définissez les propriétés des nœuds d’élément Field comme vous le feriez pour les nœuds d’élément Field qui apparaissent dans un schéma de message. Vous êtes limité à utilisation des seuls types simples XSD.
Important
Ne renommez pas un schéma utilisé par un autre schéma. Cela concerne également les schémas de propriété pour lesquels des promotions ont déjà été établies. Si vous ne respectez pas cette règle, le schéma utilisé ne pourra pas retrouver l'autre schéma, car le nom qu'il contient ne sera plus exact.
La propriété De base du schéma de propriété est unique aux nœuds Field Element , car ils apparaissent dans les schémas de propriété. Cette propriété est vide par défaut, mais peut être définie sur MessageDataPropertyBase ou MessageContextPropertyBase, ce qui entraîne l’ajout d’un attribut propSchFieldBase à l’élément d’annotation fieldInfo avec l’une ou l’autre de ces valeurs.
Lorsque l’attribut propSchFieldBase est défini sur MessageDataPropertyBase, cela signifie que la valeur de la propriété promue correspond aux données du message, telles que la valeur de certains champs. Lorsque l’attribut propSchFieldBase est défini sur MessageContextPropertyBase, cela signifie que la valeur de la propriété promue peut provenir d’un autre emplacement, comme une enveloppe, ou qu’elle peut être définie par un composant de pipeline.
Les nœuds Field Element dans les schémas de propriétés ont également une propriété appelée Informations sensibles, qui, lorsqu’elle est définie sur Oui, empêche la valeur correspondante d’être visible à partir de BizTalk Explorer et de l’événement et du service de message instance suivi, préservant ainsi sa nature sensible. Pour plus d’informations, consultez Informations sensibles dans les instructions de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs .
La représentation de langage XSD (XML Schema Definition) suivante d'un schéma de propriété contient une annotation associée à l'élément de schéma qui identifie ce schéma en tant que schéma de propriété (schema_type="property"). Il contient également trois nœuds d’élément field sous le nœud Schéma . Le premier nœud Field Element , nommé PromProp1, n’a pas de valeur définie pour sa propriété Property Schema Base , mais les deux derniers nœuds Field Element ont cette propriété définie sur MessageDataPropertyBase et MessageContextPropertyBase, respectivement.
<?xml version="1.0" encoding="utf-16" ?>
<xs:schema xmlns="http://BizTalk_Server_Project1.PropertySchema1"
xmlns:b="http://schemas.microsoft.com/BizTalk/2003"
targetNamespace="http://BizTalk_Server_Project1.PropertySchema1"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:appinfo>
</xs:appinfo>
</xs:annotation>
<xs:element name="" type="xs:string">
<xs:annotation>
<xs:appinfo>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element name="" type="xs:string">
<xs:annotation>
<xs:appinfo>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element name="" type="xs:string">
<xs:annotation>
<xs:appinfo>
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:schema>