activities

latest

false

重要 :

このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

UI Automation のアクティビティ

最終更新日時 2025年11月12日

サポートされている SAP WinGUI 要素

SAP インターフェイスには、このページの例が示すような操作を可能とする、さまざまな固有コントロールがあります。

SAP ボタン

[SAP WinGUI] ウィンドウで使用される、任意のボタンを表します。複数の種類があり、それぞれが特定の要素によって定義されます。

アイコン

アイコンは、テキストラベルを表示しない対話型ボタンです。

プッシュボタン

プッシュボタンは、アプリケーションのコマンドに直接アクセスする単純な UI 要素です。

ラジオボタン

ラジオボタンは一連のオプションを示します。リストには、少なくとも 2 つのラジオボタンがあり、そのうち 1 つだけ選択できます。

ボタンは、[クリック] アクティビティを使用して操作できます。

SAP カレンダー

SAP カレンダーでは単一の日付または期間を選択できます。

SAP カレンダーは、[カレンダーから日付を選択] アクティビティを使用して操作できます。

Note: This SAP control is not supported by Recording in Studio.

SAP チェックボックス

チェックボックス要素は、複数の選択肢のリストを示します。1 つまたは複数を選択するか、まったく選択しないかを選べます。

チェックボックスは、[クリック] アクティビティを使用して操作できます。

SAP コンテキストメニュー

コンテキストメニューに表示される項目のリストを表します。親コンテキストメニュー内では、複数の子テキストメニューを使用できることに注意してください。

You can use the Click activity to interact with the SAP Context Menu. The AA element detection framework is required for interactive selection.

SAP ダイアログ・ボックス

ボタン、テキストメッセージ、ポップアップウィンドウなど、SAP の各種コントロールを含む外部ウィンドウを表します。

ダイアログボックス内のセレクターは、それらが表す要素に従って生成されます。

If you want to close a dialog box using the Close button, you need to use the AA element detection framework.

ダイアログボックスは、[クリック] または [文字を入力] などの UI Automation アクティビティを使用して操作できます。

SAP ドロップダウンリスト

ドロップダウンリストを使用すれば、事前に設定したリストから項目を選択できます。

リストの項目は、[項目を選択] アクティビティを使用して操作できます。

SAP HTML コンテンツ

HTML コントロールは、SAP WinGUI 内に HTML コンテンツを表示するために使用します。

To interact with an HTML page inside the SAP WinGUI, you need to use the AA element detection framework. UIAutomation activities can be used to build processes for SAP HTML content.

SAP 入力フィールド

ユーザー入力を受け付ける専用のフィールドを示します。

[文字を入力] アクティビティを使用して、入力フィールドを操作できます。

SAP にログオン

SAP ログオンは、SAP システムに直接ログオンするための、ローカルにインストールするプログラムです。

SAP を開くには、[SAP にログオン] アクティビティを使用します。

このアクティビティには、次の 2 つのパラメーターが必要です。

SAP システムへのログオンに使用する SAP ログオンまたは SAP ログオンパッドウィンドウから取得する、正確な SAP 接続名
SAP ログオンまたは SAP ログオンパッドのプログラムへのパス。既定のパスは対応するシステムレジストリのエントリから取得されます。

注: 画面上で指定する機能は不要です。SAP システムへの接続には、SAP スクリプトインターフェイスを使用します。

SAP にログイン

SAP システムへのログインを可能にします。

この後に、[SAP にログイン] アクティビティを使用できます。

[複数ログオンオプション] ドロップダウンでは、ユーザーが複数回システムへのログインを試み、複数のログオンポップアップウィンドウでライセンス情報が表示された場合に、どのような操作を実行するかを指定できます。以下のオプションがあります。

他のログオンを終了しこのログオンで続行
他のログオンを終了せずにこのログオンで続行
このログオンを終了

SAP メニュー

SAP メニューの項目を選択できます。SAP メニューは、SAP WinGUI のメインウィンドウでのみ使用できます。

メニュー項目は、SAP の [メニュー項目を選択] アクティビティを使用して操作できます。

Note: This SAP control is not supported by Recording in Studio.

SAP 画像

SAP WinGUI に画像を表示します。

指定した画像をクリックするには、[SAP 画面上の画像をクリック] アクティビティを使用します。

Note: This SAP control is not supported by Recording in Studio.

SAP ステータスバー

SAP WinGUI ウィンドウ下部の、メッセージが表示される領域を示します。システムおよびログインに関する情報は表示されません。

[SAP ステータスバーを読み取り] アクティビティを使用すると、SAP のステータスバーからメッセージの種類、テキスト、データを抽出できます。

Note: This SAP control is not supported by Recording in Studio.

SAP セッション情報

現在の SAP セッションの詳細情報、例えば、システム、クライアント、ログインしたユーザー、現在開いているプログラムやトランザクションなどを表示します。

SAP のオートメーションを作成する際、UIExplorer では、下記のオプションのセレクター属性を、[属性を取得] アクティビティなど、他のアクティビティと併用できます。

sapClient、sapLanguage, sapProgram、sapScreen, sapSession、sapSysName, sapSysNumber、sapSysSessionId, sapTransaction、sapUser

SAP タブ

SAP タブは、特定の情報やコントロールにアクセスできる一連のボタンを示します。

[クリック] アクティビティを使用して一度に 1 つのタブを選択するか、[項目を選択] アクティビティによって、リストから対象のタブを選択できます。

特殊なオートメーションケース

一部の SAP トランザクションは名前にスラッシュ / が含まれているため、セレクターでワイルドカードを使用するときに識別の問題が発生することがあります。

たとえば、SAP トランザクション /COCKPIT/1 の場合、トランザクション内のある SAP タブのセレクターは次のようになります。

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

セレクターの動的な部分は SAPLDISPLAY46:0389 です。数値 0389 は動的に変化するため、安定した識別を行うことができません。

セレクターの構造は次のとおりです。

安定した識別を行うために、階層区切り文字の間にワイルドカードを使用し、区切り文字/スラッシュの間のすべての (そして唯一の) スラッシュを ? で置き換える必要があります。

変更前:

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

変更後:

<sap id='usr/subSUB_MAIN:?COCKPIT?SAPLDISPLAY46:038*/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

SAP テーブル

SAP テーブルは、表形式で表示される一連の標準コントロールを示します。

共通の操作

SAP では複数の種類のテーブルを使用できます。最も一般的に使用されるのが、標準 (既定) テーブル、グリッドテーブル、および ALV テーブルです。すべての種類の SAP テーブルを Studio で自動化できます。

次のアクティビティを使用して、SAP テーブルとその内容を操作できます。

SAP 標準テーブル

SAP 標準テーブルは、上で説明した利用可能なすべての一般的な操作をサポートしています。

SAP グリッドテーブル

SAP グリッドテーブルは、上で説明した利用可能なすべての一般的な操作のほかに、選択/選択解除操作とデータスクレイピングもサポートしています。

選択/選択解除

SAP のオートメーションプロジェクトでは、[クリック] アクティビティまたは[チェック] アクティビティを使用して、必要なあらゆる操作を実行できます。

列を選択/選択解除
行を選択/選択解除
すべて選択/選択解除

テーブルのセルのフィルター処理

上述のように、テーブルのセルでは共通の操作をすべて実行できます。

[表のセルスコープ] アクティビティを使用して、テーブルのセル (列と行) の内容をフィルター処理することもできます。SAP テーブルの列は、表示名だけでなく、他の属性 (ColumnName など) でも識別できます。また、列と行をフィルター処理し、他のプロパティを使用して要素を識別することもできます。

列のツールチップの名前が別の列と似ている場合は、以下の例に示すように、その列を別の属性 (ColumnName など) で識別できるように自動的に切り替わります。

また、行番号に対して高度なフィルター処理を行うこともでき、これにより、以下の例に示すように、複数の属性に基づいた識別が可能になります。

データスクレイピング

Data scraping enables you to extract structured data from SAP Tables, as exemplified below.

同じ名前の複数の列を含むテーブルを自動化する場合、スクレイピングメカニズムによって列名が自動的にインクリメントされます (例: column1、column2、column3)。

[構造化データを抽出] アクティビティは、SAP グリッドビューテーブルからデータを抽出する機能を強化します。columns_name_source パラメーターに次の値を指定することで、テーブルの情報を取得する方法を定義できます。

最長 - 完全な列名を抽出して使用します。
最短 - 短い列名を抽出して使用します。
表示 - SAP WinGUI に表示されている状態の名前を使用します。
技術 - 列の技術的ヘッダー名を抽出して使用します。
ツールチップ - 列名の上にカーソルを合わせたときに表示されるツールチップ名です。

SAP ALV テーブル

SAP ALV テーブルは、上で説明した利用可能なすべての一般的な操作のほかに、簡易ヘッダーテーブルおよび複数ヘッダーテーブルのデータスクレイピングと画面スクレイピングもサポートしています。これにより、SAP 画面の 1 つ以上の ALV テーブルを抽出できます。

データスクレイピング

上で説明した SAP グリッドテーブルのデータスクレイピングとまったく同じように機能します。場合によっては、列のツールチップ名が SAP ALV テーブルの表示名と異なることがあります。

columns_name_source='Tooltip' パラメーターを使用して、テーブルの情報を取得する正しい方法を定義します。

複数ヘッダーのテーブル

Studio では、ヘッダーが 2 行以上にわたるテーブルから正しいデータを抽出できます。

そのために、メタデータは以下を表示します。

join_type = ['LeftOuter' | 'Inner']

これらのオプションは、それぞれの名前を持つ SQL 結合に対応しています。左外部結合は、最初のヘッダーのみが存在する行も抽出します。その他の欠落する列値には NULL プレースホルダーテキストが入力されます。null_value_text = ['(null)' | 'any other user provided value']

内部結合は、完全なデータを持つ行のみを抽出し、すべてのヘッダーについて、データがない行は無視します。