Freigeben über


Korrelationssätze

Sie erzielen diese Art der Korrelation von Nachrichten mit Orchestrierungsinstanzen durch das Definieren von Korrelationssätzen. Ein Korrelationssatz ist ein Satz von Eigenschaften mit bestimmten Werten. Dies ist ein Unterschied zu einem Korrelationstyp, der lediglich eine Liste von Eigenschaften darstellt. Wenn eine eingehende Nachricht nicht über alle diese Eigenschaften mit entsprechenden Werten verfügt, schlägt die Korrelation fehl, und die Nachricht wird nicht durch die Orchestrierungsinstanz empfangen.

Korrelationstypen definieren einen Satz von Eigenschaften, anhand derer Sie Nachrichten korrelieren. Dies können zuvor in einem Eigenschaftenschema definierte Eigenschaften sein, die mit einem BizTalk-Projekt bereitgestellt wurden, einschließlich "system"-Eigenschaften, die mit GlobalPropertySchemas bereitgestellt wurden, die als Teil der Basisinstallation von BizTalk installiert werden. Ein Korrelationssatz definiert einen Satz von Eigenschaften und Werte für diese Eigenschaften, die eine Nachricht enthalten muss, um von einer bestimmten Orchestrierung verarbeitet zu werden.

Ein Korrelationstyp könnte z. B. folgende Eigenschaften enthalten:

Korrelationstypeigenschaft Mögliche XML-Darstellung
Sozialversicherungsnummer <SSN></SSN>
Geburtsdatum <DOB></DOB>
Geschlecht <Geschlecht></Geschlecht>

Ein von diesem Korrelationstyp abgeleiteter Korrelationssatz könnte folgende Eigenschaften und Werte enthalten:

Korrelationssatzeigenschaft/Wert Mögliche XML-Darstellung
Sozialversicherungsnummer = 222112222 <SSN-222112222></SSN>
Geburtsdatum = "1/1/1995" <DOB>"1/1/1995"</DOB>
Geschlecht = Männlich <Geschlecht>M</Geschlecht>

Hinweis

Jeder Korrelationssatz unterstützt maximal drei Parameter.

Initialisierungskorrelationssätze

  • Bei einer Empfangsaktion initialisierte Korrelationssätze

    Bei einer Empfangsaktion initialisierte Korrelationssätze definieren den genauen Satz von Eigenschaften, der in einer veröffentlichten Nachricht enthalten sein muss, damit diese durch die entsprechende(n) Empfangsaktion(en) in einer Orchestrierung verarbeitet werden. Ein Initialisierungskorrelationssatz erstellt einen Korrelationssatz aus einem Korrelationstyp anhand der entsprechenden Werte in einem Dokument.

  • Bei einer Sendeaktion initialisierte Korrelationssätze

    Korrelationssätze, die bei einer Sendeaktion initialisiert werden, werden aus einem Korrelationstyp anhand der entsprechenden Werte in einem Dokument erstellt und stufen die Korrelationseigenschaften im ausgehenden Dokument herauf.

Folgekorrelationssätze

Folgekorrelationssätze können nur an eine nicht aktivierende Empfangsaktion oder an eine Sendeaktion gebunden werden. Sie werden zusammen mit den zuvor initialisierten Korrelationssätzen angegeben.

  • An eine Empfangsaktion gebundene Folgekorrelationssätze

    An eine Empfangsaktion gebundene Folgekorrelationssätze definieren den Satz von Eigenschaften und die Werte, die das Dokument enthalten muss, um empfangen zu werden. Empfangsaktionen mit Folgekorrelationssätzen nehmen Dokumente an, die Eigenschaften aus einem zuvor initialisierten Korrelationssatz enthalten.

  • An eine Sendeaktion gebundene Folgekorrelationssätze

    An eine Sendeaktion gebundene Folgekorrelationssätze legen fest, dass der Satz von Eigenschaften im Korrelationssatz im ausgehenden Dokument heraufgestuft wird.

Überprüfen von Korrelationssätzen

BizTalk Server bietet die Möglichkeit, Korrelationssätze zu überprüfen. Mit einem dem folgenden Beispiel entsprechenden Code können Sie einen Korrelationssatz in einer Form Ausdruck überprüfen:

MsgLen = Correlation_1(BTS.MessageLength);  

Im obigen Beispiel wird davon ausgegangen, dass Sie eine Variable mit dem Namen MsgLen vom Typ System.Int16 erstellt haben und dass Ihre Orchestrierung einen Korrelationssatz namens Correlation_1 enthält. Die Möglichkeit zum Überprüfen von Korrelationssätzen ist hilfreich, wenn Sie den Wert einer Korrelation prüfen möchten, die von einer anderen Orchestrierung an eine Orchestrierung übergeben wurde.

Übergeben von Korrelationssätzen als Parameter an Orchestrierungen

Sie können Korrelationen wie in Parametern an andere Orchestrierungen übergeben.