ヘッダーをスキップ

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

Oracle Assetsの除・売却詳細API

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

はじめに

Oracle Assetsの既存のインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。除・売却詳細APIを使用すると、インタフェースに関係なく、既存の除・売却に関する特定の詳細を変更できます。

代替元帳通貨

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

NULL値の受渡し

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

フィールド NULLフィールドに渡す値
BONUS_RULE FND_API.G_MISS_CHAR
CEILING_NAME FND_API.G_MISS_CHAR
GROUP_ASSET_ID FND_API.G_MISS_NUM

関連項目

除・売却詳細APIの摘要

サンプル・スクリプト: 除・売却詳細APIの使用

除・売却詳細APIの摘要

除・売却詳細APIプロシージャは、FA_ASSET_DESC_PUB.UPDATE_RETIREMENT_DESC()と呼ばれます。

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

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

引数 説明
P_API_VERSION NUMBER 内部使用のみ。 使用しているAPIのバージョン。
P_INIT_MSG_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をコールする関数。
PX_TRANS_REC FA_API_TYPES. TRANS_REC_TYPE   実行する取引を示します。
PX_ASSET_HDR_REC FA_API_TYPES. ASSET_HDR_REC_ TYPE   資産の一意の識別子。
PX_ASSET_RETIRE_REC_NEW FA_API_TYPES.ASSET_RETIRE_REC_TYPE    

TRANS_REC_TYPE取引体系

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

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

ASSET_HDR_REC_TYPE資産体系

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

引数 必須/オプション
ASSET_ID 必須 NUMBER(15) 資産識別番号。
BOOK_TYPE_CODE 必須 VARCHAR2(15) 台帳名。

ASSET_RETIRE_REC_TYPE資産体系

ASSET_RETIRE_REC_TYPE資産体系には、特定の資産が除・売却された場合の公開除・売却情報が記載されています。次の表に、各引数の型と値の情報を示します。

引数 必須/オプション
RETIREMENT_ID 必須 NUMBER(15) 除・売却識別番号。オプションのOUTパラメータです。
PROCEEDS_OF_SALE 必須 NUMBER 資産売却による売上代金。
COST_OF_REMOVAL 必須 NUMBER 資産の削除コスト。
RETIREMENT_TYPE_CODE オプション VARCHAR2(15) 除・売却タイプ。
RETIREMENT_PRORATE_ CONVENTION 必須 VARCHAR2(10) 除・売却の按分形式。例: MID-MONTH。
SOLD_TO オプション VARCHAR2(30) 資産の購買者。
TRADE_IN_ASSET_ID オプション NUMBER(15) この資産と交換された新規資産の資産識別番号。
REFERENCE_NUM オプション VARCHAR2(15) 参照番号。
DESC_FLEX オプション DESC_FLEX_ REC_TYPE 除・売却の付加フレックスフィールド情報。
STL_METHOD_CODE オプション    
STL_LIFE_IN_MONTHS オプション    

サンプル・スクリプト: 除・売却詳細APIの使用

set serveroutput on;



declare



   l_return_status           VARCHAR2(100);

   l_mesg_count              NUMBER:= 0;

   l_mesg                    VARCHAR2(4000);



   l_trans_rec               FA_API_TYPES.trans_rec_type;

   l_asset_hdr_rec           FA_API_TYPES.asset_hdr_rec_type;

   l_asset_retire_rec        FA_API_TYPES.asset_retire_rec_type;



begin



   dbms_output.enable(1000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- Retirement description info

   l_asset_retire_rec.retirement_id := &retirment_id



   l_asset_retire_rec.cost_of_removal := &cost_of_removal

   

   FA_ASSET_DESC_PUB.update_retirement_desc(

           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,

           px_trans_rec              => l_trans_rec,

           px_asset_hdr_rec          => l_asset_hdr_rec,       

           px_asset_retire_rec_new   => l_asset_retire_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('RETIREMENT_ID ' || to_char(l_asset_retire_rec.retirement_id));

     dbms_output.put_line('BOOK_TYPE_CODE ' || l_asset_hdr_rec.book_type_code);

   end if;



end;

/