カスタマイズ › Web インターフェースのカスタマイズ › サーバの変数 › ビジネス オブジェクト変数

ビジネス オブジェクト変数

ビジネス オブジェクト変数は、案件やリクエストなどのCA SDMオブジェクトを表します。 オブジェクトにアクセスするには、変数名、ピリオド（.）、表示する属性名の順に続けて指定する必要があります。 たとえば、慣例上オブジェクトが変数argsで表される案件の場合は、以下のように指定することで、説明、オープン日、担当者の電話番号お、案件のアクティビティ数、最初のアクティビティの説明を表示できます。

$args.description
$args.open_date
$args.assignee.phone_number
$args.act_log.length
$args.act_log.0.description

変数名の前後に空白がない場合は、大かっこを使用して変数名を区切ることができます。 たとえば、$foo barと${foo}barはどちらも有効です。 変数argsを使用して、非属性値（「サポートされる操作」で説明している$args.KEEP.nameなど）にアクセスすることもできます。

非属性値が定義されていない可能性もあります。 たとえば、2つの異なる場所からフォームにアクセスしている場合に、そのうちの1つだけが$args.KEEP.fooの値を提供していることがあります。 この場合は、以下の構文を使用して$args 参照にデフォルト値を指定できます。variable が未定義の場合は、コロンの後の文字列が参照の代わりに使用されます。

${args.variable:default}

タイム ゾーン日付変数

タイム ゾーン日付変数は、ビジネス オブジェクト変数の中でも特殊なものです。 タイム ゾーン日付変数は、整数で表される協定世界時（UTC）を、ユーザのブラウザのタイム ゾーンに合わせて文字列の日付に変換する手段を提供します。 以下の変数は、整数の日付を表します。

$args.attr_name_INT_DATE

例： $args.open_date_INT_DATE

ファクトリ データ変数

ファクトリ データ変数は、ビジネス オブジェクト変数の中でも特殊なものです。 ファクトリ データ変数は、参照オブジェクトに関する情報に置き換わります。 ファクトリ データ変数は、以下の7つです。

$args.attr_name.COMMON_NAME

属性が参照するテーブルの共通名（外部から読み取り可能な文字列）。 たとえば、［リクエストの詳細］フォームでは、$args.assignee.COMMON_NAMEの値は担当者のコンボ名（「姓、名、middle name」）です。

$args.attr_name.COMMON_NAME_ATTR

属性が参照するテーブル内の共通名の属性名。 たとえば、［リクエストの詳細］フォームでは、$args.assignee.COMMON_NAME_ATTRの値は「combo_name」です。

$args.FACTORY_attr_name

指定された属性に関連付けられているファクトリの名前。 たとえば、［リクエストの詳細］フォームでは、$args.FACTORY_assigneeの値は「agt」です。

$args.LENGTH_attr_name

属性の最大長。 たとえば、［リクエストの詳細］フォームでは、$args.LENGTH_summaryの値は240です。

$args.attr_name.REL_ATTR

属性の関連付け属性（外部キー）。 たとえば、［リクエストの詳細］フォームでは、$args.assignee.REL_ATTRの値は担当者の［ID］フィールドの値です。

$args.attr_name.REL_ATTR_ATTR

属性が参照するテーブル内のrel_attrの属性名。 たとえば、［リクエストの詳細］フォームでは、$args.assignee.REL_ATTR_ATTRの値は「id」です。

$args.REQUIRED_attr_name

「0」または「1」の文字列で、参照属性が必須かどうかを示します。

$args.attr_name.SELECTIONS

attr_nameの有効な選択肢のリスト。 attr_nameが別のテーブルへの参照でない場合、またはattr_nameが参照するテーブルのサイズが環境設定ファイルのSelListCacheMaxプロパティを超える場合、この値は空の文字列になります。 それ以外の場合、SELECTIONS変数は、参照されるテーブル内のすべてのエントリの共通名と関連付け属性を含む文字列になります。 後続の値は文字列「@,@」で区切られます。つまり、この変数の値は、以下の形式になります。

"cname1@,@rel_attr1@,@cname2@,@rel_attr2"

$args.factory_SEL_UNDER_LIMIT

「0」または「1」の文字列で、factoryに対応するテーブル内の現在の行数が、環境設定ファイルのプロパティSelListCacheMaxの値よりも小さいかどうかを示します。 ただし、この変数は今後サポートされなくなる可能性があるため、新規フォームではSELECTIONS変数を使用してください。

ドット付きの参照を含むファクトリ データ変数（COMMON_NAME、REL_ATTR、およびSELECTIONS）は、どのような長さのドット付き参照でも使用できます。 たとえば、［リクエストの詳細］フォームでは、$args.assignee.organization.COMMON_NAMEは、担当者の組織の外部名に置き換わります。