SAP 自動化アクションには、SAP ワークフローの合理化と自動化に役立つ一連のツールが用意されています。 これらのアクションを使用すると、SAP GUI アプリの起動、新しいセッションの作成、メニュー項目の選択、トランザクションの開始と終了などを簡単に行うことができます。
SAP 自動化グループのアクションを使用すると、SAP UI 要素をクリックしたり、テキスト フィールドに入力したり、データを抽出したりすることで、簡単に SAP UI 要素とやり取りできます。 SAP UI 要素の ID 属性値を入力するだけです。 ID の値がわからない場合は、デスクトップ用 Power Automate の UI 要素ピッカーを使用して、必要な SAP 要素を指定し、その ID 値を取得することができます。 この方法で SAP UI 要素をキャプチャすると、要素の ID 値のみが回復され、デスクトップ フローの UI 要素リポジトリに UI 要素は追加されません。
SAP 自動化アクションは、UI 自動化アクション群を含め、デスクトップ用 Power Automate で利用可能な他のアクションともシームレスに連携できます。 このアクション グループでは、すべての SAP GUI UI 要素をキャプチャして、デスクトップ フローの UI 要素リポジトリに追加できます。 SAP の GUI 自動化アクションと UI 自動化アクション グループを組み合わせることで、最も複雑な SAP プロセスも自動化する強力な RPA ワークフローを作成できます。
注意
デスクトップ用 Power Automate は、SAP GUI バージョン 750 以降による自動化をサポートします。
既知の制限
SAP Web UI
UI または Web オートメーション アクションまたは SAP アクションは、SAP の埋め込みブラウザー (Web Dynpro) で開いている SAP フォームでは機能しません。 この制限の回避策の 1 つは、そのページをスタンドアロン ブラウザーに直接開き、Web Automation アクションを使用して自動化することです。
SAP を起動
SAP GUI アプリケーションを開き、SAP システムに接続します。
次の 2 つの接続モード オプションがあります。
- サーバーの説明で SAP 名または IP アドレスを使用します。 このオプションを使用するには、必要なログイン資格情報とアクセス許可が必要です。 サーバーの説明は、人間が判読できる SAP システムの名前または説明です。
- サーバー 接続文字列を使用します。 通常、サーバー 接続文字列には、サーバーの名前または IP アドレス、インスタンス番号、およびシステム ID が含まれます。 サーバー接続文字列は、SAP システムを識別して接続するための特定の形式です。
複数のログオン オプションがあります。
- このログオンを終了する: このオプションは、特定のアクションのログオンを終了します。
- このログオンを続行し、他のログオンを終了します。このオプションは、既存の SAP インスタンスを特定のログオンに置き換えます。
- システム内の他のログオンを終了せずに、このログオンを続行します。このオプションでは、新しい SAP セッションが作成されます。
注意
SAP GUI では、SAP システムへのアクティブな接続 (セッション) が 6 つ以上許可されません。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
| 接続モード | N/A | サーバーの説明とサーバー接続文字列 | サーバーの記述 | SAP GUI サーバーへの接続方法を指定してください。 |
| ログイン モード | N/A | 手動ログインとシングル サインオン (SSO) | 手動ログイン | SAP GUI サーバーへのログイン方法を指定します。ユーザー名とパスワードを自分で入力してログインするか、シングル サインオン (SSO) を使用するかを選択できます。 |
| サーバーの記述 | はい | テキスト値 | SAP システム名または IP アドレスを指定して接続します。 | |
| 接続文字列 | はい | テキスト値 | SAP GUI サーバーの接続文字列を指定します。 接続文字列は、サーバーの名前、システム番号、その他の接続の詳細を指定する一意の識別子です。 | |
| Client | いいえ | テキスト値 | 接続する SAP クライアント番号を指定します。 | |
| Username | いいえ | テキスト値 | ログイン用の SAP ユーザー ID を指定します。 | |
| Password | はい | テキスト値 | ログイン用の SAP ユーザー パスワードを指定します。 | |
| Language | いいえ | テキスト値 | ユーザー インターフェイスの SAP ログインの言語を指定します。 | |
| 複数のログオン オプション | いいえ | このログオンを終了する、このログオンを続行して他のログオンを終了する、システム内の他のログオンを終了せずにこのログオンを続行する | このログオンを終了する | 複数のログオン オプションは、ユーザーがすでにログインしているときにログインしようとしたときの SAP システムの動作を指定します。 |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
SAPInstance |
SAP インスタンス | SAP オートメーション アクションで使用する新しい SAP インスタンス。 SAP インスタンスは、特定の SAP ウィンドウを指します。 |
CurrentSAPLoginTerminated |
ブール値 | 指定したアクションで実行される SAP ログインが終了したかどうかを示します。 |
OtherSAPLoginTerminated |
ブール値 | 他の SAP ログインが終了しているかどうかを示します。 |
例外
| 例外 | Description |
|---|---|
| SAP GUI ログイン アクションが失敗する | SAP GUI システムへのログインに問題があることを示します。 |
添付
実行中の SAP GUI アプリケーションを SAP インスタンスにアタッチします。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
| アタッチ モード | いいえ | フォアグラウンドまたは最後にアクティブになったウィンドウのタイトル | ウィンドウ タイトル | SAP インスタンスをウィンドウにアタッチするためのモードを指定します。 [フォアグラウンド] オプションまたは [最後にアクティブ化されたオプション] を選択すると、SAP インスタンスはフォアグラウンドの SAP セッションにアタッチされます。 フォアグラウンドに SAP セッションがない場合は、起動した最後の SAP セッションにアタッチされ、まだ閉じられません。 |
| ウィンドウ タイトル | はい | テキスト | インスタンスがアタッチされている SAP ウィンドウのタイトルを指定します。 既存の SAP セッションのドロップダウン リストからウィンドウ タイトルを選択するか、手動で入力することができます。 |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
SAPInstance |
SAP インスタンス | SAP オートメーション アクションで使用する新しい SAP インスタンス。 SAP インスタンスは、特定の SAP ウィンドウを指します。 |
例外
| 例外 | Description |
|---|---|
| SAP へのアタッチ エラー | Excel インスタンスを SAP インスタンスにアタッチするときに問題が発生したことを示します。 |
新しい SAP セッションを作成
同じ SAP インスタンスに基づいて新しい SAP セッションを作成します。
注意
SAP GUI では、SAP システムへのアクティブな接続 (セッション) が 6 つ以上許可されません。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
SAPInstance |
SAP インスタンス | SAP オートメーション アクションで使用する新しい SAP インスタンス。 SAP インスタンスは、特定の SAP ウィンドウを指します。 |
例外
| 例外 | Description |
|---|---|
| 新しい SAP セッションの作成アクションが失敗する | 新しい SAP セッションの作成で問題が発生したことを示します。 |
SAP のナビゲーション項目を選択する
SAP ウィンドウのアプリケーション ツールバーで SAP のメニュー項目を選択します。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 | |
| ナビゲーション項目名 | いいえ | テキスト値 | 選択するナビゲーション ツールバー上の項目の名前 (「システム」など)。 親子関係を示す記号「>」を使用して、サブメニューからオプションを指定することもできます。 たとえば、「Program > Execute」は、「Program」の下のサブメニューの一部である「Execute」オプションが選択されていることを意味します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP GUI のナビゲーション ツール バー項目の選択エラー | ナビゲーション ツールバーの項目を選択できないことを示しています。 |
SAP メニュー項目を選択
ウィンドウのツールバーで SAP メニュー項目を選択します。 SAP GUI 画面が表示されているのと同じ言語で、それぞれの入力パラメータに項目の名前を手動で入力します。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 | |
| メニュー項目名 | いいえ | テキスト値 | 選択するツール バーのメニュー項目の名前 ([保存] など)。 マシンの SAP インストールに表示されるメニュー項目の名前を挿入します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP メニュー項目の選択アクションが失敗する | メニュー項目の選択に問題があることを示します。 |
SAP 接続を閉じる
選択した SAP インスタンスの SAP 接続を閉じます。 接続を閉じると、その特定の接続に関連するすべてのインスタンスが終了します。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP セッションを閉じるアクションが失敗する | SAP セッションのクローズ時に問題が発生したことを示します。 |
SAP トランザクションを開始
既存のセッションで特定のトランザクション コードを開きます。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 | |
| トランザクション コード | いいえ | テキスト値 | 実行するトランザクション コード。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP トランザクションの開始アクションが失敗する | SAP トランザクションの開始時に問題が発生したことを示します。 |
SAP トランザクションを終了する
指定された SAP インスタンスで SAP トランザクションを閉じ、SAP Easy Access メニューに戻ります。 特定の SAP セッションの前に SAP トランザクションを開始する必要があります。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP トランザクションの終了アクションが失敗する | SAP トランザクションの終了時に問題が発生したことを示します。 |
SAP UI 要素をクリックする
SAP ウィンドウの任意の UI 要素に対するクリック アクションを通じて対話します。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 | |
| 要素タイプ | いいえ | SAP の基本要素、チェックボックス、ラベル、ドロップダウン リスト、グリッド要素 | 基本 SAP 要素 | 操作する SAP 要素の種類を選択します。 [SAP 要素のクリック] オプションは、ボタン、ラジオ ボタン、タブ、テキスト フィールド、ツリーなどの SAP 要素に対してクリック アクションを実行します。 |
| SAP 要素 ID | いいえ | 数値 | SAP 要素の ID。 このパラメータは、アクションが対話する SAP 内の UI 要素を決定します。 次のボタンを使用して、SAP 画面で SAP UI 要素を指定するか、値を手動で挿入します。 | |
| SAP 要素 ID | いいえ | 数値 | SAP 要素の ID。 このパラメータは、アクションが対話する SAP 内の UI 要素を決定します。 次のボタンを使用して、SAP 画面で SAP UI 要素を指定するか、値を手動で挿入します。 | |
| SAP チェックボックスの状態を次に設定する | はい | チェックボックスがオン、チェックボックスがオフ | 確認済 | チェックボックスがチェックされた状態になるか、チェックされていない状態になるかを指定します。 |
| SAP ラベルの操作 | はい | 展開、折りたたむ、選択 | 展開する | SAP ラベルを展開するか折りたたむかを指定します。 |
| ドロップダウン オプションの値 | はい | テキスト値 | ドロップダウン オプションが選択されていることを指定します。 | |
| SAP グリッド要素 | はい | セル、行、ヘッダー、リスト、ボタン、ツール バー ボタン、チェック ボックス、ラジオ ボタン | セル | 操作する SAP グリッド要素の種類を選択します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP GUI 要素クリック エラー | クリックに失敗したことを示します。 |
SAP UI 要素の詳細を取得する
SAP ウィンドウの SAP UI 要素の属性値を取得します。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 | |
| SAP 要素 ID | いいえ | 数値 | SAP 要素の ID。 このパラメータは、アクションが対話する SAP 内の UI 要素を決定します。 次のボタンを使用して、SAP 画面で SAP UI 要素を指定するか、値を手動で挿入します。 | |
| 属性名 | いいえ | テキスト値 | 独自のテキスト | 値を取得する属性です。 |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
| AttributeValue | テキスト値 | SAP UI 要素の属性の値です。 |
例外
| 例外 | Description |
|---|---|
| SAP 要素の詳細取得エラー | UI 要素の属性の取得中に発生した問題を示します。 |
要素の SAP テキスト フィールに入力する
SAP ウィンドウのテキスト ボックスに指定されたテキストを入力します。
入力パラメーター
| 引数 | オプション | 受入 | 既定の値 | Description |
|---|---|---|---|---|
SAPInstance |
いいえ | SAP インスタンス | 作業する SAP インスタンスを保持する変数を選択します。 この変数は、以前の SAP ログイン アクションで定義します。 | |
| SAP 要素 ID | いいえ | 数値 | SAP 要素の ID。 このパラメータは、アクションが対話する SAP 内の UI 要素を決定します。 次のボタンを使用して、SAP 画面で SAP UI 要素を指定するか、値を手動で挿入します。 | |
| 入力するテキスト | いいえ | 直接暗号化された入力またはテキスト値 | SAP テキスト フィールドに入力するテキストです | |
| フィールドが空白ではない場合 | はい | テキストを置き換える、テキストをアペンドする | テキストを置換する | 既存のコンテンツの置換、または追加を指定します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| SAP テキスト フィールド値入力エラー | 指定された SAP テキスト フィールドへの入力に問題があることを示します。 |