Lire en anglais

Partager via


Ensembles de corrélations

Vous pouvez réaliser une sorte de corrélation de messages avec des instances d'orchestration en définissant des ensembles de corrélations. Un jeu de corrélations est un ensemble de propriétés avec des valeurs spécifiques. Il ne s'agit pas d'un type de corrélation, qui correspond à une simple liste de propriétés. Si un message entrant ne dispose pas de l'ensemble de ces propriétés, avec des valeurs correspondantes pour chacune d'elles, la corrélation échoue et l'instance d'orchestration ne reçoit pas le message.

Les types de corrélations définissent un jeu de propriétés sur lesquelles corréler les messages. Il peut s'agir de n'importe laquelle des propriétés précédemment définies dans un schéma de propriété et déployées dans le cadre d'un projet BizTalk, y compris des propriétés « système » déployées avec les schémas GlobalPropertySchemas installés en même temps que l'installation BizTalk de base. Un ensemble de corrélations définit un ensemble de propriétés et de valeurs attribuées à ces propriétés qu'un message doit contenir pour être traité par une orchestration particulière.

Par exemple, un type de corrélation pourrait se composer des propriétés suivantes :

Propriété d'un type de corrélation Représentation XML possible
Social Security number <SSN></SSN>
Date of Birth <DOB></DOB>
Sexe <Genre></Sexe>

Un ensemble de corrélations dérivé de ce type de corrélation pourrait se composer des propriétés et valeurs suivantes :

Propriété/valeur de l'ensemble de corrélations Représentation XML possible
Social Security number = 222112222 <SSN>222112222</SSN>
Date of Birth = “1/1/1995” <DOB>"1/1/1995"</DOB>
Gender = Male <Genre>M</Sexe>

Notes

Chaque ensemble de corrélations prend en charge un maximum de trois paramètres.

Propriété Initialisation des ensembles de corrélations

  • Ensembles de corrélations initialisés lors d'une action Réception

    Les ensembles de corrélations initialisés lors d'une action de réception définissent l'ensemble exact de propriétés devant figurer dans un message publié afin que ce dernier puisse être traité par les actions de réception correspondantes dans une orchestration. Un ensemble de corrélations initial crée un ensemble de corrélations à partir d'un type de corrélation en fonction des valeurs correspondantes d'un document.

  • Ensembles de corrélations initialisés lors d'une action Envoi

    Les ensembles de corrélations initialisés lors d'une action d'envoi sont créés à partir d'un type de corrélation en fonction des valeurs correspondantes d'un document. Ils promeuvent les propriétés de corrélation dans le document sortant.

Propriété Ensembles de corrélations suivants

Les ensembles de corrélations suivants ne peuvent être liés qu'à une action d'envoi ou à une action de réception sans activation. Ils sont indiqués par deux avec des ensembles de corrélations précédemment initialisés.

  • Ensembles de corrélations suivants liés à une action Réception

    Les ensembles de corrélations suivants liés à une action Réception définissent le jeu de propriétés et de valeurs devant absolument figurer dans le document pour que ce dernier puisse être reçu. Les actions de réception avec ensembles de corrélations suivants acceptent les documents contenant les propriétés d'un ensemble de corrélations précédemment initialisé.

  • Ensembles de corrélations suivants liés à une action Envoi

    Les ensembles de corrélations suivants liés à une action Envoi indiquent que le jeu de propriétés figurant dans l'ensemble de corrélations est promu dans le document sortant.

Inspection des ensembles de corrélations

BizTalk Server permet d’inspecter les jeux de corrélation. Vous pouvez inspecter un ensemble de corrélations dans une forme Expression à l'aide d'un code similaire à ce qui suit :

MsgLen = Correlation_1(BTS.MessageLength);  

L’exemple ci-dessus suppose que vous avez créé une variable nommée MsgLen de type System.Int16 et que votre orchestration contient un jeu de corrélations nommé Correlation_1. Cette possibilité d'inspection des ensembles de corrélations peut se révéler utile lorsque vous avez besoin de vérifier la valeur d'une corrélation transmise entre orchestrations.

Transmission d'ensembles de corrélations aux orchestrations en tant que paramètres

Vous pouvez passer des corrélations en tant que paramètres dans à d’autres orchestrations.