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

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

インストールの前提条件

注:

インストールの前提条件は、SAP BAPI パッケージ バージョン 2.2.6 以前に適用されます。バージョン 3.0.0 から、Studio の Windows プロジェクトでは前提条件は不要ですが、Windows - レガシ ワークフローを構築する場合は引き続き必要です。

このアクティビティ パッケージの前提条件は、SAP Connector for Microsoft.NET 3.0 (NCo 3.0) の 32 ビット (x86) .NET 4.0 バリアント (3.0.0.42 を推奨) です。このコネクタには、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 - パラメータの変数またはオブジェクト型。
• 方向 - パラメータが入力、出力、または 入力/出力のいずれかを指定します。
• Value - パラメータの値。
• - BAPI からパラメータを削除します。

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

パラメータの追加

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

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

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

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

バージョン v1.x.x 用の SAP BAPI ワークフローを生成する

v2.0.0 よりも古いバージョンを使用している場合は、こちらで SAP BAPI ワークフローを生成する手順をご覧ください。