SAP Modules

標準サブセットの Engines- >SAP フォルダには、 SAPエンジン 3,0の特定のタスクを実行するModulesが含まれています。

SAP フォルダには、追加 ModulesContextMenuEntry 、 MenuEntry 、および TreeMenuEntry を含む Classes という名前のサブフォルダーが含まれています。これらのModulesは、テストで使用するModulesのためにバックグラウンドタスクを実行します。これらをTestCaseに使用することはできません。

SAP ContextMenu

SAP ContextMenu モジュールは、 SAPコンテキストメニューを制御できます。

コンテキストメニューを開き、 SAP Engine 3.0 を制御できるようにしておく必要があります。イメージベースのテスト自動化を使用して、ツリー内のコンテキストメニューを開きます。

モジュールには、次のModuleAttributeがあります。

ModuleAttribute

説明

ContextMenu

メニュー項目へのパス。

例えば、挿入＞画像のように、ノードを＞で示します。

ディレクトリ全体を選択するには、 x 、 X を指定するか、値を指定しません。

ContextMenu->ContextMenuEntry

あるいは、 ContextMenuEntry を使用してメニューアイテムを指定します（次の例を参照）。

この例では、 SAP Engine 3.0 でコンテキストメニューを開き、 Unicode制御文字を挿入->ゼロ幅接合子のエントリを選択します。

SAPコンテキストメニュー: メニューパスを指定する

この例では、 SAP Engine 3.0 でコンテキストメニューを開き、ゼロ幅接合子オプションが存在するか否かを検証します。

SAP コンテキストメニューの項目を確認する

SAP Login

SAP Login モジュールは、 SAP Login画面を制御できます。

次のModuleAttributeがあります。

ModuleAttribute

説明

Client

使用するClient

User

サインインする必要があるユーザーのユーザー名。

Password

ユーザーのパスワード。

Language

適切な言語（使用言語）。

Enter

Enter ボタンをマウスでクリックするには、 {Click} と入力します。

この例では、ユーザー test01 のユーザー認証情報を使用してClient 001 にサインインします。

  • 最初のテストステップで、 SAP Logon モジュールを使用してSAPシステムを開きます。

  • 2番目のTestStepで、ログイン画面を制御する。SAP Engine 3.0 で、必要なデータを入力し Enter で確定します。

SAPシステムを開き、Login画面を制御する

SAPログオン

モジュール SAPログオンを使用すると、SAPセッションを開くことができます。これはつまり、SAPログオンウィンドウを操縦するためです。

これは、 SAPログイン画面を操縦する場合の必須の最初の手順です。

次のModuleAttributeがあります。

モジュール属性

説明

SapLogonPath

saplogon.exe プログラムファイルへの全パス。

SapConnection

接続先のセッションの名前またはシステムID（SID）。

ワイルドカードを使用可能。

シングルサインオンをバイパスする

このModuleAttributeはオプションのため、手作業で追加する必要があります。

ユーザー名とパスワードを代わりに使用したいがSAP環境の初期設定のサインイン方式がシングルサイオン（SSO）の場合は、このModuleAttributeを作成して True に指定します。詳細情報については、以下の指示を参照してください。

この例では、接続名を使用して SAP  Logon ダイアログを開きます。

接続名を使用してSAP接続を開く

この例では、SIDを使用して SAP Logon ダイアログを開きます。

SIDを使用してSAP接続を開く

一部のSAP環境では、初期設定のサインイン方式がシングルサインオン（SSO）に設定されている場合があります。SSOをオフにするには、以下の手順に従ってください：

  1. 「 モジュール」タブで、「標準モジュール」->「エンジン」 -& gt;「Sap 」にある「 SAP ログオンモジュール」に移動します。

  2. モジュールを右クリックし、ミニツールバーから 「 ModuleAttributeの作成」を選択します。

  3. 新しいModuleAttributeの名前を Bypass Single Sign-On に設定します。

  4. 新しいModuleAttributeのプロパティペインで、パラメータという新しい構成パラメータを作成し、その値を TRUE に設定します。

Bypass Single Sign-On ModuleAttributeの追加パラメータ

  1. SAPログオンモジュールをテストケースにドラッグアンドドロップします。

  2. SAPLogonPath および SAP Connection には、 chapter "SAPログオン" で説明されている値を入力します。

  3. Bypass Single Sign-On の場合は、 True と入力して、デフォルトのSSOサインイン方法をオフにします。ActionModeを入力に設定します。

テストケースのBypass Single Sign-On ModuleAttribute

SAPメニュー

SAP Menu モジュールは、 SAPメニューを操縦できます。さらに、 ActionModeの Verify を使用して、特定のメニューエントリが含まれているか否かを検証できます。

次のModuleAttributeがあります。

ModuleAttribute

説明

MenuBar

メニュー項目へのパス。

挿入＞画像のように、ノードを＞で示します。

ディレクトリ全体を選択するには、 x 、 X を指定するか、値を指定しない。

MenuBar->MenuEntry

あるいは、 MenuEntry を使用してメニューアイテムを指定することもできる（次の例を参照）。

この例では、システム->サービス->; QuickViewer のパスを入力してメニューエントリ QuickViewer を選択します。

SAPメニュー: メニューパスを使用する

この例では、メニューエントリ QuickViewer を直接選択します。

SAPメニュー: メニューエントリを直接使用する

この例では、 SAP Engine 3.0 で、システム ->サービス->QuickViewer のメニューエントリが存在することを確認します。

SAPメニュー: メニューエントリ QuickViewer が存在することを確認します

SAP Multiple Logon License Warning

SAP Multiple Logon License Warning モジュールは、 License Information for Multiple Logon モーダルダイアログウィンドウを制御できます。

このダイアログは、ユーザーがシステムへのサインインを複数回にわって試行した時に開きます。

モジュールには、次のModuleAttributeがあります。

ModuleAttribute

説明

Login Option

サインインの試行によって何をするかを指定する。

使用可能な値:

  • Continue with this logon and end any other logons in system: SAP Engine 3.0 は、現在のログオン試行を続行して他のログオン試行をすべて終了する

  • Continue with this logon, without ending any other logons in system: SAP Engine 3.0 は、現在のログオン試行を続行して他のログオン試行をすべてそのまま放置する

  • Terminate this logon: SAP Engine 3.0 は、現在のログオン試行を終了する

Button

ダイアログボックスボタンを制御する。

使用可能な値:

  • Confirm Selection ：選択を確認し、ダイアログボックスを閉じる

  • cancel ：選択をキャンセルし、ダイアログボックスを閉じます。

この例では、 SAP Engine 3.0 で次のアクションを実行します。

  • 現在のログオン試行を続行し、他のログオン試行をすべて終了する。

  • 選択を確認し、ダイアログボックスを閉じる。

複数ログオン時のライセンス情報ダイアログボックスの操縦

SAP StatusBar

SAP Statusbar モジュールは、 SAP Status Barの情報と現在のセッションの情報を検証できます。

次のModuleAttributeがあります。

ModuleAttribute

説明

Message

検証するメッセージ。ActionModeの Verify を使用する。

Messagetype

検証するメッセージタイプ。

使用可能な値:

  • Success

  • Warning

  • Error

  • Abort

  • Information

ActionModeの Verify を使用する。

SessionInfo

確認する現在のセッションに関する情報。

使用可能な値:

  • Client

  • Flushes

  • InterpretationTime

  • Language

  • Program

  • ResponseTime

  • RoundTrips

  • SystemName

  • Transaction

  • User

ActionModeの Verify を使用する。

このModuleAttributeを任意の SAP Engine 3.0 モジュールに追加可能。

SAP SubToolBar

SAP SubToolBar モジュールは、 SAP SubToolbarを制御できます。

次のModuleAttributeがあります。

ModuleAttribute

説明

SubToolBar

操縦するサブツールバーのエントリ。

この例では、 SAP Engine 3.0 が、 SAP SubToolbar の役割を作成ボタンを操縦します。​

SAP SubToolbarを操縦する

SAP Toolbar

SAP Toolbar モジュールは、 Transaction codeフィールドが含まれているSAP Toolbarを制御できます。

次のModuleAttributeがあります。

ModuleAttribute

説明

Transaction code

トランザクションコードを指定する。

Button

どのアクションを実行するかを定義する。

使用可能な値:

  • Enter

  • Save

  • Back

  • Exit

  • Cancel

  • Print

  • Find 、 Find Next

  • First Page 、 Previous Page 、 Next Page 、 Last Page

  • ヘルプ

この例では、トランザクションコード RZ11 を検索します。

トランザクションコードを検索する

SAP TreeView

SAP TreeView モジュールは、 SAP TreeViewsを制御できます。

以下のモジュール属性を持っています：

ModuleAttribute

説明

MenuPath

メニュー項目へのパス。

挿入＞画像のように、ノードを＞で示します。

ディレクトリ全体を選択するには、 x 、 X を指定するか、値を指定しない。

MenuPath->TreeMenuEntry

あるいは、 ContextMenuEntry を使用してメニュー項目を指定することも可能。

ドッキングされたツリーメニュー

ドッキングした状態の TreeView で選択するメニュー項目へのパス。

TreeView のテクニカルIDに応じて、ModuleAttributeの MenuPath または Docked Tree-Menu を使用。既定値のModuleAttributeは MenuPath 。

この例では、 SAP Engine 3.0 が、 SDCCN - Service Data Control Center のメニューエントリをダブルクリックで開きます。

SAP TreeViewを制御する

SAP Logon - Open with Solution Manager

SAP Logon - Open with Solution Manager モジュールは、実行中に複数のSAP接続を開くことができます。

次のModuleAttributeがあります。

ModuleAttribute

説明

SapLogonPath

SAP Logon GUIへの全パス。

SapConnection

接続したいセッションの名前です。

SAP エミュレートツリー

モジュール SAP Emulated Tree は、 SAP Emulated Treeを操縦することを可能にします。

次のModuleAttributeがあります。

ModuleAttribute

説明

Tree

Emulated Treeの項目へのパス。

ノードを -> で示す。例： NodeA->NodeB 。

もし複数のエントリがパスにマッチする場合、 Tricentis Tosca は最初のマッチングを操縦します。

インデックス番号でノードを置き換えることができます。例えば、 NodeA->#5-& gt;NodeC と入力することで、第2ノードの第5エントリを選択することができます。

列

Emulated Treeの列番号。列番号は #1 から開始。

テキストが一切含まれていないセルがある列も数にかぞえる。一部のEmulated Treeでは、このような空白セルによって列が分割される（次の例を参照）。

Action

Emulated Treeの項目で実行するアクション。

使用可能な値:

  • {CLICK}

  • {DOUBLECLICK}

  • {RIGHTCLICK}

  • アイコンのツールチップ：。Tooltip==Tooltip Text

  • トラフィックライト: Green 、 Yellow 、 Red

ScanAlgorithm

Emulated Treeをナビゲートするために SAP Engine 3.0 が使用するアルゴリズム。

使用可能なアルゴリズム:

  • FastVerticalNoHorizontal - このモジュールでデフォルトのアルゴリズム。Emulated Treeを上下にスクロールできるが、左右にスクロールできない。このアルゴリズムは、固定された最上位行を含むエミュレートされたツリーを操縦する場合には適していません。

  • FastVerticalFastHorizontalWithStaticAre - エミュレートツリーを縦横にスクロールします。このアルゴリズムは静的エリアを考慮しているため、固定された上部行を含むエミュレートツリーを操縦するのに適しています。

  • DetailedIdentification - エミュレートツリーを縦横にスクロールします。このアルゴリズムは、テーブルのセルをより正確に識別するため、エッジケースに適しています。静的領域を持つエミュレートツリーを操縦するためにも使用できます。

この例では、次のエミュレートされたツリーのエントリ BAPISDBUSI をクリックします：

SAPのエミュレートされたテーブルツリー

これを行うにはモジュール SAP Emulated Tree を使用し、次のテストステップ値を入力します:

  • ModuleAttribute ツリーでは、ノード -> を使用してエントリへのパスを入力します。Tricentis Tosca は、このパスに一致する複数のエントリを見つけた場合、最初のエントリを選択します。

  • ModuleAttributeのColuの列で、 #3 と入力します。これは、最初の列の後の空きスペースも列として認識されるためです。

  • ModuleAttributeの Action で、 {CLICK} と入力します。これでエントリがクリックされます。

  • デフォルトの ModuleAttributeである ScanAlgorithm は変更しないでください。

テストケースのSAP Emulated Tree モジュール

こ の例では、その他のオブジェクトのトラフィックライトが赤に設定されているかどうかを確認します。

SAPのEmulated Tree

これを行うには、モジュール SAP Emulated Tree を使用し、次のテストステップ値を入力します。

  • ModuleAttributeの Tree の場合、ノードを -> を使用してエントリへのパスを入力します。

  • ModuleAttribute 列には、トラフィックライトが最初の列にあるため、 #1 と入力します。

  • ModuleAttributeのアクションには、トラフィックライトの値が赤かどうかを確認するため、 Red と入力します。ActionModeを確認するに指定します。

  • デフォルトの ScanAlgorithm ModuleAttribute は変更しません。

TestCaseのSAP Emulated Tree モジュール

SAPエミュレートテーブルツリー

モジュール SAP Emulated Table Tree を使用すると、SAPエミュレート テーブル ツリーを操縦できます。

次のModuleAttributeがあります。

ModuleAttribute

説明

ヘッダー テーブル

chapter "テーブル" で説明されているようにメイン テーブルを操縦します。

Content Table

chapter "テーブル" で説明されているように埋め込みテーブルを操縦します。

エミュレートされたテーブル ツリーに埋め込まれたコントロール（トラフィック機など）を操縦する場合は、Moduleの レベルでそれらを作成できます。<Cell>詳細情報は を参照してください。see chapter "セル内のコントロールの定義"

ScanAlgorithm

SAP Engine 3.0 がEmulated Table Treeのナビゲートに使用するアルゴリズムです。

使用可能なアルゴリズム:

  • FastVerticalNoHorizontal - Emulated Treeを上下にスクロールできるが、左右にスクロールできません。このアルゴリズムは、最上行が凍結されているEmulated Treeの制御には適さない。

  • FastVerticalFastHorizontalWithStaticArea - このモジュールにデフォルトのアルゴリズム。Emulated Treeを上下および左右にスクロールできる。このアルゴリズムは静的領域を考慮するため、たとえば、固定された最上位行を含むエミュレートされたテーブル ツリーを操縦する場合に適しています。

  • DetailedIdentification - エミュレートされたツリーを縦方向と横方向の両方にスクロールします。このアルゴリズムは、テーブルのセルをより正確に識別するため、エッジケースに適しています。静的領域を持つEmulated Treeの制御にも使用できる。

こ の例では、以下のスクリーンショットでマークされたセルの値が 591,48 であるかどうかを確認します。

SAPのEmulated Table Tree

これを行うには、モジュール SAP Emulated Table Tree を使用し、次のTestStepValueを入力します。

  • メインテーブルを制御するために、列番号 $1 を入力します。これで、メインテーブルの最初の行が選択される。

  • Content Table の下で、行番号 $4 を入力して、埋め込まれたテーブルの最初の行を選択します。

  • <Cell> には、検証するセルがこの列に含まれているため、列名 Val/COArea Crcy を入力します。セル番号も使用可能で、この場合は $15 です（列と列の間の空白セルとスペースも数にカウントされます）。

  • このセルの値フィールドに 2.957,40 と入力し、この値が含まれているかどうかを確認します。

  • ScanAlgorithm　ModuleAttribute では、このEmulated Table Treeの最初の行が固定されているため、既定値 FastVerticalFastHorizontalWithStaticArea のままにします。

TestCase内のSAP Emulated Table Tree モジュール

この例では、エミュレートされたテーブルツリーの次の値を検証します：

SAPのエミュレートされたテーブルツリー

SAP Emulated Table Tree モジュールを使用し、次のテストステップ値を入力します。

  • で、操作する行の最初のセルの値を入力します。<Cell>ActionModeを Constraint に指定します。SAP Engine 3.0 が、指定した値のセルが含まれている行を検索し、この行のテスト自動化を制限します。

  • 別のセルの名前をその列のDoc.Dateで指定します。31.03.2020 の値を入力し、この値が含まれているか否かを検証します。

  • コンテンツテーブルの下で、行番号 $1 を入力します。これは、組み込まれているテーブルの最初の行のセルの内容を検証するためです。

  • <Cell> で、列名 Val/COArea Crcy を入力します。これは、検証するセルが含まれているためです。セル番号も使用可能で、この場合は $15 とします（列と列の間の空白のセルとスペースも数にかぞえるためです）。

  • このセルの値フィールドに、 2.957,40 と入力し、この値が含まれているか否かを検証します。

  • ModuleAttributeの ScanAlgorithm で、既定値 FastVerticalFastHorizontalWithStaticArea をそのままにします。これは、このエミュレートされたテーブル ツリーには固定された最上位の行が含まれているためです。

テストケースのSAP Emulated Table Tree モジュール