サポートされる SAP GUI for Java の要素

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

SAP ボタン

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

アイコン

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

プッシュ ボタン

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

ラジオ ボタン

ラジオ ボタンには、一連のオプションが表示されます。リストには少なくとも 2 つのラジオ ボタンが含まれ、選択できるのは 1 つだけです。

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

SAP チェックボックス

チェックボックスの要素は、複数の選択肢のリストを表します。オプションを 1 つまたは複数選択することも、オプションなしで選択することもできます。

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

SAP コンテキスト メニュー

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

SAP のコンテキスト メニューは、Java セレクターと [クリック] アクティビティを使用して操作できます。

SAP ダイアログ・ボックス

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

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

[閉じる] ボタンでダイアログ ボックスを閉じるには、AA 要素検出フレームワークが必要です。

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

SAP ドロップダウン リスト

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

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

SAP 入力フィールド

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

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

SAP にログオン

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

SAP を開くには、[ クリック] アクティビティを使用できます。

SAP ステータスバー

SAP GUI for Java ウィンドウの下部にある、メッセージを表示するセクションを表します。システム情報とログイン情報は表示されません。

[属性を取得] アクティビティを使用して、SAP のステータスバーからステータスのプロパティを読み取ることができます。

注: この SAP コントロールは、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 テーブルです。Studio では、あらゆる種類の SAP テーブルを自動化できます。

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

• クリック
• テキストを取得
• 文字を入力
• チェック

SAP 標準テーブル

SAP 標準テーブルでは、以下の一般的な操作がサポートされています。

• クリック
• テキストを取得
• 文字を入力
• チェック

SAP グリッド テーブル

SAP グリッド テーブルでは、選択/選択解除操作、データ スクレイピング、および以下の一般的な操作がサポートされています。

• クリック
• テキストを取得
• 文字を入力
• チェック

選択/選択解除

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

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

データ スクレイピング

データ スクレイピング を使用すると、SAP テーブルから構造化データを抽出できます。

同じ名前の列が複数含まれる表を自動化する場合は、スクレイピング機能によって列名が自動的にインクリメントされます (例:column1、 column2、 column3など)。

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

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

SAP ALV テーブル

SAP ALV テーブルは、前述のように利用可能な共通の操作をすべてサポートしているほか、単純なヘッダー テーブルのデータ スクレイピングや画面スクレイピングもサポートしています。SAP 画面では、単一の ALV テーブルを抽出することができます。

データ スクレイピング

前述の SAP グリッド テーブルのデータ スクレイピングと同様に機能しますが、次の点が異なります。

注:

• 横スクロールはサポートされていません。テーブルが画面の横幅に収まっていて、全体が表示されている必要があります。表示されていない列はスクレイピングされません。

• セル内の複数の行はサポートされていません。

• 列のツールチップ名が SAP ALV テーブルの表示名と異なる場合があります。

画面スクレイピング

画面スクレイピングを使用する場合、推奨されるスクレイピング メソッドはフルテキストで、[非表示のテキストを無視] チェックボックスをオンにする必要があります。このメソッドで抽出されるのは、SAP 画面に表示中されているテキストのみであることに注意してください。

画面スクレイピングの詳細については、こちらのページをご覧ください。

SAP テキスト編集

SAP テキスト編集コントロールは、編集可能なテキスト フィールド/エディターを表します。

次のアクティビティを使用して、このコントロールを操作できます。

• テキスト フィールドに使用する[文字を入力] アクティビティ
• ホットキー対応のボタンに使用する [ホットキーを押下] アクティビティ、またはボタンに使用する [画像をクリック] アクティビティ

SAP ツールバー

SAP ツールバーは、操作可能な一連のボタンを表します。SAP では、SAP トランザクションまたは SAP プログラムに応じて、さまざまな種類のツールバーがあります。

• SAP システムのツールバー
• SAP アプリケーションのツールバー
• SAP 特殊ツールバー
• SAP GridTable ツールバー
• SAP ジェネリック オブジェクト サービス

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

注: この SAP コントロールは、Studio の [レコーディング] には対応していません。

SAP ツリー

SAP ツリーは、ツリー構造に体系化された要素のリストを表します。SAP ツリーには数種類のコントロールが用意されています。

• 単純ツリー

  

• リスト ツリー

  

• 列ツリー

  

SAP ツリー コントロールのすべての種類において、ノードや項目の操作に [クリック] や [テキストを取得] アクティビティを使用できます。

手記： SAP ツリーを操作する際は 、[クリックをシミュレート] プロパティを使用することをお勧めします。