Leggere in inglese

Condividi tramite


Riferimento

L'elemento Reference può essere usato per aggiungere una o più relazioni a un'attività BAM. Ciò risulta utile quando si desidera associare un puntatore, ad esempio una chiave primaria, un ID o un URL, a un messaggio correlato. È ad esempio possibile memorizzare un riferimento a un elemento Shipment Batch in un'attività Purchase Order.

Formato

L'elemento Reference supporta sia gli elementi figlio Data che LongData che contengono un'espressione che specifica i dati da collegare all'attività BAM. È possibile usare qualsiasi combinazione di Dati e LongData per soddisfare i requisiti di rilevamento.

Attributi

Nome attributo Descrizione
Nome Nome della relazione che verrà associata all'attività BAM.
Tipo Stringa arbitraria che specifica il tipo di relazione che verrà associato all'attività BAM. Sono supportate sia le stringhe arbitrarie sia i tipi BAM predefiniti seguenti:

- BizTalkService
-Messageid
- Activity
- DocumentUrl
-Instanceid

Elementi figlio

Stato esecuzione Descrizione
Dati Specifica come estrarre i dati delle stringhe fino a 128 caratteri che verranno associati all'attività BAM.
LongData Specifica come estrarre i dati di stringhe lunghe arbitrarie che verranno associati all'attività BAM.

Nota

Un Reference elemento può combinare uno o più elementi figlio di Data e LongData in base alle esigenze.

Commenti

Le operazioni comuni seguenti non sono consentite nelle espressioni di riferimento:

  • e

  • Uguale a

Esempio

Nell'esempio seguente viene creato un riferimento denominato "Documento correlato" di tipo "DocumentUrl" usando GetUserData per un flusso di lavoro. Poiché i dati utente devono essere inferiori a 1024 caratteri in lunghezza, l'elemento Data viene usato per contenere l'elemento Expression .

<ic:Reference Name="Related Document" Type="DocumentUrl">
  <ic:Data>
    <ic:Expression>
      <wf:Operation Name="GetUserData" />
    </ic:Expression>
  </ic:Data>
</ic:Reference>

L'elemento Reference supporta una combinazione di Data elementi e LongData . Nell'esempio seguente, i campi nome paese/area geografica e note di un ordine di acquisto vengono recuperati da un servizio WCF e scritti nella relazione "Long and Short Data" come tipo "MyType". Poiché il campo note supporta più di 1024 caratteri, l'espressione è racchiusa in un LongData elemento.

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

Vedere anche

Metodo Interceptor OnEvent Element EventStream.AddRelatedActivity