Oracle Assetsユーザー・ガイド リリース12 E06049-01 | ![]() 目次 | ![]() 前へ | ![]() 次へ |
この付録では、次のトピックについて説明します。
Oracle Assetsの既存のインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。共通請求書振替APIを使用すると、ソース明細の振替、コードの簡素化およびコード重複の防止を実行できます。
代替元帳通貨を設定している場合は、Oracle Assets APIを使用して資産を追加または変更すると、その取引はAPIによって報告通貨に自動的にコピーされます。請求書端数処理の問題は、APIを使用して、元帳通貨と報告通貨の両方に対して代替元帳通貨会計処理を実行することで回避されます。
税務台帳の「資産台帳管理」ウィンドウで「建設仮勘定資産の許可」チェック・ボックスを選択している場合は、追加APIを使用して建設仮勘定資産を追加すると、その建設仮勘定資産が税務台帳に自動的に追加され、同時に会計用資産台帳にも追加されます。
関連項目
共通請求書振替APIプロシージャは、FA_INV_XFR_PUB.DO_TRANSFER ()プロシージャと呼ばれます。次の表に、FA_INV_XFR_PUB.DO_TRANSFER ()プロシージャの各要素の引数、型、値および説明を示します。
各引数には、P、XまたはPXのプリフィクスが付加されます。それぞれの意味は、次のとおりです。
P: In引数を示します。
X: Out引数を示します。
PX: InとOutの両方の引数を示します。
引数 | 型 | 値 | 説明 |
---|---|---|---|
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_SRC_TRANS_REC | FA_API_TYPES.TRANS_REC_TYPE | 実行する取引を示します。 | |
PX_SRC_ASSET_HDR_REC | FA_API_TYPES.ASSET_HDR_REC_TYPE | 資産の一意の識別子。 | |
PX_DEST_TRANS_REC | FA_API_TYPES.TRANS_REC_TYPE | 実行する取引を示します。 | |
PX_DEST_ASSET_HDR_REC | FA_API_TYPES.ASSET_HDR_REC_TYPE | 資産の一意の識別子。 | |
P_INV_TBL | FA_API_TYPES. INV_TBL_TYPE | 資産の請求書。 |
TRANS_REC_TYPE取引体系には、取引ヘッダー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) | CUSTOMにデフォルト設定されます。 |
DESC_FLEX | オプション | DESC_FLEX_ REC_ TYPE | 付加フレックスフィールド・セグメント。 |
WHO_INFO | 必須 | STANDARD_ WHO_REC_ TYPE | 標準WHO列。 |
INV_REC請求書体系には、資産に関連付けられている単一の請求書の請求書情報が記載されています。INV_TBLはINV_REC_TYPEレコードの表です。これらのレコードには、資産に割り当てられているすべての請求書が含まれています。次の表に、各引数の型と摘要情報を示します。
引数 | 必須/オプション | 型 | 値 |
---|---|---|---|
FIXED_ASSETS_COST | 必須 | NUMBER | Oracle Assetsの資産の取得価額。 |
SOURCE_LINE_ID | 必須 | NUMBER(15) | この値は、振り替える各明細のデルタ金額です。この値は、0(ゼロ)から問題の明細の現行取得価額までの範囲内である必要があります。 |
set serveroutput on
declare
-- source
l_src_trans_rec FA_API_TYPES.trans_rec_type;
l_src_asset_hdr_rec FA_API_TYPES.asset_hdr_rec_type;
l_inv_tbl FA_API_TYPES.inv_tbl_type;
l_inv_rec FA_API_TYPES.inv_rec_type;
-- destination
l_dest_trans_rec FA_API_TYPES.trans_rec_type;
l_dest_asset_hdr_rec FA_API_TYPES.asset_hdr_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;
-- get source / destination info
l_src_asset_hdr_rec.book_type_code := '&book';
l_dest_asset_hdr_rec.book_type_code := l_src_asset_hdr_rec.book_type_code;
l_src_asset_hdr_rec.asset_id := &source_asset_id
l_dest_asset_hdr_rec.asset_id := &destination_asset_id
-- get transaction_info
l_src_trans_rec.transaction_subtype := '&src_transaction_subtype';
l_dest_trans_rec.transaction_subtype := '&dest_transaction_subtype';
l_src_trans_rec.transaction_date_entered := '&src_transaction_date';
l_dest_trans_rec.transaction_date_entered := '&dest_transaction_date';
-- invoice info - source
l_inv_rec.source_line_id := &source_line_id
l_inv_rec.fixed_assets_cost := &delta_cost_to_transfer
-- set up the table for source
l_inv_tbl (1) := l_inv_rec;
-- call for source
FA_INV_XFR_PUB.do_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
px_src_trans_rec => l_src_trans_rec,
px_src_asset_hdr_rec => l_src_asset_hdr_rec,
px_dest_trans_rec => l_dest_trans_rec,
px_dest_asset_hdr_rec => l_dest_asset_hdr_rec,
p_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
rollback;
dbms_output.put_line('FAILURE');
else
dbms_output.put_line('SUCCESS');
dbms_output.put_line('THID_SRC' || to_char(l_src_trans_rec.transaction_header_id));
dbms_output.put_line('THID_DEST' || to_char(l_dest_trans_rec.transaction_header_id));
end if;
end;
/