SAP BAPI packageを使用して bot をビルドし、SAP データベースにデータを書き込みます。

前提条件

Download the SAP Java connector and dynamic library files (.dll file for Windows automation and .dylib file for macOS automation) from the SAP portal.

このチュートリアルでは SAP デモ フライト データ アプリケーションから BAPI_FLCUST_CREATEFROMDATA を呼び出す bot をビルドします。CUSTOMER_DATA インポート パラメーターを使用して、顧客データを BAPI に渡します。実行すると、bot は、SAP データベースに新規の顧客レコードを作成し、BAPI から返された顧客番号を表示します。

このチュートリアルでは、次の操作の実行方法を紹介します。
  • インポート パラメーターに値を設定するには、[構造を取得] コマンドを使用します。
  • SAP のテーブルに新しいレコードを作成します。
  • BAPI からの応答を受信します。

手順

  1. 「SAP-BAPI-CreateNewFlightCustomer」という名前の botを作成します。
    1. Control Room にログインします。
    2. 左側のペインで [オートメーション] をクリックします。
    3. [Bot を作成] アイコンをクリックします。
    4. [名前] フィールドに、「SAP-BAPI-CreateNewFlightCustomer」と入力し、[作成と編集] をクリックします。
  2. To connect the bot to your SAP system, from the Actions panel, find SAP BAPI > Connect action and add it to the Bot editor.
    1. In JCo: SAP Java Connector package, specify the path to the Java connector .jar file.
    2. In JCo DLL/DYLIB dependency, specify the path to the dynamic library file.
      .dll for Windows automation and .dylib for macOS automation.
    3. Choose Custom Application Server as Connection Type.
    4. In Application server host name, specify the host name of the SAP application server.
      注: As a best practice, use the Credential Vault to specify sensitive information such as host name, user name, and password.
    5. In System number, enter the instance number.
    6. In SAP instance system ID, enter the system ID.
    7. In Client number, enter the client number.
    8. In Logon language code, enter EN or the language specific to your system.
    9. In Router string, enter the SAP router string.
    10. In Username, enter your SAP username.
    11. In Password, enter your password.
    12. Run the bot to test the connection.
      If you specify the correct connection properties, the bot executes successfully.
  3. 関数を作成するには、[SAP BAPI] > [関数を作成] アクションを追加します。
    1. [関数エイリアス名] に、「createNewFlightCustomer」と入力します。
    2. [BAPI 名] に、「BAPI_FLCUST_CREATEFROMDATA」と入力します。
  4. CUSTOMER_DATA パラメーターはタイプ構造なので、インポート パラメーターの構造を取得し、エイリアスに代入します。 これを実行するには、[SAP BAPI] > [構造を取得] アクションを実行します。
    1. [関数エイリアス名] に、「createNewFlightCustomer」と入力します。
    2. [構造名] に、「CUSTOMER_DATA」と入力します。
    3. 取得した構造体をエイリアスで保存するには、[送り先] で [エイリアス] タブをクリックします。
    4. [構造のエイリアスを作成] に、「CustomerData」と入力します。
      エイリアスを使用して、取得した構造体内のインポート フィールドに値を設定することができるようになります。
  5. [CUSTNAME] フィールドに値を設定するには、[SAP BAPI] > [フィールド値を設定] アクションを実行します。
    1. [関数エイリアス名] に、「createNewFlightCustomer」と入力します。
    2. [送り元] で、[構造] タブをクリックします。
    3. [構造のエイリアス] に、「CustomerData」と入力します。
    4. [フィールド名] に、「CUSTNAME」と入力します。
    5. [フィールド値] に、「John Doe」と入力します。
  6. ステップ 5 を繰り返し、次の各フィールドに [フィールド値を設定] アクションを追加して構成します。
    フィールド名 フィールド値
    STREET testStreet
    POSTCODE 101001
    CITY testCity
    COUNTR US
    COUNTR 00000000
    EMAIL test@example.com
    CUSTTYPE P
  7. BAPI_FLCUST_CREATEFROMDATA を実行するには、[SAP BAPI] > [関数を実行] アクションを追加します。
    1. [関数エイリアス名] に、「createNewFlightCustomer」と入力します。
    注: BAPI_FLCUST_CREATEFROMDATA がデータを SAP データベースに書き込むようにする場合、シーケンスを終了 と トランザクションを確定 オプションを選択する必要があります。 [シーケンスを終了] オプションを選択する場合、[関数を作成] アクションで [シーケンスを開始] オプションを選択してください。

    このチュートリアルで作成したサンプル bot は、SAP BAPI packageを使用した場合の Create() BAPI の動作を説明することを目的としています。 データベースの修正については説明していません。

    BAPI は、新規顧客レコードの作成後、顧客番号を付与して返します。
  8. 変数に数値を取り込むには、[SAP BAPI] > [フィールド値を取得] アクションを追加します。
    1. [関数エイリアス名] に、「createNewFlightCustomer」と入力します。
    2. [送り元] で、[関数] タブをクリックします。
    3. [フィールド名] に、「CUSTOMERNUMBER」と入力します。
    4. [結果を変数に保存] で、[(x)] をクリックして、「strCustomerNumber」という名前の変数を作成し、その変数を選択します。
  9. 顧客番号を表示するには [メッセージボックス] アクションを追加します。
    1. [表示するメッセージを入力] で、strCustomerNumber 変数を選択します。
  10. bot を保存して実行します。