Freigeben über


BAM-API aus einem Orchestrierungsausdruck (BizTalk Server-Beispiel)

In diesem Beispiel wird Folgendes veranschaulicht:

  • Verwenden Sie die BAM-API aus einem BizTalk Server Orchestrierungsausdruck.

  • Überwachen wiederholter Elemente in einer Nachricht als unterschiedliche Aktivitätsinstanzen

  • Erstellen einer Beziehung zwischen BAM-Daten, die mithilfe eines Überwachungsprofils überwacht werden, und BAM-Daten, die mithilfe der BAM-API überwacht werden.

Speicherort dieses Beispiels

Dieses Beispiel finden Sie unter <Beispielpfad>\BAM\BamFromExpression.

In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck aufgelistet.

Datei BESCHREIBUNG
BamDefinition.xls BAM-Definitions-Stylesheet.
BamDefinition.xml BAM-Definition.
BamFromExpression.btproj Visual Studio-Nachverfolgungsdateiprojekt.
BamFromExpression.sln Visual Studio-Projektmappe.
Cleanup.bat Batchdatei für das Zurücknehmen der Bereitstellung des Beispiels
InputMessage.xml Eingabenachricht
Orchestration1.odx Orchestrierung.
PoSchema.xsd Bestellungsschema
PropertySchema.xsd Eigenschaftsschema.
Setup.bat Batchdatei für das Kompilieren und Bereitstellen des Beispiels
QueryBam.sql SQL-Skript

Erstellen des Nachverfolgungsprofils

  1. Öffnen Sie eine Eingabeaufforderung als Administrator, und führen Sie Beispielpfad>\BAM\BAMFromExpression\Setup.bat aus<. Setup.bat initialisiert die BAM-Infrastruktur für dieses Beispiel und stellt die BAM-Aktivität bereit.

  2. Klicken Siein Ihren Microsoft BizTalk Server-Programme> mit der rechten Maustaste auf Überwachungsprofil-Editor, und klicken Sie dann als Administrator ausführen.

  3. Klicken Sie im linken Bereich des Fensters Nachverfolgungsprofil-Editor auf Klicken Sie hier, um eine BAM-Aktivitätsdefinition zu importieren.

  4. Wählen Sie im Abschnitt BAM-Aktivitätsdefinitionsname des Dialogfelds BAM-Aktivitätsdefinition importierendie Option FromExpressionPo aus, und klicken Sie dann auf OK.

  5. Klicken Sie im rechten Bereich des Fensters Überwachungsprofil-Editor auf Klicken Sie hier, um eine Ereignisquelle auszuwählen.

  6. Wählen Sie im Abschnitt Assemblyname des Dialogfelds Übergeordnete Assembly für Ereignisquelle auswählendie Option Microsoft.Samples.BizTalk.BamFromExpression aus, und klicken Sie dann auf Weiter.

  7. Wählen Sie im Abschnitt Orchestrierungsname des Dialogfelds Orchestrierung auswählendie Option BamFromExpression.Orchestration1 aus, und klicken Sie dann auf OK.

  8. Klicken Sie mit der rechten Maustaste auf das shape Receive_1 , und klicken Sie dann auf Nachrichtennutzlastschema.

  9. Erweitern Sie <Schema>, erweitern Sie PurchaseOrder, erweitern Sie Von, und ziehen Sie dann PoID im rechten Bereich zu ActivityID im linken Bereich.

  10. Ziehen Sie die folgenden Elemente aus dem rechten Bereich in den linken Bereich, und legen Sie sie auf den angegebenen Knoten ab:

    From Beschreibung
    Name From
    State State
    City City
    Phone Phone
    Gesamt PoTotal
  11. Klicken Sie auf das Ordnersymbol mit dem Pfeil (Schaltfläche mit Ordner und Pfeil nach oben), um die Orchestrierung anzuzeigen.

  12. Ziehen Sie die Receive_1 Form im rechten Bereich auf Empfangen im linken Bereich.

  13. Ziehen Sie die Send_1 Form im rechten Bereich auf Senden im linken Bereich.

  14. Speichern Sie das Nachverfolgungsprofil unter <Samples Path>\BAM\BamFromExpression\ BamFromExpression.btt.

  15. Klicken Sie im Menü Extras auf Nachverfolgungsprofil anwenden.

Erstellen und Initialisieren dieses Beispiels

Stellen Sie das Überwachungsprofil BamFromExpression.btt bereit. Weitere Informationen finden Sie unter Bereitstellen von Nachverfolgungsprofilen mit dem Verwaltungsprogramm für Nachverfolgungsprofile.

Dieses Beispiel ausführen

Kopieren Sie die Datei <Beispielpfad>\BamFromExpression\InputMessage.xml zu <Beispielpfad>\BamFromExpression\Input.

In etwa 10 Sekunden wird die Ausgabemeldung unter <Beispielpfad>\BamFromExpression\Output angezeigt.

Anzeigen der BAM-Daten

  1. Öffnen Sie SQL Server Management Studio.

  2. Erweitern Sie in SQL Server Management Studio den Server, datenbanken, BAMPrimaryImport und tabellen.

  3. Klicken Sie mit der rechten Maustaste auf dbo.bam_FromExpressionPo_Completed, und klicken Sie dann auf Tabelle öffnen. Wenn Sie SQL Server verwenden, klicken Sie auf Top 1000 Zeilen auswählen.

    Der Inhalt der Tabelle bam_FromExpressionPo_Completed wird im rechten Bereich angezeigt. Die eine Zeile mit der Aktivitäts-ID 123 stellt die Bestellung über 345 $ dar, die in der Eingabenachricht enthalten war.

  4. Klicken Sie mit der rechten Maustaste auf dbo.bam_FromExpressionPoItem_Completed, und klicken Sie dann auf Tabelle öffnen. Wenn Sie SQL Server verwenden, klicken Sie auf Top 1000 Zeilen auswählen.

    Der Inhalt der Tabelle bam_FromExpressionPoItem_Completed wird im rechten Bereich angezeigt. Die beiden Zeilen mit den Aktivitäts-IDs 123_0 und 123_1 stellen die Elemente in der Bestellung dar: Flash MC und Infrarot-Decoder.

  5. Klicken Sie mit der rechten Maustaste auf dbo.bam_FromExpressionPoItem_CompletedRelationships, und klicken Sie dann auf Tabelle öffnen. Wenn Sie SQL Server verwenden, klicken Sie auf Top 1000 Zeilen auswählen.

    Der Inhalt der Tabelle bam_FromExpressionPoItem_CompletedRelationships wird im rechten Bereich angezeigt. Jede Zeile in der Tabelle stellt eine Beziehung zwischen einer FromExpressionPoItem-Aktivität und einer FromExpressionPo-Aktivität dar. Der Wert in der Spalte ActivityID verweist auf die Aktivitäts-ID der FromExpressionPoItem-Aktivität. Der Wert in der Spalte ReferenceData verweist auf die Aktivitäts-ID der FromExpressionPo-Aktivität. In diesem Fall geben die beiden Datensätze an, dass die Artikel Flash MC und Infrared Decoder der Bestellung über 345 $ zugeordnet sind.

Erneutes Ausführen des Beispiels

  1. Öffnen Sie eine Eingabeaufforderung als Administrator, und führen Sie Beispielpfad>\BAM\BamFromExpression\Cleanup.bat aus<, um das Nachverfolgungsprofil und andere BAM-Infrastruktur zu entfernen.

  2. Führen Sie <beispielpfad>\BAM\BamFromExpression\Setup.bat aus, um das Beispiel zu kompilieren und bereitzustellen.

Weitere Informationen

Geschäftsaktivitätsüberwachung (BAM) (Ordner für BizTalk Server-Beispiele)
Aktivitätsbeziehungen