v2.0.0 よりも古いバージョン用の SAP BAPI ワークフローを生成する

SAP BAPI パッケージをインストールすると、SAP コネクタ ウィザードが UiPath Studio で使用可能になります。このウィザードは、[ウィザード] セクションの [デザイン] リボン タブに表示されます。

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

このウィザードには、次の4つのセクションが含まれています。

Login Credentials (ログイン資格情報)

このセクションでは、[ システム接続パラメーター] と [ ログイン情報] を入力する必要があります。

[System Connection Parameters] (システム接続パラメーター) には、BAPI 情報を取得するための接続先となる SAP システムの詳細情報を入力します。必須フィールドは次のとおりです。

• Application Server Host (アプリケーション サーバー ホスト)
• System Number (システム番号)

[Login Information (ログイン情報)] には、上記の SAP システムへの接続認証を受ける SAP ユーザーの詳細情報を入力します。必須フィールドは次のとおりです。

• Client (クライアント)
• ユーザー (User)
• パスワード

また、[Language] (言語) フィールドに入力して、SAP の言語を指定することもできます。このフィールドは、言語コード (EN、DE など) で入力します。接続先となる SAP インスタンスに指定した言語をインストールしておく必要があります。このフィールドで言語が未指定の場合、SAP システムの既定言語が使用されます。

[ 接続 ] をクリックすると、接続に成功したかどうかを示し、ステータスが [オンライン] に変わります。

注: 接続が確立されなかった場合、エラー メッセージが表示されます。[System Connection Parameters] (システム接続パラメーター) または [Login Information] (ログイン情報) の設定内容を確認して修正し、リトライしてください。接続が正常に確立されない場合は、SAP 管理者にお問い合わせください。

SAP BAPI Wizard は、[System Connection Parameters (システム接続パラメーター)] および [Login Information (ログイン情報)] の値 ([Password (パスワード)] フィールド以外) を継続中の Studio セッションのために保持します。

BAPI の選択

[SAP BAPI Name (SAP BAPI 名)] フィールドに自動化する BAPI の名前を入力します。任意で、説明も入力します。

[SAP BAPI Name (SAP BAPI 名)] フィールドに入力したら、[Next (次へ)] をクリックします。BAPI がリポジトリで検出されると、ウィザードは [Arguments (引数)] 画面に移動します。

BAPI が見つからない場合は、エラー メッセージが表示されます。入力した SAP BAPI の名前が正しく、SAP システムで有効化されていることを確認します。BAPI が見つからない場合は、SAP 管理者に問い合わせてください。

Select Arguments (引数の選択)

ウィザードには、BAPI のすべての引数が表示されます。また、[Direction (方向)] (In (入力)、Out (出力)、(In/Out) 入力/出力)、[Data Type (データ型)]、引数が [Mandatory (必須)] かどうかなどの詳細情報も表示されます。ワークフローにマッピングする引数をリストから選択します。[Mandatory (必須)] とマークされた引数は、常にマッピング対象として選択されます。

SAP BAPI の 技術名 の代わりに ワークフローの引数 に使用する 割り当て 名を指定することもできます。

BAPI に表や構造などの複雑な引数が含まれることで、その引数がさらに複雑化している場合、サポートされていない BAPI 例外がスローされます。これは、次の引数の型で発生します。

• 表内の表
• 構造内の表
• 構造内の構造
• 表内の構造

また、BAPI に BAPIRETURN、BAPIRETURN1、BAPIRET1、BAPIRET2、BAPIRET2_FIX 以外のパラメーター型の戻り引数が含まれる場合にも、例外がスローされます。

[Next (次へ)] をクリックすると、[Generate Workflow (ワークフローを生成)] 画面に移動します。

ワークフローの生成

この画面では、ワークフローの詳細を見直し、マッピングされるすべての引数が選択されていることを確認できます。

[ ワークフロー ファイル パス ] プロパティ フィールドは、ワークフローを保存する場所を指定します。

[Generate (生成)] をクリックすると、[Select Arguments (引数の選択)] 画面で選択したすべてのオプションに基づいて、指定したパスに .xaml ファイルが作成されます。

BAPI ワークフローの呼び出し

SAP BAPI ワークフローの呼び出しには、[ワークフロー ファイルを呼び出し] アクティビティを使用できます。呼び出しアクティビティの前に [SAP 接続を開く] アクティビティを置く必要があります。これは、このアクティビティによって、後で SAP BAPI ワークフローの引数 SAPConnectionService で使用される SAPConnectionService 変数が生成されるからです。この引数は、[SAP 接続を開く] アクティビティの SapConnectionService プロパティ フィールドで設定します。

注: [ワークフロー ファイルを呼び出し] アクティビティで [分離] プロパティを使用している場合は、SAP BAPI パッケージで生成したワークフローは呼び出すことができません。

BAPI の Table 型の引数はすべて DataTable 引数にマッピングされ、BAPI の Structure 型の引数は DataRow 引数にマッピングされます。その他のすべての引数は、基本データ型にマッピングされます。

また、すべての BAPI ワークフローは、該当する型の BapiReturn 構造も返します。

[ワークフロー ファイルを呼び出し] アクティビティの後に、[SAP 接続を閉じる] アクティビティを使用して、SAP 接続を閉じる必要があります。この接続は、同じ SAPConnectionService 変数を使って指定できます。