構文ルール

メッセージ・プロパティへの参照

BPL プロセス内部のアクティビティで、メッセージのプロパティを参照しなければならない場合があります。プロパティを参照するためのルールは、操作するメッセージの種類によって異なります。

• 仮想ドキュメント以外のメッセージの場合は、次のような構文を使用します。

  message.propertyname
  

  

  または

  message.propertyname.subpropertyname
  

  

  ここで、propertyname はメッセージ内のプロパティで、subpropertyname はそのプロパティのプロパティです。

• XML 仮想ドキュメント以外の仮想ドキュメントの場合は、"Ensemble 仮想ドキュメント" の “仮想プロパティ・パスに関する構文ガイド” に記載された構文を使用します。

• XML 仮想ドキュメントについては、"Ensemble XML 仮想ドキュメント開発ガイド" を参照してください。

リテラル値

値をプロパティに代入するときに、リテラル値を指定することがよくあります。リテラル値は、trace アクション内の値のような他の場所にも適している場合があります。

リテラル値は次のどちらかです。

• 数値リテラルはただの数字です。例えば、42.3 などです。

• 文字列リテラルは二重引用符で囲まれた文字列です。例えば、"ABD" などです。

  Note:

  この文字列には XML 予約文字を含めることができません。詳細は、“XML 予約文字” を参照してください。

  仮想ドキュメントの場合は、この文字列に仮想ドキュメント形式で使用されるセパレータ文字を含めることができません。“仮想ドキュメント内のセパレータ文字” と “XML 予約文字がセパレータでもある場合” を参照してください。

XML 予約文字

BPL プロセスは XML ドキュメントとして保存されるため、XML 予約文字の代わりに XML エンティティを使用する必要があります。

この文字を含めるには...	次の XML エンティティを使用します...
>	>
<	&lt;
&	&amp;
'	&apos;
"	&quot;

例えば、値の Joe’s "Good Time" Bar & Grill をプロパティに代入するには、[値] を次のように設定します。

"Joe's "Good Time" Bar & Grill"

Ensemble では、エディタに入力されたテキストの周りに自動的に CData ブロックが配置されるため、この制限は <code> アクティビティと <sql> アクティビティの内部に適用されません(XML 標準では、CData ブロックの間に XML と解釈すべきではないテキストが入ります。そのため、そのブロックに予約文字を含めることができます)。

有効な式

値をプロパティに代入するときに、BPL プロセス用に選択した言語で式を指定できます。式は、<if> アクティビティの条件、<trace> アクティビティ内の値、<code> アクティビティ内の文などの他の場所でも使用します。

有効なすべての式を以下に示します。

• 前節 で説明したリテラル値。

• 関数コール (Ensemble はビジネス・ルールやデータ変換で使用するための一連のユーティリティ関数を提供しています。詳細は、"ビジネス・ルールの開発" の “Ensemble ユーティリティ関数” を参照してください)。

• “プロパティへの参照” で説明したプロパティへの参照。

• BPL プロセス用に選択したスクリプティング言語の構文を使用してこれらを組み合わせた式。以下に留意してください。

  • ObjectScript の場合、連結演算子は、以下のように _ (アンダースコア) 文字です。

    value='"prefix"_source.{MSH:ReceivingApplication}_"suffix"'

    Basic では、連結演算子は & (アンパサンド) です。

  • $CHAR や $PIECE などの便利な ObjectScript 文字列関数については、"Caché ObjectScript リファレンス" を参照してください。Basic の同等な関数は、"Caché Basic リファレンス" を参照してください。

  • 概要は、"Caché ObjectScript の使用法" または "Caché Basic の使用法" を参照してください。

間接指定

Ensemble では、以下に示す BPL 要素と属性の組み合わせについてのみ、値を間接的に指定できます。

• <call name=

• <call target=

• <sync calls=

• <transform class=

アット・マーク記号 @ は間接演算子です。

例えば、<call> 要素では、name 属性または target 属性の値を間接指定できます。name　は呼び出しを識別し、その後、<sync> 要素で参照できます。target は、要求の送信先であるビジネス・オペレーションまたはビジネス・プロセスの構成名です。どちらの文字列もリテラル値にすることができます。

<call name="Call" target="MyApp.MyOperation" async="1"> 

また、次のように @ 間接演算子を使用して、適切な文字列を含むコンテキスト変数の値にアクセスすることもできます。

<call name="@context.nextCallName" target="@context.nextBusinessHost" async="1"> 

このドキュメントでは、@ 間接構文をサポートしている各要素 (<call>、<sync>、<transform>) で、この構文について説明しています。