Riferimenti

L'elemento Reference può essere usato per aggiungere una o più relazioni a un'attività BAM. Ciò è utile quando si vuole collegare un puntatore come una chiave primaria, un ID o un URL a un messaggio correlato. Ad esempio, è possibile archiviare un riferimento a un lotto di spedizione in un'attività relativa a un ordine di acquisto.

Formato

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

Attributi

Nome dell'attributo	Descrizione
Nome	Nome della relazione che verrà associata all'attività BAM.
TIPO	Stringa arbitraria che specifica il tipo di relazione che verrà associata all'attività BAM. Sono supportate sia stringhe arbitrarie che i tipi BAM predefiniti seguenti: - BizTalkService - ID messaggio - Attività - DocumentUrl - InstanceID

Elementi figli

Stato di esecuzione	Descrizione
Dati	Specifica come estrarre dati stringa fino a 128 caratteri che verranno associati all'attività BAM.
LongData	Specifica come ricavare dati di stringa di lunghezza arbitraria che verranno associati all'attività BAM.

Annotazioni

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

Osservazioni:

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

• E

• Uguale

Esempio

Nell'esempio seguente viene creato un riferimento denominato "Documento correlato" di tipo "DocumentUrl" usando GetUserData per un flusso di lavoro. Poiché si prevede che i dati utente siano di lunghezza inferiore a 1024 caratteri, 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 "Dati lunghi e brevi" 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

Elemento Interceptor OnEventMetodo EventStream.AddRelatedActivity