IM-ERP Real Connect for Accel Platform プログラミングガイド 初版 2013-02-01

引合伝票 登録 API (InquiryCreateFromData2Controller)

引合伝票を登録するためには、InquiryCreateFromData2Controller クラスの持つ各メソッドを利用する必要があります。
引数、戻り値についての詳細な情報は、API リストを参照してください。
また、登録可能な項目は、引合伝票として必要最低限必要と判断される項目のみとなっています。

各メソッドの説明

コンストラクタ / メソッド名 説明
InquiryCreateFromData2Controller コンストラクタ(引数無し)
InquiryCreateFromData2Controller
コンストラクタ(第 1 引数あり)。
ConnectionManager を使う場合に使用する。
第 1 引数で「ConnectionManager」を設定する。
InquiryCreateFromData2Controller
コンストラクタ(第 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 のカスタマ拡張情報を取得します。
getInquiryCfgsBlobList import 項目:設定した選定: BLOB 内部データ (SCE)情報を取得します。
getInquiryCfgsInstList import 項目:設定した選定: インスタンス情報を取得します。
getInquiryCfgsPartOfList import 項目:設定した選定: 部分設定情報を取得します。
getInquiryCfgsRefList import 項目:設定した選定: 参照データ情報を取得します。
getInquiryCfgsRefInstList import 項目:設定した選定: 参照明細/インスタンス情報を取得します。
getInquiryCfgsValueList import 項目:設定した選定: 特性値情報を取得します。
getInquiryCfgsVkList import 項目:設定した選定: バリアント条件キー情報を取得します。
getInquiryConditionsInList import 項目:設定した条件情報を取得します。
getInquiryConditionsInXList import 項目:設定した受注における条件更新の通信項目情報を取得します。
getInquiryHeaderIn import 項目:設定した引合伝票ヘッダデータ情報を取得します。
getInquiryHeaderInX import 項目:設定したヘッダデータチェックボックス情報を取得します。
getInquiryItemsInList import 項目:設定した明細データ情報を取得します。
getInquiryItemsInXList import 項目:設定した明細データチェックボックス情報を取得します。
getInquiryKeysList import 項目:設定した参照キーの出力テーブル情報を取得します。
getInquiryPartnersList import 項目:設定した伝票取引先情報を取得します。
getInquirySchedulesInList import 項目:設定した納入日程行情報を取得します。
getInquirySchedulesInXList import 項目:設定した納入日程行チェックボックス情報を取得します。
getInquiryTextList import 項目:設定したテキスト情報を取得します。
getLogicSwitch import 項目:設定した内部制御パラメータ情報を取得します。
getPartnerAddressesList import 項目:設定したアドレス (組織/会社) 用 BAPI 参照構造情報を取得します。
getSender import 項目:設定した論理システム - 送信者情報を取得します。

サンプルプログラム

var salesDocument;
var partneraddressesList;
var partneraddresseslistCount;
var extensioninList;
var extensioninlistCount;
var cfgsblobList;
var cfgsbloblistCount;
var textList;
var textlistCount;
var schedulesinxList;
var schedulesinxlistCount;
var schedulesinList;
var schedulesinlistCount;
var partnersList;
var partnerslistCount;
var keysList;
var keyslistCount;
var itemsinxList;
var itemsinxlistCount;
var itemsinList;
var itemsinlistCount;
var cfgsinstList;
var cfgsinstlistCount;
var cfgspartofList;
var cfgspartoflistCount;
var conditionsinxList;
var conditionsinxlistCount;
var conditionsinList;
var conditionsinlistCount;
var cfgsvkList;
var cfgsvklistCount;
var cfgsvalueList;
var cfgsvaluelistCount;
var cfgsrefinstList;
var cfgsrefinstlistCount;
var cfgsrefList;
var cfgsreflistCount;
var ret;

function init(request) {
    //--------------------------------------------------------------------------
    //変数宣言
    //--------------------------------------------------------------------------
    var objResult;                                                              // executeBapi実行結果

    //--------------------------------------------------------------------------
    //インスタンス生成      //  説明 1 
    //--------------------------------------------------------------------------
    var objCon = new InquiryCreateFromData2Controller();

    //--------------------------------------------------------------------------
    // テスト実行      //  説明 2
    //--------------------------------------------------------------------------
    objCon.setTestrun("");

    //--------------------------------------------------------------------------
    // 構造体項目セット      //  説明 3
    //--------------------------------------------------------------------------
    // 通信項目: 販売管理伝票ヘッダ
    objCon.setStrParam("HeaderIn", "DOC_TYPE", "AF");                   // 販売伝票タイプ
    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
    //--------------------------------------------------------------------------
     objResult = objCon.executeBapi();

    //--------------------------------------------------------------------------
    // エラー判定
    //--------------------------------------------------------------------------
    //要素[ERR_CODE]に何らかの値がセットされている場合
    if (objResult["ERR_CODE"] != null) {
       //エラーメッセージ出力
       Debug.browse(objResult);
    }

    // 各データをセット      //  説明 6
    // 販売伝票番号をセット
    salesDocument = objCon.getSalesdocument();

    // アドレス (組織/会社) 用 BAPI 参照構造
    partneraddressesList = objCon.getPartnerAddressesList();
    partneraddresseslistCount = partneraddressesList.length;

    // VBAK、VBAP、VBEP のカスタマ拡張
    extensioninList = objCon.getExtensionInList();
    extensioninlistCount = extensioninList.length;

    // 選定: BLOB 内部データ (SCE)
    cfgsblobList = objCon.getInquiryCfgsBlobList();
    cfgsbloblistCount = cfgsblobList.length;

    // テキスト
    textList = objCon.getInquiryTextList();
    textlistCount = textList.length;

    // 納入日程行チェックボックス
    schedulesinxList = objCon.getInquirySchedulesInXList();
    schedulesinxlistCount = schedulesinxList.length;

    // 納入日程行
    schedulesinList = objCon.getInquirySchedulesInList();
    schedulesinlistCount = schedulesinList.length;

    // 伝票取引先
    partnersList = objCon.getInquiryPartnersList();
    partnerslistCount = partnersList.length;

    // 参照キーの出力テーブル
    keysList = objCon.getInquiryKeysList();
    keyslistCount = keysList.length;

    // 明細データチェックボックス
    itemsinxList = objCon.getInquiryItemsInXList();
    itemsinxlistCount = itemsinxList.length;

    // 明細データ
    itemsinList = objCon.getInquiryItemsInList();
    itemsinlistCount = itemsinList.length;

    // 選定: インスタンス
    cfgsinstList = objCon.getInquiryCfgsInstList();
    cfgsinstlistCount = cfgsinstList.length;

    // 選定: 部分設定
    cfgspartofList = objCon.getInquiryCfgsPartOfList();
    cfgspartoflistCount = cfgspartofList.length;

    // 受注における条件更新の通信項目
    conditionsinxList = objCon.getInquiryConditionsInXList();
    conditionsinxlistCount = conditionsinxList.length;

    // 条件
    conditionsinList = objCon.getInquiryConditionsInList();
    conditionsinlistCount = conditionsinList.length;

    // 選定: バリアント条件キー
    cfgsvkList = objCon.getInquiryCfgsVkList();
    cfgsvklistCount = cfgsvkList.length;

    // 選定: 特性値
    cfgsvalueList = objCon.getInquiryCfgsValueList();
    cfgsvaluelistCount = cfgsvalueList.length;

    // 選定: 参照明細/インスタンス
    cfgsrefinstList = objCon.getInquiryCfgsRefInstList();
    cfgsrefinstlistCount = cfgsrefinstList.length;

    // 選定: 参照データ
    cfgsrefList = objCon.getInquiryCfgsRefList();
    cfgsreflistCount = cfgsrefList.length;

    //API実行結果を取得します。
    ret = objCon.getBapiReturnMessage();

}
  • 引合伝票登録 API のインスタンス生成(説明1)

    InquiryCreateFromData2Controller クラスのインスタンスを生成します。
    引数は不要です。
    インスタンスを生成すると、引合伝票登録 BAPI(BAPI_INQUIRY_CREATEFROMDATA2)の import 型の import、structure、table パラメータに値を設定することができます。
„
  • import の各項目に値を設定(説明2)

    import パラメータの項目に値を設定する場合は、set メソッドを使用します。
    メソッドについては各API の API リストを参照ください。
„
  • structure の各項目に値を設定(説明3)

    structure パラメータの項目に値を設定する場合は、setStrParam メソッドを使用します。
    第1引数のstructure 名称は固定値になっています。
    後述のとおりに名称を設定して下さい。
    第二引数の項目名称はSAP の各属性の項目名称を設定してください。
    structure 名称、項目名称は英字の大文字、小文字は厳密に区別されます。
    第3引数に値を設定します。
    SAP structure セットする固有名称
    INQUIRY_HEADER_IN 引合伝票ヘッダデータ HeaderIn
    INQUIRY_HEADER_INX ヘッダデータチェックボックス HeaderInX
    LOGIC_SWITCH 内部制御パラメータ LogicSwitch
    SENDER 論理システム - 送信者 Sender
„
  • table の各項目に値を設定(説明4)

    table パラメータの項目に値を設定する場合は、setTblParam メソッドを使用します。
    第1引数のtable名称は固定値になっています。
    後述のとおりに名称を設定して下さい。
    第2引数の項目名称は SAP の各属性の„項目名称を設定してください。
    table 名称、項目名称は英字の大文字、小文字は厳密に区別されます。
    第3引数に値、第4引数にレコード番号を設定します。
    SAP table セットする固有名称
    EXTENSIONIN VBAK、VBAP、VBEP のカスタマ拡張 ExtensionIn
    INQUIRY_CFGS_BLOB 選定: BLOB 内部データ (SCE) CfgsBlob
    INQUIRY_CFGS_INST 選定: インスタンス CfgsInst
    INQUIRY_CFGS_PART_OF 選定: 部分設定 CfgsPartOf
    INQUIRY_CFGS_REF 選定: 参照データ CfgsRef
    INQUIRY_CFGS_REFINST 選定: 参照明細/インスタンス CfgsRefInst
    INQUIRY_CFGS_VALUE 選定: 特性値 CfgsValue
    INQUIRY_CFGS_VK 選定: バリアント条件キー CfgsVk
    INQUIRY_CONDITIONS_IN 条件 ConditionsIn
    INQUIRY_CONDITIONS_INX 受注における条件更新の通信項目 ConditionsInX
    INQUIRY_ITEMS_IN 明細データ ItemsIn
    INQUIRY_ITEMS_INX 明細データチェックボックス ItemsInX
    INQUIRY_KEYS 参照キーの出力テーブル Keys
    INQUIRY_PARTNERS 伝票取引先 Partners
    INQUIRY_SCHEDULES_IN 納入日程行 SchedulesIn
    INQUIRY_SCHEDULES_INX 納入日程行チェックボックス SchedulesInX
    INQUIRY_TEXT テキスト Text
    PARTNERADDRESSES アドレス (組織/会社) 用 BAPI 参照構造 PartnerAddresses
„
  • 引合伝票の登録(説明5)

    InquiryCreateFromData2Controller クラスの executeBapi メソッドを実行すると、各項目にセットされた値がSAP 上に、引合伝票データとして登録されます。
    登録が成功した場合には、引合伝票登録 API の内部で自動的に commit 処理が実行されます。
    登録に失敗した場合には、自動的に rollback 処理が実行されます。
    成功・失敗の基準は、引合伝票登録用 BAPI(BAPI_INQUIRY_CREATEFROMDATA2)の実行後にRETURN パラメータの TYPE 値を取得して、S(正常終了)、空文字以外が1つでも存在するかどうかです。
    1つでも存在する場合は、rollback が自動的に実行されます。
„
  • サンプルプログラムの中で記載されたデータ取得メソッドの詳細説明については、以下を参照してください。(説明6)

    • Type 情報が正常(デフォルト値: “S” / “”)以外の BapiReturn を取得

      InquiryCreateFromData2Controller クラスの getBapiReturnErrMessage メソッドを使用すると、取得したBapiReturn の Type 情報が正常(デフォルト値: “S” / “”)以外の BapiReturn オブジェクトのメッセージ情報を取得することが可能です。全て正常の場合は null を取得します。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • Type 情報が正常(デフォルト値: “S” / “”)の BapiReturn を取得

      InquiryCreateFromData2Controller クラスの getBapiReturnMessage メソッドを使用すると、取得したBapiReturn の Type 情報が正常(デフォルト値: “S” / “”)と判断された Type 情報のメッセージ情報を取得することが可能です。メッセージが存在しない場合は null を取得します。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • エラー処理情報を取得

      InquiryCreateFromData2Controller クラスの getBehaveWhenError メソッドを使用すると、設定したエラー処理情報を取得することが可能です。
    • バイナリ関連タイプ (専用)情報を取得

      InquiryCreateFromData2Controller クラスの getBinaryRelationshiptype メソッドを使用すると、設定したバイナリ関連タイプ (専用)情報を取得することが可能です。
    • 変換: 取引先機能 + 受注伝票タイプ情報を取得

      InquiryCreateFromData2ControllerクラスのgetConvertメソッドを使用すると、設定した変換(取引先機能 + 受注伝票タイプ情報)を取得することが可能です。
    • 明細番号内部採番情報を取得

      InquiryCreateFromData2Controller クラスの getIntNumberAssignment メソッドを使用すると、設定した明細番号内部採番情報を取得することが可能です。
    • 販売管理伝票番号情報を取得

      InquiryCreateFromData2Controller クラスの getSalesdocumentin メソッドを使用すると、設定した販売管理伝票番号情報を取得することが可能です。
    • テスト実行情報を取得

      InquiryCreateFromData2Controller クラスの getTestrun メソッドを使用すると、設定したテスト実行情報を取得することが可能です。
    • 販売伝票番号情報を取得

      InquiryCreateFromData2ControllerクラスのgetSalesdocumentメソッドを使用すると、取得した販売伝票番号情報を取得することが可能です。
    • VBAK、VBAP、VBEP のカスタマ拡張情報を取得

      InquiryCreateFromData2ControllerクラスのgetExtensionInListメソッドを使用すると、設定したVBAK、VBAP、VBEP のカスタマ拡張情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: BLOB 内部データ (SCE)情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryCfgsBlobList メソッドを使用すると、設定した選定: BLOB 内部データ (SCE)情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: インスタンス情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryCfgsInstList メソッドを使用すると、設定した選定: インスタンス情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: 部分設定情報を取得

      InquiryCreateFromData2ControllerクラスのgetInquiryCfgsPartOfListメソッドを使用すると、設定した選定: 部分設定情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: 参照データ情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryCfgsRefList メソッドを使用すると、設定した選定: 参照データ情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: 参照明細/インスタンス情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryCfgsRefInstList メソッドを使用すると、設定した選定: 参照明細/インスタンス情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: 特性値情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryCfgsValueList メソッドを使用すると、設定した選定: 特性値情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 選定: バリアント条件キー情報を取得

      InquiryCreateFromData2Controller クラスのgetInquiryCfgsVkList メソッドを使用すると、設定した選定: バリアント条件キー情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 条件情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryConditionsInList メソッドを使用すると、設定した条件情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 受注における条件更新の通信項目情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryConditionsInXList メソッドを使用すると、設定した受注における条件更新の通信項目情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 引合伝票ヘッダデータ情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryHeaderIn メソッドを使用すると、設定した引合伝票ヘッダデータ情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • ヘッダデータチェックボックス情報を取得

      InquiryCreateFromData2ControllerクラスのgetInquiryHeaderInXメソッドを使用すると、設定したヘッダデータチェックボックス情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 明細データ情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryItemsInList メソッドを使用すると、設定した明細データ情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 明細データチェックボックス情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryItemsInXList メソッドを使用すると、設定した明細データチェックボックス情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 参照キーの出力テーブル情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryKeysList メソッドを使用すると、設定した参照キーの出力テーブル情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 伝票取引先情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryPartnersList メソッドを使用すると、設定した伝票取引先情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 納入日程行情報を取得

      InquiryCreateFromData2Controller クラスの getInquirySchedulesInList メソッドを使用すると、設定した納入日程行情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 納入日程行チェックボックス情報を取得

      InquiryCreateFromData2Controller クラスの getInquirySchedulesInXList メソッドを使用すると、設定した納入日程行チェックボックス情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • テキスト情報を取得

      InquiryCreateFromData2Controller クラスの getInquiryTextList メソッドを使用すると、設定したテキスト情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 内部制御パラメータ情報を取得

      InquiryCreateFromData2Controller クラスの getLogicSwitch メソッドを使用すると、設定した内部制御パラメータ情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • アドレス (組織/会社) 用 BAPI 参照構造情報を取得

      InquiryCreateFromData2Controller クラスの getPartnerAddressesList メソッドを使用すると、設定したアドレス (組織/会社) 用 BAPI 参照構造情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。
    • 論理システム - 送信者情報を取得

      InquiryCreateFromData2Controller クラスの getSender メソッドを使用すると、設定した論理システム - 送信者情報を取得することが可能です。
      項目の値を取得するには、KEY に SAP の各属性の項目名称を設定してください。

    コラム

    サンプルプログラム実行結果では、SAP テスト環境のデータが取得されています。SAP 標準では該当データが存在しません。

    注意

    引合伝票登録 API に関して、import、structure、table パラメータが持つ各コンポーネントの必須項目や値の相関チェック等を確認する必要がある場合は、SAP 上の汎用モジュールビルダ(t-cd:SE37)等を使用して、「BAPI_INQUIRY_CREATEFROMDATA2」の BAPI 仕様を確認してください。