SAP BAPI アクティビティパッケージについて

SAP BAPI アクティビティパッケージでは、RPA 開発者がワークフローを使用して、SAP Business Application Programming Interface (BAPI) を呼び出すことができます。パッケージにはユーザーが SAP システムに接続できるスコープアクティビティである [SAP アプリケーションスコープ] が入っており、[SAP BAPI を呼び出し] アクティビティを使って指定した BAPI を呼び出すことができます。

インストールの前提条件

このアクティビティパッケージの前提条件として、SAP Connector for Microsoft .NET 3.0 (NCo 3.0) の 32 ビット (x86) .NET 4.0 バリアントが必要です。このコネクタには、Microsoft C++ ランタイム DLL バージョン 10.0 も必要です (これは、Microsoft Visual C++ 2010 再頒布可能パッケージに含まれています)。 SAP 管理者からインストーラーを入手してください。

注: SAP Connector for Microsoft を Windows グローバルアセンブリキャッシュ (GAC) にインストールしないと、正しく機能しません。これは、SAP コネクタのインストール中に適切なオプションを選択することで実行できます。

これらの依存関係は、このアクティビティパッケージを使用する任意のマシンにインストールできます。これは、Studio でワークフローを作成する開発マシンと、そうしたワークフローをロボットが実行する実稼働マシンの両方を指します。

SAP .NET コネクタの公式ドキュメントは、こちらに掲載されています。

v2.0.0 以上のバージョン用の SAP BAPI ワークフローを生成する

まず、SAP システムへの接続を設定する必要があります。この手順を実行すると、接続を閉じる前に複数の BAPI ワークフローを呼び出すことができます。

接続の構成

カスタムアプリケーションサーバーまたはグループ/サーバーの選択を使用して SAP システムへの接続を構成し、ユーザー/パスワードまたは SSO を使用して認証を行うことができます。接続を成功させるには、サーバーと認証の両方に有効なパラメーターのセットを指定する必要があります。SAP からのエラーメッセージは、欠落しているパラメーターがあることを示します。

デザインコネクション

[SAP アプリケーションスコープ] アクティビティの本体にある [構成] ボタンをクリックすると、ウィザードが開き、設計時に SAP システムへの接続を構成できます。

接続に必要な認証情報をすべて入力し、Test connection (接続のテスト) ボタンをクリックします。接続が正常に確立されると、これを知らせるメッセージが表示されます。

このメッセージボックスで [閉じる] をクリックすると、接続ウィザードが閉じ、認証情報として各プロパティフィールドに入力したすべての値が設定され、アクティビティを使用できる状態になります。

注: 接続ウィンドウを終了するとき Password (パスワード) フィールドの値は、アクティビティのプロパティに保存されません。

ロボットコネクション

[ロボットコネクション] タブに切り替えれば、ロボットコネクションの詳細設定も可能です。

ロボットコネクションの詳細設定は、[デザインコネクション] タブの [ロボットコネクションにコピー] ボタンを使用して、このタブから自動的にコピーすることもできます。

実行時

実行時には、すべてのサーバー認証情報をそれぞれのプロパティフィールドに変数として指定する必要があります。またExistingSAPConnection プロパティフィールド内のすべての接続の詳細を含む IConnectionService オブジェクトを使用することができます。

SAP BAPI を呼び出しアクティビティを設定する

[SAP BAPI を呼び出し] アクティビティのボディにある Configure (構成) ボタンをクリックすると、ウィザードが開き、呼び出す BAPI を選択して構成できます。

BAPI Name 検索バーを使用して、呼び出す BAPI を見つけることができます。選択すると、BAPI の必須パラメータが以下の表に追加され、そこで編集できます。

注: * でマークされたパラメーターは必須であり、削除できません。

表は、次のように 7 つの列に分割されます。

Name - 選択した BAPI に固有のパラメーター名。
Description - パラメーターの簡単な説明です。
Length - 最大文字数 (ある場合)。
Data Type - パラメータの変数またはオブジェクト型。
方向 - パラメータが入力、出力、または 入力/出力のいずれかを指定します。
値 - パラメーターの値です。
- BAPI からパラメータを削除します。

BAPI を待機するパラメーターを設定した後、Done (完了) をクリックすると、ウィザードが閉じ、[SAP BAPI を呼び出し] アクティビティに構成が保存されます。これで、作成したプロセスを実行できます。

パラメータの追加

ウィンドウの左下にある [パラメーターを追加] テキストフィールドを使用してパラメーターのリストを検索し、Enter を押すと、パラメーターを 1 つずつ追加できます。

右上の領域にある Add Parameters (パラメータの追加) ボタンを押すと、実行していた BAPI 呼び出しに任意のパラメータを追加することができます。ボタンをクリックすると、使用可能なすべてのパラメータのリストに切り替わり、それぞれのチェックボックスを選択して、追加するパラメータを指定できます。

パラメータのエクスポート

Export Parameters (パラメーターをエクスポート) ボタンは、現在定義されているすべてのパラメーターとそのメタデータを .xlsx ファイルにエクスポートします。ボタンをクリックすると、参照ウィンドウが開き、エクスポートされたデータを含むファイルを保存する場所を選択できます。このファイルは、入力データファイルを作成するためのテンプレートとして使用できます。