Basic Windows Operations

Der Ordner TBox Automation Tools->Basic Windows Operations in der Standard-Untermenge enthält die folgenden Module:

TBox Take Screenshot

Dieses Modul erstellt einen Screenshot des aktuell aktiven Bildschirms. Nachdem Sie Ihre Tests durchgeführt haben, können Sie den Screenshot in der Spalte Detail des Ausführungseintrags einsehen.

Das Modul TBox Take Screenshot besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Environment

Legt fest, ob Sie einen Screenshot von Ihrem Desktop, mobilen Gerät oder Browser aufnehmen möchten.

Wenn Sie den Wert leer lassen, erstellt Tosca einen Screenshot des Desktops.

Storage Location Type

Geben Sie optional an, ob Sie Ihren Screenshot im Tricentis File Service, in einem lokalen Directory oder in beiden speichern möchten.

Wenn Sie unter Storage Location Type keinen Speicherorttyp angeben, verwendet Tosca den in der Einstellung Screenshot directory definierten Speicherpfad.

Directory

Optional können Sie einen lokalen Pfad zum Speichern des Screenshots angeben.

Wenn Sie unter Storage Location Type keinen Speicherorttyp oder kein Directory angeben, verwendet Tosca den in der Einstellung Screenshot directory definierten Speicherpfad.

Filename

Dateiname des Screenshots.

Dieser Name umfasst nicht die Dateiendung. Sie können das Dateiformat in der Einstellung Screenshot image format festlegen.

Select Screen

Geben Sie optional an, welchen Bildschirm oder welche Applikation Sie aufnehmen möchten. Sie können aus den folgenden Optionen wählen:

  • Active Monitor: Nimmt den Bildschirm auf, auf dem sich derzeit eine aktive Applikation befindet.

  • Active Window: Nimmt das aktuell aktive Applikationsfenster auf.

  • Everything: Nimmt alle aktuell verbundenen Bildschirme auf.

  • Eine ganze Zahl <n>: Nimmt einen bestimmten Bildschirm auf, der durch seinen Index identifiziert wird. Um beispielsweise den zweiten Bildschirm zu erfassen, der mit Ihrem Rechner verbunden ist, geben Sie 2 ein.

Wenn Sie keinen Wert angeben, nimmt Tricentis Tosca einen Screenshot aller verbundenen Bildschirme auf.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Nehmen Sie einen Screenshot von Ihrem Desktop, spezifisch von Bildschirm Nummer zwei, auf.

  • Speichern Sie diesen im lokalen Verzeichnis C:\MyScreenshots.

  • Benennen Sie den Screenshot monitor_two.

Einen Screenshot vom Desktop mit dem Modul TBox Take Screenshot machen

TBox Clipboard

Mit diesem Modul können Sie einen Text in die Zwischenablage von Microsoft Windows kopieren. Sie können es auch verwenden, um den Text zu überprüfen, der sich in Ihrer Zwischenablage befindet, diesen Text in einem Buffer zu speichern oder zu warten, bis sich ein bestimmter Text in der Zwischenablage befindet.

Es hat das folgende Modulattribut:

Modulattribut

Beschreibung

Value

Wert, den Sie in die Zwischenablage kopieren, überprüfen, in den Buffer schreiben oder auf den Sie warten möchten.

Je nach gewünschter Aktion verwenden Sie jeweils die Aktion Input, Verify, Buffer oder WaitOn.

Dieses Beispiel zeigt, wie Sie mit TBox Clipboard arbeiten.

  • Der erste Testschritt kopiert den Wert Sample text in die Zwischenablage.

  • Der zweite Testschritt prüft, ob der Wert in der Zwischenablage Sample text ist.

TBox Clipboard

TBox Dialog

Das Modul TBox Dialog steuert Dialogfenster.

  • Microsoft Windows®-Dialoge: Sie können sie steuern, ohne sie aufzuzeichnen.

  • Kundenspezifische Dialoge: Sie müssen sie zuerst aufzeichnen.

Das Modul TBox Dialog hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Caption

Titel des Dialogfensters, das Sie steuern möchten. Dieser Titel identifiziert das Dialogfenster.

Label

Sie können den Text des ersten Absatzes des Dialogfensters zur weiteren Identifizierung eingeben. Es ist nicht notwendig, den gesamten Text einzugeben.

Dieses Modulattribut ist optional.

Button

Geben Sie an, auf welche Schaltfläche Tosca klicken soll, um den Dialog zu bestätigen. Geben Sie den Text der Schaltfläche ein.

Dieses Beispiel zeigt, wie Sie den Folgedialog steuern:

Dialog, den Sie steuern möchten

Der Testschritt führt die folgenden Aktionen durch:

  • Identifiziert den Dialog Example: TBox Dialog

  • Verwendet den Text aus dem Dialogfenster zur weiteren Identifizierung

  • Klickt auf die Schaltfläche OK

Beispiel TBox Dialog

TBox Context Menu

Das Modul TBox Context Menu ermöglicht es Ihnen, Kontextmenüs von Applikationen zu steuern, die auf .NET und WinForms (DotNet Engine 3.0) und dem Microsoft UI Automation Framework (UIA Engine 3.0) basieren.

Um das Modul TBox Context Menu zu verwenden, muss das Kontextmenü, das Sie steuern möchten, geöffnet sein, damit Tricentis Tosca es erkennen kann.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Menu

Pfad zum Menüpunkt.

Geben Sie den Kontextmenüpfad mit -> an, z. B. Insert->Image.

Menu-><MenuItem>

Alternativ können Sie dieses Modulattribut verwenden, um stattdessen ein Kontextmenü mit Control-Hierarchie zu steuern (siehe Beispiel unten).

Im folgenden Beispiel führen Sie die folgenden Aktionen aus:

  • Der Testschritt Open context menu klickt mit der rechten Maustaste auf den Bereich des Controls My folders, um das Kontextmenü zu öffnen.

  • Der Testschritt TBox Context Menu wählt aus dem zuvor geöffneten Kontextmenü den Eintrag New -> Folder aus.

Beispiel für die Steuerung eines Kontextmenüs

In diesem Beispiel wählen Sie den Eintrag Insert->New Image eines aktuell geöffneten Kontextmenüs aus.

Dies geschieht auf zwei verschiedene Arten:

  • Im Testschritt TBox Context Menu - Control Hierarchy steuern Sie das Kontextmenü über die Control-Hierarchie, um den Eintrag New Image auszuwählen.

  • Im Testschritt TBox Context Menu - Inline Syntax steuern Sie das Kontextmenü über die Inline-Syntax, um den Eintrag New Image auszuwählen.

Verschiedene Möglichkeiten, ein WinForms-Kontextmenü zu steuern

TBox Send Keys

Mit diesem Modul können Tastaturbefehle an ein beliebiges Fenster gesendet werden. Wie der Tastaturbefehl SendKeys verwendet auch das Modul TBox Send Keys die WinForms-Funktion SendKeys.

Das Modul TBox Send Keys besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Caption

Geben Sie optional den Titel ein, der dem Fenster zugewiesen ist, das Sie steuern möchten. Tosca bringt das Fenster in den Vordergrund.

Sie können entweder einen führenden oder einen nachfolgenden Platzhalter hinzufügen, d. h. einen Platzhalter am Anfang oder am Ende einer Zeichenfolge.

Keys

Tastaturbefehl, den Sie an das Fenster senden möchten.

Standardmäßig ist der Datentyp RawString. Tosca sendet RawString-Daten genau so, wie sie in das zu testende System eingegeben wurden. Es besteht keine Notwendigkeit, Sonderzeichen zu maskieren.

Tosca verwendet die WinForms-Funktion SendKeys. Eine Liste der verfügbaren SendKeys-Befehle und deren Syntax finden Sie auf Englisch in der Microsoft SendKeys-Dokumentation: http://msdn.microsoft.com/en-us/library/system.windows.forms.sendkeys.aspx.

Wenn Sie auf Ihrem Rechner die Feststelltaste aktiviert haben, sendet Tosca die Tasten invertiert. Wenn Sie beispielsweise Abc senden möchten und die Feststelltaste aktiviert ist, sendet Tricentis Tosca aBC.

Standardmäßig ist F6 die Taste zum Abbrechen von Testläufen. Wenn Sie also F6 als Teil eines Testfalls an Ihre Anwendung senden möchten, müssen Sie zunächst die Standard-Abbrechen-Taste in den Tosca Einstellungen ändern. Andernfalls bricht Tosca den Testlauf ab, sobald es zu dem Testschritt kommt, der F6 sendet.

Um dynamische Ausdrücke in Ihren Tastaturbefehlen zu verwenden, wählen Sie den Datentyp String aus.

In diesem Beispiel senden Sie einen Wert und mehrere Tastaturbefehle an die Datei Example_Send_Key.txt.

Verwenden Sie den Datentyp RawString für Keys-Modulattribute.

Tastenkombination

Testschrittwert

Beschreibung

Text

This is an example text.

Text eingeben.

Strg + A

^(a)

Sendet den Befehl Alles markieren an das Fenster.

Entf

{DEL}

Sendet den Befehl Entfernen an das Fenster.

Strg + S

^(s)

Sendet den Befehl Speichern an das Fenster.

Alt + F4

%{F4}

Sendet den Befehl Fenster schließen an das Fenster.

TBox Send Keys – Beispiel

TBox Window Operation

Das Modul TBox Window Operation sendet bestimmte Befehle an ein Fenster.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Caption

Titel des Fensters, das Sie steuern möchten. Dieser Titel identifiziert das Fenster.

Child Window Caption

Titel des untergeordneten Fensters, das Sie steuern möchten. Dieser Titel identifiziert das untergeordnete Fenster.

Operation

Befehl zur Steuerung des Controls. Sie können aus den in der folgenden Tabelle beschriebenen Operationen wählen.

Operation->Height

Gewünschte Höhe des Fensters in Pixel.

Dieses Modulattribut ist obligatorisch, wenn Sie die Operation Resize ausgewählt haben.

Operation->Width

Gewünschte Breite des Fensters in Pixel.

Dieses Modulattribut ist obligatorisch, wenn Sie die Operation Resize ausgewählt haben.

Window Index

Geben Sie das Fenster an, auf das Tosca die angegebene Operation anwenden soll.

Dieses Modulattribut ist optional, aber nützlich, wenn die von Ihnen angegebene Caption für mehr als ein Fenster gilt. Zum Beispiel, wenn Sie einen Platzhalter verwenden.

Operationen

Tosca unterstützt die folgenden Operationen:

Operation

Beschreibung

Bring To Front

Weist Tosca an, das Fenster nach vorne zu holen.

Abhängig von der Komplexität der Fenster-Benutzeroberfläche und der Leistung Ihres Rechners kann es länger dauern, ein Fenster nach vorne zu holen. Tricentis empfiehlt, nach dieser Operation einen Testschritt hinzuzufügen, damit Tosca mit der Ausführung des nächsten Testschritts wartet, bis ein Control im Fenster sichtbar ist, wie im Beispiel gezeigt.

Close

Schließt das Fenster.

Maximize

Maximiert das Fenster.

Minimize

Minimiert das Fenster.

Move to Center

Verschiebt das Fenster in die Mitte des Bildschirms.

Normal

Setzt das Fenster auf seine ursprüngliche Größe zurück.

Resize

Ändert die Größe des Fensters auf die Höhe und Breite, die Sie jeweils in den Modulattributen Height und Width angegeben haben.

Try Bring To Front

Bringt das Fenster in den Vordergrund, aber wenn dies nicht gelingt, wird mit Ihrem nächsten Testschritt fortgefahren. Ihre Automatisierung wird fortgesetzt und Tosca zeigt den Testschritt Try Bring To Front als fehlgeschlagen an.

Verify Window Exists

Überprüft, ob das angegebene Fenster geöffnet ist.

Verify Window Does Not Exist

Überprüft, ob das angegebene Fenster geschlossen ist.

Wait On Close

Diese Operation erfordert die Aktion WaitOn.

Sie hat zwei verschiedene Verhaltensweisen:

  • Wenn Sie die Operation selbst verwenden, wartet Tosca für die Zeit, die Sie in der Einstellung Synchronization Timeout during WaitOn definiert haben oder bis das Fenster geschlossen wird – je nachdem, was zuerst eintritt.

  • Wenn Sie die Operation mit dem Modulattribut Window Index kombinieren, wartet Tosca, bis die Anzahl der geöffneten Fenster mit dem angegebenen Titel niedriger ist als der Wert von Window Index.

Wait On Open

Diese Operation erfordert die Aktion WaitOn.

Sie hat zwei verschiedene Verhaltensweisen:

  • Wenn Sie nur diese Operation verwenden, wartet Tricentis Tosca für die Zeit, die Sie in der Einstellung Synchronization Timeout during WaitOn definiert haben, bis das Fenster geöffnet ist.

  • Wenn Sie die Operation mit dem Modulattribut Window Index kombinieren, wartet Tosca, bis die Anzahl der geöffneten Fenster mit dem angegebenen Titel gleich oder höher ist als der Wert von Window Index.

In diesem Beispiel haben Sie mehr als ein Fenster geöffnet. Der Titel aller geöffneten Fenster beginnt mit Test file.

Sie möchten das zweite Fenster schließen.

Ein bestimmtes Fenster schließen

In diesem Beispiel haben Sie ein übergeordnetes Fenster und sein untergeordnetes Fenster geöffnet und maximieren nur das untergeordnete Fenster.

Untergeordnetes Fenster maximieren

In diesem Beispiel fügen Sie nach der Operation Bring to Front einen neuen Testschritt hinzu. Dieser Testschritt stellt sicher, dass Tosca mit der Ausführung des nächsten Testschritts wartet, bis die Controls im Fenster sichtbar sind, d. h. das Fenster in den Vordergrund gebracht wird.

  • Sie erstellen einen Testschritt nach der Operation Bring to Front mit demselben Modul, das Sie für den nächsten Testschritt, in diesem Beispiel Automobile, verwendet haben.

  • Sie setzen die Aktion des Testschrittwertes auf WaitOn und geben den Wert Visible == True an.

Warten Sie, bis das Fenster sichtbar ist

TBox Scroll Window Operation

Mit dem Modul TBox Scroll Window Operation können Sie das Scroll-Verhalten definieren.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Caption

Titel des Applikationsfensters, das Tosca scrollen soll. Dieser Titel identifiziert das Applikationsfenster.

Window Index

Gibt das Fenster (basierend auf der Öffnungsreihenfolge) an, das Tosca scrollen soll.

Dieses Modulattribut ist optional, aber nützlich, wenn die von Ihnen angegebene Caption für mehr als ein Fenster gilt. Zum Beispiel, wenn Sie einen Platzhalter verwenden.

Vertical

Gibt in Pixeln (px) oder Zeilen (lines) an, wie weit Tosca entlang der vertikalen Achse scrollen soll. Wenn Sie eine Zahl ohne Maßeinheit angeben, scrollt die Seite nach der Anzahl der Mausradschritte.

Horizontal

Gibt in Pixeln (px) oder Zeilen (lines) an, wie weit Tosca entlang der horizontalen Achse scrollen soll. Wenn Sie eine Zahl ohne Maßeinheit angeben, scrollt die Seite nach der Anzahl der Mausradschritte.

Beachten Sie, dass dieses Modulattribut nur funktioniert, wenn horizontales Scrollen vom Applikationsfenster unterstützt wird.

MousePolicy

Gibt an, wo Tosca den Mauszeiger beim Scrollen positionieren soll.

Geben Sie einen der folgenden Werte an: Center (Standardeinstellung), None.

DirectionPolicy

Gibt an, ob Tosca zuerst entlang der vertikalen oder horizontalen Achse scrollen soll.

Geben Sie einen der folgenden Werte an: NoDirectionPolicy (Standardeinstellung), HorizontalFirst, VerticalFirst.

Delay

Gibt die Zeit in Millisekunden (ms) an, die Tosca zwischen dem Scrollen entlang der vertikalen und horizontalen Achse warten soll.

In diesem Beispiel führt Tosca die folgenden Aktionen durch:

  • Identifiziert alle geöffneten Applikationsfenster, die mit dem Titel - Notepad enden.

  • Scrollt durch das dritte Applikationsfenster, das mit dem Titel - Notepad endet.

  • Scrollt 500px entlang der vertikalen Achse.

  • Scrollt 1000px entlang der horizontalen Achse.

  • Der Mauszeiger befindet sich in der Mitte.

  • Scrollt zuerst entlang der horizontalen Achse.

  • Wartet 300ms, bis entlang der vertikalen Achse gescrollt wird.

Beispiel für TBox Scroll Window Operation

TBox Save As

Das Modul TBox Save As steuert das Dialogfenster Speichern unter. Um es zu steuern, muss der Dialog Speichern unter geöffnet sein.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Caption

Titel des Dialogs Speichern unter, den Sie steuern möchten. Tricentis Tosca identifiziert den Dialog aus dem Titel im oberen Bereich des Bildschirms (WindowText). Sie können eine beliebige Zeichenfolge eingeben.

Dieses Modulattribut ist obligatorisch.

FileNameLabel

Label des Eingabefeldes, in dem Sie den Pfad im Dialog Speichern unter eingeben.

Sie müssen das Label nur angeben, wenn das Eingabefeld NICHT Dateiname ist. Wenn das Label Dateiname ist, steuert Tosca es automatisch.

Sie können eine beliebige Zeichenfolge eingeben.

FilePath

Pfad, in dem Tosca die Datei speichert.

Dieses Modulattribut ist obligatorisch.

Button

Geben Sie an, auf welche Schaltfläche Tosca klicken soll.

Tosca steuert Speichern oder Abbrechen automatisch. Sie müssen die Schaltfläche nur dann angeben, wenn die Schaltfläche NICHT Speichern oder Abbrechen ist.

Dieses Modulattribut ist optional.

ConfirmationPopupCaption

Titel des modalen Dialogfensters. Dadurch können Sie modale Dialogfenster steuern, z. B. einen Bestätigungsdialog oder einen Überschreibungsdialog, wenn die Datei bereits existiert.

Sie können den modalen Dialog nur bestätigen.

Geben Sie eine beliebige Zeichenfolge ein, um den Titel des modalen Dialogs anzugeben.

Dieses Modulattribut ist optional.

ConfirmationPopupButton

Legt die Bestätigungsschaltfläche in dem im Modulattribut ConfirmationPopup angegebenen Dialog fest. Sie können eine beliebige Zeichenfolge eingeben.

Tosca steuert Ja, Yes oder OK automatisch. Sie müssen die Schaltfläche nur angeben, wenn die Schaltfläche NICHT Ja, Yes oder OK ist.

 

Dieses Beispiel zeigt, wie Sie einen Speichern unter-Dialog steuern. Der Tosca Commander führt die folgenden Aktionen durch:

  • Identifiziert den Dialog Speichern unter

  • Speichert die Datei test.txt im Pfad C:\Temp

  • Wenn die Datei bereits existiert, bestätigt der Tosca Commander das Überschreiben im Dialog Speichern unter bestätigen.

Beispiel TBox Save As