ヘッダーをスキップ

Oracle Assetsユーザー・ガイド
リリース12
E06049-01
目次へ
目次
前のページへ
前へ
次のページへ
次へ

Oracle Assetsの償却累計額振替API

この付録では、次のトピックについて説明します。

はじめに

Oracle Assetsの既存のインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。償却累計額振替では、償却累計額の一部をあるグループ資産から別のグループ資産に移動し、現行期間の修正額償却として処理できます。あるグループ資産から別のグループ資産への償却累計額振替は、ユーザー・インタフェースを介した場合のみ可能です。

代替元帳通貨

代替元帳通貨を設定している場合は、Oracle Assets APIを使用して資産を追加または変更すると、その取引はAPIによって報告通貨に自動的にコピーされます。請求書端数処理の問題は、APIを使用して、元帳通貨と報告通貨の両方に対して代替元帳通貨会計処理を実行することで回避されます。

関連項目

償却累計額振替APIの摘要

サンプル・スクリプト: 償却累計額振替APIの使用

償却累計額振替APIの摘要

償却累計額振替APIプロシージャは、FA_RESERVE_TRANSFER_PUB.DO_RESERVE_TRANSFER ()プロシージャと呼ばれます。次の表に、FA_RESERVE_TRANSFER_PUB.DO_RESERVE_TRANSFER ()プロシージャの各要素の引数、型、値および説明を示します。

各引数には、P、XまたはPXのプリフィクスが付加されます。それぞれの意味は、次のとおりです。

引数 説明
P_API_VERSION NUMBER 内部使用のみ。 使用しているAPIのバージョン。
P_INIT_MESG_LIST VARCHAR2(1) FND_API.G_TRUE: メッセージ・スタックを初期化します。
FND_API.G_FALSE: メッセージ・スタックを初期化しません(デフォルト)。
メッセージ・スタックを初期化および消去するかどうかを決定します。
P_COMMIT VARCHAR2(1) FND_API.G_TRUE: 自動的にコミットします。
FND_API.G_FALSE: 自動的にコミットしません(デフォルト)。
取引をコミットします。
P_VALIDATION_LEVEL NUMBER FND_API.G_VALID_ LEVEL_NONE: 取引に対して低レベルの検証を実行します。
FND_API.G_VALID_ LEVEL_FULL: 取引に対して高レベルの検証を実行します(デフォルト)。
APIによる資産の検証。
X_RETURN_STATUS VARCHAR2(1) FND_API.G_RET_STS_ SUCCESS: 成功を示します。
FND_API.G_RET_STS_ ERROR: 取引の失敗を示します。
FND_API.G_RET_STS_ UNEXP_ERROR: 予期しないエラーを示します。
APIの成功を判別します。
X_MSG_COUNT NUMBER   メッセージ・スタックのメッセージ数。
X_MSG_DATA VARCHAR2(1024)   メッセージ・スタック。
P_CALLING_FN VARCHAR2(30)   APIをコールする関数。
P_SRC_ASSET_ID NUMBER   振替元資産ID。
P_DEST_ASSET_ID NUMBER   振替先資産ID。
P_BOOK_TYPE_CODE VARCHAR2(15)   台帳タイプ・コード。
P_AMOUNT NUMBER   資産金額。
PX_SRC_TRANS_REC FA_API_TYPES.TRANS_REC_TYPE   資産振替元取引レコード。
PX_DEST_TRANS_REC FA_API_TYPES.TRANS_REC_TYPE   資産振替先取引レコード。

ASSET_SRC_TRANS_REC取引体系

ASSET_SRC_TRANS_REC取引体系には、取引ヘッダーIDや取引タイプ・コードなど、取引に関する情報が記載されています。次の表に、各引数の型および値の情報を示します。

引数 必須/オプション
TRANSACTION_HEADER_ ID 内部使用のみ NUMBER(15) オプションのOUTパラメータ。
TRANSACTION_DATE_ENTERED オプション DATE 事業供用日にデフォルト設定されます。
TRANSACTION_NAME オプション VARCHAR2(20) 取引の摘要。このフィールドは、資産ワークベンチの「注釈」フィールドです。
MASS_REFERENCE_ID オプション NUMBER(15) 取引を起動したコンカレント要求を識別します(一括取引の一部の場合)。
TRANSACTION_SUBTYPE オプション VARCHAR2(9) 取引タイプに関する追加情報。
AMORTIZATION_START_DATE オプション DATE 償却開始日。
CALLING_INTERFACE オプション VARCHAR2(30) APIをコールするインタフェース。このフィールドは、CUSTOMにデフォルト設定されます。
DESC_FLEX オプション DESC_FLEX_ REC_ TYPE 付加フレックスフィールド・セグメント。
WHO_INFO 必須 STANDARD_ WHO_REC_ TYPE 標準WHO列。

ASSET_DEST_TRANS_REC取引体系

ASSET_DEST_TRANS_REC取引体系には、取引ヘッダーIDや取引タイプ・コードなど、取引に関する情報が記載されています。次の表に、各引数の型および値の情報を示します。

引数 必須/オプション
TRANSACTION_HEADER_ID 内部使用のみ NUMBER(15) オプションのOUTパラメータ。
TRANSACTION_DATE_ENTERED オプション DATE 事業供用日にデフォルト設定されます。
TRANSACTION_NAME オプション VARCHAR2(20) 取引の摘要。このフィールドは、資産ワークベンチの「注釈」フィールドです。
MASS_REFERENCE_ID オプション NUMBER(15) 取引を起動したコンカレント要求を識別します(一括取引の一部の場合)。
TRANSACTION_SUBTYPE オプション VARCHAR2(9) 取引タイプに関する追加情報。
AMORTIZATION_START_DATE オプション DATE 償却開始日。
CALLING_INTERFACE オプション VARCHAR2(30) APIをコールするインタフェース。このフィールドは、CUSTOMにデフォルト設定されます。
DESC_FLEX オプション DESC_FLEX_ REC_ TYPE 付加フレックスフィールド・セグメント。
WHO_INFO 必須 STANDARD_WHO_REC_TYPE 標準WHO列。

サンプル・スクリプト: 償却累計額振替APIの使用

set serveroutput on



declare



   l_book_type_code           varchar2(15);

   l_src_asset_id             number;

   l_dest_asset_id            number;

   l_amount                   number;

   l_src_trans_rec            FA_API_TYPES.trans_rec_type;

   l_dest_trans_rec           FA_API_TYPES.trans_rec_type;



   l_return_status            VARCHAR2(1);

   l_mesg_count               number;

   l_mesg                     varchar2(4000);

   

begin



   dbms_output.enable(1000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- asset header info

   l_book_type_code            := '&book';

   l_src_asset_id              := &src_asset_id

   l_dest_asset_id             := &dest_asset_id

   l_amount                    := &amount

          

   -- call the api

   FA_RESERVE_TRANSFER_PUB.do_reserve_transfer(

           -- std parameters

           p_api_version         => 1.0,

           p_init_msg_list       => FND_API.G_FALSE,

           p_commit              => FND_API.G_FALSE,

           p_validation_level    => FND_API.G_VALID_LEVEL_FULL,

           p_calling_fn          => NULL,

           x_return_status       => l_return_status,

           x_msg_count           => l_mesg_count,

           x_msg_data            => l_mesg,

           -- api parameters

           p_src_asset_id        => l_src_asset_id,

           p_dest_asset_id       => l_dest_asset_id,

           p_book_type_code      => l_book_type_code,

           p_amount              => l_amount,

           px_src_trans_rec      => l_src_trans_rec,

           px_dest_trans_rec     => l_dest_trans_rec

          );



   --dump messages

   l_mesg_count := fnd_msg_pub.count_msg;



   if l_mesg_count > 0 then



      l_mesg := chr(10) || substr(fnd_msg_pub.get

                                    (fnd_msg_pub.G_FIRST, fnd_api.G_FALSE),

                                     1, 250);

      dbms_output.put_line(l_mesg);



      for i in 1..(l_mesg_count - 1) loop

         l_mesg :=

                     substr(fnd_msg_pub.get

                            (fnd_msg_pub.G_NEXT,

                             fnd_api.G_FALSE), 1, 250);



         dbms_output.put_line(l_mesg);

      end loop;



      fnd_msg_pub.delete_msg();



   end if;



   if (l_return_status <> FND_API.G_RET_STS_SUCCESS) then

     dbms_output.put_line('FAILURE');

   else

     dbms_output.put_line('SUCCESS');

     dbms_output.put_line('TRX_REFERENCE_ID ' || to_char(l_src_trans_rec.trx_reference_id));

     dbms_output.put_line('SRC_ASSET_ID ' || to_char(l_src_asset_id));

     dbms_output.put_line('DEST_ASSET_ID ' || to_char(l_dest_asset_id));

   end if;



end;

/