Schritt 6: Konfigurieren einer unidirektionalen XML-Brücke

Letzte Aktualisierung: August 2015

Dieses Thema enthält Anweisungen zum Konfigurieren einer unidirektionale XML-Bridge. Als Teil der unidirektionale XML-Bridge-Konfiguration führen Sie die folgenden Schritte aus:

  • Konfigurieren der Bridge für die Verarbeitung der Flatfilenachricht des Typs, den Sie zuvor erstellt haben.

  • Extrahieren des Werts der Datensätze OrderId (vor der Nachrichtentransformation) und TotalAmount (nach der Nachrichtentransformation) mithilfe höher gestufter Eigenschaften. Die Werte für diese beiden Datensätze werden während der Verarbeitung der Nachricht durch die Bridge nachverfolgt.

  • Konfigurieren der Bridge für die Verwendung der zuvor erstellten Transformation Map.trfm.

  • Konfigurieren der Bridge zum Nachverfolgen der von ihr verarbeiteten Nachrichten.

  1. Ziehen Sie eine unidirektionale XML-Bridge mithilfe von Drag & Drop aus der Toolbox auf den Entwurfsbereich der Bridgekonfiguration. Geben Sie für die Eigenschaften "Entitätsname" und "Relative Adresse" der Brücke den Wert ProcessOrders ein.

  2. Doppelklicken Sie im Routen-Designer auf die unidirektionale XML-Bridge.

  3. Klicken Sie im unidirektionale XML-Bridge-Entwurfsbereich im Feld Nachrichtentypen auf das Symbol "Hinzufügen" [ Symbol "Hinzufügen" ], um das Dialogfeld Nachrichtentypauswahl zu öffnen.

  4. Klicken Sie im Dialogfeld Nachrichtentypauswahl im Feld Verfügbare Nachrichtentypen auf den Nachrichtentyp PurchaseOrder dann auf den Nach-Rechts-Pfeil [ Symbol "Pfeil" ], um das Anforderungsschema unidirektionale XML-Bridge zuzuordnen. Klicken Sie dann auf OK. Das ausgewählte Schema wird jetzt unter dem Abschnitt Anforderungsnachrichtentyp aufgeführt.

  5. Konfigurieren Sie die Enrich-Vortransformationsphase, um den Wert des Elements OrderId im Quellschema zu extrahieren.

    1. Wählen Sie in der Enrich-Phase die Aktivität Enrich aus, und wählen Sie dann im Bereich Eigenschaften die Schaltfläche mit den Auslassungszeichen (…) für die Eigenschaft Eigenschaften aus, um das Dialogfeld Eigenschaftendefinition zu öffnen.

    2. Wählen Sie in EigenschaftendefinitionenHinzufügen aus, um das Dialogfeld Eigenschaft hinzufügen zu öffnen. Gehen Sie im Dialogfeld Eigenschaft hinzufügen wie folgt vor:

       

      Abschnitt Feldname Beschreibung

      Quelle (Lesen von)

      Typ

      Wählen Sie XPath aus der Dropdownliste aus.

      Bezeichner

      Geben Sie die XPath-Abfrage zum Extrahieren des Werts von OrderId aus dem Anforderungsschema an.

      TipTipp
      Sie können die XPath-Abfrage aus dem Schema-Editor abrufen. Wählen Sie das Element OrderId im Schema-Editor aus, und suchen Sie im Eigenschaftenfenster nach dem Wert der Eigenschaft Instanz-XPath. Dies sollte die XPath-Abfrage für den Knoten sein.

      Nachrichtentyp

      Wählen Sie das Schema für PurchaseOrder aus.

      Eigenschaft (Schreiben in)

      Eigenschaftsname

      Gibt den Namen der Eigenschaft an, die Sie definieren. Geben Sie für dieses Lernprogramm OrderId an.

      Datentyp

      Gibt den Datentyp für die Eigenschaft an. Geben Sie für dieses Lernprogramm string an.

    3. Wählen Sie im Dialogfeld Eigenschaft hinzufügenOK aus, und wählen Sie dann im Dialogfeld EigenschaftendefinitionOK aus.

  6. Konfigurieren Sie die Bridge für die Verwendung der zuvor erstellten Transformation. Wählen Sie in der Transformation-Phase die Aktivität XML-Transformation aus, und wählen Sie dann im Fenster Eigenschaften die Schaltfläche mit den Auslassungszeichen (…) für die Eigenschaft Zuordnungen aus, um das Dialogfeld Auswahl zuordnen zu öffnen.

    Wählen Sie aus der Liste der Transformationen, die im Dialogfeld angezeigt wird, Map.trfm aus. Sie haben diese Transformation in den vorherigen Schritten erstellt.

  7. Konfigurieren Sie die Enrich-Nachtransformationsphase, um den Wert des Elements TotalAmount im Quellschema zu extrahieren.

    1. Wählen Sie in der Enrich-Phase die Aktivität Enrich aus, und wählen Sie dann im Bereich Eigenschaften die Schaltfläche mit den Auslassungszeichen (…) für die Eigenschaft Eigenschaften aus, um das Dialogfeld Eigenschaftendefinition zu öffnen.

    2. Wählen Sie im Dialogfeld EigenschaftendefinitionenHinzufügen aus, um das Dialogfeld Eigenschaft hinzufügen zu öffnen. Gehen Sie im Dialogfeld Eigenschaft hinzufügen wie folgt vor:

       

      Abschnitt Feldname Beschreibung

      Quelle (Lesen von)

      Typ

      Wählen Sie XPath aus der Dropdownliste aus.

      Bezeichner

      Geben Sie die XPath-Abfrage zum Extrahieren des Werts von TotalAmount aus dem Anforderungsschema an.

      Nachrichtentyp

      Wählen Sie das Schema für Insert aus.

      Eigenschaft (Schreiben in)

      Eigenschaftsname

      Gibt den Namen der Eigenschaft an, die Sie definieren. Geben Sie für dieses Lernprogramm TotalAmount an.

      Datentyp

      Gibt den Datentyp für die Eigenschaft an. Geben Sie long an.

    3. Wählen Sie im Dialogfeld Eigenschaft hinzufügenOK aus, und wählen Sie dann im Dialogfeld EigenschaftendefinitionOK aus.

    4. Speichern Sie die Änderungen am Projekt.

  8. Konfigurieren Sie die Bridge zum Nachverfolgen von Nachrichteneigenschaften und anderen Daten für die Eigenschaften OrderId und TotalAmount, die Sie soeben höher gestuft haben.

    1. Kehren Sie zur Datei "MessageFlowItinerary.bcs" zurück, wählen Sie die unidirektionale XML-Bridge aus, und wählen Sie dann im Eigenschaftenfenster die Auslassungszeichen (...) für Eigenschaften nachverfolgen aus.

    2. Aktivieren Sie das Kontrollkästchen Nachrichtenverarbeitungsereignisse nachverfolgen, um Detailinformationen nachzuverfolgen, z. B. wann eine Phase gestartet, abgeschlossen oder mit Fehlern beendet wird, wann eine Aktivität in einer Phase gestartet, abgeschlossen oder mit Fehlern beendet wird, ob ein Artefakt abgerufen wird usw.

    3. Optional. Aktivieren Sie das Kontrollkästchen Alle Nachrichteneigenschaften nachverfolgen, und wählen Sie dann die Eigenschaften aus, die nachverfolgt werden sollen. Beachten Sie, dass das Dialogfeld alle Eigenschaften auflistet, die Sie in einer der Enrich-Phasen in einer Bridge höher gestuft haben.

      Wählen Sie für dieses Lernprogramm OrderId und TotalAmount aus.

    4. Wählen Sie OK.

  9. Speichern Sie die Konfiguration der Bridge, und kehren Sie zur Entwurfsoberfläche der Bridgekonfiguration zurück.

  10. Verbinden Sie die FTP-Quellkomponente mit der unidirektionale XML-Bridge und die Bridge mit der LOB-Relay-Entität.

  11. Legen Sie die Filterbedingung für den Connector zwischen der Bridge und der LOB-Relay-Entität fest.

    1. Wählen Sie den Connector zwischen der unidirektionale XML-Bridge und der LOB-Relay-Entität aus.

    2. Wählen Sie im Eigenschaftenfenster die Schaltfläche mit den Auslassungszeichen (…) für Filterbedingung aus.

    3. Legen Sie im Dialogfeld Routenfilterkonfiguration die Filterbedingung auf Alle vergleichen fest.

    4. Wählen Sie OK.

  12. Legen Sie die Weiterleitungsaktion fest, damit die ausgehende Nachricht an die Branchenanwendung über einen SOAP-Action-Header verfügt.

    1. Öffnen Sie Server-Explorer, und navigieren Sie zum zuvor erstellten SQL Server-LOB-Relay. Klicken Sie mit der rechten Maustaste auf das Relay, wählen Sie Eigenschaften aus, und kopieren Sie für die Eigenschaft Vorgänge den Wert des ersten Vorgangs.

    2. Klicken Sie im Entwurfsbereich der Bridgekonfiguration auf den Connector zwischen der unidirektionale XML-Bridge und der LOB-Relay-Entität.

    3. Wählen Sie in Eigenschaften die Schaltfläche mit den Auslassungszeichen (…) für Weiterleitungsaktion aus. Wählen Sie in Weiterleitungsaktionen den Befehl Hinzufügen aus, um das Dialogfeld Weiterleitungsaktion hinzufügen zu öffnen. Gehen Sie im Dialogfeld Weiterleitungsaktion hinzufügen wie folgt vor:

    4. Wählen Sie im Abschnitt Eigenschaft (Lesen von) die Option Ausdruck aus, und fügen Sie dann den Wert ein, den Sie kopiert haben.

      ImportantWichtig
      Sie müssen den Wert für einen Ausdruck immer in einfachen Anführungszeichen angeben.

    5. Legen Sie im Abschnitt Ziel (Schreiben in) den Typ auf SOAP und den Bezeichner auf Action fest.

      ImportantWichtig
      Sie müssen den Wert für einen Ausdruck immer in einfachen Anführungszeichen angeben.

    6. Wählen Sie im Dialogfeld Weiterleitungsaktion hinzufügenOK aus, um die Weiterleitungsaktion hinzuzufügen. Wählen Sie im Dialogfeld WeiterleitungsaktionenOK aus, und wählen Sie dann Speichern aus, um die Änderungen in einem BizTalk Service-Projekt zu speichern.

Siehe auch

Anzeigen: