Oracle Applicationsフレックスフィールド・ガイド リリース12 E05658-01

目次

前へ

次へ

キー・フレックスフィールド・ルーチンの特別検証

キー・フレックスフィールド・ルーチンの構文

キー・フレックスフィールド・ルーチンを使用する特殊値セット（レポート・パラメータ用）を作成する場合は、この項の他に特殊値セット用の追加の引数および引数オプションについての説明がある「特別検証値セット」の項も参照してください。

特殊値セットおよびペアの値セットはユーザー・イグジットの値セットで、使用できるのはフォームベースのアプリケーションのみです。

必要とするフレックスフィールドのタイプに該当する引数リストを、レポート・パラメータ（外部キー参照フレックスフィールドまたは範囲フレックスフィールド）のための値セットとして使用します。

アプリケーションの開発者が新しいキー・フレックスフィールドや組合せフォームを作成する方法の詳細は、『Oracle Applications開発者ガイド』を参照してください。

外部キー参照フレックスフィールド

外部キー参照フレックスフィールド（ほとんどのフレックスフィールド・レポート・パラメータ用）に使用するPOPID/LOADID/VALIDコール順序は、次のとおりです。

構文

#FND {POPID|LOADID|VALID}
CODE="flexfield code"
APPL_SHORT_NAME="application_short_name"
VALIDATE="{FULL|PARTIAL|NONE|QUERY}"
SEG="block.concatenated values field name"
[BLOCK="block_name"]
[FIELD="field_name"]
[DERIVED=":block.field\nSegment qualifier"]
[READ_ONLY="{Y|N}"]
[DINSERT="{Y|N}"]
[WINDOW="{Y|N}"]
[ID="block.unique ID field"]
[REQUIRED="{Y|N}"]
[DISPLAY="{ALL | flexfield qualifier |  segment number}"]
[UPDATE="{ALL | flexfield qualifier |  segment number}"]
[INSERT="{ALL | flexfield qualifier |  segment number}"]
[DATA_FIELD="concatenated hidden IDs field"]
[DESC="block.concatenated description field name"]
[TITLE="window title"]
[VDATE="date"]
[NAVIGATE="{Y|N}"]
[AUTOPICK="{Y|N}"]
[NUM=":structure defining field"]
[COPY=":block.field\n{ALL | flexfield qualifier}"]
[VRULE="flexfield qualifier\n
                                 segment qualifier\n
                                {I[nclude]|E[xclude]}\n APPL=shortname;
                                NAME=Message Dictionary message name\n
                                validation value1\n
                                validation value2..."]
[VALATT=":block.field\n
        flexfield qualifier\n
        segment qualifier"]
[USEDBFLDS="{Y|N}"]
[COLUMN="{column1(n) | column1 alias(n) [, column2(n), ...]}]
[WHERE="where clause"]
[SET="set number"]
[ALLOWNULLS="{Y|N}"]
[QUERY_SECURITY="{Y|N}"]
[QBE_IN="{Y|N|B}"]
[LONGLIST="{Y|N}"]
[NO_COMBMSG="MESG_NAME"]

DISPLAY="ALL"
DISPLAY="1"

UPDATE="ALL"
UPDATE="1"

SELECT ID_FLEX_NUM, ID_FLEX_STRUCTURE_NAME
FROM FND_ID_FLEX_STRUCTURES
WHERE APPLICATION_ID = 'application id'
AND ID_FLEX_CODE = 'flexfield code';

COPY="block.Concatenated_field\nALL"
                                COPY="block.Value_field\n2"

01
XYZ
680

VRULE="GL_GLOBAL\nDETAIL_POSTING_ALLOWED\nE
\nNAME=GL Detail Posting Not Allowed\nN"

範囲キー・フレックスフィールド

範囲キー・フレックスフィールドを持つパラメータ用のPOPIDR/LOADIDR/VALIDRコール順序は、次のとおりです。

構文

#FND {POPIDR|LOADIDR|VALIDR}
CODE="flexfield code"
APPL_SHORT_NAME="application_short_name"
VALIDATE="{PARTIAL|NONE}"
[REQUIRED="{Y|N}"]
[DISPLAY="{ALL | flexfield qualifier |
        segment number}"]
[UPDATE="{ALL | flexfield qualifier |  segment number}"]
[INSERT="{ALL | flexfield qualifier |  segment number}"]
[SEG=":block.concatenated values field name"]
[DESC=":block.concatenated description field name"]
[TITLE="window title"]
[VDATE="date"]
[NAVIGATE="{Y|N}"]
[AUTOPICK="{Y|N}"]
[NUM="structure defining field"]
[VRULE="flexfield qualifier\n
        segment qualifier\n
        {I[nclude]|E[xclude]} APPL=shortname;
        NAME=Message Dictionary message name\n
        validation value1\n
        validation value2..."]
[ALLOWNULLS="{Y|N}"]

DISPLAY="ALL"
DISPLAY="1"

UPDATE="ALL"
UPDATE="1"

SELECT ID_FLEX_NUM, ID_FLEX_STRUCTURE_NAME
FROM FND_ID_FLEX_STRUCTURES
WHERE APPLICATION_ID = 'application id'
AND ID_FLEX_CODE = 'flexfield code';

VRULE="GL_GLOBAL\nDETAIL_POSTING_ALLOWED\nE
\nNAME=GL Detail Posting Not Allowed\nN"

関連トピック

特別検証値セット

外部キー参照フレックスフィールド

範囲キー・フレックスフィールド

特別検証値セット

特別検証値セットを使用すると、フレックスフィールド内フレックスフィールドというメカニズムを使用してフレックスフィールド・セグメントまたはレポート・パラメータを検証するために、キー・フレックスフィールド・ユーザー・イグジットをコールできます。フレックスフィールド・ルーチンをコールし、完全なフレックスフィールドをこの値セットによって渡される値として使用できます。

警告: Oracle Applicationsで提供されている定義済の値セットは、変更したり削除したりしないでください。そのような変更を行うと、レポート作成などのアプリケーション機能の動作に思わぬ影響を与えることがあります。

「値セット」フォームの「特別検証ルーチン」ウィンドウを使用して、特別値セットの特別ユーザー・イグジット検証を定義します。また、そのリージョンを使用して、ペア値セットの検証ルーチンも定義します。

特別検証値セットを定義する場合には、イベントおよび機能を指定します。イベントとは機能が発生する時点のことであり、機能とはキー・フレックスフィールド・ユーザー・イグジットのコールのことです。たとえば、「検証」イベントはユーザーが値を入力すると発生し、機能がその値を検証します。

特別検証値セットを使用して、ユーザーに、付加フレックスフィールドまたはレポート・パラメータの単一のセグメント内にキー・フレックスフィールド全体を入力させることができます。たとえば、キー・フレックスフィールド・セグメントを連結し、レポートへのパラメータとして渡すことができます。このタイプの値セットを使用すると、ユーザーは付加フレックスフィールド・セグメントまたはレポート・パラメータを入力した後、キー・フレックスフィールド・ポップアップ・ウィンドウおよびそのキー・フレックスフィールドへ関連付けられたセグメント「値セット」など、キー・フレックスフィールドの標準動作を見ることができます。Oracle Application Object Libraryフレックスフィールド・ルーチンを使用して、セグメント値またはレポート・パラメータについてのフレックスフィールド・データ入力機能および検証機能を実行できます。

注意: 値セットの中にフレックスフィールドが入っており、その中にもフレックスフィールドが（いずれかのセグメントの値セットとして）入っているような状況を回避するように、特別に注意を払ってください。このことが原因で問題が起きる状況が2つあります。第1の状況（再帰）は、フレックスフィールドがそのセグメントの1つとして自分自身をコールし、ポップアップ・ウィンドウの無限連鎖になる場合です。このようなループは、間接的なループの場合もあります。次に起こる可能性がある問題は、データの切捨ておよびデータの破壊につながることです。フレックスフィールドは連結されたフレックスフィールド値として渡される場合が多いため、それらの連結したフレックスフィールドの長さがすぐに値セットの最大サイズおよび基礎フレックスフィールド表内のセグメント列の最大サイズを超えてしまう可能性があります。付加フレックスフィールドまたは範囲フレックスフィールドの場合に比べて、キー・フレックスフィールドの場合に、このことが問題になる可能性が小さくなるのは、キー・フレックスフィールドは通常、連結したセグメント値としてでなく単一のコード組合せID番号として渡されるためです。「値セットの定義」フォームおよび「セグメントの定義」フォームでは、フレックスフィールドのループまたはフレックスフィールド内の複数のフレックスフィールドも定義できますが、そのような定義をすると重大な切捨ての問題およびデータ破壊の問題が起きる可能性があります。値セットの中にそのような値セットを入れないように注意して値セットの計画および定義を行ってください。

関連トピック

キー・フレックスフィールド・セグメント

付加フレックスフィールド・セグメント

「値セット」ウィンドウ

レポート・パラメータにおけるフレックスフィールド情報の使用

特別検証イベント

特別検証ルーチンを起動するイベントを指定します。有効なイベントは次のとおりです。

• 編集

• 検証

• ロード

次のイベントは、将来のバージョンとの互換性を保つためにOracle Applicationsに組み込まれており、現在のバージョンでは、これらのイベントを使用することはできません。

• 挿入/更新

• 問合せ

• 編集/編集

• 値リスト

1つのイベント・タイプにつき1つのイベントのみを使用できます。通常は特別検証を使用して既存のキー・フレックスフィールドをコールし、1つのイベント・タイプにつき1つのイベントを定義します。ただし、「ID」フィールド（コード組合せID番号が入っているフィールド）または「データ」フィールド（非表示ID列を使用する値セットの値に対応する非表示ID番号が入っているフィールド）を使用しない場合は、「ロード」イベントを定義しないでください。

編集

データ入力モードでユーザーのカーソルがセグメントに入ったときに、特別検証ルーチンをコールします。通常、「編集」イベントにはPOPID(R)を使用します。

ロード

データ入力モードでユーザーのカーソルがセグメントに入ったときに、特別検証ルーチンをコールします。通常、「ロード」イベントにはLOADID(R)を使用します。

「ロード」用に定義したユーザー・イグジットは、格納された非表示IDに基づいて値と摘要を取得し、ユーザーがフレックスフィールド・セグメントに入れるデータを問い合せたときに起動します。「ロード」イベントは、非表示IDを使用する場合にのみ定義してください。「ロード」イベントがある場合は、非NULLのIDフィールド（コード組合せID番号が入っているフィールド）またはデータ・フィールド（非表示ID列を使用する値セットの値に対応する非表示ID番号が入っているフィールド）が必ず存在する必要があります。「ロード」イベントがある場合は、IDフィールドまたはデータ・フィールドに:!ID（後述）を使用してください。ユーザー・イグジットは、:!VALUE（後述）の内容でなく:!IDの内容をレポートまたはフレックスフィールドへ渡します。

検証

ユーザーのカーソルがセグメントから出るかポップアップ・ウィンドウをクローズしたとき、またはデフォルト値がセグメントまたはレポートのパラメータの中へコピーされたときに、特別検証ルーチンがコールされます。「検証」イベントは、問合せの後に、問合せ対象となった値の摘要を生成するためにも起動されます。通常、「検証」イベントにはVALID(R)を使用します。

「検証」イベントは必ず存在する必要があります。

ユーザーの特別検証機能の定義

#符号を含む必要がない（すなわち、#FNDと入力するかわりに、FNDと入力できる）場合以外は、フォーム・トリガーからコールするとおりにユーザー・イグジット構文を正確に入力します。

特別検証には、ユーザー・イグジットとの間で値の受渡しに使用できる次のような特別な引数があります。

• :!ID

• :!VALUE

• :!MEANING

• !DIR

:!ID

:!IDを使用すると、環境に応じて異なる情報を渡すことができます。フレックスフィールド・ルーチンの場合、:!IDはセグメント値（キー・フレックスフィールドのみ）の組合せ全体の組合せID番号を渡すか、個々のフレックスフィールド・セグメント値（キー・フレックスフィールドまたは付加フレックスフィールド）の連結文字列を渡すことができます。

:!IDを使用して個々のセグメント値の連結文字列を渡す場合、値セット内の値の非表示ID値が、ある場合は、:!IDに入っている必要があります。値セットに非表示ID列を使用していない場合、:!IDには値セットの値の列から実際の値が入ります。

VALIDATE=FULL引数を使用している外部キー・フレックスフィールドの場合には、ID=:!ID引数を使用して、DATA_FIELD=:!ID引数は使用しないでください。VALIDATE=PARTIAL（またはNONE）引数を使用する外部キー・フレックスフィールドをコーディングする場合には、DATA_FIELD=:!ID引数を使用し、ID=:!ID引数は使用しないでください。キー・フレックスフィールドにDATA_FIELD=:!ID引数を使用する場合は、セグメントおよびセパレータの連結後の長さが合計で240文字未満になるようにする必要があります。

範囲フレックスフィールドの#FND POPIDR、LOADIDRまたはVALIDRルーチンにID=:!IDは使用できず、DATA_FIELD=:!ID引数が使用できます。

「ロード」イベントがある場合は、「ID」フィールドまたは「データ」フィールドに:!IDを使用してください。ユーザー・イグジットは、:!VALUEの内容でなく:!IDの内容をレポートまたはフレックスフィールドへ渡します。

:!VALUE

ユーザーの入力へアクセスするには、:!VALUEを使用します。:!VALUEは、フレックスフィールド・ウィンドウおよび連結値フィールドに示される表示値を参照します。:!VALUEには、値セットが使用するフレックスフィールドの連結値が入ります。:!IDに値を指定しなかった場合、:!VALUEがレポートへ渡されるか、セグメント列に格納されます。

「ロード」イベントがある場合は、「ID」フィールドまたは「データ」フィールドに:!IDを使用してください。ユーザー・イグジットは、:!VALUEの内容でなく:!IDの内容をレポートまたはフレックスフィールドへ渡します。

:!MEANING

:!MEANINGは、フレックスフィールド値の連結された摘要を渡すために使用します。値の摘要は、通常どおりフレックスフィールド・セグメント値の隣の連結摘要フィールドに表示されます。独自の機能を作成する場合は、値の摘要を:!MEANINGの中へ書き込むようにユーザー・イグジットをコーディングしてください。

!DIR

!DIRは、キーおよび付加フレックスフィールド・ルーチンのNAVIGATE引数に使用します。!DIRを使用すると、フレックスフィールドをセグメント値セットとして使用した場合に、フレックスフィールド・ルーチンで正しい移動方向を判別できます。POPIDまたはその他のフレックスフィールド・ルーチンに!DIRを指定する場合は、コロン（:）を使用しないでください。

ペアの値セットに使用するその他の引数

「ペア」タイプの値セット用に検証を定義する場合、範囲フレックスフィールドに#FND POPIDR、LOADIDRまたはVALIDRのフレックスフィールド・ルーチンを使用していないと、これらの引数の特別な形式、つまり:!ID_LOWおよび:!ID_HIGH、:!VALUE_LOWおよび:!VALUE_HIGH、あるいは:!MEANING_LOWおよび:!MEANING_HIGHが使用できます。ただし、通常、範囲フレックスフィールド（POPIDR、LOADIDRおよびVALIDR）にはキー・フレックスフィールド・ルーチンを使用する必要があり、これらのルーチンは:!IDおよび:!VALUE、:!MEANINGに_LOWおよび_HIGHの接尾辞を自動的に付加します。

DINSERTおよび動的挿入

特別検証にキー・フレックスフィールド・ユーザー・イグジットを使用した場合は、「編集」、「ロード」および「検証」イベントにDINSERT=Nというトークンを組み込む必要があります。たとえそのフレックスフィールドが動的挿入を許可していても、フレックスフィールド内のフレックスフィールドからの動的挿入は実行できません。

非表示IDの使用

キー・フレックスフィールド組合せID番号を渡す場合はID=:!ID引数を使用する必要がありますが、連結したキー・セグメント値を渡すにはDATA_FIELD=:!ID引数またはSEG=:!VALUE引数が使用できます。フレックスフィールドに使用する値セットが非表示IDの列および値を使用していない場合でも、明示的に:!IDフィールドへ書き込む（そして「ロード」イベントを定義する）ことにより、どの値をデータベースへ格納しようとしているか、またはレポートへ渡そうとしているかを明確にすることができます。値セットに非表示ID列を使用していない場合、:!IDには値セットの値の列から実際の値が入ります。表示値と非表示ID値を（フレックスフィールド・セグメントにどの値セットを使用するかに応じて）混合して連結し、:!IDに入れることもできます。フレックスフィールド・ルーチンを使用するOracle Reportsレポートへ情報を渡す場合には、データ・フィールドがあり、DATA_FIELD=:!ID引数を使用する必要があります。

特別検証を使用するためのヒント

特別（またはペアの）値セットが期待どおりの動作をしない場合には、値セット定義をチェックし、機能名を正しくタイプしたかどうかを確認してください。よくあるエラーは、感嘆符（!）やコロン（:）の位置の誤りです。これらの句読記号の付け忘れや、誤った順序での指定、または誤った位置に付けていないかを確認してください。その他のよくあるエラーは、トークン名のスペルの誤り、およびアポストロフィ（'）の欠落または重複、引用符（"）の欠落または重複などです。

特別検証の例

ここでは、特別検証の使用例を示します（ペア検証の例は、この例の後にあります）。この例は、ユーザーが、連結した「会計フレックスフィールド」セグメントの単一の組合せをパラメータとしてレポートへ渡すことを想定しています。ユーザーにそのような範囲を選択させるためには、ユーザーが「レポートの実行」フォームでレポート・パラメータ・ウィンドウの中からキー・フレックスフィールド・ウィンドウを使用できるようにしてください。そのためには、単に特別検証を使用して値セットを定義し、使い慣れたフレックスフィールド・ユーザー・イグジットを使用します。既存の組合せを渡す（つまり、その組合せのID番号を渡す）ので、しかもそれは外部キー・フレックスフィールドなので、VALIDATE=FULLおよびID=:!ID引数を使用します。DATA_FIELD=:!ID引数は使用しません。この例は、会計フレックスフィールドの体系101を使用します。このフィールドで「イベント」および「機能」を次のように定義します。

データ入力の検証（イベント = 編集）の場合には、次のように入力します。

FND POPID
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        REQUIRED=Y
        VALIDATE=FULL
        ID=:!ID
        SEG=:!VALUE
        DESC=:!MEANING
        NAVIGATE=!DIR
        DINSERT=N

データの問合せ（イベント = ロード）の場合には、次のように入力します。

FND LOADID
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        REQUIRED=Y
        VALIDATE=FULL
        ID=:!ID
        SEG=:!VALUE
        DESC=:!MEANING
        DINSERT=N

データの検証（イベント = 検証）の場合には、次のように入力します。

FND VALID
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        REQUIRED=Y
        VALIDATE=FULL
        ID=:!ID
        SEG=:!VALUE
        DESC=:!MEANING
        DINSERT=N

単一セグメントについての特別検証の例

ここでは、ユーザーが単一の「会計フレックスフィールド」セグメント値をパラメータとしてレポートへ渡す場合の特別検証の使用例を示します。ユーザーに単一のセグメントを選択させるためには、ユーザーが「レポートの実行」フォームでレポート・パラメータ・ウィンドウの中からキー・フレックスフィールド・ウィンドウを使用できるようにしてください。既存のセグメント値を渡すので、しかもそれは外部キー・フレックスフィールドなので、VALIDATE=PARTIALを使用します。この場合、DATA_FIELD=:!ID引数またはID=:!ID引数は使用しません。これは、会計フレックスフィールドに非表示ID値セットを使用しないためです。:!IDを使用しないので、「ロード」イベントは使用しません。この例では、会計フレックスフィールドの体系101を使用し（ただし、通常は値セットの使用方法に応じて前のセグメントまたはプロファイル・オプションから体系番号を取得します）、フレックスフィールド・クオリファイアFA_COST_CTRは、どのセグメントを渡すかを識別します。このフィールドで「イベント」および「機能」を次のように定義します。

データ入力の検証（イベント = 編集）の場合には、次のように入力します。

FND POPID
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        REQUIRED=N
        VALIDATE=PARTIAL
        DISPLAY="FA_COST_CTR"
        SEG=:!VALUE
        DESC=:!MEANING
        NAVIGATE=!DIR
        DINSERT=N

データの検証（イベント = 検証）の場合には、次のように入力します。

FND VALID
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        REQUIRED=N
        VALIDATE=PARTIAL
        DISPLAY="FA_COST_CTR"
        SEG=:!VALUE
        DESC=:!MEANING
        DINSERT=N

ペア検証の例

ここでは、ペア検証の使用例を示します。この例は、ユーザーが、連結した「会計フレックスフィールド」セグメントの範囲をパラメータとしてレポートへ渡すことを想定しています。たとえば、ユーザーは2番目のセグメント値が001以上101以下であるすべての組合せについて報告を要求します。ユーザーにそのような範囲を選択させるためには、ユーザーが「レポートの実行」フォームでレポート・パラメータ・ウィンドウの中からキー・フレックスフィールド範囲ウィンドウを使用できるようにしてください。そのためには、単にペア検証を使用して値セットを定義し、使い慣れた範囲フレックスフィールド・ユーザー・イグジットを使用して、連結したセグメント値の範囲を渡します。範囲フレックスフィールドには、VALIDATE=PARTIAL（またはNONE）を使用します。範囲フレックスフィールドを使用するので、ID=:!ID引数は使用できません。この例ではDATA_FIELD=:!IDを使用しない（会計フレックスフィールドには非表示ID値セットを使用できません）ため、「ロード」イベントは必要ありません。この例は、会計フレックスフィールドの体系101を使用します。このフィールドで「イベント」および「機能」を次のように定義します。

データ入力の検証（イベント = 編集）の場合には、次のように入力します。

FND POPIDR
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        VALIDATE=PARTIAL
        SEG=:!VALUE
        DESC=:!MEANING
        NAVIGATE=!DIR

データの検証（イベント = 検証）の場合には、次のように入力します。

FND VALIDR
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=101
        VALIDATE=PARTIAL
        SEG=:!VALUE
        DESC=:!MEANING

特別検証およびペア検証での変数の使用

特別検証ユーザー・イグジット・コールでは、次のようなバインド変数が使用できます。

たとえば、「検証」イベントでの次のユーザー・イグジットは、プロファイル・オプションからキー・フレックスフィールドの体系（NUM）を取得します。

FND VALID
        APPL_SHORT_NAME=SQLGL
        CODE="GL#"
        NUM=:$PROFILES$.MY_STRUCTURE_ID
        REQUIRED=Y
        VALIDATE=FULL
        ID=:!ID
        SEG=:!VALUE
        DESC=:!MEANING
        DINSERT=N

関連トピック

バインド変数

Copyright © 1994, 2006, Oracle. All rights reserved.