Auf Englisch lesen

Freigeben über


Verweis

Das Reference-Element kann verwendet werden, um einer BAM-Aktivität eine oder mehrere Beziehungen hinzuzufügen. Dies ist hilfreich, wenn Sie einen Zeiger wie etwa einen primären Schlüssel, eine ID oder oder eine URL an eine zugehörige Nachricht anfügen möchten. Sie können z. B. einen Verweis auf einen Shipment Batch in einer Purchase Order-Aktivität speichern.

Format

Das Reference -Element unterstützt sowohl die untergeordneten Data- als auch die LongData-Elemente , die einen Ausdruck enthalten, der die Daten angibt, die an die BAM-Aktivität angefügt werden sollen. Sie können eine beliebige Kombination aus Daten und LongData verwenden, um Ihre Nachverfolgungsanforderungen zu erfüllen.

Attribute

Attributname BESCHREIBUNG
Name Der Name der Beziehung, die an die BAM-Aktivität angefügt wird.
Typ Eine willkürliche Zeichenfolge, die den Typ der Beziehung angibt, die an die BAM-Aktivität angefügt wird. Willkürliche Zeichenfolgen und die folgenden vordefinierten BAM-Typen werden unterstützt:

– BizTalkService
-Messageid
- Activity
– DocumentUrl
-Instanceid

Untergeordnete Elemente

Ausführungsstatus Beschreibung
Daten Gibt an, wie Zeichenfolgedaten mit einer Länge von bis zu 128 Zeichen extrahiert werden, die an die BAM-Aktivität angefügt werden.
LongData Gibt an, wie willkürlich lange Zeichenfolgedaten extrahiert werden, die an die BAM-Aktivität angefügt werden.

Hinweis

Ein Reference Element kann bei Bedarf ein oder mehrere untergeordnete Data - und LongData-Elemente kombinieren.

Hinweise

Die folgenden allgemeinen Vorgänge sind in Reference-Ausdrücken nicht zulässig:

  • Und

  • Equals

Beispiel

Im folgenden Beispiel wird ein Verweis mit dem Namen "Verwandtes Dokument" vom Typ "DocumentUrl" für einen Workflow erstellt GetUserData . Da die Benutzerdaten voraussichtlich weniger als 1024 Zeichen lang sein sollen, wird das Data Element verwendet, um das Expression -Element zu enthalten.

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

Das Reference-Element unterstützt eine Mischung aus Data - und LongData -Elementen. Im folgenden Beispiel werden die Länder-/Regionsnamen und Notizfelder aus einer Bestellung aus einem WCF-Dienst abgerufen und als Typ "MyType" in die Beziehung "Long and Short Data" geschrieben. Da das Notizfeld mehr als 1024 Zeichen unterstützt, wird der Ausdruck in ein LongData Element eingeschlossen.

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

Weitere Informationen

Interceptor OnEvent-ElementEventStream.AddRelatedActivity-Methode