PDF-Dateien aufzeichnen

Ihre Applikation verfügt über verschiedene Controls, bei denen es sich um Elemente handelt, mit denen Tosca beim Ausführen Ihrer Tests interagiert. Dazu müssen Sie zunächst Ihre Applikation aufzeichnen. Dadurch werden die erforderlichen technischen Daten in Tosca übernommen.

Dieses Kapitel erläutert, wie Sie PDF-Dokumente für die folgenden Anwendungsfälle aufzeichnen:

  • Sie möchten Text, Bilder oder Tabellen in einer PDF-Datei testen.

  • Sie möchten Bereiche aus einem PDF-Vergleich ausschließen.

In allen anderen Fällen, z. B. beim Überprüfen auf fehlerhafte Links, verwenden Sie stattdessen die Standard-Untermenge. Weitere Informationen finden Sie hier: PDF-Module.

Starten Sie die Aufzeichnung

Um die Aufzeichnung zu starten, führen Sie diese Schritte aus:

  1. Klicken Sie mit der rechten Maustaste auf einen Modulordner und wählen Sie im Kontextmenü die Option  Scan, oder verwenden Sie das dynamische Menü Modules und wählen Sie  Scan->PDF. Alternativ können Sie die Tastenkombination Strg + Umschalt + P verwenden.

  2. Wählen Sie die PDF-Datei aus, die Sie aufzeichnen möchten, und wählen Sie Open aus.

Inhaltsvorschau hinzufügen

Überprüfen Sie die Content Preview des PDF Scan, um sicherzustellen, dass Ihre aufgezeichneten Controls korrekt sind. Die Content Preview zeigt genau an, welchen Inhalt Sie für Ihr Control ausgewählt haben. Möglicherweise müssen Sie ihn manuell hinzufügen.

Standardmäßig zeigt das Fenster PDF Scan Folgendes an:

  • Die PDF-Datei.

  • Die Namen und Typen der PDF-Controls, die Sie während der Aufzeichnung auswählen.

Um den Inhalt eines ausgewählten Controls anzuzeigen, wählen Sie im Menüband Show Content Preview aus.

So können Sie sicherstellen, dass Ihre Auswahl den richtigen Inhalt enthält. Außerdem können Sie die Option Force optical recognition verwenden, falls Tosca den Inhalt eines Controls nicht richtig erkennt.

Zusätzliche Optionen in der Aufzeichnungsoberfläche

Das Menü PDF Scan bietet außerdem folgende Optionen:

Option

Beschreibung

Zoom

Ändern Sie die Zoomstufe der PDF View.

 Zoom Fit

Vergrößern Sie die aufgezeichnete PDF-Datei, sodass sie in die PDF View passt.

Show scanned areas

Zeigen oder verbergen Sie die aufgezeichneten Bereiche in der PDF View.

Select Document Language

Wählen Sie die Sprache der aufgezeichneten PDF-Datei aus. Der PDF Scan verwendet diese Sprache für die optische Zeichenerkennung (OCR).

Controls auswählen

Sie können die PDF-Controls, die Sie Ihrem Modul hinzufügen möchten, auf unterschiedliche Weise definieren:

  • Definieren Sie ein Control anhand seiner absoluten Position.

  • Definieren Sie ein Control anhand seiner relativen Position zu einem anderen Element. Dies ist hilfreich, wenn ein PDF-Element keine absolute Position hat, relativ zu einem anderen PDF-Element jedoch immer an derselben Position erscheint.

    Angenommen, Sie testen Rechnungen und möchten überprüfen, ob Net price den richtigen Preis anzeigt. Je nach Länge der Einzelpostenliste kann Net price weiter oben oder unten auf der Seite erscheinen. Das Element hat keine absolute Position. Es erscheint jedoch immer direkt über Gross price. Es erscheint somit relativ zu einem anderen Element immer an einer bestimmten Position.

  • Sich wiederholende Bereiche definieren Dies ist hilfreich, wenn ein Element auf mehreren Seiten des Dokuments im selben Bereich erscheint.

    Angenommen, Sie möchten überprüfen, ob der Copyright-Hinweis unten auf allen Seiten erscheint. Anstatt das Control für jede einzelne Seite separat zu definieren, können Sie einen sich wiederholenden Bereich für das gesamte Dokument erstellen.

Wählen Sie Ihren Anwendungsfall:

Bei dieser Option identifiziert Tosca ein Control anhand seiner Position in Ihrer PDF-Datei.

Führen Sie zum Aufzeichnen diese Schritte aus:

  1. Wählen Sie im Menüband des PDF Scan den Typ des Controls aus, das Sie Ihrem Modul hinzufügen möchten: Text, Image oder Table.

  2. Markieren Sie in der PDF-Ansicht der Aufzeichnung den entsprechenden Bereich mit der Maus. Dadurch wird das Control Ihrem Modul hinzugefügt.

  3. Führen Sie für Table-Controls außerdem folgende Aktionen durch:

    • Fügen Sie die Content Preview hinzu.

    • Geben Sie bei Bedarf die Anzahl der Zeilen- bzw. Spaltenüberschriften an.

    • Wenn die Gitternetzlinien nicht mit der Tabelle übereinstimmen, wählen Sie Edit Table aus, um die Spaltenlinien zu verschieben und die Zeilengröße anzupassen. Halten Sie C gedrückt und klicken Sie, um eine neue Spalte zu erstellen, oder halten Sie R gedrückt und klicken Sie, um eine neue Zeile zu erstellen. Wählen Sie Edit rows aus, wenn Sie Zeilen präzise verschieben müssen.

  4. Fügen Sie die Content Preview hinzu, falls Sie dies noch nicht getan haben. Stellen Sie anschließend sicher, dass Ihre Text- und Table-Controls den richtigen Inhalt aufweisen:

    • Im Control fehlen keine wichtigen Zeichen, z. B. Leerzeichen.

    • Die Vorschau des Control-Inhalts stimmt mit dem Original in der PDF-Datei überein. Ist dies nicht der Fall, können Sie als alternative Erkennungsmethode Force optical recognition wählen.

  5. Speichern Sie, nachdem Sie alle Controls definiert haben, die Sie dem Modul hinzufügen möchten. Wählen Sie anschließend entweder Scan New Document oder Close aus.

Bei dieser Option identifiziert Tosca ein Control (Ziel-Control) anhand seiner Position relativ zu einem anderen Element (Anker-Control).

Das Anker-Control muss folgende Anforderungen erfüllen:

  • Es handelt sich um Text oder ein Bild.

  • Es ist eindeutig identifizierbar. Daher können Sie sich wiederholende Bereiche nicht als Anker-Controls verwenden.

  • Es befindet sich auf derselben Seite wie das Ziel-Control.

Führen Sie zum Aufzeichnen diese Schritte aus:

  1. Definieren Sie im PDF Scan zwei Controls anhand ihrer absoluten Position: ein Anker-Control und ein Ziel-Control.

  2. Klicken Sie in der Liste der Controls mit der rechten Maustaste auf das Anker-Control. Führen Sie anschließend diese Aktionen durch:

    • Wählen Sie je nach Control-Typ des Ankers im Kontextmenü Use as Text Anchor for ... oder Use as Image Anchor for ... aus.

    • Wählen Sie das Ziel-Control aus der Liste aus.

      Beachten Sie, dass Sie Anker-Controls nicht wieder in normale Controls umwandeln können.

  3. Speichern Sie, nachdem Sie alle Controls definiert haben, die Sie dem Modul hinzufügen möchten. Wählen Sie anschließend entweder Scan New Document oder Close aus.

Zur Laufzeit durchsucht Tosca die PDF-Datei nach dem Anker-Control und berechnet anschließend die Position des Ziel-Controls.

Standardmäßig sucht Tosca nach einem Anker-Control, das exakt mit dem von Ihnen definierten Text oder Bild übereinstimmt. Falls dies bei Ihren Tests zu Problemen führt, können Sie eine geringere Genauigkeit konfigurieren. Weitere Informationen finden Sie hier: Anker-Controls konfigurieren. Dieses Kapitel erläutert außerdem, wie Sie Anker-Controls bearbeiten oder eindeutig machen.

Bei dieser Option definieren Sie ein Control, das auf mehreren Seiten Ihres Dokuments im selben Bereich erscheint.

Führen Sie zum Aufzeichnen diese Schritte aus:

  1. Wählen Sie im Menüband des PDF Scan den Typ des Controls aus, das Sie als sich wiederholender Bereich hinzufügen möchten: Text, Image oder Table.

  2. Markieren Sie in der PDF view der Aufzeichnung den entsprechenden Bereich mit der Maus. Klicken Sie anschließend mit der rechten Maustaste auf den Bereich und wählen Sie im Kontextmenü Repetitive Area aus.

  3. Speichern Sie, nachdem Sie alle Controls definiert haben, die Sie dem Modul hinzufügen möchten. Wählen Sie anschließend entweder Scan New Document oder Close aus.

Standardmäßig sucht Tosca auf allen Seiten Ihrer PDF-Datei nach dem sich wiederholenden Bereich. Informationen zum Ausschließen bestimmter Seiten finden Sie unter „Controls in sich wiederholenden Bereichen“.

Wenn Sie ein Modul mit einem oder mehreren sich wiederholenden Bereichen erstellen, wird auch ein zusätzliches Modulattribut Repetitive Area Exclusions generiert. Auf diese Weise können Sie verhindern, dass diese Bereiche auf bestimmten Seiten ausgeführt werden. In Testschritten, die das Modul verwenden, können Sie Folgendes tun:

  1. Wählen Sie Odd numbered pages aus dem Wertebereich des Modulattributs, um alle ungerade nummerierten Seiten auszuschließen.

  2. Wählen Sie Even numbered pages aus dem Wertebereich des Modulattributs, um alle gerade nummerierten Seiten auszuschließen.

  3. Geben Sie im Modulattribut die auszuschließenden Seiten als Wert an. Verwenden Sie dazu die folgende Syntax: <n>;<n-n>; ....

    Beispiel: Der Wert 1; 3-6; 9 schließt die Seiten 1, 3, 4, 5, 6 und 9 aus.

Controls während der Aufzeichnung bearbeiten

Sie können Ihre Controls während der Aufzeichnung bearbeiten:

  • Um einen Bereich auszuwählen, wählen Sie ihn in der PDF View oder in der Liste der Controls aus.

  • Um in der PDF View zu einem Control zu springen, doppelklicken Sie in der Liste auf das Control oder verwenden Sie das Symbol Jump.

  • Um ein Control umzubenennen, doppelklicken Sie auf seinen Namen.

  • Um einen Bereich zu verschieben oder seine Größe zu ändern, bearbeiten Sie das Rechteck in der PDF View.

  • Um ein Control neu zu zeichnen, wählen Sie in der Liste der Controls das Symbol Redraw aus.

  • Um ein Control zu löschen, wählen Sie in der Liste der Controls das Symbol Delete aus. Alternativ klicken Sie in der PDF View mit der rechten Maustaste auf den Bereich und wählen im Kontextmenü Remove this control aus.

Rescan

Wenn Sie Controls in Ihrem Modul hinzufügen oder ändern möchten, zeichnen Sie Ihre PDF-Datei erneut auf. Beachten Sie folgende Einschränkungen:

  • Während der erneuten Aufzeichnung können Sie keine Controls löschen.

  • Während der erneuten Aufzeichnung können Sie den Control-Typ nicht ändern.

Um die PDF-Datei erneut aufzuzeichnen, klicken Sie mit der rechten Maustaste auf das zu ändernde Modul und wählen im Kontextmenü Rescan aus. Alternativ drücken Sie Strg + Umschalt + R.

Nächste Schritte

Nachdem Sie Ihre PDF-Module erstellt haben, können Sie mit dem Erstellen von PDF-Testschritten beginnen.