表現文法
式は値を計算する方法の説明です。 関数を呼び出したり、フィールドへの参照にしたり、リテラルにしたりできます。 式は、間に演算子を入れて、1 つ以上のこれらの要素で構成することもできます。
式は、ビジネス ルール、保存された検索、クイック アクション定義、リスト フィルター、フォーム コントロールの表示ルールなど、 サービス マネージャ全体のさまざまな場所で使用されます。
ほとんどの式は単に値を計算します。 ただし、組み込み関数のいくつかは、値を計算する以上の処理を実行します。 値を返す以外の方法でアプリケーションに影響を与えます。 たとえば、 Prompt 関数はユーザーに入力を促し、 GetNext Counter 関数はカウンターの値を返すだけでなく、カウンターを増分します。
サブ式は、値を計算する式内の式ですが、コンテキストが異なり、複数回評価される場合もあります。 現在、部分式は特定の組み込み関数に引数としてのみ渡すことができます。 ChildFold、 FindAncestor、 ForEachChild、 IfAllSiblings、 IsTrueForAllChildren、 Prompt、および PromptAndExecuteAction は、部分式を使用する唯一の組み込み関数です。
部分式の例は次のとおりです。
$(FindAncestor("Frs_CompositeContract_Entity", "ServiceAgreement", EntityLink_RecID,"$((ServiceLink == [OtherObject]Service_Valid) && (Status == \"Published\"))"))サブ式は "$((ServiceLinkで始まります。
部分式を呼び出す方法は 2 つあります。「古い」方法では、部分式全体を二重引用符で囲んだ文字列として入力し、「新しい」方法では、二重引用符なしで入力します。 (新しい方法を使用する場合は、文字列内の引用符をエスケープするためにバックスラッシュを使用する必要はありません。)
この例では、関数は祖先を検索し、見つかった祖先ごとにサブ式を評価し、評価するたびに異なるサブコンテキストを持ちます。 サブ式内のフィールド参照は、サブ式の外部のフィールド参照と同じオブジェクトを参照しません。
外側のレベルでは、次のように、式、関数、またはフィールド参照を括弧付きのドル記号で囲みます。
$( )$( は式の最も外側の部分としてのみ出現することができ、部分式を除き、式自体内のどこにも出現してはなりません。 式内の他の場所に $( と入力すると、パーサーは式を正しく解釈できず、式全体を通常のテキストリテラルであるかのように誤って解釈します。
場合によっては、パーサーは $()を使用せずに単純な値を表現できます。 例としては、「Active」などの単純なテキストリテラル値の表現が挙げられます。
現時点では、 サービス マネージャ では式にコメントを追加することはできません。
トップレベルでは、式またはスタンドアロンのリテラルのいずれかを入力します。
保存された式は、 サービス マネージャ がシステム全体で再利用するために維持する式です。 保存された式をビジネス オブジェクトに関連付けることも、保存された式を関連付けないままにすることもできます。 保存された式の詳細については、「 保存された式について」を参照してください。
- 保存された式は、 式エディタ ツールボックスにリストされています。 保存した式をツールボックスからエディターにドラッグするか、保存した式の名前を入力し始めると、一致する式が自動的に入力されます。
いずれかの方法で選択した保存された式に、外側の $() 構文を手動で追加する必要があります。
- 保存された式を呼び出すための構文は、コンテキストに応じて異なる場合があります。 表 1 に、各使用コンテキストの構文を示します。
表1: コンテキスト化された保存式構文
関連付けられていない保存式 | $(GlobalStoredExpression()) |
|---|---|
現在のビジネス オブジェクト コンテキストに関連付けられた保存式 この例では、 [this] はリテラル値であり、変更しないでください。 | $([this]AssociatedStoredExpression()) |
関連するビジネス オブジェクト コンテキストに関連付けられた保存式 | $([OtherBusOb#.refname]RelatedStoredExpression()) |
組み込み関数を呼び出すには、次の構文を使用します。
$(FunctionName (arguments))ここで、 引数 は、関数に対する 0 個以上の引数であり、カンマで区切られます。 引数には、値、フィールド参照、またはリテラルを計算する式を指定できます。
すべての サービス マネージャ 組み込み関数の詳細については、「組み込み関数の操作 」を参照してください。
式内の値は、浮動小数点数または整数のいずれかとして表されます。 サービス マネージャ 32 ビットおよび 64 ビットの整数をサポートします。
ただし、JavaScript のすべての数値は倍精度浮動小数点数として表されます。 したがって、クライアント上で式が実行される場合、64 ビット整数を含め、整数はまったくサポートされません。 倍精度浮動小数点整数は 2⁻⁵³ から 2⁵³ -1 までの間の整数しか正確に表現できないため、アプリケーションは、それより大きいか小さいが 2⁻⁶⁴ から 2⁶⁴ -1 未満の整数の計算をすべて切り上げます。
サービス マネージャ 式エディタを使用できる場所であれば、プラットフォーム全体で再利用するために値を保存できます。 保存された値の詳細については、「 保存された値について」を参照してください。
- 式で保存された値を使用するには、システム関数 GetStoredValueを使用します。
- 結果の式は次のようになります: $(GetStoredValue("YourStoredValueNameHere"))。
式には複数行とタブスペースを追加できます。これらは、 式エディタで式を保存した後も保持されます。 式エディタ で式を開くと、適用した書式設定が保持されます。
式フィールド コントロールでは新しい行とタブ スペースがサポートされており、新しい行を保持しながらこれらのフィールドで直接編集できます。 新しい行は改行記号
で示されます。
新しい行とタブスペースを追加するには:
- 式エディタ に新しい行を追加するには、 Enterキーを押してください。
- 式フィールドで式を編集するときに改行を追加するには、 Alt Enter を押します。 これにより、フィールドに改行記号が追加されますが、実際の行の区切りは表示されません。 式エディタで式を開くと、新しい行が表示されます。
- 行にタブスペースを追加するには、 Tab キーを押します。
式にコメントを追加することもできます。「 式でのコメントの使用
