Beispiele für Regeln - erstellt auf Grundlage einer Nachrichteninstanz oder eines Schemas

Geschäftsregeln und deren Parameter sind von einem Schema abhängig.

Das folgende Beispiel zeigt, in welchem Zusammenhang die eingehende Nachricht und das XML-Schema zu den Parametern stehen, die an die Geschäftsregeln übergegeben werden. Außerdem veranschaulicht das Beispiel die Geschäftslogik, die von den Regeln auf die Nachrichtendaten angewendet wird.

Der folgende Abschnitt ein Schema als Beispiel.
<?xml version="1.0" encoding="UTF-8"?><xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="purchase" type="purchseType"/>
  <xsd:complexType name="purchaseType">
    <xsd:sequence>
      <xsd:element name="items" type="orderType"/>
      <xsd:element name="company" type="xsd:string"/>
    </xsd:sequence>
  </xsd:complexType>

  <xsd:complexType name="orderType">
    <xsd:sequence>
      <xsd:element maxOccurs="unbounded" minOccurs="1" name="nextitem" type="sale"/>
    </xsd:sequence>
  </xsd:complexType>

  <xsd:complexType name="sale">
    <xsd:sequence>
      <xsd:element name="title" type="xsd:string"/>
      <xsd:element name="price" type="xsd:decimal"/>
      <xsd:element name="quantity" type="xsd:integer"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>
Die folgende Eingabenachricht verwendet das zuvor genannte Schema.
<purchase xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="simple.xsd">
  <items>
    <nextitem>
      <title>one</title>
      <price>1.0</price)
      <quantity>1</quantity>
    </nextitem>
    <nextitem>
      <title>two</title>
      <price>2.0</price>
      <quantity>2</quantity>
    </nextitem>
  </items>
  <company>the company</company>
</purchase>
Das Element <items> in der Nachrichteninstanz enthält das sich wiederholende Element <nextitem>. Beim Erstellen einer Regel, mit der ein Element in dieser sich wiederholenden Struktur geändert werden soll (z. B. der Wert im Feld "price"), muss eine Geschäftsregelanweisung verwendet werden, die den Zugriff auf ein sich wiederholendes Element erlaubt. Sie können dabei die Anweisung "for each" mit der Bedingung "if...then" für den Zugriff auf das sich wiederholende Element verwenden, wie im folgenden Beispiel dargestellt ist:
if <condition met> then
for each <object> [called <variable>,] in <list>:
  - <action>;*
In diesem Beispiel ist "object" das aktuelle Objekt (in diesem Fall das sich wiederholende Element) und "list" das übergeordnete Element des sich wiederholenden Elements.
Wenn dieses Beispiel einen Eingabeparameter (mit der Standardverbalisierung "parameter") enthält, der den Stammelementtyp "purchaseType" hat, dann kann eine Regel erstellt werden, mit der der Preis eines jeden sich wiederholenden Elements geändert wird:
if the company of parameter contains "the" then
for each sale in the items of parameter : 
  - set the price of this sale to 99; 
(Ein detailliertes Referenzhandbuch zur Business Action Language (BAL), die zum Erstellen von Geschäftsregeln verwendet wird, finden Sie im IBM® Operational Decision Manager Version 8.5 Information Center online.
In diesem Beispiel wird ein Eingabeparameter angegeben, der den Nachrichtenstammtyp hat. Zwei Teile der Nachricht werden in dieser Regel verwendet: der Name des Unternehmens und der Preis jedes Artikels, der bestellt wird. Anstatt nur einen Parameter zu übergeben, der der gesamten Nachricht entspricht, können Sie auch zwei Parameter übergeben: Die Regel kann dann wie in folgendem Beispiel erstellt werden.
if 'the name of the company' contains "the" then
for each sale in the nextitems of parameter : 
  - set the price of this sale to 55;  
Dieses Beispiel zeigt auch, wie als Parameter ein einfacher Typ anstelle eines komplexen Typs übergeben werden kann. Im Feld Data location (Datenposition) für den DecisionService-Knoten können Sie folgende XPath-Ausdrücke für die jeweiligen Parameter hinzufügen:

Die Entscheidung, ob ein einzelner Parameter oder mehrere Parameter übergeben werden sollen, hängt zum Teil von der Größe der Nachricht ab. Da Geschäftsregeln auf einem Schema basieren, werden die Parameter als XML-Instanzdokumente erstellt und dann zur Auswertung an die Regeln übergeben. Wenn ein Parameter als komplexer Typ definiert ist, der einen großen Inhalt umfassen kann, wird der Inhalt serialisiert und für die Regelauswertung erneut geparst. Wenn die Regeln nur einen Teil des Inhalts auswerten, können Leistung und Speicherbelegung dadurch verbessert werden, dass die Parameter nur für die bestimmten verschachtelten Strukturen ausgelegt werden.

Denken Sie auch daran, dass eine Änderung an einer verschachtelten Struktur durch eine Änderung an der übergeordneten Struktur überschrieben werden kann. Wenn Sie XPath-Ausdrücke für die Datenposition hinzufügen, sollten Sie daher nicht auf verschachtelte über- und untergeordnete Felder in einer Nachrichtenbaumstruktur zugreifen.

Beim Erstellen von Geschäftsregeln sollten die Geschäftsobjekte, auf die die Regeln angewendet werden sollen, berücksichtigt werden. Wenn Sie also ein Schema haben, das einen Kundenauftrag beschreibt, sollte der Auftragstyp und nicht die einzelnen Komponenten des Auftrags (z. B. der Kundenauftrag und die bestellten Artikel) übergeben werden. Die Nachrichtengröße muss jedoch auch berücksichtigt werden. Bei einer umfangreichen Nachricht kann die Verarbeitungszeit eventuell dadurch verringert werden, dass Typen übergeben werden, die nur einen kleinen Teil der Nachricht und nicht die ganze Nachricht definieren.

XML-Formatierung

Der DecisionService-Knoten erstellt für jeden Parameter in einer Regel ein XML-Instanzdokument, das zur Auswertung an die Regeln übergeben wird. Wenn alle Regeln ausgewertet sind, erhält der DecisionService-Knoten die XML-Dokumente für jeden Parameter zurück. Anschließend führt der DecisionService-Knoten das Parsing des XML-Codes für jeden Parameter durch und füllt damit die Ausgabenachrichtenbaumstruktur, wobei die vorhandene XML-Struktur, die an den Regelsatz übergeben wurde, ersetzt wird. Die als Formatierung klassifizierten Teile der XML-Struktur werden jedoch nicht beibehalten. Wenn der DecisionService-Knoten also eine XML-Nachricht verarbeitet, die ursprünglich Entscheidungsserviceparameter enthält, gehen die Teile von Formatierung und Inhalt, die nicht zum XML-Schema gehören, verloren.

Betrachten Sie die folgende Struktur:
Person:
 - FirstName
 - Surname
 - DateofBirth
 - Adresse
 - AdditionalInfo
Wenn Sie einen Entscheidungsservice auf Grundlage dieser XML-Struktur erstellen möchten, können Sie "Person" als einzigen Parameter übergeben und dann die Felder für diesen Parameter verwenden. Alternativ dazu können Sie auch insgesamt fünf Parameter übergeben: "FirstName", "Surname", "DateofBirth", "Address" und "AdditionalInfo".
Sie erhalten dann XML-Nachrichten der folgenden Art:
<Person>
 <!-- Die folgende Angabe ist der Vorname der Person -->
 <FirstName>John</FirsName>
 <!-- Die folgende Angabe ist der Nachname der Person -->
 <Surname>Smith</Surname>
 <!-- Die folgende Angabe ist der Geburtstag im Format TT/MM/JJJJ -->
 <DateofBirth>01/01/1970</DateofBirth>
 <!-- Die folgende Angabe ist die Adresse der Person -->
 <Address>123 High Street, London</Address>
 <AdditionalInfo></AdditionalInfo>
</Person> 
Wenn Sie bei diesem Beispiel nur "Person" als einzigen Parameter übergeben, gehen die Kommentare und zusätzlichen Leerzeichen zwischen den Tags verloren. Wenn die Kommentare beibehalten werden sollen, müssen Sie stattdessen alle fünf untergeordneten Parameter übergeben.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-07-18 03:07:15


KonzeptthemaKonzeptthema | IBM Integration Bus Version 9.0.0.0 | bc23820_