Lire en anglais

Partager via


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.

Format

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.

Attributs

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

Éléments enfants

É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.

Remarques

Les opérations communes suivantes ne sont pas autorisées dans les expressions Reference :

  • And

  • Égal à

Exemple

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>

Voir aussi

Interceptor OnEvent, élémentEventStream.AddRelatedActivity, méthode