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

目次

前へ

次へ

Oracle Assetsの追加API

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

• はじめに
• 追加APIの摘要
• サンプル・スクリプト: 請求書による追加APIの使用
• サンプル・スクリプト: 請求書のない追加APIの使用
• サンプル・スクリプト: 代替元帳通貨対応の請求書による追加APIの使用

はじめに

Oracle Assetsの既存のインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。この追加APIでは、FA_ADDITION_PUB.DO_ADDITIONプロシージャが使用されます。Oracle Assetsの既存の資産追加インタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。

Oracle Assetsでは、次の方法のいずれかを使用して資産を追加することもできます。

• 資産クイック登録: 手動で入力する必要がある通常の資産をすばやく入力するには、この資産クイック登録を使用します。「資産クイック登録」ウィンドウで最小限の情報を入力すると、残りの資産情報は資産カテゴリ、資産台帳および事業供用日からデフォルト設定できます。

• 詳細追加: 残存価額や複数の割当がある資産など、資産クイック登録処理では処理できない複雑な資産を手動で追加するには、この詳細追加処理を使用します。

• 一括追加: 資産を外部ソースから自動的に追加するには、この一括追加処理を使用します。資産は、Oracle Payables内の複数の請求書配分明細、Oracle Projects内の建設仮勘定明細、他の資産システムからの資産情報、またはインタフェースを使用した他のフィーダ・システムからの情報から作成されます。

代替元帳通貨

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

建設仮勘定

税務台帳の「資産台帳管理」ウィンドウで「建設仮勘定資産の許可」チェック・ボックスを選択している場合は、追加APIを使用して建設仮勘定資産を追加すると、その建設仮勘定資産が税務台帳に自動的に追加され、同時に会計用資産台帳にも追加されます。

NULL値の受渡し

BONUS_RULE、CEILING_NAMEまたはGROUP_ASSET_IDの値をNULLに設定するためには、特別な値を渡す必要があります。これらの値にNULL値を直接渡した場合、APIでは、カテゴリに対する設定値に自動的にデフォルト設定されます。次の表に、NULLのフィールド値に渡す必要がある値を示します。

関連項目

追加APIの摘要

サンプル・スクリプト: 請求書による追加APIの使用

サンプル・スクリプト: 請求書のない追加APIの使用

追加APIの摘要

追加APIプロシージャは、FA_ADDITION_PUB.DO_ADDITION ()と呼ばれています。

次の表に、このFA_ADDITION_PUB.DO_ADDITIONプロシージャの各要素の引数、タイプ、値および説明を示します。

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

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

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

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

TRANS_REC_TYPE取引体系

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

ASSET_HDR_REC_TYPE資産体系

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

ASSET_DESC_REC_TYPE資産体系

ASSET_DESC_REC_TYPE資産体系には、現品票番号、シリアル番号、製造業者名など、資産に関する摘要情報が記載されています。次の表に、各引数の型と値の情報を示します。

ASSET_TYPE_REC_TYPE資産体系

ASSET_TYPE_REC_TYPE資産体系には、資産タイプ（建設仮勘定、資産計上、費用処理済）に関する情報が記載されています。次の表に、各引数の型と値の情報を示します。

ASSET_CAT_REC_TYPE資産体系

ASSET_CAT_REC_TYPE資産体系には、カテゴリIDやカテゴリ付加フレックスフィールドなど、資産カテゴリに関する情報が記載されています。次の表に、各引数の型と値の情報を示します。

ASSET_HIERARCHY_REC_TYPE資産体系

ASSET_HIERARCHY_REC_TYPE資産体系には、資産が資産階層に属するかどうかに関する情報が記載されています。この資産体系は、CRL資産にのみ適用されます。次の表に、各引数の型と値の情報を示します。

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は、グループ資産およびメンバー資産用です。

ASSET_DEPRN_REC_TYPE資産体系

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

ASSET_DIST_REC_TYPE資産体系

ASSET_DIST_REC_TYPE資産体系には、単一の振替元または振替先の配分明細が記載されています。単一の振替取引を構成するASSET_DIST_REC_TYPEレコードは、ASSET_DIST_TBL_TYPE表に格納されています。各振替取引には、少なくとも1つの振替元明細と1つの振替先明細が必要です。次の表に、各引数の型と値の情報を示します。

INV_REC_TYPE請求書体系

INV_REC_TYPE請求書体系には、資産に関連付けられている単一の請求書の請求書情報が記載されています。INV_TBL_TYPEはINV_REC_TYPEレコードの表です。これらのレコードには、資産に割り当てられているすべての請求書が含まれています。次の表に、各引数の型と値の情報を示します。

INV_RATE_REC_TYPE請求書レート体系

INV_RATE_REC_TYPE請求書体系には、請求書のレート情報が記載されています。INV_RATE_REC_TYPEレコードには、1つの換算レートが含まれています。INV_RATE_TBL_TYPEはINV_RATE_REC_TYPEレコードの表です。この表は、資産の換算レートを判別するために、代替元帳通貨で使用されます。次の表に、各引数の型と値の情報を示します。

サンプル・スクリプト: 請求書による追加APIの使用

次のサンプル・スクリプトに、請求書による追加APIの使用方法を示します。

set serveroutput on



declare



   l_trans_rec                FA_API_TYPES.trans_rec_type;

   l_dist_trans_rec           FA_API_TYPES.trans_rec_type;

   l_asset_hdr_rec            FA_API_TYPES.asset_hdr_rec_type;

   l_asset_desc_rec           FA_API_TYPES.asset_desc_rec_type;

   l_asset_cat_rec            FA_API_TYPES.asset_cat_rec_type;

   l_asset_type_rec           FA_API_TYPES.asset_type_rec_type;

   l_asset_hierarchy_rec      FA_API_TYPES.asset_hierarchy_rec_type;

   l_asset_fin_rec            FA_API_TYPES.asset_fin_rec_type;

   l_asset_deprn_rec          FA_API_TYPES.asset_deprn_rec_type;

   l_asset_dist_rec           FA_API_TYPES.asset_dist_rec_type;

   l_asset_dist_tbl           FA_API_TYPES.asset_dist_tbl_type;

   l_inv_tbl                  FA_API_TYPES.inv_tbl_type;

   l_inv_rate_tbl             FA_API_TYPES.inv_rate_tbl_type;

   l_inv_rec                  FA_API_TYPES.inv_rec_type;



   l_return_status            VARCHAR2(1);          

   l_mesg_count               number;

   l_mesg                     varchar2(4000);



begin



   dbms_output.enable(10000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- desc info

   l_asset_desc_rec.description               := '&description';



   -- cat info

   l_asset_cat_rec.category_id                := &category_id



   --type info

   l_asset_type_rec.asset_type                := '&ASSET_TYPE';



   -- invoice info

   l_inv_rec.fixed_assets_cost                := 2500;

   l_inv_rec.deleted_flag                     := 'NO';

   l_inv_rec.description                      := l_asset_desc_rec.description;

   l_inv_rec.unrevalued_cost                  := 5555;

   l_inv_rec.create_batch_id                  := 1000;

   l_inv_rec.payables_code_combination_id     := 13528;

   l_inv_rec.feeder_system_name               := 'ACK';

   l_inv_rec.payables_cost                    := 5555;

   l_inv_rec.payables_units                   := 1;

   l_inv_rec.po_vendor_id                     := 1;

   l_inv_rec.inv_indicator                    := 1;



   l_inv_tbl (1)                              := l_inv_rec;



   -- fin info

   l_asset_fin_rec.date_placed_in_service     := '&DPIS';

   l_asset_fin_rec.depreciate_flag            := 'YES';





   -- book / trans info

   l_asset_hdr_rec.book_type_code             := '&book';



   -- distribution info 

   l_asset_dist_rec.units_assigned            := 1;

   l_asset_dist_rec.expense_ccid              := &ccid

   l_asset_dist_rec.location_ccid             := &location_id

   l_asset_dist_rec.assigned_to               := null;

   l_asset_dist_rec.transaction_units         := l_asset_dist_rec.units_assigned;

   l_asset_dist_tbl(1)                        := l_asset_dist_rec;



   -- call the api

   fa_addition_pub.do_addition(

           -- 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_dist_trans_rec         => l_dist_trans_rec,

           px_asset_hdr_rec          => l_asset_hdr_rec,

           px_asset_desc_rec         => l_asset_desc_rec,

           px_asset_type_rec         => l_asset_type_rec,

           px_asset_cat_rec          => l_asset_cat_rec,

           px_asset_hierarchy_rec    => l_asset_hierarchy_rec,

           px_asset_fin_rec          => l_asset_fin_rec,

           px_asset_deprn_rec        => l_asset_deprn_rec,

           px_asset_dist_tbl         => l_asset_dist_tbl,

           px_inv_tbl                => l_inv_tbl

          );

 

   dbms_output.put_line(l_return_status);



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

     dbms_output.put_line('ASSET_ID' || to_char(l_asset_hdr_rec.asset_id));

     dbms_output.put_line('ASSET_NUMBER' || l_asset_desc_rec.asset_number);

   end if;



end;

/

サンプル・スクリプト: 請求書のない追加APIの使用

次のサンプル・スクリプトに、請求書情報を使用しないときに、追加APIを使用して手動変更をテストする方法を示します。

set serveroutput on



declare



   l_trans_rec                FA_API_TYPES.trans_rec_type;

   l_dist_trans_rec           FA_API_TYPES.trans_rec_type;

   l_asset_hdr_rec            FA_API_TYPES.asset_hdr_rec_type;

   l_asset_desc_rec           FA_API_TYPES.asset_desc_rec_type;

   l_asset_cat_rec            FA_API_TYPES.asset_cat_rec_type;

   l_asset_type_rec           FA_API_TYPES.asset_type_rec_type;

   l_asset_hierarchy_rec      FA_API_TYPES.asset_hierarchy_rec_type;

   l_asset_fin_rec            FA_API_TYPES.asset_fin_rec_type;

   l_asset_deprn_rec          FA_API_TYPES.asset_deprn_rec_type;

   l_asset_dist_rec           FA_API_TYPES.asset_dist_rec_type;

   l_asset_dist_tbl           FA_API_TYPES.asset_dist_tbl_type;

   l_inv_tbl                  FA_API_TYPES.inv_tbl_type;

   l_inv_rate_tbl             FA_API_TYPES.inv_rate_tbl_type;



   l_return_status            VARCHAR2(1);     

   l_mesg_count               number;

   l_mesg                     varchar2(4000);



begin



   dbms_output.enable(10000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- desc info

   l_asset_desc_rec.description                  := '&description';

   l_asset_desc_rec.asset_key_ccid               := null;



   -- cat info 

   l_asset_cat_rec.category_id                   := &category_id



   --type info

   l_asset_type_rec.asset_type                   := '&asset_type';



   -- fin info

   l_asset_fin_rec.cost                          := &cost

   l_asset_fin_rec.date_placed_in_service        := '&DPIS';

   l_asset_fin_rec.depreciate_flag               := 'YES';



   -- deprn info

   l_asset_deprn_rec.ytd_deprn                   := &ytd

   l_asset_deprn_rec.deprn_reserve               := &reserve

   l_asset_deprn_rec.bonus_ytd_deprn             := 0;

   l_asset_deprn_rec.bonus_deprn_reserve         := 0;



   -- book / trans info

   l_asset_hdr_rec.book_type_code                := '&book';



   -- distribution info

   l_asset_dist_rec.units_assigned               := 1;

   l_asset_dist_rec.expense_ccid                 := &ccid

   l_asset_dist_rec.location_ccid                := &location_id

   l_asset_dist_rec.assigned_to                  := null;

   l_asset_dist_rec.transaction_units            := l_asset_dist_rec.units_assigned;

   l_asset_dist_tbl(1)                           := l_asset_dist_rec;



   -- call the api 

   fa_addition_pub.do_addition(

           -- 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_dist_trans_rec         => l_dist_trans_rec,

           px_asset_hdr_rec          => l_asset_hdr_rec,

           px_asset_desc_rec         => l_asset_desc_rec,

           px_asset_type_rec         => l_asset_type_rec,

           px_asset_cat_rec          => l_asset_cat_rec,

           px_asset_hierarchy_rec    => l_asset_hierarchy_rec,

           px_asset_fin_rec          => l_asset_fin_rec,

           px_asset_deprn_rec        => l_asset_deprn_rec,

           px_asset_dist_tbl         => l_asset_dist_tbl,

           px_inv_tbl                => l_inv_tbl

          );



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

     dbms_output.put_line('ASSET_ID' || to_char(l_asset_hdr_rec.asset_id));

     dbms_output.put_line('ASSET_NUMBER' || l_asset_desc_rec.asset_number);

   end if;



end;

/

サンプル・スクリプト: 代替元帳通貨対応の請求書による追加APIの使用

set serveroutput on



declare



   l_trans_rec                FA_API_TYPES.trans_rec_type;

   l_dist_trans_rec           FA_API_TYPES.trans_rec_type;

   l_asset_hdr_rec            FA_API_TYPES.asset_hdr_rec_type;

   l_asset_desc_rec           FA_API_TYPES.asset_desc_rec_type;

   l_asset_cat_rec            FA_API_TYPES.asset_cat_rec_type;

   l_asset_type_rec           FA_API_TYPES.asset_type_rec_type;

   l_asset_hierarchy_rec      FA_API_TYPES.asset_hierarchy_rec_type;

   l_asset_fin_rec            FA_API_TYPES.asset_fin_rec_type;

   l_asset_deprn_rec          FA_API_TYPES.asset_deprn_rec_type;

   l_asset_dist_rec           FA_API_TYPES.asset_dist_rec_type;

   l_asset_dist_tbl           FA_API_TYPES.asset_dist_tbl_type;

   l_inv_tbl                  FA_API_TYPES.inv_tbl_type;

   l_inv_rate_tbl             FA_API_TYPES.inv_rate_tbl_type;

   l_inv_rec                  FA_API_TYPES.inv_rec_type;



   l_return_status            VARCHAR2(1);          

   l_mesg_count               number;

   l_mesg                     varchar2(4000);



begin



   dbms_output.enable(10000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- desc info

   l_asset_desc_rec.description               := '&description';



   -- cat info

   l_asset_cat_rec.category_id                := &category_id



   --type info

   l_asset_type_rec.asset_type                := '&ASSET_TYPE';



   -- invoice info

   l_inv_rec.fixed_assets_cost                := 2500;

   l_inv_rec.deleted_flag                     := 'NO';

   l_inv_rec.description                      := l_asset_desc_rec.description;

   l_inv_rec.unrevalued_cost                  := 5555;

   l_inv_rec.create_batch_id                  := 1000;

   l_inv_rec.payables_code_combination_id     := 13528;

   l_inv_rec.feeder_system_name               := 'ACK';

   l_inv_rec.payables_cost                    := 5555;

   l_inv_rec.payables_units                   := 1;

   l_inv_rec.po_vendor_id                     := 1;

   l_inv_rec.inv_indicator                    := 1;



   l_inv_tbl (1)                              := l_inv_rec;



   -- rate info

   l_inv_rec.inv_rate_tbl(1).set_of_books_id  := 102;

   l_inv_rec.inv_rate_tbl(1).exchange_rate    := 2;

   l_inv_rec.inv_rate_tbl(1).cost             := 2001;



   -- fin info

   l_asset_fin_rec.date_placed_in_service     := '&DPIS';

   l_asset_fin_rec.depreciate_flag            := 'YES';





   -- book / trans info

   l_asset_hdr_rec.book_type_code             := '&book';



   -- distribution info 

   l_asset_dist_rec.units_assigned            := 1;

   l_asset_dist_rec.expense_ccid              := &ccid

   l_asset_dist_rec.location_ccid             := &location_id

   l_asset_dist_rec.assigned_to               := null;

   l_asset_dist_rec.transaction_units         := l_asset_dist_rec.units_assigned;

   l_asset_dist_tbl(1)                        := l_asset_dist_rec;



   -- call the api

   fa_addition_pub.do_addition(

           -- 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_dist_trans_rec         => l_dist_trans_rec,

           px_asset_hdr_rec          => l_asset_hdr_rec,

           px_asset_desc_rec         => l_asset_desc_rec,

           px_asset_type_rec         => l_asset_type_rec,

           px_asset_cat_rec          => l_asset_cat_rec,

           px_asset_hierarchy_rec    => l_asset_hierarchy_rec,

           px_asset_fin_rec          => l_asset_fin_rec,

           px_asset_deprn_rec        => l_asset_deprn_rec,

           px_asset_dist_tbl         => l_asset_dist_tbl,

           px_inv_tbl                => l_inv_tbl

          );

 

   dbms_output.put_line(l_return_status);



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

     dbms_output.put_line('ASSET_ID' || to_char(l_asset_hdr_rec.asset_id));

     dbms_output.put_line('ASSET_NUMBER' || l_asset_desc_rec.asset_number);

   end if;



end;

/

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