見積伝票 登録 API (QuotationCreateFromData2Controller)¶
見積伝票を登録するためには、QuotationCreateFromData2Controller クラスの持つ各メソッドを利用する必要があります。引数、戻り値についての詳細な情報は、API リストを参照してください。
各メソッドの説明¶
コンストラクタ / メソッド名 説明 QuotationCreateFromData2Controller コンストラクタ(引数無し) QuotationCreateFromData2Controller コンストラクタ(第 1 引数あり)。ConnectionManager を使う場合に使用する。第 1 引数で「ConnectionManager」を設定する。QuotationCreateFromData2Controller コンストラクタ(第 1 引数あり)。SAPClient の接続情報を使う場合に使用する。第 1 引数で「SAPClient」(オブジェクト)を設定する。setBehaveWhenError import 項目:エラー処理を設定します。 setBinaryRelationshiptype import 項目:バイナリ関連タイプ (専用)を設定します。 setConvert import 項目:取引先機能/受注伝票タイプの変換を設定します。 setIntNumberAssignment import 項目:明細番号内部採番を設定します。 setSalesdocumentin import 項目:見積伝票番号を設定します。 setTestrun import 項目:テスト実行を設定します。 setStrParam 構造型の各項目に値を設定する。第1引数に structure 名、第2引数に項目名、第3引数に値を設定する。setTblParam テーブル型の各項目に値を設定する。第1引数にテーブル名、第2引数に項目名第3引数に値、第4引数にレコード番号を設定する。executeBapi BapiController により見積伝票を登録します。 getBapiReturnErrMessage BAPI実行結果である BapiReturn の Type 情報が正常(デフォルト値: “S” / “”)以外の BapiReturn オブジェクトのメッセージ情報を全て返します。全て正常の場合は null が返却されます。getBapiReturnMessage BAPI実行結果である BapiReturn の Type 情報が正常(デフォルト値: “S” / “”)と判断された Type 情報のメッセージ情報を全て返します。メッセージが存在しない場合は null が返却されます。getBehaveWhenError import 項目:エラー処理を取得します。 getBinaryRelationshiptype import 項目:バイナリ関連タイプ (専用)を取得します。 getConvert import 項目:取引先機能/受注伝票タイプの変換を取得します。 getIntNumberAssignment import 項目:明細番号内部採番を取得します。 getSalesdocumentin import 項目:見積伝票番号を取得します。 getTestrun import 項目:テスト実行を取得します。 getSalesdocument export 項目:販売管理伝票番号を取得します。 getExtensionInList import項目:設定したVBAK、VBAP、VBEP のカスタマ拡張情報を取得します。 getLogicSwitch import 項目:設定した内部制御パラメータ情報を取得します。 getPartnerAddressesList import 項目:設定したアドレス (組織/会社) 用 BAPI 参照構造情報を取得します。 getQuotationCfgsBlobList import項目:設定した選定: BLOB 内部データ (SCE)情報を取得します。 getQuotationCfgsInstList import 項目:設定した選定: インスタンス情報を取得します。 getQuotationCfgsPartOfList import 項目:設定した選定: 部分設定情報を取得します。 getQuotationCfgsRefList import 項目:設定した選定: 参照データ情報を取得します。 getQuotationCfgsRefInstList import 項目:設定した選定: 参照明細/インスタンス情報を取得します。 getQuotationCfgsValueList import 項目:設定した選定: 特性値情報を取得します。 getQuotationCfgsVkList import 項目:設定した選定: バリアント条件キー情報を取得します。 getQuotationConditionsInList import 項目:設定した条件情報を取得します。 getQuotationConditionsInXList import 項目:設定した受注における条件更新の通信項目情報を取得します。 getQuotationHeaderIn import 項目:設定した伝票ヘッダデータ情報を取得します。 getQuotationHeaderInX import 項目:設定した伝票ヘッダチェックボックス情報を取得します。 getQuotationItemsInList import 項目:設定した明細データ情報を取得します。 getQuotationItemsInXList import 項目:設定した明細データチェックボックス情報を取得します。 getQuotationKeysList import 項目:設定した参照キーの出力テーブル情報を取得します。 getQuotationPartnersList import 項目:設定した伝票取引先情報を取得します。 getQuotationSchedulesInList import 項目:設定した納入日程行データ情報を取得します。 getQuotationSchedulesInXList import 項目:設定した納入日程行データチェックボックス情報を取得します。 getQuotationTextList import 項目:設定したテキスト情報を取得します。 getSender import 項目:設定した論理システム - 送信者情報を取得します。
サンプルプログラム¶
var salesDocument; var partneraddressesList; // グローバル変数 省略 var cfgsreflistCount; var ret; function init(request) { //-------------------------------------------------------------------------- //変数宣言 //-------------------------------------------------------------------------- var objRet; // executeBapi実行結果 var objMsg; // executeBapi実行結果メッセージ //-------------------------------------------------------------------------- //インスタンス生成 // 説明 1 //-------------------------------------------------------------------------- var objCon = new QuotationCreateFromData2Controller(); //-------------------------------------------------------------------------- // テスト実行 // 説明 2 //-------------------------------------------------------------------------- objCon.setTestrun(""); //-------------------------------------------------------------------------- // 構造体項目セット // 説明 3 //-------------------------------------------------------------------------- // 通信項目: 販売管理伝票ヘッダ objCon.setStrParam("HeaderIn", "DOC_TYPE", "AG"); // 販売伝票タイプ objCon.setStrParam("HeaderIn", "QT_VALID_F", "20070301"); // 見積/引合有効開始日 objCon.setStrParam("HeaderIn", "QT_VALID_T", "20070331"); // 見積の有効終了日 objCon.setStrParam("HeaderIn", "PURCH_NO_C", "API_見積伝票登録1"); // 出荷先発注番号 //-------------------------------------------------------------------------- // テーブル項目セット // 説明 4 //-------------------------------------------------------------------------- // 伝票取引先 objCon.setTblParam("Partners", "PARTN_ROLE", "AG", 1); // 取引先機能 objCon.setTblParam("Partners", "PARTN_NUMB", "0000000012", 1); // 得意先コード1 objCon.setTblParam("Partners", "PARTN_ROLE", "WE", 2); // 取引先機能 objCon.setTblParam("Partners", "PARTN_NUMB", "0000000012", 2); // 得意先コード1 objCon.setTblParam("Partners", "PARTN_ROLE", "RG", 3); // 取引先機能 objCon.setTblParam("Partners", "PARTN_NUMB", "0000000012", 3); // 得意先コード1 //ORDER_ITEMS_IN[明細データ] objCon.setTblParam("ItemsIn", "MATERIAL", "000000000000000011", 1); // 品目コード //ORDER_SCHEDULES_IN[納入日程行データ] objCon.setTblParam("SchedulesIn", "REQ_QTY", "3", 1); // 販売単位による受注数量 //-------------------------------------------------------------------------- // executeBapi実行 // 説明 5 //-------------------------------------------------------------------------- objRet = objCon.executeBapi(); //-------------------------------------------------------------------------- // エラー判定 //-------------------------------------------------------------------------- //要素[ERR_CODE]に何らかの値がセットされている場合 if (objRet["ERR_CODE"] != null) { //エラーメッセージ出力 Debug.browse(objRet); } // 各種データを取得 // 説明 6 // 販売伝票番号をセット salesDocument = objCon.getSalesdocument(); // アドレス (組織/会社) 用 BAPI 参照構造 partneraddressesList = objCon.getPartnerAddressesList(); partneraddresseslistCount = partneraddressesList.length; // VBAK、VBAP、VBEP のカスタマ拡張 extensioninList = objCon.getExtensionInList(); extensioninlistCount = extensioninList.length; // 選定: BLOB 内部データ (SCE) cfgsblobList = objCon.getQuotationCfgsBlobList(); cfgsbloblistCount = cfgsblobList.length; // 省略 // 選定: 参照データ cfgsrefList = objCon.getQuotationCfgsRefList(); cfgsreflistCount = cfgsrefList.length; //API実行結果を取得します。 ret = objCon.getBapiReturnMessage(); }
見積伝票登録 API のインスタンス生成(説明1)
QuotationCreateFromData2Controller クラスのインスタンスを生成します。引数は不要です。インスタンスを生成すると、見積伝票登録 BAPI(BAPI_QUOTATION_CREATEFROMDATA2)の import 型の import、structure、table パラメータに値を設定することができます。
-
import の各項目に値を設定(説明2)
import パラメータの項目に値を設定する場合は、set メソッドを使用します。メソッドについては各 API のAPI リストを参照ください。
-
structure の各項目に値を設定(説明3)
structure パラメータの項目に値を設定する場合は、setStrParam メソッドを使用します。第1引数のstructure 名称は固定値になっています。後述のとおりに名称を設定して下さい。第2引数の項目名称はSAPの各属性の項目名称を設定してください。structure 名称、項目名称は英字の大文字、小文字は厳密に区別されます。第3引数に値を設定します。SAP structure セットする固有名称 LOGIC_SWITCH 内部制御パラメータ LogicSwitch QUOTATION_HEADER_IN 伝票ヘッダデータ HeaderIn QUOTATION_HEADER_INX 伝票ヘッダチェックボックス HeaderInX SENDER 論理システム - 送信者 Sender
-
table の各項目に値を設定(説明4)
table パラメータの項目に値を設定する場合は、setTblParam メソッドを使用します。第1引数のtable名称は固定値になっています。後述のとおりに名称を設定して下さい。第2引数の項目名称は SAP の各属性の項目名称を設定してください。table 名称、項目名称は英字の大文字、小文字は厳密に区別されます。第3引数に値、第4引数にレコード番号を設定します。SAP table セットする固有名称 EXTENSIONIN VBAK、VBAP、VBEP のカスタマ拡張 ExtensionIn PARTNERADDRESSES アドレス (組織/会社) 用 BAPI 参照構造 PartnerAddresses QUOTATION_CFGS_BLOB 選定: BLOB 内部データ (SCE) CfgsBlob QUOTATION_CFGS_INST 選定: インスタンス CfgsInst QUOTATION_CFGS_PART_OF 選定: 部分設定 CfgsPartOf QUOTATION_CFGS_REF 選定: 参照データ CfgsRef QUOTATION_CFGS_REFINST 選定: 参照明細/インスタンス CfgsRefInst QUOTATION_CFGS_VALUE 選定: 特性値 CfgsValue QUOTATION_CFGS_VK 選定: バリアント条件キー CfgsVk QUOTATION_CONDITIONS_IN 条件 ConditionsIn QUOTATION_CONDITIONS_INX 受注における条件更新の通信項目 ConditionsInX QUOTATION_ITEMS_IN 明細データ ItemsIn QUOTATION_ITEMS_INX 明細データチェックボックス ItemsInX QUOTATION_KEYS 参照キーの出力テーブル Keys QUOTATION_PARTNERS 伝票取引先 Partners QUOTATION_SCHEDULES_IN 納入日程行 SchedulesIn QUOTATION_SCHEDULES_INX 納入日程行チェックボックス SchedulesInX QUOTATION_TEXT テキスト Text 見積伝票の登録(説明5)
QuotationCreateFromData2Controller クラスの executeBapi メソッドを実行すると、各項目にセットされた値が SAP 上に見積伝票データとして登録されます。登録が成功した場合には、見積伝票登録 API の内部で自動的に commit 処理が実行されます。登録に失敗した場合には、自動的に rollback 処理が実行されます。成功・失敗の基準は、見積伝票登録用 BAPI(BAPI_QUOTATION_CREATEFROMDATA2)の実行後に RETURN パラメータの TYPE 値を取得して、S(正常終了)、空文字以外が1つでも存在するかどうかです。1つでも存在する場合は、rollback が自動的に実行されます。サンプルプログラムの中で記載されたデータ取得メソッドの詳細説明については、以下を参照してください。(説明6)
Type 情報が正常(デフォルト値: “S” / “”)以外の BapiReturn を取得
QuotationCreateFromData2Controller クラスの getBapiReturnErrMessage メソッドを使用すると、取得した BapiReturn の Type 情報が正常(デフォルト値: “S” / “”)以外の BapiReturn オブジェクトのメッセージ情報を取得することが可能です。全て正常の場合は null を取得します。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。Type 情報が正常(デフォルト値: “S” / “”)の BapiReturn を取得
QuotationCreateFromData2Controller クラスの getBapiReturnMessage メソッドを使用すると、取得したBapiReturn の Type 情報が正常(デフォルト値: “S” / “”)と判断された Type 情報のメッセージ情報を取得することが可能です。メッセージが存在しない場合は null を取得します。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。エラー処理情報を取得
QuotationCreateFromData2Controller クラスの getBehaveWhenError メソッドを使用すると、設定したエラー処理情報を取得することが可能です。バイナリ関連タイプ (専用)情報を取得
QuotationCreateFromData2Controller クラスの getBinaryRelationshiptype メソッドを使用すると、設定したバイナリ関連タイプ (専用)情報を取得することが可能です。取引先機能/受注伝票タイプの変換情報を取得
QuotationCreateFromData2Controller クラスの getConvert メソッドを使用すると、設定した取引先機能/受注伝票タイプの変換情報を取得することが可能です。明細番号内部採番情報を取得
QuotationCreateFromData2Controller クラスの getIntNumberAssignment メソッドを使用すると、設定した明細番号内部採番情報を取得することが可能です。見積伝票番号情報を取得
QuotationCreateFromData2Controller クラスのgetSalesdocumentin メソッドを使用すると、設定した見積伝票番号情報を取得することが可能です。テスト実行情報を取得
QuotationCreateFromData2Controller クラスの getTestrun メソッドを使用すると、設定したテスト実行情報を取得することが可能です。販売管理伝票番号情報を取得
QuotationCreateFromData2Controller クラスの getSalesdocument メソッドを使用すると、取得した販売管理伝票番号情報を取得することが可能です。VBAK、VBAP、VBEP のカスタマ拡張情報を取得
QuotationCreateFromData2Controller クラスの getExtensionInList メソッドを使用すると、設定したVBAK、VBAP、VBEP のカスタマ拡張情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。内部制御パラメータ情報を取得
QuotationCreateFromData2Controller クラスの getLogicSwitch メソッドを使用すると、設定した内部制御パラメータ情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。アドレス (組織/会社) 用 BAPI 参照構造情報を取得
QuotationCreateFromData2Controller クラスの getPartnerAddressesList メソッドを使用すると、設定したアドレス (組織/会社) 用 BAPI 参照構造情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: BLOB 内部データ (SCE)情報を取得
QuotationCreateFromData2Controller クラスの getQuotationCfgsBlobList メソッドを使用すると、設定した選定: BLOB 内部データ (SCE)情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: インスタンス情報を取得
QuotationCreateFromData2ControllerクラスのgetQuotationCfgsInstListメソッドを使用すると、設定した選定: インスタンス情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: 部分設定情報を取得
QuotationCreateFromData2Controller クラスの getQuotationCfgsPartOfList メソッドを使用すると、設定した選定: 部分設定情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: 参照データ情報を取得
QuotationCreateFromData2Controller クラスのgetQuotationCfgsRefList メソッドを使用すると、設定した選定: 参照データ情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: 参照明細/インスタンス情報を取得
QuotationCreateFromData2Controller クラスの getQuotationCfgsRefInstList メソッドを使用すると、設定した選定: 参照明細/インスタンス情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: 特性値情報を取得
QuotationCreateFromData2ControllerクラスのgetQuotationCfgsValueListメソッドを使用すると、設定した選定: 特性値情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。選定: バリアント条件キー情報を取得
QuotationCreateFromData2Controller クラスの getQuotationCfgsVkList メソッドを使用すると、設定した 選定: バリアント条件キー情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。条件情報を取得
QuotationCreateFromData2Controller クラスの getQuotationConditionsInList メソッドを使用すると、設定した条件情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。受注における条件更新の通信項目情報を取得
QuotationCreateFromData2Controller クラスのgetQuotationConditionsInXList メソッドを使用すると、設定した受注における条件更新の通信項目情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。伝票ヘッダデータ情報を取得
QuotationCreateFromData2Controller クラスの getquotationHeaderIn メソッドを使用すると、設定した伝票ヘッダデータ情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。伝票ヘッダチェックボックス情報を取得
QuotationCreateFromData2Controller クラスの getquotationHeaderInX メソッドを使用すると、設定した伝票ヘッダチェックボックス情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。明細データ情報を取得
QuotationCreateFromData2Controller クラスの getQuotationItemsInList メソッドを使用すると、設定した明細データ情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。明細データチェックボックス情報を取得
QuotationCreateFromData2Controller クラスの getQuotationItemsInXList メソッドを使用すると、設定した明細データチェックボックス情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。参照キーの出力テーブル情報を取得
QuotationCreateFromData2Controller クラスの getQuotationKeysList メソッドを使用すると、設定した参照キーの出力テーブル情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。伝票取引先情報を取得
QuotationCreateFromData2Controller クラスのgetQuotationPartnersList メソッドを使用すると、設定した伝票取引先情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。納入日程行データ情報を取得
QuotationCreateFromData2Controller クラスの getQuotationSchedulesInList メソッドを使用すると、設定した納入日程行データ情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。納入日程行データチェックボックス情報を取得
QuotationCreateFromData2Controller クラスの getQuotationSchedulesInXList メソッドを使用すると、設定した納入日程行データチェックボックス情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。テキスト情報を取得
QuotationCreateFromData2Controller クラスの getQuotationTextList メソッドを使用すると、設定したテキスト情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。論理システム - 送信者情報を取得
QuotationCreateFromData2Controller クラスの getSender メソッドを使用すると、設定した論理システム - 送信者情報を取得することが可能です。項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
コラム
サンプルプログラム実行結果では、SAP テスト環境のデータが取得されています。SAP標準では該当データが存在しません。
注意
見積伝票登録 API に関して、import、structure、table パラメータが持つ各コンポーネントの必須項目や値の相関チェック等を確認する必要がある場合は、SAP 上の汎用モジュールビルダ(t-cd:SE37)等を使用して、「BAPI_QUOTATION_CREATEFROMDATA2」の BAPI 仕様を確認してください。