Oracle Assetsユーザー・ガイド リリース12 E06049-01

目次

前へ

次へ

Oracle Assetsの建設仮勘定資産計上および建設仮勘定戻し処理API

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

• はじめに
• 建設仮勘定資産計上APIの摘要
• 建設仮勘定戻し処理APIの摘要
• 資産計上および戻し処理に使用される標準タイプ
• サンプル・スクリプト: 建設仮勘定資産計上APIの使用
• サンプル・スクリプト: 建設仮勘定戻し処理APIの使用

はじめに

Oracle Assetsの既存のインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。建設仮勘定APIでは、資産計上にFA_CIP_PUB.DO_CAPITALIZATION ()プロシージャが、資産計上の戻し処理にFA_CIP_PUB.DO_REVERSE ()が使用されます。資産修正用の既存のOracle Assetsインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。

代替元帳通貨

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

関連項目

建設仮勘定資産計上APIの摘要

建設仮勘定戻し処理APIの摘要

サンプル・スクリプト: 建設仮勘定資産計上APIの使用

サンプル・スクリプト: 建設仮勘定戻し処理APIの使用

建設仮勘定資産計上APIの摘要

建設仮勘定資産計上APIプロシージャは、FA_CIP_PUB.DO_CAPITALIZATION ()と呼ばれます。

次の表に、FA_CIP_PUB.DO_CAPITALIZATION ()プロシージャの各要素の引数、型、値および説明を示します。

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

• P: In引数を示します。

• X: Out引数を示します。

• PX: InとOutの両方の引数を示します。

建設仮勘定戻し処理APIの摘要

建設仮勘定戻し処理APIプロシージャは、FA_CIP_PUB.DO_REVERSE ()と呼ばれます。

次の表に、FA_CIP_PUB.DO_REVERSE ()プロシージャの各要素の引数、型、値および説明を示します。

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

• P: In引数を示します。

• X: Out引数を示します。

• PX: InとOutの両方の引数を示します。

資産計上および戻し処理に使用される標準タイプ

このAPIの主な利点の1つは、スカラー・パラメータ型のリストのかわりに体系を使用する点にあります。スカラー・パラメータ型のかわりに体系を使用することで、修正取引に必要な情報のみが渡されるため、インタフェースのコールが容易になります。

注意: ユーザーによる直接入力ではなく内部で導出された列へのアクセスは可能です。たとえば、取引のTRANSACTION_HEADER_ID（参照番号）を確認する場合は、PX_TRANS_REC.TRANSACTION_HEADER_IDの内容を参考にしたり、コピーできます。

TRANS_REC_TYPE取引体系

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

ASSET_HDR_REC_TYPE資産体系

ASSET_HDR_REC_TYPE資産体系には、資産IDや台帳タイプ・コードなど、特定の資産に関する一意の識別情報が記載されています。次の表に、各引数の型と値の情報を示します。

ASSET_FIN_REC_TYPE資産体系

ASSET_FIN_REC_TYPE資産体系には、特定資産の財務情報が記載されています。次の表に、各引数の型と値の情報を示します。

次の内容は、グループ資産に関連します。

• DISABLED_FLAG

• OVER_DEPRECIATE_OPTION

• SUPER_GROUP_ID

• REDUCE_ADDITION_FLAG

• REDUCE_ADJUSTMENT_FLAG

• REDUCE_RETIREMENT_FLAG

• RECOGNIZE_GAIN_LOSS

• RECAPTURE_RESERVE_FLAG

• LIMIT_PROCEEDS_FLAG

• TERMINAL_GAIN_LOSS

• TRACKING_METHOD

• EXCESS_ALLOCATION_OPTION

• DEPRECIATION_OPTION

• MEMBER_ROLLUP_FLAG

• ALLOCATE_TO_FULLY_RSV_FLAG

REDUCTION_RATEは、グループ資産およびメンバー資産用です。

サンプル・スクリプト: 建設仮勘定資産計上APIの使用

次に、建設仮勘定の資産計上の例を示します。この例では、必要な体系が移入され、次に、建設仮勘定資産計上APIがコールされます。

set serveroutput on



declare



   l_trans_rec                FA_API_TYPES.trans_rec_type;

   l_asset_hdr_rec            FA_API_TYPES.asset_hdr_rec_type;

   l_asset_fin_rec            FA_API_TYPES.asset_fin_rec_type;



   l_return_status            VARCHAR2(1);

   l_mesg_count               number;

   l_mesg                     varchar2(512);



begin



   dbms_output.enable(1000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- asset header info

   l_asset_hdr_rec.asset_id       := &asset_id



   -- fin info

   l_asset_fin_rec.date_placed_in_service := '&dpis';





   FA_CIP_PUB.do_capitalization(

           -- 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

           px_trans_rec          => l_trans_rec,

           px_asset_hdr_rec      => l_asset_hdr_rec,

           px_asset_fin_rec      => l_asset_fin_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('THID' || to_char(l_trans_rec.transaction_header_id));

   end if;





end;

/

サンプル・スクリプト: 建設仮勘定戻し処理APIの使用

次に、建設仮勘定の資産計上戻し処理の例を示します。この例では、必要な体系が移入され、次に、建設仮勘定戻し処理APIがコールされます。

set serveroutput on



declare



   l_trans_rec                FA_API_TYPES.trans_rec_type;

   l_asset_hdr_rec            FA_API_TYPES.asset_hdr_rec_type;

   l_asset_fin_rec            FA_API_TYPES.asset_fin_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_asset_hdr_rec.asset_id          := &asset_id



   FA_CIP_PUB.do_reverse(

           -- 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

           px_trans_rec               => l_trans_rec,

           px_asset_hdr_rec           => l_asset_hdr_rec,

           px_asset_fin_rec           => l_asset_fin_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('THID' || to_char(l_trans_rec.transaction_header_id));

   end if;



end;

/

Copyright © 1988, 2007, Oracle. All rights reserved.