Excel-Module

Der Ordner TBox XEngines->Excel in der Standard-Untermenge enthält Module, die bestimmte Aufgaben für die Excel Engine 3.0 ausführen.

TBox Open Excel Workbook

Das Modul TBox Open Excel Workbook ermöglicht es Ihnen, eine Excel-Datei zu öffnen, d. h. eine Excel-Arbeitsmappe. Jede Arbeitsmappe kann mehrere Arbeitsblätter enthalten.

Dieser Schritt ist für jeden Excel Engine 3.0-Testfall obligatorisch.

Die Excel Engine 3.0 öffnet die Datei im Hintergrund. Sie sehen nicht tatsächlich, wie die Datei in Excel geöffnet wird.

Das Modul TBox Open Excel Workbook besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Geben Sie einen Namen für die Arbeitsmappe an.

Dies kann ein beliebiger Name sein. Die Excel Engine 3.0 verwendet ihn, um die Datei zu identifizieren, die Sie in anderen Testschritten der Excel Engine 3.0 steuern möchten.

Path

Vollständiger Pfad zur Excel-Datei, die Sie öffnen möchten, einschließlich Dateiname und -endung.

Create new

Geben Sie an, ob Sie eine neue Excel-Datei erstellen möchten. Sie können die folgenden Werte verwenden:

  • False: keine neue Datei erstellen. Dies ist der Standardwert.

  • True: neue Datei erstellen und öffnen. Die Excel Engine 3.0 erstellt die Datei im Speicher. Sie können die Datei später mit dem Modul TBox Close Excel Workbook speichern.

Password

Optionales Passwort für passwortgeschützte Arbeitsmappen.

Open as Read-only

Geben Sie an, ob Sie die Datei im schreibgeschützten Modus öffnen möchten.

  • Wert False: nicht schreibgeschützt öffnen. Dies ist der Standardwert.

  • Wert True: schreibgeschützt öffnen.

In diesem Beispiel öffnen Sie die Excel-Datei sales_data.xlsx, die sich unter C:\Temp befindet.

Sie vergeben den Namen MyWorkbook an die Arbeitsmappe, die Sie steuern möchten.

Da die Datei passwortgeschützt ist, geben Sie das Passwort ein und öffnen die Datei im schreibgeschützten Modus.

Excel-Datei öffnen

In diesem Beispiel erstellen Sie die neue Excel-Datei marketing.xlsx. Die Excel Engine 3.0 speichert sie unter C:\Users\janedoe\Desktop.

Sie weisen der Arbeitsmappe, die Sie steuern möchten, den Namen CustomerData zu.

Neue Excel-Datei erstellen und öffnen

TBox Define Excel Range

Das Modul TBox Define Excel Range ermöglicht es Ihnen, einen Datenbereich zu definieren, den Sie steuern möchten. Dieser Schritt ist für jeden Testfall obligatorisch, in dem Sie einen bestimmten Datenbereich bearbeiten möchten.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Name der Arbeitsmappe, die Sie definiert haben.

Worksheet Name

Name des Excel-Arbeitsblattes, das die Daten enthält. Dieser Name muss genau mit dem Arbeitsblatt in der Arbeitsmappe übereinstimmen.

Range Name

Geben Sie einen Namen für den Datenbereich an, den Sie steuern möchten.

Dies kann ein beliebiger Name sein. Die Excel Engine 3.0 verwendet diesen, um den Datenbereich zu identifizieren, den Sie in anderen Testschritten der Excel Engine 3.0 steuern möchten.

Data Range

Schreibgeschützt.

Beachten Sie, dass der angegebene Bereich beeinflusst, wie die Excel Engine 3.0 die Werte für die Eigenschaften ColumnCount, RowCount, ColumnNumber, RowNumber und ResultCount berechnet.

Data Range->Start Cell

Startzelle des Datenbereichs, den Sie steuern möchten.

Data Range->End Cell

Endzelle des Datenbereichs, den Sie steuern möchten.

In diesem Beispiel definieren Sie einen Datenbereich in der Arbeitsmappe MyWorkbook. Dieser Datenbereich befindet sich in der Excel-Tabelle January.

Sie weisen dem Datenbereich den Namen JanuarySales zu.

Der Bereich beginnt mit Zelle A2 und endet mit Zelle T982.

Den zu steuernden Bereich definieren

TBox Create Excel Worksheet

Das Modul TBox Create Excel Worksheet ermöglicht es Ihnen, ein neues Arbeitsblatt in einer bestehenden Excel-Datei zu erstellen.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Name der Arbeitsmappe, die Sie definiert haben.

Worksheet Name

Geben Sie einen Namen für das Arbeitsblatt an.

Worksheet Order

Legen Sie fest, wo die Excel Engine 3.0 das Arbeitsblatt hinzufügen soll. Sie können die folgenden Werte eingeben:

  • Zahlen zur Angabe der Position. Geben Sie beispielsweise 3 ein, um das Arbeitsblatt als drittes Blatt in der Excel-Datei zu erstellen.

  • Der Wert first, 0 oder eine negative Zahl, um das Arbeitsblatt als erstes Blatt in der Excel-Datei zu erstellen.

  • Der Wert last oder eine Zahl größer als die Gesamtanzahl der vorhandenen Arbeitsblätter, um das Arbeitsblatt als letztes Blatt in der Excel-Datei zu erstellen.

In diesem Beispiel erstellen Sie ein neues Arbeitsblatt namens JAN_summary in der Arbeitsmappe MyWorkbook.

Die Excel Engine 3.0 erstellt das Arbeitsblatt als zweites Blatt in der Excel-Datei.

Neues Arbeitsblatt erstellen

TBox Delete Excel Worksheet

Mit dem Modul TBox Delete Excel Worksheet können Sie ein Arbeitsblatt in einer vorhandenen Excel-Datei löschen.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Name der Arbeitsmappe, die Sie definiert haben.

Worksheet Name

Geben Sie den Namen des Arbeitsblatts an, das Sie löschen möchten.

In diesem Beispiel löschen Sie ein Arbeitsblatt namens JAN_summary in der Arbeitsmappe MyWorkbook.

Arbeitsblatt löschen

TBox Update Excel Worksheet

Mit dem Modul TBox Update Excel Worksheet können Sie ein Arbeitsblatt in einer vorhandenen Excel-Datei aktualisieren.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Name der Arbeitsmappe, die Sie definiert haben.

Current Worksheet Name

Name des Arbeitsblatts, das Sie aktualisieren möchten.

New Worksheet Name

Der neue Name, den Sie dem Arbeitsblatt geben möchten.

New Order

Definieren Sie, wohin die Excel Engine 3.0 das Arbeitsblatt verschieben soll. Sie können die folgenden Werte eingeben:

  • Zahlen zur Angabe der Position. Geben Sie beispielsweise 3 ein, um das Arbeitsblatt als drittes Blatt in der Excel-Datei zu erstellen.

  • Der Wert first, 0 oder eine negative Zahl, um das Arbeitsblatt als erstes Blatt in der Excel-Datei zu erstellen.

  • Der Wert last, eine Zahl größer als die Gesamtanzahl der vorhandenen Arbeitsblätter oder ein leerer Wert, um das Arbeitsblatt als das letzte Blatt in der Excel-Datei zu erstellen.

In diesem Beispiel führen Sie die folgenden Aktionen für ein Arbeitsblatt namens JAN_summary in der Arbeitsmappe MyWorkbook aus:

  • Sie benennen das Arbeitsblatt in FEB_summary um.

  • Sie verschieben das Arbeitsblatt, damit es das zweite Blatt in der Excel-Datei ist.

Arbeitsblatt aktualisieren

TBox Excel Range Manipulation

Das Modul TBox Excel Range Manipulation ermöglicht es Ihnen, Daten in einer Excel-Datei zu bearbeiten.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Range Name

Name des von Ihnen definierten Datenbereichs.

Data Table und seine untergeordneten Attribute

Tabellenelement.

Steuern Sie die Daten in Ihrer Excel-Datei so, wie Sie eine Tabelle steuern würden. Weitere Informationen hierzu finden Sie hier: siehe Kapitel "Tabelle".

In diesem Beispiel steuern Sie den Datenbereich ExampleRange.

Die Excel Engine 3.0 sucht nach einer Zeile, welche die folgenden Anforderungen erfüllt:

  • Der Wert der Zelle in der Spalte First name ist Sylvia.

  • Der Wert der Zelle in der Spalte Last name ist Jones.

Dann führt die Engine eine Verifikation durch. In dieser Zeile sollte der Wert der Zelle in der Spalte Salary größer als 3000 sein.

Excel-Daten steuern

Besondere technische Eigenschaften von Excel-Zellen

Excel-Tabellenzellen haben einige spezielle technische Eigenschaften, die Sie verwenden können, um gewisse Funktionen in Microsoft Excel zu automatisieren:

  • BackgroundColor: Setzt oder überprüft die Hintergrundfarbe im Format R=<x>,G=<y>,B=<z>, z. B. R=255,G=0,B=0 für einen leuchtend roten Hintergrund.

  • Comment: Verwenden Sie diese Eigenschaft, um den Excel-Kommentar, der einer bestimmten Zelle zugeordnet ist, hinzuzufügen, zu aktualisieren, zu überprüfen oder andere Operationen damit durchzuführen.

  • Font: Setzt oder überprüft den Namen der für die Zelle verwendeten Schriftart, z. B. Arial Black.

  • FontColor: Setzt oder überprüft die Schriftfarbe im Format R=<x>,G=<y>,B=<z>, z. B. R=255,G=0,B=0 für leuchtend rote Schrift.

  • FontSize: Setzt oder überprüft die Zahl, die die Schriftgröße angibt.

    Beachten Sie, dass Excel Zahlen auf den nächsten ,5-Wert rundet, z. B. wird eine Eingabe von 11,3 auf 11,5 gerundet.

  • FontStyle: Setzt oder überprüft, ob der Text in der Zelle fett und/oder kursiv ist, z. B. zeigt Bold Italic an, dass er beides ist.

  • FormattedText: Überprüfen oder führen Sie schreibgeschützte Operationen am Textinhalt einer Zelle durch.

  • Formula: Setzt oder überprüft die Formel für die Zelle, z. B. =SUM(A1:A2) für die Summe der Werte in den Zellen A1 und A2.

  • HasFormula: Überprüft, ob die Zelle eine Formel enthält, z. B. True für eine Zelle mit einer Formel.

  • IsHidden: Setzt oder überprüft, ob die Zelle ausgeblendet ist, z. B. True für eine ausgeblendete Zelle.

  • IsLocked: Setzt oder überprüft, ob die Zelle gesperrt ist, z. B. False, wenn die Zelle nicht gesperrt ist.

  • Note: Verwenden Sie diese Eigenschaft, um die Excel-Notiz, die einer bestimmten Zelle zugeordnet ist, hinzuzufügen, zu aktualisieren, zu überprüfen oder andere Operationen damit durchzuführen.

  • NumberFormat: Verwenden Sie diese Eigenschaft, um die Formatierungszeichenfolge für eine bestimmte Zelle festzulegen, zu überprüfen oder andere Operationen damit durchzuführen. Weitere Informationen finden Sie in der Microsoft-Dokumentation.

    Ein Teil der Formatierungssyntax ist sprachspezifisch in Bezug auf die Spracheinstellungen in Microsoft Excel.

    Beispiel: NumberFormat==0.0% in einer englischen Version von Microsoft Excel entspricht NumberFormat==0,0% in einer deutschen Version von Microsoft Excel.

  • Underline: Setzt oder überprüft die Unterstreichung für den Text in der Zelle, z. B. Double für doppelt unterstrichenen Text.

In diesem Beispiel steuern Sie technische Eigenschaften des Datenbereichs BeispielBereich.

Sie führen die folgenden Aktionen aus:

  • Sie überprüfen, ob Zelle #2 eine Formel enthält.

  • Sie fügen der Zelle #3 die Formel SUM(A15:B15) hinzu.

  • In Zelle #7 setzen Sie die Hintergrundfarbe auf R=123, G=0, B=50.

  • In Zelle #9 überprüfen Sie, ob der Name der Schriftart Arial Black ist.

  • In Zelle #9 setzen Sie die Schriftgröße auf 22,5.

  • Sie überprüfen, dass Zelle #10 nicht gesperrt ist.

  • Sie setzen das Zahlenformat in Zelle #11 auf 0,00;[Rot]0,00.

  • In Zelle #5 setzen Sie den Schriftschnitt auf Regular.

  • In Zelle #6 setzen Sie die Schriftfarbe auf R=100, G=50, B=102.

  • In Zelle #7 überprüfen Sie, ob der Text Single Accounting unterstrichen ist.

  • Sie überprüfen, ob Spalte #16 ausgeblendet ist.

Technische Eigenschaften von Zellen in Excel verwenden

TBox Clear Excel Range

Mit dem Modul TBox Clear Excel Range können Sie Daten und Formatierungen aus einem Zellbereich in einer Excel-Datei löschen.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Range Name

Name des Bereichs, den Sie definiert haben.

Contents

Geben Sie an, ob Sie den Inhalt des angegebenen Bereichs löschen möchten. Sie können die folgenden Werte verwenden:

  • False: Zelleninhalt nicht löschen.

  • True: Zelleninhalt löschen. Dies ist der Standardwert.

Formats

Geben Sie an, ob Sie die Formatierung des angegebenen Bereichs löschen möchten. Sie können die folgenden Werte verwenden:

  • False: Zellenformatierung nicht löschen. Dies ist der Standardwert.

  • True: Zellenformatierung löschen.

Notes and Comments

Geben Sie an, ob Sie Notizen und Kommentare aus dem angegebenen Bereich löschen möchten. Sie können die folgenden Werte verwenden:

  • False: Notizen und Kommentare nicht löschen. Dies ist der Standardwert.

  • True: Notizen und Kommentare löschen.

Hyperlinks

Geben Sie an, ob Hyperlinks aus dem angegebenen Bereich gelöscht werden sollen. Sie können die folgenden Werte verwenden:

  • False: Hyperlinks nicht löschen. Dies ist der Standardwert.

  • True: Hyperlinks löschen.

Outlines

Geben Sie an, ob Gliederungen aus dem angegebenen Bereich gelöscht werden sollen. Sie können die folgenden Werte verwenden:

  • False: Gliederungen nicht löschen. Dies ist der Standardwert.

  • True: Gliederungen löschen.

In diesem Beispiel löschen Sie Daten und Formatierungen aus einem Zellbereich namens MyRange.

Einen Zellbereich löschen

TBox Run Excel Macro

Das Modul TBox Run Excel Macro ermöglicht es Ihnen, bestehende Microsoft Excel-Makros in einer Excel-Datei auszuführen. Informationen zu Microsoft Excel-Makros finden Sie in der Microsoft Excel-Dokumentation.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Name der Arbeitsmappe, die Sie definiert haben.

Macro Name

Name des Microsoft Excel-Makros, das Sie ausführen möchten.

Timeout

Maximale Dauer (in Millisekunden), für die das Makro ausgeführt werden darf. Wenn dieser Schwellenwert erreicht ist, wird das laufende Makro beendet und der Testschritt schlägt fehl.

In diesem Beispiel führen Sie ein Makro mit dem Namen HighlightOverdueAccounts auf die Arbeitsmappe Accounts aus. Sie setzen die maximale Dauer für das Makro auf 10000 Millisekunden.

Makro auf die Arbeitsmappe Accounts ausführen

TBox Close Excel Workbook

Das Modul TBox Close Excel Workbook ermöglicht es Ihnen, eine geöffnete Arbeitsmappe zu schließen. Dieser Schritt ist für jeden Excel Engine 3.0-Testfall obligatorisch.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Workbook Name

Name der Arbeitsmappe, die Sie definiert haben.

Path

Vollständiger Pfad zur Excel-Datei, die Sie schließen möchten, einschließlich Dateiname und -endung.

Save

Geben Sie an, ob Sie die Excel-Datei speichern möchten.

  • Wert False: Datei nicht speichern. Dies ist der Standardwert.

  • Wert True: Datei speichern.

Save Path

Absoluter Pfad zum Speicherort der Datei, einschließlich Dateiname und -endung. Wenn Sie keinen Pfad angeben, überschreibt Tricentis Tosca die vorhandene Datei.

Save As Type

Dateiformat, in dem Sie die Datei speichern möchten.

Dieses Modulattribut funktioniert nur zusammen mit Save Path. Wenn Save Path leer ist, ignoriert Tricentis Tosca jeden Wert, den Sie für Save as Type ausgewählt haben.

Wenn Sie einen Speicherort mit Save Path angeben, aber Save As Type leer lassen, verwendet Tricentis Tosca das Dateiformat der vorhandenen Datei.

Um eine Dateibeschädigung zu verhindern, muss die unter Save Path angegebene Dateiendung mit der für dieses Modulattribut ausgewählten Erweiterung übereinstimmen.

In diesem Beispiel schließen Sie die Excel-Datei sales_data.xlsx, die sich unter C:\Temp befindet.

Die Excel Engine 3.0 speichert alle Änderungen an sales_orders.pdf unter C:\Temp\Orders. Sie geben das Dateiformat als PDF (*.pdf) an.

Excel-Datei speichern und schließen

TBox Excel 1:1 File Compare

Mit dem Modul TBox Excel 1:1 Compare können Sie den Zelleninhalt, die Zellenformatierung und die Objekte von zwei Excel-Dateien vergleichen.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Reference File

Vollständiger Pfad zur Excel-Referenzdatei, einschließlich Dateiname und -endung.

Reference Password

Geben Sie das Passwort ein, wenn Ihre Referenzdatei passwortgeschützt ist.

Target File

Vollständiger Pfad zur Excel-Zieldatei, einschließlich Dateiname und -endung.

Target Password

Geben Sie das Passwort ein, wenn Ihre Zieldatei passwortgeschützt ist.

Include Cells Data

Standardmäßig vergleicht die Excel Engine 3.0 den Zelleninhalt. Wenn Sie den Zelleninhalt nicht vergleichen möchten, geben Sie den Wert False ein.

Include Formats

Standardmäßig vergleicht die Excel Engine 3.0 nicht die Zellenformatierung. Wenn Sie die Zellenformatierung vergleichen möchten, geben Sie den Wert True ein.

Include Objects

Standardmäßig vergleicht die Excel Engine 3.0 keine Objekttypen wie Bilder, Formen und Diagramme. Wenn Sie Objekte vergleichen möchten, geben Sie den Wert True ein.

Include Sheets

Wenn Ihre Excel-Dateien mehrere Datenblätter haben, können Sie festlegen, welche Blätter Sie vergleichen möchten. Geben Sie dazu die Blattnamen durch Semikolon (;) getrennt ein.

Um alle Blätter zu vergleichen, lassen Sie diesen Wert leer.

Output Path

Wenn Sie das Ergebnis in einer Textdatei speichern möchten, geben Sie den vollständigen Pfad zur Datei ein, einschließlich des Dateinamens und der Endung.

In diesem Beispiel vergleichen Sie die Excel-Dateien reference.xlsx und target.xlsx. Beide Dateien befinden sich unter C:\Temp. Sie führen die folgenden Schritte aus:

  • Sie geben das erforderliche Passwort für jede Datei an.

  • Sie geben an, dass Sie nur den Zelleninhalt von Sheet1 und Sheet2 vergleichen möchten.

  • Sie geben an, dass Tricentis Tosca das Ergebnis in C:\Temp\report\results.txt speichern soll.

Zwei Excel-Dateien vergleichen