ユニット間およびユニット内プロセッサの実行

ユニット間およびユニット内プロセッサを呼び出すための技術的な要件

カスタマイズを実装してユニット間/ユニット内プロセッサを利用する場合は、次の要件を考慮します。

ユニット間プロセッサの呼出し

ユニット間/ユニット内プロセッサ (IU_PROCESSOR) は、アプリケーション エンジン プログラムです。多くの場合、AP 伝票転記や GL 仕訳編集などの別のアプリケーション エンジン プログラムから呼び出されます。CallAppEngine ビルトイン関数を使用して、PeopleCode から直接呼び出す場合もあります。

プロセッサを呼び出す場合は、次のセクションで説明するように、まずステート レコード (IU_PROCESS_AET) のフィールドに入力する必要があります。別のアプリケーション エンジン プログラムからプロセッサを呼び出す場合は、使用しているプログラムのステート レコードのリストにあるユニット間/ユニット内プロセッサ ステート レコードを指定する必要があります。

ユニット間およびユニット内プロセッサでは、一部の内部処理に一時テーブル (IU_TRAN_TAO) を使用します。別のアプリケーション エンジン プログラムからプロセッサを呼び出す場合は、一時テーブルのリストにあるこのレコードを指定して、アプリケーション エンジン プログラムを呼び出します。この方法で、専用インスタンスがプロセスの最初に割り当てられます。一時テーブルの割当に関するその他の情報は、『PeopleTools Application Engine』ドキュメントを参照してください。

プロセッサからアプリケーションにコントロールを戻す場合、ステート レコードのプロセッサ ステータス フィールド (IU_STATUS) の値を確認して、処理中にプロセッサでエラーが発生していないかどうかを判断します。

ユニット間プロセッサ ステート レコード (IU_PROCESS_AET)

ユニット間/ユニット内プロセッサ ステート レコードは、呼出プログラムとユニット内およびユニット間プロセッサとの間でパラメータを渡す際に使用されます。次のフィールドを含むには、レコードに表示される順序でリストされます。

プロセス インスタンス (PROCESS_INSTANCE)

プロセス インスタンスは、各アプリケーション エンジン ステート レコードで必須です。このフィールドは PeopleSoft ツールによって自動的に入力されます。

ビジネス ユニット (BUSINESS_UNIT)

ユニット間およびユニット内プロセッサでビジネス ユニット専用の貸借一致入力を作成する場合に、このフィールドに一般会計ビジネス ユニットの値を挿入します。

ヘッダー (入力) レコード (HEADER_RECORD)

ヘッダー レコードは、未処理の会計入力の関連データを、貸借一致を行うユニット間およびユニット内プロセッサに送信するために使用します。これは、SQL テーブル、SQL ビューまたは一時テーブルです。

ヘッダー更新レコード (UPDATE_HEADER_REC)

ヘッダー更新レコードは、[ヘッダー ステータス] フィールドの更新に使用します。これは SQL テーブルまたは一時テーブルで、ヘッダー (入力) レコードが SQL ビューである場合以外は、多くの場合ヘッダー (入力) レコードと同じです。

明細行 (入力) レコード (LINE_RECORD)

明細行レコードは、未処理の会計入力の関連データを、貸借一致を行うユニット間およびユニット内プロセッサに送信するために使用します。これは、SQL テーブル、SQL ビューまたは一時テーブルです。次のフィールドが含まれている必要があります。

• GL (一般会計) ビジネス ユニット

• 外貨

• 外貨金額

• 会計処理日 (明細またはオプション ヘッダーに記載)

• レート タイプ (明細またはオプション ヘッダーに記載)

• 通貨有効日 (明細またはオプション ヘッダーに記載、会計処理日と同じ日付の可能性あり)

• チャートフィールド (標準サブレコードと部門 ID およびプロジェクト ID のチャートフィールド)

• 元帳グループ (LEDGER_GROUP)

• 元帳 (LEDGER)

• IU 基準フラグ (IU_ANCHOR_FLG)

• IU システム取引 (IU_SYS_TRAN_CD)

• IU 取引コード (IU_TRAN_CD)

明細行更新レコード (UPDATE_LINE_REC)

明細行更新レコードは、元の会計入力の [ドキュメント ステータス] フィールドと [取引ステータス] フィールドの更新に使用されます。これは SQL テーブルまたは一時テーブルで、明細行 (入力) レコードが SQL ビューである場合以外は、多くの場合明細行 (入力) レコードと同じです。

明細行挿入レコード (INSERT_LINE_REC)

明細行挿入レコードは、プロセッサが作成したユニット間およびユニット内貸借一致入力を挿入するレコードです。これは SQL テーブルまたは一時テーブルで、多くの場合明細行 (入力) レコードまたは明細行更新レコードと同じです。

ユニット間およびユニット内貸借一致入力を会計入力テーブルに挿入する前に、それらに対して呼出アプリケーションで別の操作を実行する必要がある場合は、別の明細行挿入レコードを使用できます。たとえば、連番の採番に関して呼出アプリケーションに標準以外のルールがある場合、プロセッサで連番を割り当てるよりも、プロセッサが貸借一致入力を作成後にこの機能を実行することをお勧めします。

明細ワーク レコード (LINE_WRK_REC)

明細ワーク レコードは、ユニット間/ユニット内プロセッサで内部的に使用されます。これは、SQL テーブルまたは一時テーブルです。ここには、明細行レコードと同じフィールドが全て含まれる他に、次のフィールド (まだ明細行レコードにない場合) も含まれます。

• プロセス インスタンス (PROCESS_INSTANCE)

• ユニット間行タイプ (IU_LINE_TYPE)

• システム取引の勘定残高グループ オプションが選択されている場合、ワーク レコードにも勘定残高グループ (ACT_BAL_GRP) フィールドが含まれている必要があります。

明細ワーク レコード 2 (LINE_WRK2_REC)

明細ワーク レコード 2 は、ユニット間/ユニット内プロセッサで内部的に使用されます。これは、SQL テーブルまたは一時テーブルです。ここには、明細ワーク レコードと同じフィールドが全て含まれる他に、次のフィールド (まだ明細行レコードにない場合) も含まれます。

最大連番 (MAX_SEQ_NBR)

エラー メッセージ セットおよび番号 (MESSAGE_SET_NBR and MESSAGE_NBR)

プロセッサで返されるステータスが [完了 - エラーあり] (IU_STATUS = 1) の場合、これらのフィールドには該当するエラー メッセージのメッセージ セットとメッセージ番号が表示されます。

ユニット間/ユニット内プロセッサ ステータス (IU_STATUS)

IU プロセッサ ステータスには次の有効な値があります。

0 - 完了 - エラーなし。

1 - 完了 - エラーあり。

2 - 未完了。

ユニット間/ユニット内プロセッサを呼び出す前にステート レコードを入力する場合は、ステータスを [2 - 未完了] に設定するのがベスト プラクティスです。プロセッサが呼出プログラムにコントロールを戻す場合、ステータスは [0 - 完了 - エラーなし] または [1 - 完了 - エラーあり] に設定されます。

動的 Where 句、パート 1 (SQL_STMT_254)

動的 Where 句は、プロセッサが呼び出されるたびに変更する選択条件を指定するために使用します。定数または静的の選択条件は、通常システム取引定義で定義されますが、必要な場合はここに含めることもできます。

Where 句は、明細行レコードとオプションのヘッダー レコードの両方のフィールドを参照できます。明細行レコードのフィールドに対する全ての参照ではレコードの別名 LN_A を使用し、ヘッダー レコードの全ての行ではレコードの別名 HDR を使用します。

Where 句が 254 文字を超える場合、このフィールドの代わりまたはこのフィールドに加えて次の IU_WHERE_SQL フィールドを使用できます。

システム取引コード (IU_SYS_TRAN_CD)

明細行 (入力) レコードの全ての取引が、同じユニット間システム取引コードの取引である場合、またはシステム取引専用の入力を処理する場合は、ステート レコードにあるこのフィールドのシステム取引コードを指定します。これにより、プロセッサの効率が向上します。

明細行 (入力) レコードに 2 つ以上のシステム取引が含まれており、1 呼出でプロセッサに処理させる場合は、このフィールドを空白のままにします。

動的 Where 句、パート 2 (IU_WHERE_SQL)

前述の動的 Where 句の続きです。Where 句が 254 文字を超える場合、前述の SQL_STMT_254 フィールドの代わりまたはこのフィールドに加えて、この長い文字列のフィールドを使用できます。

ユニット間/ユニット内プロセッサの基準値の指定

ユニット間/ユニット内プロセッサでは、ユニット間基準 (IU_ANCHOR_FLG) が Y に設定されている会計入力行を探し、各取引グループ (または取引グループ化フィールドが使用されていない場合はドキュメント グループ) について、他の貸借一致チャートフィールドの基準ビジネス ユニットと基準値を決定します。

各取引グループ (または取引グループ化フィールドが使用されていない場合はドキュメント グループ) に、元帳ごとの基準入力として指定される会計入力が 1 つのみであることが重要です。

基準行 (IU_ANCHOR_FLG = Y) とマーク付けされている行は、借勘定および貸勘定明細のフォーマット方法に影響を与えます。たとえば、ユニット間およびユニット内プロセッサを呼び出して次の明細を処理するとします。

前の情報の処理に基づいて、プロセッサで次の明細が作成されます。

ただし、最初の行ではなく 2 番目の行に Y の値と基準が入るように元の想定を変更する場合は、プロセッサで作成された借勘定明細および貸勘定明細は次のように表示されます。

次の例では、IU_ANCHOR_FLG によって通貨間取引の借勘定明細と貸勘定明細の取引 (外貨) 通貨と金額がどのようにして決定されるかを説明します。このプロセッサ ルールは、借勘定および貸勘定明細に基準外明細の取引通貨と金額があるというルールです。たとえば、次の取引明細に対してプロセッサを実行するとします。

次の明細は、前の想定に従ってプロセッサが作成した明細です。

複数帳簿入力およびユニット間/ユニット内プロセッサ

呼出アプリケーションで PeopleSoft 複数帳簿処理がサポートされている場合、アプリケーションでは通常、プロセッサを呼び出す前に主元帳と補助元帳の両方に対して会計入力を作成します。この場合、主元帳の 1 入力と対応する補助元帳の全ての入力が、各取引グループ (または取引グループ化フィールドが使用されていない場合はドキュメント グループ) の基準入力として全てフラグ付されます。

次の例では、ユニット間/ユニット内プロセッサを呼び出すときに、実行時に指定される一般会計のパラメータのタイプを説明します。

次のフィールドの JRNL_IU_ANCHOR テーブルでは、ユニット間およびユニット内基準値が管理されます。

ユニット間でない仕訳ではこのテーブルに入力されていないため、このテーブルはユニット間およびユニット内仕訳の特定にも使用されます。

JRNL_HEADER テーブルの次のフィールドでは、ユニット間プロセッサの呼出しがサポートされています。

ユニット間およびユニット内プロセッサを呼び出す前に、JRNL_LN テーブルの次のフィールドに正しく入力する必要があります。