トリガについて

反復トリガ テーブル

反復トリガで作成される情報は、反復トリガ テーブル (GP_ITER_TRGR) に保存されます。このテーブルには、以下のデータが含まれます。

データ変更によって反復トリガが作成されると、従業員 ID、国、およびカレンダー実行 ID が、バッチ コードによる反復処理を容易にするその他の情報と共にトリガ テーブルに書き込まれます。

たとえば、このデータにより次の事柄が認識されます。

• 処理または再処理対象の受給者。

• 処理対象のオープン カレンダー。

さらに、RECNAME、FIELDNAME、TRGR_FLD_VAL_CHAR、TRGR_FLD_VAL_DT、および TRGR_FLD_VAL_NUM フィールドで、反復トリガのソース (トリガを作成するレコード、フィールド、またはフィールド値の変更) が識別されます。この情報により、受給者の支給が反復処理される原因を明確に把握し、デバッグを簡単に行ったりクエリーに回答することができます。

「反復ページ」を参照してください。

遡及トリガ テーブル

遡及トリガで作成される情報は、遡及トリガ テーブル (GP_RTO_TRGR) に保存されます。このテーブルには、以下のデータが含まれます。

最初にデータ変更によって遡及トリガが作成されると、従業員 ID、変更の有効日 (トリガ有効日)、国、および関連付けられたイベント ID が、バッチ コードによる遡及処理を容易にするその他の情報と共にトリガ テーブルに書き込まれます。

たとえば、このデータにより次の事柄が認識されます。

• 処理対象の受給者。

• トリガ有効日に基づく遡及処理の実行期間。

• 過去の期間の再計算に使用するプロセス定義。

さらに、RECNAME、FIELDNAME、TRGR_FLD_VAL_CHAR、TRGR_FLD_VAL_DT、および TRGR_FLD_VAL_NUM フィールドで、遡及トリガのソース (トリガを作成するレコード、フィールド、またはフィールド値の変更) が識別されます。この情報により、受給者の支給が遡及処理される原因を明確に把握し、デバッグを簡単に行ったりクエリーに回答することができます。

「遡及ページ」を参照してください。

分割トリガ テーブル

分割トリガで作成される情報は、分割トリガ テーブル (GP_SEG_TRGR) に保存されます。このテーブルには、以下のデータが含まれます。

最初にデータ変更によって分割トリガが作成されると、従業員 ID、変更の有効日 (トリガ有効日)、国コード、および関連付けられたイベント ID が、バッチ コードによる遡及処理を容易にするその他の情報と共にトリガ テーブルに書き込まれます。

たとえば、このデータにより次の事柄が認識されます。

• 処理対象の受給者。

• 期間セグメントまたはスライスに使用する日付。

• 使用する分割のタイプと、分割対象のエレメント (エレメント分割の場合)。

さらに、RECNAME、FIELDNAME、TRGR_FLD_VAL_CHAR、TRGR_FLD_VAL_DT、TRGR_FLD_VAL_NUM、および TRGR_FLD_VAL_PIN フィールドで、分割トリガのソース (トリガを作成するレコード、フィールド、またはフィールド値の変更) が識別されます。この情報により、受給者の支給が分割される原因を明確に把握し、デバッグを簡単に行ったりクエリーに回答することができます。

「分割ページ」を参照してください。

有効日と有効日タイプ

反復トリガを除く全てのトリガは、トリガ有効日 (TRGR_EFFDT) と共にトリガ テーブルに保存されます。トリガ有効日は、トリガ作成の原因となったデータベース変更の日付に基づいていますが、必ずしも同一ではありません。PeopleSoft システムでは、データベース変更の日付は [有効日]、[開始日]、[終了日]、および [固定日] フィールドに記録されます。これらのフィールドは中心的な役割を果たすため、遡及トリガと分割トリガは日付で管理されているレコードからのみ作成することができます。遡及トリガは、[有効日] フィールドか、[開始日] フィールドと [終了日] フィールドが指定されているレコード、または [固定日] フィールドが指定されているレコードに対してのみ定義できます。分割トリガは [有効日] フィールドが指定されているレコードに対してのみ定義できますが、例外が 1 つあります。分割トリガは、開始日と終了日が指定された支給/控除割り当てレコード GP_PYE_OVRD から作成することもできます。

トリガ有効日のソースとなる日付フィールドに基づいて、それぞれの遡及トリガおよび分割トリガは以下のいずれかの有効日タイプに属します。

• [有効日]: トリガ日付は [有効日] フィールドに基づきます。

• [開始/終了日]: トリガ日付は [開始日] または [終了日] フィールドに基づきます。

• [固定日]: トリガ日付は、汎用の PeopleCode 関数 Generate_Triggers にパラメータとして渡された固定日に基づきます。

  「トリガの導入」を参照してください。

遡及トリガと分割トリガの処理時には、有効日タイプが参照され、トリガ有効日として使用する日付が決定されます。

トリガ レベル

PeopleSoft グローバル ペイロールでトリガを設定する際は、データベース変更に反応するレベルを指定する必要があります。レコードの任意のフィールドに対する、有効日が指定された変更、または開始日と終了日が指定された変更に反応するか ([トリガ レベル] は [レコード])、レコードの特定のフィールドに対する全ての変更に反応するか ([トリガ レベル] は [フィールド] で、値に依存しない場合)、特定の値がフィールドに入力されたときにのみトリガが作成されるように設定します ([トリガ レベル] は [フィールド] で、値に依存する場合)。トリガ レベルによって、いつ、どのような状況でトリガが作成されるかが決定されます。

反復トリガのルール: トリガの作成

反復トリガは、オープン カレンダー グループが存在する場合のみ作成されるので、カレンダー グループを指定しておく必要があります。

[トリガ レベル] が [レコード] の場合、行の追加、変更、または削除があれば、反復トリガが作成されます。

[トリガ レベル] が [フィールド] で、値に依存しない場合、反復トリガは以下のときに作成されます。

• 行およびフィールドが変更されたとき。

• 行が追加または削除されたとき。

  注: [トリガ レベル] が [フィールド] で、値に依存しない場合、行の追加でトリガが作成されるのは、フィールド値が変更されたときだけです。

[トリガ レベル] が [フィールド] であり、値に依存する場合は、追加、変更、削除された行の値が指定した値と一致するとき、または値が一致しなくてもトリガが作成されるように指定されているときのみ、反復トリガが作成されます。それ以外のルールは、値に依存しない場合と同じです。

遡及トリガのルール: トリガ有効日の設定とトリガの作成

[トリガ有効日タイプ] が [有効日] の場合:

• デフォルトでは、行が追加されると、その有効日がトリガ有効日として使用されます。

  注: デフォルトでは、変更日 (追加された行の有効日) がトリガ有効日として使用されますが、トリガ定義のフィールド値ページで、トリガ日付が実際の変更日よりも前または後になるように遡及トリガの有効日を修正できます。

  「トリガ定義 - フィールド値ページ」を参照してください。

• 行が削除されると、元の有効日がトリガ有効日として使用されます。

• 行が変更されると、元の有効日と変更後の有効日のうち、日付の古い方がトリガ有効日として使用されます。

元の有効日は、行がロードされたときの有効日です。変更後の有効日は、行が保存されたときの有効日です。有効日が変更されなければ、元の有効日と同じ日付になります。有効日が変更された場合、元の有効日とは異なる日付になります。

[トリガ有効日タイプ] が [開始 - 終了日] の場合:

• デフォルトでは、行が追加されると、その開始日がトリガ有効日として使用されます。

  注: デフォルトでは、変更日 (追加された行の開始日) がトリガ有効日として使用されますが、トリガ定義のフィールド値ページで、トリガ日付が実際の変更日よりも前または後になるように遡及トリガの有効日を修正できます。

  「トリガ定義 - フィールド値ページ」を参照してください。

• 行が削除されると、元の開始日がトリガ有効日として使用されます。

• 行が変更され、終了日の他に変更されたフィールドがない場合は、元の終了日と変更後の終了日のうち、日付の古い方がトリガ有効日として使用されます。それ以外の場合は、元の開始日と変更後の開始日のうち、日付の古い方がトリガ有効日として使用されます。

元の開始日は、行がロードされたときの開始日です。変更後の開始日は、行が保存されたときの開始日です。開始日が変更されなければ、元の開始日と同じ日付になります。開始日が変更された場合は、元の開始日とは異なる日付になります。

元の終了日は、行がロードされたときの終了日です。変更後の終了日は、行が保存されたときの終了日です。終了日が変更されなければ、元の終了日と同じ日付になります。終了日が変更された場合は、元の終了日とは異なる日付になります。

[トリガ有効日タイプ] が [固定日] の場合、関数 Generate_Triggers (PeopleCode) でパラメータとして指定した日付がトリガ日付になります。

[トリガ レベル] が [レコード] の場合:

• 行が追加、変更、または削除されると、遡及トリガが作成されます。

• 複数の行を変更した場合、トリガ有効日には、変更された行の中で最も古いトリガ日付が使用されます。

[トリガ レベル] が [フィールド] で、値に依存しない場合:

• 行が追加または削除されると、その行のトリガ日付より前の日付で、最も新しい有効日の行が検索されます。

  前の行と追加または削除された行とでフィールド値が異なる場合は、遡及トリガが作成されます。

• 行とそのフィールド値が変更されると、その行の有効日が変更されたかどうかにかかわらず、遡及トリガが作成されます。

• 行とその行の有効日が変更された場合 (変更前の有効日が "古い日付" で、変更後の有効日が "新しい日付" と仮定) は以下のようになります。

  • フィールドが変更されると、遡及トリガが作成されます。

  • 新しい日付よりも前の日付で、最も新しい有効日の行が検索されます。

    前の行と変更された行でフィールド値が異なる場合は、遡及トリガが作成されます。

  • 古い日付よりも前の日付で、最も新しい有効日の行が検索されます。

    前の行と変更された行でフィールド値が異なる場合は、遡及トリガが作成されます。

• 前の行が見つからない場合は、追加/変更/削除された行がバッファの最初の行であることを意味します。

  この場合は、トリガ定義で指定された主要イベント ID を使用して遡及トリガが作成されます。

[トリガ レベル] が [フィールド] で、値に依存する場合は、追加、変更、削除された行の値が指定した値と一致するとき、または値が一致しなくてもトリガが作成されるように指定されているときのみ、遡及トリガが作成されます。それ以外のルールは、値に依存しない場合と同じです。

分割トリガのルール: トリガ有効日の設定とトリガの作成

開始日と終了日が指定された支給/控除割り当てレコード GP_PYE_OVRD を除き、分割トリガは、[トリガ有効日タイプ] が [有効日] のレコードからのみ作成されます。

「支給および控除の割り当てを使用した分割トリガ」を参照してください。

削除された行に対して、分割トリガは作成されません。

[トリガ有効日タイプ] が [有効日] の場合:

• 行が追加されると、追加された行の有効日がトリガ有効日として使用されます。

• 行が変更されると、変更後の有効日 (元の有効日ではない) がトリガ有効日として使用されます。

[トリガ有効日タイプ] が [開始 - 終了日] の場合:

• 行が追加されると、開始日が最初のトリガの有効日として使用され、終了日 + 1 が最終トリガの有効日として使用されます。

  注: 開始日と終了日が指定されたレコード GP_PYE_OVRD から分割トリガを作成すると、それぞれ異なるトリガ有効日を使用して 2 つのトリガが作成されます。1 つは開始日に基づき、もう 1 つは終了日に基づきます。たとえば、開始日と終了日に 6 月 10 日と 6 月 20 日を指定して受給者に控除を割り当て、月次カレンダーで給与計算を処理するとします。有効日 6 月 10 日を使用してトリガが作成され (最初のトリガ)、有効日 6 月 21 日を使用して別のトリガが作成されます (終了日 + 1 の有効日を使用する最終トリガ)。これらのトリガ日付に基づいて、期間は 6 月 1 日 から 6 月 10 日、6 月 11 日 から 6 月 20 日、6 月 21 日 から 6 月 30 日の 3 つのセグメントに分割されます。

• 行が変更され、終了日の他に変更されたフィールドがない場合は、変更後の終了日 + 1 が新しい最終トリガの有効日として使用されます。行が変更され、開始日の他に変更されたフィールドがない場合は、変更後の開始日が最初のトリガの有効日として使用されます。

元の開始日は、行がロードされたときの開始日です。変更後の開始日は、行が保存されたときの開始日です。開始日が変更されなければ、元の開始日と同じ日付になります。開始日が変更された場合は、元の開始日とは異なる日付になります。

元の終了日は、行がロードされたときの終了日です。変更後の終了日は、行が保存されたときの終了日です。終了日が変更されなければ、元の終了日と同じ日付になります。終了日が変更された場合は、元の終了日とは異なる日付になります。

[トリガ レベル] が [レコード] に指定されている場合、行が追加または変更されると、分割トリガが作成されます。

[トリガ レベル] が [フィールド] で、値に依存しない場合:

• 行が追加または変更されると、追加、変更された行よりも前の日付で、最も新しい有効日の行が検索されます。

  前の行と現在の行でフィールド値が異なる場合は、分割トリガが作成されます。

• 前の行が見つからない場合は、以下のようになります。

  • フィールド値が変更されると、分割トリガが作成されます。

  • 新規の行であれば、指定されたフィールド全てに対して分割トリガが作成されます。

[トリガ レベル] に [フィールド] が指定され、値に依存する場合は、追加または変更された行の値が指定した値と一致するとき、または値が一致しなくてもトリガが作成されるように指定されているときのみ、分割トリガが作成されます。それ以外のルールは、値に依存しない場合と同じです。

例: 行の有効日の変更に反応した分割トリガの削除

JOB レコードで設定されているトリガのレベルがフィールドで、値に依存する場合を仮定します。

トリガを作成するように定義されたフィールドおよびフィールド値は、[異動区分] と PAY (給与レートの変更) または TER (雇用終了) です。

異動区分が雇用終了 (TER) の有効日を、11 月 15 日から 11 月 20 日に変更するとします。

この異動区分に関連付けられた有効日を変更すると、以下の動作が行われます。

• 変更したソース行に関連付けられている古いトリガが削除されます。

• 新しいトリガ有効日で新しいトリガが挿入されます。

この例では、雇用終了行の有効日が 11 月 15 日から 11 月 20 日に変更されます。その結果、11 月 15 日のトリガは削除され、有効日が 11 月 20 日の新しいトリガが作成されます。

例: フィールド値の変更に反応した分割トリガの削除

JOB レコードで設定されているトリガのレベルがフィールドで、値に依存する場合を仮定します。

トリガを作成するように定義されたフィールドおよびフィールド値は、[異動区分] と PAY (給与レートの変更) または TER (雇用終了) です。

有効日が 10 月 20 日に設定された行の [異動区分] の値を、TER (雇用終了) から DTA (データ変更) に変更するとします。

この異動区分に関連付けられた有効日を変更すると、以下のように、古いトリガが削除されます。新しいトリガは作成されません。

この例では、有効日が 10 月 20 日の行の値が TER から DTA に変更されます。TER と PAY だけがトリガを作成するように設定されており、DTA はトリガを作成する値として認識されないため、有効日が 10 月 20 日のトリガが削除されても、新しいトリガは作成されません。

例: フィールド値の変更に反応した分割トリガの削除

JOB レコードで設定されているトリガのレベルがフィールドで、値に依存する場合を仮定します。

トリガを作成するように定義されたフィールドおよびフィールド値は、[異動区分] と PAY (給与レートの変更) または TER (雇用終了) です。

有効日が 2005 年 7 月 1 日に設定された行の [異動区分] の値を、DTA (データ変更) から PAY (給与レートの変更) に変更するとします。このとき、この行とは別に、値が PAY で有効日が 2006 年 1 月 1 日の既存の行があるとします。この例では、前者の行の変更によって、後者の行が影響を受ける場合を示します。

この例では、有効日が 2005 年 7 月 1 日の行の値が DTA から PAY に変更されます。トリガの作成はフィールド値の変更に基づきますが、2005 年 7 月 1 日の行と 2006 年 1 月 1 日の行の間で変更がないため (両方ともフィールド値は PAY です)、後者の行で最初は作成されていたトリガが削除され、有効日が 2005 年 7 月 1 日の新しいトリガが挿入されます。DTA はトリガを作成する値として定義されていないため、DTA 行のトリガはありません。

EFFSEQ (同一有効日連番) フィールドを含むレコードに対するフィールド ベースの分割トリガのための特殊ルール

たとえば JOB レコードのように、レコードに EFFSEQ フィールドが含まれている場合、フィールド ベースの分割トリガを管理するための特殊なルールがあります。

• トリガ定義がフィールドで、値に依存しない場合、PeopleCode により有効日連番が最も大きい行だけを使用して、指定された有効日のトリガが挿入されます。つまり、トリガ定義がフィールドで、値に依存しない場合は、有効日ごとに有効日連番が最も大きい行だけが考慮されます。これにより、有効日連番の行を入力した後で、この行のエラーを訂正するために同じ有効日の別の行を入力する際に、不要なトリガが作成されるのを防ぐことができます。

• トリガ定義がフィールドで、値に依存する場合、PeopleCode により、指定された有効日の有効日連番行ごとに、それぞれ別個のトリガが挿入されます。言い換えると、値に依存するようにトリガが定義されている場合、同一有効日連番の行が全て処理されます。これは、同一有効日連番の複数の行を処理することが必要、または望ましい状況に対応します。たとえば、異動と昇進を同じ日に続けて入力する JOB.ACTION のようなフィールドが該当します。このフィールドのトリガ定義は通常、値に依存するように設定されています。