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

UiPath のオートメーション ワークフローで SAP Business Application Programming Interfaces を呼び出すための 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 ワークフローを生成する手順をご覧ください。