メッセージ・インスタンスおよびスキーマから作成されるルールの例

ビジネス・ルールとそのパラメーターはスキーマによって異なります。

以下の例は、着信メッセージおよび XML スキーマと、ビジネス・ルールに渡されるパラメーターとの関係を示しています。この例には、ルールがメッセージ・データに適用されるビジネス・ロジックも示されています。

以下のスキーマ例をご覧ください。
<?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>
以下の入力メッセージでは上記のスキーマを使用します。
<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>
メッセージ・インスタンスの <items> エレメントには、反復エレメント <nextitem> が含まれています。その反復構造内のエレメント (フィールド「price」の値など) を変更するために記述されるルールでは、反復エレメントにアクセスできるビジネス・ルール構成を使用する必要があります。以下の例に示されているように、「if...then」条件で「for each」構成を使用して、反復エレメントにアクセスすることができます。
if <condition met> then
for each <object> [called <variable>,] in <list>:
  - <action>;*
この例では、「object」は現行オブジェクト (この場合、反復エレメント) であり、「list」は反復エレメントの親になります。
この例に、ルート・エレメント・タイプ「purchaseType」である 1 つの入力パラメーター (デフォルトの言語化は「parameter」) が含まれている場合、次のように、各反復エレメントの price を変更するルールを記述できます。
if the company of parameter contains "the" then
for each sale in the items of parameter : 
  - set the price of this sale to 99; 
(ビジネス・ルールの作成時に使用される Business Action Language (BAL) の詳しいリファレンス・ガイドについては、IBM® Operational Decision Manager バージョン 8.5 インフォメーション・センター・オンラインを参照してください。)
この例では、メッセージ・ルート・タイプの入力パラメーターが 1 つ提供されています。このルールにはメッセージの 2 つの部分 (会社名および各発注品の価格) が使用されています。したがって、メッセージ全体である 1 つのパラメーターを渡す代わりに、以下の 2 つのパラメーターを渡すことができます。 ルールは、以下の例に示されているように構成することができます。
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;  
この例には、複合タイプではなく、パラメーターとして単純タイプを渡す方法も示されています。DecisionService ノードのパラメーター表の「データのロケーション」フィールドで、パラメーターごとに以下の XPath 式を追加します。

単一のパラメーターと複数のパラメーターのどちらを渡すかは、ある程度メッセージのサイズによって決まります。ビジネス・ルールはスキーマに基づいているため、パラメーターは XML インスタンス文書として形成されてから、評価のためにルールに渡されます。 パラメーターが、大きなコンテンツを含める複合タイプとして定義されている場合、このコンテンツはシリアライズされ、ルールでの評価のために再度解析されます。ルールでコンテンツの一部のみを評価する際に、パラメーターのターゲットが特定のネスト構造である場合は、パフォーマンスとメモリー使用量を改善できます。

また、ネストした構造に対する変更は、親構造の変更によって上書きされることがある点も考慮してください。したがって、データ・ロケーション XPath 式を追加する場合、メッセージ・ツリーの親フィールドとネストした子フィールドにアクセスしないようにしてください。

ビジネス・ルールを作成する場合は、ルールを適用するビジネス・オブジェクトを考慮します。したがって、顧客オーダーを記述するスキーマがある場合は、オーダーの個々のコンポーネント (顧客オーダーや発注品など) ではなく、オーダーのオーダー・タイプを渡します。ただし、メッセージ・サイズも考慮する必要があります。メッセージが大きい場合は、メッセージ全体ではなく、メッセージのごく一部を定義するタイプを渡して、処理時間が短くなるように試みてください。

XML フォーマット

ルールの各パラメーターについて、DecisionService ノードは、評価のためにルールに渡される XML インスタンス文書を作成します。ルールがすべて評価されると、DecisionService ノードは各パラメーターの XML 文書を再度受け取ります。次に、DecisionService ノードは各パラメーターの XML を解析し、出力メッセージ・ツリーにデータを取り込んで、ルール・セットに渡された既存の XML 構造を置き換えます。ただし、XML 構造のうち、フォーマットとして分類されている部分は保持されません。したがって、DecisionService ノードが、決定サービス・パラメーターの取得元である XML メッセージを処理すると、XML スキーマに関連のないフォーマットとコンテンツが失われる可能性があります。

以下の構造について考えてみます。
Person:
 - FirstName
 - Surname
 - DateofBirth
 - Address
 - AdditionalInfo
この XML 構造を処理する決定サービスを作成する場合、「Person」という 1 つのパラメーターを渡してから、このパラメーターのフィールドを使用することができます。あるいは、「FirstName」、「Surname」、「DateofBirth」、「Address」および「AdditionalInfo」の 5 つのパラメーターを渡すこともできます。
次のような書式の XML メッセージが予想されます。
<Person>
 <!-- The following is the name of the person -->
 <FirstName>John</FirsName>
 <!-- The following is the surname of the person -->
 <Surname>Smith</Surname>
 <!-- The following is the date of birth in the form dd/mm/yyyy -->
 <DateofBirth>01/01/1970</DateofBirth>
 <!-- The following is the address of the person -->
 <Address>123 High Street, London</Address>
 <AdditionalInfo></AdditionalInfo>
</Person> 
この場合、単一のパラメーターとして「Person」を渡すと、タグの間のコメントと余分な空白が失われます。コメントを保持する場合は、5 つの子パラメーターを渡してください。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2013-07-17 15:20:11


概念トピック概念トピック | IBM Integration Bus バージョン 9.0.0.0 | bc23820_