MENU
  1. ホーム
  2. 開発
  3. ABAP
  4. 【SAP ABAP】バッチインプットを用いたプログラム(CALL TRANSACTION)の作成方法を徹底解説！

【SAP ABAP】バッチインプットを用いたプログラム(CALL TRANSACTION)の作成方法を徹底解説！

ABAP

登場人物紹介

三崎レイナ
社会人1年目。新卒でITコンサルティングファームに就職。初配属がSAPプロジェクトにアサインされる。SAPがわからないことだらけで悩んでいたところ、会社の先輩にSAPラボの所長を紹介され、毎週末に所長とSAPのお勉強中！

博士
SAPラボの所長。SAP大好き博士！SAP導入プロジェクトを構想策定～運用保守まであらゆるフェーズを数多く経験。
いまは優しきおじいちゃんだが、プロマネバリバリの時代はかなり怖かったらしい。現在は引退し、SAPの後進育成と啓蒙活動に従事中！

この記事を読むメリット

  • SAPでのバッチインプットの概要が理解できるようになります。
  • バッチインプットレコーダーの使用方法が理解できるようになります。
  • ABAPを用いたバッチインプットプログラムの作成方法が理解できるようになります。
レイナ

アドオンプログラムでバッチインプットをする方法をしりたいな…！

SAPではバッチインプットという機能を用い、SAP上で手作業で実施すべきことを自動化することが可能です。
例えばアドオンプログラムでバッチインプットを利用することで、マスタデータやトランザクションデータを登録することもできます。

今回はバッチインプットの概要からバッチインプットレコーダーの使用方法、ABAPを用いたバッチインプットプログラムの作成について解説します！

この記事のポイント

バッチインプットとは？

バッチインプットとは、SAP上で手作業で入力する動作をプログラムで再現し自動入力させる手法です。
アドオンプログラムの中でバッチインプットの処理をすることが可能で、大量のマスタデータやトランザクションデータを処理する際に便利です。

しかしバッチインプットにもデメリットがあります。

バッチインプットプログラムのデメリット

  • 処理速度が遅い。
  • SAPのバージョンやGUIのバージョンの違いにより、画面仕様（画面名や画面項目名や画面遷移など）が異なる場合に動かなくなってしまう可能性があります。

対象のマスタデータやトランザクションデータを更新するためのBAPIが準備されていれば、BAPIを用いる方がよいでしょう。

バッチインプットレコーダーの使用方法

バッチインプットレコーダーとは、SAPの画面を実際に動かしたとき、システム的にどのような挙動をしているのかを記録するものです。
この結果を元にバッチインプットプログラムを作成していきます。
（慣れたらバッチインプットレコーダーを使わずともバッチインプット用のプログラムを作成できるようになるかも）

さっそくバッチインプットレコーダーを動かしてみましょう！
ここではT-CODE：MM01（品目マスタ登録）をレコーディングしていきます。

バッチインプットレコーダーを使ってみる

バッチインプットレコードを登録してみましょう。
ここでは品目マスタ登録（T-CODE：MM01）のバッチインプットをレコーディングしていく例をみていきます！

まず、T-CODE：SHDBを起動し、「新規記録」を押下します。

バッチインプットレコーダーの使用方法

以下の項目に入力します。

  • レコード
    T-CODE：SHDBの一覧画面に表示されるレコード名になります。分かりやすい名称にしましょう。
  • トランザクションCode
    バッチインプットさせたいトランザクションコードを入力します。
  • バックグラウンドシミュレーションモード
    オンライン実行とバックグラウンド実行で挙動が異なるトランザクションコードが存在します。
    その場合はバッチインプットで動作させたい実行モードに合わせて設定します。
バッチインプットレコーダーの使用方法

ここでは例として品目マスタ登録（T-CODE：MM01）を行っています。
以下のように登録する品目の情報を入力していきます。

  • 品目コード/産業コード/品目タイプを入力してENTER
  • 基本データ1/基本データ2 ビューを選択してENTER
バッチインプットレコーダーの使用方法（品目マスタ登録）

次に以下の手順を実行します。

  • 基本データ1：品目テキスト/基本数量単位/品目グループを入力してENTER
  • 基本データ2：標準テキスト/危険物インジケーターPを入力してENTER
バッチインプットレコーダーの使用方法（品目マスタ登録）
  • 最後に登録確認用のポップアップが出力されるので「Yes」を押下
バッチインプットレコーダーの使用方法（品目マスタ登録）

以上で品目マスタ登録（T-CODE：MM01）での操作は終わりになります！

次に表示される画面は、品目マスタ登録（T-CODE：MM01）を操作した際のバッチインプットレコードの内容です。

バッチインプットレコーダーの結果

バッチインプットレコーダーで記録したものは、SAPで操作した全ての動作や自動で入力された内容も入っており、実際にバッチインプットを動かす際には不要となるレコードも含まれています

バッチインプットのレコードの見方

プログラム/Dynproのブロックごとに画面での動作を表しています。

下図のように1つの画面に対して1つのプログラム/Dynproのブロックに対応しており、例えばT-CODE：MM01の最初の画面はプログラム：SAPLMGMM/Dynpro：0060のブロックで確認できます。

バッチインプットレコーダーをした結果の見方

また、1つのプログラム/Dynproのブロック毎に1つのOKCODEのレコード（項目名が「BDC_OKCODE」のレコード）が存在しています。
これはENTERや実行ボタンなどを押下した場合の内部的なコードを示しています。

加えて、トランザクションコードから呼び出した画面で入力した項目は、以下のようにバッチインプットレコード上でどの項目名に対してどのような項目値を入力したかが記録されています。

バッチインプットレコーダーをした結果の見方

項目名が「BDC_CURSOR」や「BDC_SUBSCR」のレコードはカーソルがどの項目に当てられているかが記録されていますが、これはバッチインプットの処理上では不要である場合がほとんどです。

記録されたバッチインプットレコード

これまでに記録されたバッチインプットレコードの内容を見てみましょう。

プログラムDynpro開始ID項目名項目値
SAPLMGMM0060X
BDC_CURSORRMMG1-MATNR
BDC_OKCODE=ENTR
RMMG1-MATNRtest_mat_sato01
RMMG1-MBRSHM
RMMG1-MTARTROH
SAPLMGMM0070X
BDC_CURSORMSICHTAUSW-DYTXT(02)
BDC_OKCODE=ENTR
MSICHTAUSW-KZSEL(01)X
MSICHTAUSW-KZSEL(02)X
SAPLMGMM4004X
BDC_OKCODE/00
BDC_SUBSCRSAPLMGMM 2004TABFRA1
BDC_SUBSCRSAPLMGD1 1002SUB1
MAKT-MAKTXtest material
BDC_SUBSCRSAPLMGD1 2001SUB2
BDC_CURSORMARA-MATKL
MARA-MEINSPC
MARA-MATKLZBRAKES
MARA-MSTAE03
BDC_SUBSCRSAPLMGD1 2561SUB3
BDC_SUBSCRSAPLMGD1 2007SUB4
BDC_SUBSCRSAPLMGD1 2005SUB5
BDC_SUBSCRSAPLMGD1 2011SUB6
BDC_SUBSCRSAPLMGD1 2033SUB7
BDC_SUBSCRSAPLMGD1 0001SUB8
BDC_SUBSCRSAPLMGD1 0001SUB9
BDC_SUBSCRSAPLMGD1 0001SUB10
SAPLMGMM4004X
BDC_OKCODE/00
BDC_SUBSCRSAPLMGMM 2004TABFRA1
BDC_SUBSCRSAPLMGD1 1002SUB1
MAKT-MAKTXtest material
BDC_SUBSCRSAPLMGD1 2002SUB2
MARA-NORMTaaaaa
BDC_SUBSCRSAPLMGD1 2010SUB3
BDC_CURSORMARA-PROFL
MARA-PROFL001
BDC_SUBSCRSAPLLO_SGT_MM 2016SUB4
BDC_SUBSCRSAPLMGD1 2003SUB5
BDC_SUBSCRSAPLMGD1 2004SUB6
BDC_SUBSCRSAPLMGD1 2499SUB7
BDC_SUBSCRSAPLADRT21 2000SUB8
BDC_SUBSCRSAPLFGSCMPRD_DYN 3011SUB9
BDC_SUBSCRSAPLMGD1 2012SUB10
SAPLSPO10300X
BDC_OKCODE=YES

「BDC_CURSOR」や「BDC_SUBSCR」はカーソルの位置を表すもので、実際にコーディングする際は不要なレコードになります。一部の場合を除いて、大抵の場合は不要とみなして良いでしょう。
それらを削除したレコードは以下になります。

プログラムDynpro開始ID項目名項目値
SAPLMGMM0060X
BDC_OKCODE=ENTR
RMMG1-MATNRtest_mat_sato01
RMMG1-MBRSHM
RMMG1-MTARTROH
SAPLMGMM0070X
BDC_OKCODE=ENTR
MSICHTAUSW-KZSEL(01)X
MSICHTAUSW-KZSEL(02)X
SAPLMGMM4004X
BDC_OKCODE/00
MAKT-MAKTXtest material
MARA-MEINSPC
MARA-MATKLZBRAKES
MARA-MSTAE03
SAPLMGMM4004X
BDC_OKCODE/00
MAKT-MAKTXtest material
MARA-NORMTaaaaa
MARA-PROFL001
SAPLSPO10300X
BDC_OKCODE=YES

上記のうち、色が付いているレコードは画面上でデフォルトで入力されている項目値であり、バッチインプットの際も自動入力されるのでコーディングする際には不要になるレコードになります。
それらを削除したレコードは以下になります。

プログラムDynpro開始ID項目名項目値
SAPLMGMM0060X
BDC_OKCODE=ENTR
RMMG1-MATNRtest_mat_sato01
RMMG1-MBRSHM
RMMG1-MTARTROH
SAPLMGMM0070X
BDC_OKCODE=ENTR
MSICHTAUSW-KZSEL(01)X
MSICHTAUSW-KZSEL(02)X
SAPLMGMM4004X
BDC_OKCODE/00
MAKT-MAKTXtest material
MARA-MEINSPC
MARA-MATKLZBRAKES
SAPLMGMM4004X
BDC_OKCODE/00
MARA-NORMTaaaaa
MARA-PROFL001
SAPLSPO10300X
BDC_OKCODE=YES

だいぶスッキリしましたね。
この内容と同じバッチインプットレコードのデータを用いれば、品目マスタを登録できるはずです。

バッチインプットプログラムを作成

実際にABAPを用いてバッチインプットプログラムを作ってみましょう。

バッチインプットセッションを登録してT-CODE：SM35で実行する方法もありますが、今回はプログラムの中から直接トランザクションコードを呼び出してバッチインプットする方法を解説します。

バッチインプットプログラムの作成手順は以下になります。

バッチインプットプログラムの処理の流れ

  • 通称「BDCテーブル」と呼ばれる内部テーブルを作成
    標準で準備されている構造「BDCDATA」を用い、先ほど編集したバッチインプットレコードと同様の構造で内部テーブルを作成します。
  • CALL TRANSACTIONでトランザクションコードを呼び出し
    BDCテーブルの内容でトランザクションコードを動かします。
  • メッセージ内容を読み込み後続処理
    バッチインプット結果はメッセージに格納されているので、そのメッセージを読み込み成功した場合/失敗した場合でログを残す等の処理を行います。

実際のプログラムを見た方が早いと思いますので、先ほどの品目マスタ作成の例を用いてサンプルプログラムをお見せします！

サンプルプログラム

以下の前提条件でサンプルプログラムを作成してみました。

  • 同じ品目コードを登録することはできないので、ここでは選択画面で登録する品目コードを入力させるようにしています。
  • バッチインプット後のメッセージはWRITE分で出力しています。
  • SAPやGUIのバージョンにより期待値通りに動作しないことがあります。

ABAPを用いたバッチインプットのサンプルコード

*&---------------------------------------------------------------------*
*& Report ZTEST_SATO20
*&---------------------------------------------------------------------*
*&
*&---------------------------------------------------------------------*
REPORT ztest_sato20 NO STANDARD PAGE HEADING.

* 選択項目定義
PARAMETERS:
  p_matnr TYPE mara-matnr. " 品目コード

* 変数定義
DATA:
  it_bdcdata    TYPE TABLE OF bdcdata,   " BDCテーブル
  it_bdcmsgcoll TYPE TABLE OF bdcmsgcoll. " バッチインプット処理メッセージ

* 主処理
START-OF-SELECTION.

* 品目マスタ登録の第一画面
  PERFORM bdc_dynpro      USING 'SAPLMGMM' '0060'.
  PERFORM bdc_field       USING 'BDC_OKCODE'
                                '=ENTR'.
  PERFORM bdc_field       USING 'RMMG1-MATNR'
                                p_matnr.        " 選択画面で入力した品目コード
  PERFORM bdc_field       USING 'RMMG1-MBRSH'
                                'M'.
  PERFORM bdc_field       USING 'RMMG1-MTART'
                                'ROH'.

* 品目マスタ登録のビュー選択画面
  PERFORM bdc_dynpro      USING 'SAPLMGMM' '0070'.
  PERFORM bdc_field       USING 'BDC_OKCODE'
                                '=ENTR'.
  PERFORM bdc_field       USING 'MSICHTAUSW-KZSEL(01)'
                                'X'.
  PERFORM bdc_field       USING 'MSICHTAUSW-KZSEL(02)'
                                'X'.

* 品目マスタ登録の基本データ1画面
  PERFORM bdc_dynpro      USING 'SAPLMGMM' '4004'.
  PERFORM bdc_field       USING 'BDC_OKCODE'
                                '/00'.
  PERFORM bdc_field       USING 'MAKT-MAKTX'
                                'test material'.
  PERFORM bdc_field       USING 'MARA-MEINS'
                                'PC'.
  PERFORM bdc_field       USING 'MARA-MATKL'
                                'ZBRAKES'.

* 品目マスタ登録の基本データ2画面
  PERFORM bdc_dynpro      USING 'SAPLMGMM' '4004'.
  PERFORM bdc_field       USING 'BDC_OKCODE'
                                '/00'.
  PERFORM bdc_field       USING 'MARA-NORMT'
                                'aaaaa'.
  PERFORM bdc_field       USING 'MARA-PROFL'
                                '001'.

* 品目マスタの登録確認画面
  PERFORM bdc_dynpro      USING 'SAPLSPO1' '0300'.
  PERFORM bdc_field       USING 'BDC_OKCODE'
                                '=YES'.

* バッチインプット処理
  CALL TRANSACTION 'MM01'      " MM01を実行
             USING it_bdcdata  " バッチインプットデータ
              MODE 'N'         " 処理モード
            UPDATE 'A'         " 更新モード
          MESSAGES INTO it_bdcmsgcoll.

* メッセージ出力処理
  LOOP AT it_bdcmsgcoll INTO DATA(wa_bdcmsgcoll) .
*   メッセージを格納
    MESSAGE ID wa_bdcmsgcoll-msgid
          TYPE wa_bdcmsgcoll-msgtyp
        NUMBER wa_bdcmsgcoll-msgnr
          WITH wa_bdcmsgcoll-msgv1
               wa_bdcmsgcoll-msgv2
               wa_bdcmsgcoll-msgv3
               wa_bdcmsgcoll-msgv4
          INTO DATA(l_text).

*   メッセージを出力
    WRITE /001 l_text.

  ENDLOOP.

*----------------------------------------------------------------------*
*        Start new screen                                              *
*----------------------------------------------------------------------*
FORM bdc_dynpro USING program TYPE c
                      dynpro  TYPE c.
* 変数定義
  DATA:
    wa_bdcdata TYPE bdcdata. " BDC構造

  CLEAR wa_bdcdata.
  wa_bdcdata-program  = program.
  wa_bdcdata-dynpro   = dynpro.
  wa_bdcdata-dynbegin = 'X'.
  APPEND wa_bdcdata TO it_bdcdata.
ENDFORM.
*----------------------------------------------------------------------*
*        Insert field                                                  *
*----------------------------------------------------------------------*
FORM bdc_field USING fnam TYPE c
                     fval TYPE c.
* 変数定義
  DATA:
    wa_bdcdata TYPE bdcdata. " BDC構造

  CLEAR wa_bdcdata.
  wa_bdcdata-fnam = fnam.
  wa_bdcdata-fval = fval.
  APPEND wa_bdcdata TO it_bdcdata.
ENDFORM.

サンプルプログラムの解説

内部テーブル「it_bdcdata」がBDCテーブルです。
このBDCテーブルに対して、関数「bdc_dynpro（画面名の設定）」「bdc_field（項目入力値やOKコードの設定）」を用いて、バッチインプット用のレコードを格納させていきます。

その後、CALL TRANSACTIONでT-CODE：MM01を呼び出します。

CALL TRANSACTIONのパラメータ

CALL TRANSACTIONでは複数のパラメータを設定することができます。
以下に解説しますが、いろいろ試してみてどういう動作をするか実際動作確認してみると良いでしょう。

CALL TRANSACTIONのパラメータ名パラメータの解説
USING
（使用するBDCテーブル）		BDCテーブルを設定します。
MODE
（処理モード）		バッチインプット時の画面を表示するかどうか設定をすることができます。

【設定内容】
A：すべての画面を表示
E：エラー画面のみ表示
N：画面の表示はしない
※AやEはテスト時に使う場合が多く、たいていの場合はNを設定します。
UPDATE
（更新モード）		データの更新モードを設定することができます。
※指定しない場合はAになります。

【設定内容】
A：非同期更新
　更新の終了を待たず次の処理を行います。
　処理は早いですがロックエラー等の原因にもなります。
S：同期更新
　更新の終了まで待機し、終了したら次の処理を行います。
　非同期更新より処理は遅くなります。
L：ローカル更新
呼出元プログラムと同じダイアログプロセスで実行します。※筆者は使ったことありません。
MESSAGES INTO
（メッセージテーブル）		バッチインプットの処理中に表示されるメッセージを格納する内部テーブルを設定します。
例えば、エラーのメッセージタイプのメッセージのみ取り出してログに出力するような使用をします。

構造は「BDCMSGCOLL」を参照します。
博士

ちょっとだけABAP7.4以降の新構文を取り入れているので、以下も参考に見比べてみると良いのじゃ！

あわせて読みたい
【SAP ABAP】ABAP7.4以降のS4HANAでの新構文（変数定義） この記事を読むメリット ABAP7.4以降の変数定義についての新構文を理解することができます。 ABAP7.4は2013年にリリースされました。多くの便利な構文の追加がされてい…

サンプルプログラムの実行

最後にサンプルプログラムを実際に動かしてみて、期待値通りに動作するか確認してみましょう！

パターン①：既存の品目コードを入力して実行

既に登録されている品目コードを選択画面へ入力して、品目マスタを登録してみましょう。
このパターンは想定されていなかったので品目マスタへの登録は失敗するはずです。

バッチインプットを用いたアドオンプログラム実行

実行した結果は以下になります。
期待値通りに、品目マスタは更新されませんでした。

バッチインプットを用いたアドオンプログラム実行結果

実際の開発では、既存の品目コードが入力された場合も考慮してBDCテーブルを作成する必要があります！

バッチインプットで入力されるであろうデータについて、あらゆるパターンを考慮してBDCテーブルを作成するようにすべし！

パターン②：新規の品目コードを入力して実行

次に登録されていない品目コードを選択画面に入力して実行してみましょう。
この場合は品目マスタの登録に成功するはずです。

バッチインプットを用いたアドオンプログラム実行

実行した結果は以下になります。

メッセージの内容的にも品目マスタが登録された旨が表示され、T-CODE：MM03でも品目マスタが登録されていることが確認できました！

バッチインプットを用いたアドオンプログラム実行結果

さいごに

バッチインプットを用いたアドオンプログラムは便利な機能ですが、すべての入力パターンを網羅してBDCテーブルを作成することや、実行結果をログに残し失敗したデータをどうやってリカバリするかまで検討して設計することが重要になります。

博士

バッチインプットに関する解説は以上じゃ！

★★★SAPラボのライター募集★★★

SAPラボでは、SAPの知識を活かして副業をしたい方を募集してるのじゃ！

SAPラボのライターの特徴 

・ライティング初心者OK！
・報酬高単価！
・業務委託契約なので副業として最適！

SAP記事執筆者としての活動実績として利用可能なので、転職時や案件探しの際に企業へのアピール材料にもなります。

募集要項

・SAP導入や運用保守プロジェクトへの参画経験1年以上

ご応募/お問合せ先

info@sap-career.com

少しでもご興味ある方、ぜひお気軽にご連絡下さい！

ABAP
SAP ABAP バッチインプット バッチインプットレコーダー SHDB
よかったらシェアしてね！
  • URLをコピーしました！

この記事を書いた人

佐藤 皓紀 佐藤 皓紀

株式会社Luxy（https://luxy-inc.com/company_info/）と株式会社アガルートITパートナーズ（https://agaroot-itp.com/about/）の代表取締役。

新卒でSAPエンジニアとして働き始める。副業で事業を開始したのち、2015年に独立しシステム開発会社を設立。SAPの案件に従事しつつシステム開発事業を成長させ、2021年に会社をバイアウト。その後も創業会社とグループ会社で代表を兼任。
SAPエンジニア・コンサルタント歴は10年以上。

一緒に「SAPラボ」を盛り上げてくれる副業ライター(SAP経験者)を募集してますので、お問い合わせよりお願いします！

関連記事

この記事のポイント