Informations de référence
L’élément Reference peut être utilisé pour ajouter une ou plusieurs relations à une activité BAM. Cela s'avère utile lorsque vous souhaitez associer un pointeur tel qu'une clé primaire, un ID ou une URL à un message lui correspondant. Par exemple, vous voulez peut-être stocker une référence à un lot d'expéditions d'une activité Purchase Order.
L’élément Reference
prend en charge les éléments enfants Data et LongData qui contiennent une expression spécifiant les données à attacher à l’activité BAM. Vous pouvez utiliser n’importe quelle combinaison de données et longdata pour répondre à vos besoins de suivi.
Nom de l’attribut | Description |
---|---|
Nom | Nom de la relation à associer à l'activité BAM. |
Type | Chaîne arbitraire spécifiant le type de relation à associer à l'activité BAM. Les chaînes arbitraires et les types BAM prédéfinis suivants sont pris en charge : - BizTalkService -Messageid - Activity - DocumentUrl -Instanceid |
État de l'exécution | Description |
---|---|
Données | Indique le mode d'extraction des données de chaîne (jusqu'à 128 caractères) qui seront associées à l'activité BAM. |
LongData | Indique le mode d'extraction des données de chaîne longue arbitraire qui seront associées à l'activité BAM. |
Notes
Un Reference
élément peut combiner un ou plusieurs éléments enfants Data et LongData si nécessaire.
Les opérations communes suivantes ne sont pas autorisées dans les expressions Reference :
And
Égal à
Dans l’exemple suivant, une référence nommée « Document associé » de type « DocumentUrl » est créée à l’aide GetUserData
d’un workflow. Étant donné que les données utilisateur doivent comporter moins de 1 024 caractères, l’élément Data
est utilisé pour contenir l’élément Expression
.
<ic:Reference Name="Related Document" Type="DocumentUrl">
<ic:Data>
<ic:Expression>
<wf:Operation Name="GetUserData" />
</ic:Expression>
</ic:Data>
</ic:Reference>
L’élément Reference prend en charge un mélange d’éléments Data
et .LongData
Dans l’exemple suivant, les champs de nom de pays/région et de note d’un bon de commande sont récupérés à partir d’un service WCF et écrits dans la relation « Données longues et courtes » comme type « MyType ». Étant donné que le champ de note prend en charge plus de 1 024 caractères, l’expression est placée dans un LongData
élément .
<ic:Reference Name="Long and Short Data" Type="MyType">
<ic:Data>
<ic:Expression>
<ic:Operation Name="Constant">
<ic:Argument>Country: </ic:Argument>
</ic:Operation>
<wcf:Operation Name="XPath">
<wcf:Argument>//s:Body//po:Country</wcf:Argument>
</wcf:Operation>
<ic:Operation Name="Concatenate" />
</ic:Expression>
</ic:Data>
<ic:LongData>
<ic:Expression>
<ic:Operation Name="Constant">
<ic:Argument>Note: </ic:Argument>
</ic:Operation>
<wcf:Operation Name="XPath">
<wcf:Argument>//s:Body//po:Note</wcf:Argument>
</wcf:Operation>
<ic:Operation Name="Concatenate" />
</ic:Expression>
</ic:LongData>
</ic:Reference>
Interceptor OnEvent, élémentEventStream.AddRelatedActivity, méthode