Referenz

Das Reference-Element kann verwendet werden, um einer BAM-Aktivität eine oder mehrere Beziehungen hinzuzufügen. Dies ist nützlich, wenn Sie einen Zeiger wie einen Primärschlüssel, eine ID oder eine URL an eine verwandte Nachricht anfügen möchten. Sie können z. B. einen Verweis auf einen Versandbatch in einer Bestellaktivität speichern.

Format

Das Reference-Element unterstützt sowohl die untergeordneten Elemente "Data" als auch "LongData", 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 Tracking-Anforderungen zu erfüllen.

Attribute

Attributname BESCHREIBUNG
Name Name der Beziehung, die der BAM-Aktivität zugeordnet wird.
Typ Beliebige Zeichenfolge, die den Typ der Beziehung angibt, die an die BAM-Aktivität angefügt wird. Sowohl beliebige Zeichenfolgen als auch die folgenden vordefinierten BAM-Typen werden unterstützt:

- BizTalkService
- MessageID
- Aktivität
- DocumentUrl
- InstanzID

Untergeordnete Elemente

Ausführungsstatus BESCHREIBUNG
Daten Gibt an, wie Zeichenfolgendaten bis zu 128 Zeichen extrahiert werden, die an die BAM-Aktivität angefügt werden.
LongData Gibt an, wie beliebig lange Zeichenfolgendaten extrahiert werden, die an die BAM-Aktivität angefügt werden.

Hinweis

Ein Reference-Element kann je nach Bedarf ein oder mehrere Daten- und LongData-Elemente kombinieren.

Bemerkungen

Die folgenden allgemeinen Vorgänge sind in Referenzausdrücken nicht zulässig:

  • Und

  • Ist gleich

Beispiel

Im folgenden Beispiel wird mit GetUserData ein Verweis mit dem Namen "Related Document" vom Typ "DocumentUrl" für einen Workflow erstellt. Da die Benutzerdaten voraussichtlich weniger als 1024 Zeichen lang sind, wird das Element verwendet, um das DataExpression 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 Elementen und LongData Elementen. Im folgenden Beispiel werden die Felder "Länder-/Regionsname" und "Notiz" eines Bestellauftrags 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>

Siehe auch

Interceptor OnEvent ElementEventStream.AddRelatedActivity-Methode

  • Last updated on