フィールド参照の使用
現在のビジネスオブジェクトについて
ほとんどの式はビジネス オブジェクトのフィールドを参照します。
ビジネス ルールでは、現在のビジネス オブジェクトは、ビジネス ルールを含むビジネス オブジェクトのインスタンスです。 たとえば、ビジネス ルールがインシデントの定義の一部である場合、現在のビジネス オブジェクトは、このビジネス ルールをトリガーした特定のインシデントになります。
ツールバー式などの他の種類の式では、現在のビジネス オブジェクトは、ワークスペースにツールバーが含まれるビジネス オブジェクトです。 あらゆる種類の表現には、その表現に適した現在のビジネス オブジェクトが存在します。
式に関係指定子がない場合、フィールド名は現在のビジネス オブジェクトを参照します。 たとえば、 $(Status) は、現在のビジネス オブジェクトの Status フィールドを参照します。
唯一の例外は LDAP 式です。 ビジネス オブジェクト フィールドを参照しません。 代わりに、LDAP モデル内の構造のフィールドを参照します。 詳細については、「 LDAP設定の構成」を参照してください。
現在のビジネス オブジェクトのフィールドの参照
最も単純なフィールド参照はフィールド名です。 現在のビジネス オブジェクト内のフィールドを参照するには、フィールドの名前を参照します。 以下の最初の例のようにフィールド参照を単独で使用することも、以下の 2 番目の例のようにフィールド参照を式の中に配置することもできます。 フィールド参照の前に角括弧がない場合は、現在のオブジェクトを参照します。
$(FieldName)
$(PrimaryCost + SecondaryCost)たとえば、 Incident ビジネス オブジェクトにいる場合、 Service フィールドを参照するには、次の構文を使用します。
$(Service)ビジネス ルール内の現在のビジネス オブジェクト内のフィールドを参照することもできます。 たとえば、次のビジネス ルールは、 Service フィールドが変更されるたびに、 Incident ビジネス オブジェクトの Service フィールドの値に ActualService フィールドを設定します。 ActualService フィールドの値は、次の式によって計算されます。
現在のビジネス オブジェクト内のフィールドを参照する例

関係指定子の使用
関連ビジネスオブジェクト内のフィールドの参照
関連するビジネス オブジェクトは、リレーションシップまたはリンク フィールドを通じて参照できます。 リンク フィールドの使用については、「 ビジネス オブジェクト内のリンク フィールドによって参照されるフィールドへのアクセス
関連ビジネスオブジェクトについて
リレーションシップを通じて関連するビジネス オブジェクトにアクセスするには、あいまいさを排除するために、リレーションシップが 1 対 1 または多対 1 である必要があります。 つまり、式では、対応する関係に対して一致する子レコードが最大 1 つ見つかるものと想定されます。 特定のビジネス オブジェクトに対して、最大で 1 つの関連ビジネス オブジェクトが見つかる必要があります。
関連するビジネス オブジェクトを参照するには、次の構文を使用します。
$([BusinessObjectName#SubObjectName.InternalReferenceName]FieldName)ここで BusinessObjectName#SubObjectName.InternalReferenceName は関係を参照します。 角括弧で囲まれたものはすべて関係指定子です。
where BusinessObjectName#SubObjectName は関係が参照するビジネス オブジェクトの名前です。 InternalReferenceName は、ビジネス オブジェクトが複数ある場合に、ビジネス オブジェクトとの関係を指定します。
空の内部参照名について
内部参照名を常に指定する必要があります。 ただし、内部参照名を指定していない古い式がある場合は、変更を加えない限り、その古い式は引き続き機能します。 一度変更すると、内部参照名なしでは使用できなくなります。 参照名が null の新しいリレーションシップを作成することはできません。 リリレーションシップの使用参照してください。
関係に内部参照名がある場合は、関係指定子に内部参照名を指定する必要があります。 内部参照名を指定しない場合、アプリケーションは null 参照名を持つリレーションシップを指定していると想定します。 内部参照名を持つ関係指定子は、その内部参照名を持つ関係のみを参照できます。 内部参照名のない関係指定子は、空または null の内部参照名を持つ関係のみを参照できます。 (以前のリリースでは、内部参照名を空白のままにしておくと、アプリケーションは任意の内部参照名を使用できました。)
内部参照名が空の場合、ビジネス オブジェクト名はピリオドで終わる必要があります。 例: [タスク
関係指定子に空でない内部参照名がある場合、その式を使用するすべての参照で明示的に使用する必要があります。 内部参照名のないビジネス オブジェクト参照では、名前付き内部参照名とのリレーションシップを使用できません。
たとえば、[Incident#.]と入力すると、アプリケーションは現在のビジネス オブジェクト (この場合はインシデント) から内部参照名フィールドが空である関係を検索しますが、内部参照名フィールドは必須であるため、見つけることができません。 (以前のリリースでは、一致する関係を検索して使用していました。)[Incident
したがって、ビジネス ルールに [Incident#.] のようなものを入力すると、失敗します。
リモート関連ビジネスオブジェクトの参照
複数のリレーションシップ指定子を使用して、リモート関連ビジネス オブジェクトへのフィールド参照のパスを指定できます。 各関係指定子は角括弧で囲まれ、フィールドへのマルチホップ パスを指定します。
[RelSpecifier1][RelSpecifier2][RelSpecifier3]FieldName内部参照名を使用して関係を通じてビジネス オブジェクトにアクセスする
リレーションシップを通じて関連するビジネスオブジェクトにアクセスするには、このフォーム [BusinessObjectName
- BusinessObjectName#SubObjectName は、関連するビジネス オブジェクトのビジネス オブジェクト名 (# で終わるか # を含む) であり、ピリオドで終わります。 例: タスク の
- 通常のビジネス オブジェクトの場合、 BusinessObjectName の形式は [BusinessObjectName
- グループ メンバーまたはサブ ビジネス オブジェクトの場合、 BusinessObjectName の形式は [BusinessObjectName#SubObjectName.], for example, [Profile#Employee.] です。
- InternalReferenceName は、ある関係を別の関係と区別します。 同じ親ビジネス オブジェクトと子ビジネス オブジェクトの間に複数の関係が存在する場合があります (たとえば、インシデントから従業員)。 このような場合、アプリケーションは関係の内部参照名を使用して関係を区別します。 このパラメータはピリオドの後に指定されます。
内部参照名は、ビジネス オブジェクトの [関係] タブにある [内部参照名] フィールドで指定します。 例えば、[問題
問題のあるビジネスオブジェクトとの関係の例

関連ビジネスオブジェクトの参照例
フォーム エディターでこのタイプの構文を使用して、関連するビジネス オブジェクト (たとえば、 Employee ビジネス オブジェクトの EmployeeLocation フィールド) から値を取得します。
関連するビジネス オブジェクトから値にアクセスする例

ビジネス オブジェクト内のリンク フィールドによって参照されるフィールドへのアクセス
リンク フィールドを使用して関連オブジェクトを参照できます。 リンク フィールドは関係に関連付けられており、参照の代替形式となります。 リンク フィールドを通じて関連オブジェクトにアクセスするには、関係指定子 [link:LinkField] を使用します。 これは、リンク フィールドを含むビジネス オブジェクトから使用する必要があります。リモート リンク フィールドを参照することはできません。
ビジネス オブジェクト内のリンクによって参照されるフィールドにアクセスするには、次の構文を使用します。
$([link:LinkField]FieldName)たとえば、 Incident ビジネス オブジェクトの OrgUnitLink フィールドは、対応する組織単位レコードを指します。 OrgUnitLink フィールドを使用して組織単位レコードの Name フィールドの値を参照するには、次の式を使用します。
$([link:OrgUnitLink]Name)次の編集ルールでこの構文を使用して、インシデントの組織単位 ID を設定できます。
リンクによって参照されるフィールドにアクセスする例

もう一つの例を挙げます。
$("9"+[link:ProfileLink]Phone1)これは、関連するビジネス オブジェクトから、先頭に数字 9 が付いた電話番号を返します。
絶対フィールド参照を使用したビジネス オブジェクトの参照
ビジネス オブジェクトを参照する別の方法である絶対参照では、次の構文を使用します。
[^BusinessObjectName#]FieldName
現在のビジネス オブジェクトに関係なくフィールドの値を返すには、絶対参照を使用します。 この構文では、「where」句の後に式が続く制約を使用できます。 例えば:
[^BusinessObjectName# where FieldValue == value]FieldName
のような
[^Incident# where IncidentNumber == 123456] Category
この例では、アプリケーションはインシデント番号が 123456 の特定のインシデントを検索して返し、その後、 カテゴリ フィールドを参照できます。 「where」句が複数のビジネス オブジェクトを返す場合、これは失敗します。
別の構文は次のとおりです。
[^BusinessObjectName# object LinkField]
のような
[^Incident# object RecID]
ここで、 RecID はビジネス オブジェクトの RecID であり、通常はリンク フィールドによって指定されます。
この構文は主に統合シナリオ向けに設計されています。
他のビジネスオブジェクトからフィールドにアクセスする
あるビジネス オブジェクトと別のビジネス オブジェクトの関係に重点を置いたほとんどの式には、他のビジネス オブジェクトと呼ばれるものがあります。 たとえば、リンク フィールドを持つビジネス ルールを編集すると、他のビジネス オブジェクトも作成されます。
すべての式ではありませんが、多くの式には他のビジネス オブジェクトもあります。 他のビジネス オブジェクトを持つ式は、式の編集ビジネス ルールに関連付けられた関連ビジネス オブジェクトがある式です。 (編集ビジネス ルールにのみ他のビジネス オブジェクトがあります。ただし、 電子メールの送信 や 子オブジェクトの挿入 クイック アクション、または リレーションシップ タブの 条件 フィールドなど、他の式にも他のビジネス オブジェクトがある場合があります。)
たとえば、次の編集ルールは、インシデントをオーナー チームに関連付けるリンク フィールド用です。 現在のオブジェクトは特定のインシデントであり、他のオブジェクトは チーム ビジネス オブジェクトです。 他のオブジェクトは、関係指定子 [OtherObject] を使用して参照されます。
以下では、 OwnerTeam はリンク フィールドであり、 OwnerTeam フィールドは別のビジネス オブジェクトを参照しています。
編集ルールで「その他」オブジェクトを使用する例

編集ビジネス ルールでは、設定するフィールドが検証済みフィールドである場合、他のオブジェクトは検証済みフィールドの検証ビジネス オブジェクトを参照します。 他のオブジェクト構文を使用して、検証ビジネス オブジェクトのフィールドを参照できます。 これにより、追加情報を含む検証リストにアクセスできます。 次の構文を使用します。
$([OtherObject]FieldName)例えば:
$([OtherObject]PrimaryEmail)これは、ビジネス オブジェクトの PrimaryEmail フィールドを参照して、OtherObject と呼ばれる選択リストを返します。 これはビジネス ルールの編集でのみ使用できます。
たとえば、インシデント中に、インシデント レコードに現在設定されている OwnerTeam の TeamEmail 値にアクセスする場合は、まず、インシデントの OwnerTeam フィールドが検証されるように構成されていることを確認します。 (フィールドが検証されているかどうかを確認するには、ビジネス オブジェクトの「 フィールド 」タブに移動し、「 OwnerTeam 」フィールドを選択して、「 選択リスト 」カテゴリで、「 検証済み 」フィールドがチェックされているかどうかを確認します。) この例では、インシデントの「 OwnerTeam 」フィールドは、「インシデント 」で使用されている名前付き検証リスト「Team of StandardUserTeam」を使用して検証されます。
検証済みビジネス オブジェクトからフィールドにアクセスする例 1

次に、( OwnerTeam フィールド検証が設定されている状態で) インシデントの OwnerTeam フィールドに対して編集ルールを定義します。これにより、このフィールドが変更されると、ルールによって検証されたビジネス オブジェクト (つまり、他のオブジェクト) のフィールド値が返されます。 次の例を参照してください。
検証済みビジネス オブジェクトからフィールドにアクセスする例 2

特別な構文を持つその他のビジネス オブジェクトには、次の 2 つの特殊なケースがあります。
- オブジェクト一致式では、[MatchedObject] は一致したオブジェクトを参照します。
- 選択リスト制約では、[ValidationList] は検証オブジェクトを参照します。
オブジェクトマッチングを使用してビジネスオブジェクトの特定の値を参照する
$([MatchedObject]FieldName)この構文は、オブジェクト マッチングのコンテキスト内でのみ使用されます。
たとえば、インシデント オブジェクトのマッチングで使用される リンクと解決 ボタンを考えてみましょう。 ナレッジ記事を現在のインシデント レコードにリンクし、インシデントを解決します。
一致したオブジェクトの例

この例では、左側のフィールドは、オブジェクト マッチング定義を参照するビジネス オブジェクト (この例では、 Incident ビジネス オブジェクト) からのものですが、右側の $([MatchedObject]Resolution) 式は、オブジェクト マッチングからのビジネス オブジェクトのフィールド (つまり、 Knowledge ビジネス オブジェクトの Resolution フィールド) を参照します。
この例では、ユーザーが「 リンクと解決 」ボタンをクリックすると、アプリケーションはインシデントの 解決 フィールドに、 ナレッジ ビジネス オブジェクト (つまり、一致したオブジェクト) の 解決 フィールドの値を入力します。
ビジネス オブジェクトの制約付き検証リストの参照
制約付き検証リスト (選択リストとも呼ばれます) を定義するには、名前付き検証リスト定義のコンテキスト内で次の構文を使用します。
$([ValidationList]FieldName)通常、検証された 1 つのフィールドの値は、同じビジネス オブジェクト内の別のフィールドの値に基づいて制約されます。 たとえば、 Employee ビジネス オブジェクトの JobTitle フィールドは、従業員に対して選択された部門の値に基づいて制約されます。
このような検証リストを定義するには、次の手順を実行します。
- 構成コンソールから、「 ビルド > 選択リスト 」をクリックして、「 選択リスト 」ワークスペースを開きます。
- 選択リストを開きます。
- 制約 領域に、次のように入力します。
- 最初のフィールドで、ドロップダウン リストからフィールド名を選択します。
- 2 番目のフィールドで、ドロップダウン リストから「 等しい 」を選択します。
- 3 番目のフィールドに、「 $([ValidationList] FieldName>)」と入力します。ここで、「 FieldName 」はビジネス オブジェクト内のフィールドの名前です。
制約付き検証リストの定義例

この例では、最初のフィールドの値は検証ビジネス オブジェクトから取得されます。 ビジネス オブジェクトは、 JobTitle です (「 リスト データの取得元: 」ドロップダウン リストに示されているとおりです)。
$([ValidationList]Department) 式は、この名前付き検証リストを利用するビジネス オブジェクトのフィールドを参照します。 この場合、名前付き検証リストは 従業員 ビジネス オブジェクトです。
この構成では、従業員に対して選択できる役職は、以前に選択した部門の値に基づいて決定されます。 次に、従業員の部門値を使用して、同じ部門名を持つ役職レコードを判別し、それに応じて制約された結果を返します。
他のビジネス オブジェクトにわたって名前付き検証リストを参照するには、$([ValidationList]FieldName) 構文を使用します ($(FieldName) の代わりに)。 たとえば、同じ制約付き検証リストを実装する必要がある新しいビジネス オブジェクトがある場合は、そのビジネス オブジェクトに対して同じ名前の検証リストを使用します。
フィールド修飾子の使用
フィールド修飾子はコロンの後のキーワードです。
ビジネスオブジェクトフィールドの翻訳された値の参照
現在のブラウザのカルチャで式から情報を返すには、次の構文を使用します。
フィールド名:言語
別のカルチャの式から情報を返すには、次の構文を使用します。
フィールド名:言語 ("カルチャーコード")
例えば:
ステータス:言語 ("fr-FR")
サポートされている言語と文化の一覧については、「 利用可能な言語と文化」を参照してください。
ビジネスオブジェクトの元の値の参照
式内のビジネス オブジェクトを、トランザクション前の元の値 (更新された値ではなく) で参照するには、次の構文を使用します。
[BusinessObjectName#.InternalReferenceName]FieldName:original
更新されたトランザクション後の値を持つ式内のビジネス オブジェクトを参照するには、次の構文を使用します。
[BusinessObjectName#.InternalReferenceName]FieldName
たとえば、 ステータス フィールドをオープンから解決済みに変更した場合、式では通常、解決済みのステータスが使用されます。 ただし、オープンの元のステータスを参照するには、次の構文を使用します。
[BusinessObjectName#.InternalReferenceName]FieldName:original
例えば:
[Task#.name]Status:original
終了値だけでなく、遷移 (つまり、開始値と終了値) を参照する必要がある場合は、この構文を使用します。 たとえば、タスクがオープン ステータスから解決済みステータスに移行するたびに何かを実行したい場合は、ルールを設定できますが、タスクがログ済みステータスから直接解決済みステータスに移行するたびに別のルールを設定することもできます。
構文 - オリジナル は、電子メールの送信クイック アクションでは機能しません。
