Freigeben über

Definieren einer Geschäftsregel für eine private Prozessorchestrierung

  • Artikel

Sie können eine Geschäftsregel für die Verwendung in einem privaten Bestätigungsprozess definieren. Dadurch können Sie die Geschäftsregel dynamisch ändern, ohne die Orchestrierung privater Prozesse zu beenden. Bei diesem Prozess wird die Business Rule Engine von Microsoft® BizTalk Accelerator for RosettaNet (BTARN) verwendet. Dieser Vorgang umfasst die folgenden Schritte:

  1. Hinzufügen eines neuen Vokabulars. Dies umfasst die Definition von mindestens einem Wert der Vokabularkonstante. Dadurch wird ein Geschäftsregelschwellenwert festgelegt. Es umfasst auch das Definieren von XML-Dokumenten Get und Set -Elementen. Dadurch wird festgelegt, wie Microsoft BTARN den Schwellenwert verwendet.

  2. Hinzufügen einer neuen Richtlinie. Dies umfasst das Erstellen einer Richtlinie, das Erstellen einer Reihe von Regeln und das anschließende Speichern, Veröffentlichen und Bereitstellen der Richtlinie.

  3. Aufrufen der Geschäftsregel aus der Orchestrierung des privaten Prozesses. Dazu wird der Orchestrierung ein Aufrufregel-Shape hinzugefügt.

    Das BTARN SDK enthält eine BTARN-Beispiel-Geschäftsrichtlinie( samplebtarnpolicy.xml) in <drive>:\Program Files\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\PipAutomation\3A4. Weitere Informationen finden Sie unter Beispiel für eine BTARN-Geschäftsrichtlinie.

    DIE PIP3A4PrivateResponder.odx-Orchestrierung ist eine Beispielorchestrierung für private Prozesse, die veranschaulicht, wie ein partner Interface Process (PIP)-spezifischer privater Antwortprozess implementiert wird, der eine Geschäftsregel enthält. Weitere Informationen zu diesem Beispiel finden Sie unter 3A4 Private Responder Orchestrierung mithilfe einer Geschäftsregel.

    Weitere Informationen zu Vokabularen und Richtlinien finden Sie im Thema "Entwickeln mit Geschäftsregeln" in BizTalk Server.

So fügen Sie neues Vokabular hinzu

  1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf MicrosoftBizTalk Server, und klicken Sie dann auf Business Rule Composer.

  2. Wenn das Dialogfeld Regelspeicher öffnen geöffnet wird, wählen Sie die BizTalk-Regel-Engine-Datenbank aus, die Sie auf dem aktuellen Server eingerichtet haben, und klicken Sie dann auf OK.

  3. Klicken Sie in Microsoft Business Rule Composer im Bereich Fakten Explorer mit der rechten Maustaste auf Vokabular, und klicken Sie dann auf Neues Vokabular hinzufügen.

  4. Legen Sie im Bereich Eigenschaft (unten links) die Eigenschaft Name auf den Namen des entsprechenden Vokabulars fest, und drücken Sie dann die EINGABETASTE.

  5. Erweitern Sie den soeben erstellten Vokabularordner, klicken Sie mit der rechten Maustaste auf Version 1.0 (nicht gespeichert), und klicken Sie dann auf Neue Definition hinzufügen.

  6. Wählen Sie im Vokabulardefinitions-Assistenten die Option Konstanter Wert, Wertebereich oder Wertesatzaus, und klicken Sie dann auf Weiter.

  7. Geben Sie auf der Seite Konstanter Wert, Wertebereich oder Wertesatz im Feld Definitionsname den Namen des entsprechenden Werts der Vokabularkonstante ein, z. B . Maximal zulässige Menge, und klicken Sie dann auf Weiter.

  8. Geben Sie auf der Seite Konstanten Wert definieren im Feld Wertfeld den Schwellenwert ein, und klicken Sie dann auf Fertig stellen.

So definieren Sie Get- und Set-Elemente

  1. Klicken Sie in Business Rule Composer im Bereich Fakten Explorer unter dem ordner vokabular, der unter "So fügen Sie ein neues Vokabularverfahren hinzu" mit der rechten Maustaste auf Version 1.0 (nicht gespeichert) und dann auf Neue Definition hinzufügen.

  2. Wählen Sie auf der Seite Vokabulardefinitions-Assistentdie Option XML-Dokumentelement oder -Attribut aus, und klicken Sie dann auf Weiter.

  3. Geben Sie auf der Seite XML-Dokumentelement oder -Attribut im Textfeld Definitionsname einen Namen für ein Get-Element ein.

  4. Klicken Sie auf Durchsuchen, wechseln Sie zum Speicherort des Schemas, das Sie verwenden möchten, wählen Sie die Schemadatei aus, und klicken Sie dann auf Öffnen.

  5. Wenn die Seite Stammknoten auswählen geöffnet wird, wählen Sie den zu durchsuchenden Stammknoten aus.

  6. Wechseln Sie auf der Seite Bindung auswählen zu dem Feld, für das Sie den Schwellenwert definieren möchten, und klicken Sie dann auf OK.

  7. Geben Sie im Feld Dokumenttyp den Namen des Dokuments ein.

  8. Wählen Sie im Abschnitt Vorgangstyp die Option Vorgang "Get" ausführen aus.

  9. Klicken Sie auf Fertig stellen.

  10. Wiederholen Sie diese Schritte, um einen oder Set mehrere Vorgänge zu definieren. Wählen Sie Vorgang "Festlegen" für den Vorgangstyp aus.

So speichern und veröffentlichen Sie das Vokabular

  1. Klicken Sie in Business Rule Composer im Bereich Fakten Explorer unter dem von Ihnen erstellten Vokabularordner mit der rechten Maustaste auf Version 1.0 (nicht gespeichert), und klicken Sie dann auf Speichern.

  2. Klicken Sie im Bereich Fakten Explorer unter dem Ordner 3A4PurchaseOrderVocabulary mit der rechten Maustaste auf Version 1.0, und wählen Sie dann Veröffentlichen aus.

So fügen Sie eine neue Richtlinie und Regeln hinzu

  1. Klicken Sie in Business Rule Composer im Bereich Richtlinie Explorer mit der rechten Maustaste auf Richtlinien, und klicken Sie dann auf Neue Richtlinie hinzufügen.

  2. Klicken Sie auf Richtlinie1.

  3. Legen Sie im Bereich Eigenschaft die Eigenschaft Name auf den entsprechenden Richtliniennamen fest.

  4. Klicken Sie im Bereich Richtlinie Explorer unter dem Ordner für die neue Richtlinie mit der rechten Maustaste auf Version 1.0 (nicht gespeichert), und klicken Sie dann auf Neue Regel hinzufügen.

  5. Klicken Sie auf Regel1.

  6. Legen Sie im Bereich Eigenschaft die Eigenschaft Name auf den gewünschten Regelnamen fest, und drücken Sie dann die EINGABETASTE.

  7. Klicken Sie im Regelkomponisten im Bereich WENN mit der rechten Maustaste auf Bedingungen, und wählen Sie dann ggf. eine logische Bedingung aus.

  8. Erweitern Sie im Bereich Fakten Explorer unter Vokabularen die Option Prädikate, erweitern Sie Version 1.0 – Veröffentlicht, wählen Sie das gewünschte Prädikat aus, ziehen Sie es auf die Composer-Oberfläche, und legen Sie es dann unter Bedingungen oder dem logischen Operator ab.

  9. Erweitern Sie im Bereich Fakten Explorer unter dem Ordner Vokabularen das von Ihnen erstellte Vokabular, erweitern Sie Version 1.0 – Veröffentlicht, wählen Sie ein - oder Set -Element ausGet, ziehen Sie es auf die Composer-Oberfläche, und legen Sie es auf argument1 ab.

  10. Wählen Sie im Ordner vokabular ein Get - oder Set -Element aus, ziehen Sie es auf die Composer-Oberfläche, und legen Sie es auf argument2 ab.

  11. Wählen Sie im Ordner vokabular ein Set Element aus, ziehen Sie es auf die Composer-Oberfläche, und legen Sie es im Bereich THEN im Feld Aktionen ab.

  12. Wenn dem Set Element eine Variable zugeordnet ist, klicken Sie auf die Variable, nehmen Sie ggf. Änderungen vor, und drücken Sie dann die EINGABETASTE. Wiederholen Sie ggf. mit anderen Set Elementen.

So speichern und veröffentlichen Sie die Richtlinie und stellen sie bereit

  1. Wenn Sie die Definition der Regeln abgeschlossen haben, klicken Sie in Business Rule Composer im Bereich Richtlinie Explorer unter dem von Ihnen erstellten Richtlinienordner mit der rechten Maustaste auf Version 1.0 (nicht gespeichert), und klicken Sie dann auf Speichern.

  2. Klicken Sie im Bereich Richtlinie Explorer unter dem von Ihnen erstellten Richtlinienordner mit der rechten Maustaste auf Version 1.0, und klicken Sie dann auf Veröffentlichen.

  3. Klicken Sie im Bereich Richtlinie Explorer unter dem von Ihnen erstellten Richtlinienordner mit der rechten Maustaste auf Version 1.0, und klicken Sie dann auf Bereitstellen.

So rufen Sie die Geschäftsregel aus der Orchestrierung auf

  1. Starten Sie Microsoft Visual Studio 2012.

  2. Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie dann auf Projekt/Projektmappe.

  3. Suchen Sie die Lösung, die die Orchestrierung enthält, aus der Sie die Geschäftsregel aufrufen müssen, und klicken Sie dann auf Öffnen.

  4. Klicken Sie auf Ansicht, zeigen Sie auf Andere Fenster, und klicken Sie dann auf Orchestrierungsansicht.

  5. Erweitern Sie Variablen. Stellen Sie sicher, dass die Liste der Orchestrierungsvariablen eine Variable enthält, die jedem Parameter in der Geschäftsrichtlinie entspricht, den Sie aus der Orchestrierung aufrufen. Stellen Sie sicher, dass die Variable denselben Typ wie der Richtlinienparameter aufweist. Wenn die Liste keine Orchestrierungsvariable für jeden Richtlinienparameter enthält, klicken Sie mit der rechten Maustaste auf Variablen, und klicken Sie dann auf Neue Variable. Geben Sie in der Orchestrierungsansicht einen Variablennamen ein, und geben Sie dann im Eigenschaftenfenster den Typ des Parameters ein.

  6. Ziehen Sie aus der Toolbox ein Aufrufregel-Shape auf die Orchestrierungsentwurfsoberfläche, und legen Sie es dann unter der Empfangsform ab.

  7. Doppelklicken Sie auf das Shape Aufrufregeln .

  8. Wählen Sie im Feld Geschäftsrichtlinie auswählen, die Sie aufrufen möchten die Geschäftsrichtlinie aus der Dropdownliste aus.

  9. Wählen Sie für den ersten angezeigten Parameter unter Parametername einen Namen aus der Dropdownliste aus.

    Hinweis

    BTARN füllt die Liste Richtlinienparameter mit allen Parametern in der Geschäftsrichtlinie auf. Für jeden Parameter in der Liste gibt BTARN einen Wert in Parametertyp aus der Geschäftsrichtlinie ein. In der Dropdownliste, die dem Parameternamen zugeordnet ist, gibt BTARN die Namen aller Variablen aus der Variablenliste der Orchestrierung ein, die denselben Typ wie die Richtlinienparameter aufweist. Durch Auswählen einer Orchestrierungsvariablen weisen Sie diese Variable dem Richtlinienparameter zu. Sie können die Orchestrierungsvariablen in der Orchestrierungsansicht anzeigen.

  10. Wiederholen Sie Schritt 9 für alle anderen Parameter.

  11. Geben Sie im Fenster Orchestrierungsentwurf alle zusätzlichen Shapes ein, die für die Verarbeitung erforderlich sind, die der Geschäftsrichtlinie zugeordnet ist, einschließlich des Hinzufügens einer Entscheidungsform unter dem Aufrufregeln-Shape .

    Hinweis

    Ein Beispiel für die Verwendung eines Aufrufregel-Shapes in einer Orchestrierung finden Sie in der PIP3A4PrivateResponder.odx-Orchestrierung, die im BTARN SDK enthalten ist. Sie befindet sich unter <laufwerk>:\Programme\Microsoft BizTalk <Version> Accelerator for RosettaNet\SDK\PipAutomation\3A4\PR. Weitere Informationen finden Sie unter 3A4 Private Responder Orchestrierung mithilfe einer Geschäftsregel.

  12. Klicken Sie auf OK.

Weitere Informationen

Programmierhandbuch
Beispiel für eine BTARN-Geschäftsrichtlinie
Private 3A4-Antwortorchestrierung mithilfe einer Geschäftsregel