4.2. Aktionen vergleichen

Anzahl

Ein Vergleich der Anzahl von Aktionen in zwei PDF-Dokumenten, sieht so aus:

<testcase name="haveSameNumberOfActions">
  <assertThat testDocument="test/test.pdf"
              masterDocument="master/master.pdf"
  >
    <haveSameNumberOfActions />
  </assertThat>
</testcase>

Eigenschaften von Aktionen

Um die Aktionen zweier PDF-Dokumente miteinander zu vergleichen, gibt es das Tag <haveSameActions />:

<testcase name="haveSameActions">
  <assertThat testDocument="test/test.pdf"
              masterDocument="master/master.pdf"
  >
    <haveSameActions />
  </assertThat>
</testcase>

Wann zwei Aktionen gleich sind, hängt von ihrem Typ ab. Die folgende Tabelle zeigt für jeden Aktionstyp die Eigenschaften, die für eine Gleichheit relevant sind:

Typ Relevante Eigenschaft(en) für equals()
GotoAction
destination Das Ziel, auf das die Aktion zeigt.
orientation Die Richtung der Aktion, beispielsweise /FIT
GotoEmbeddedAction
destination Das Ziel, auf das die Aktion zeigt.
new window Gibt an, ob das Ziel in einem neuen Fenster angezeigt werden soll.
GotoRemoteAction
filename Die Datei, die die Aktion anspricht.
page number Die Seitenzahl im Ziel
remote destination Ein Ziel innerhalb der angesprochenen Datei.
new window Gibt an, ob das Ziel in einem neuen Fenster angezeigt werden soll.
ImportDataAction
filename Die Datei, die importiert werden soll.
JavaScriptAction
javaScript Der JavaScript-Code. Leerzeichen werden so reduziert, wie in Kapitel 13.4: „Behandlung von Whitespaces“ beschrieben.
LaunchAction
filename Die Datei, die die Aktion starten will.
default directory Das Verzeichnis, in dem die Datei gesucht.
operation Eine Funktion, die der Datei übergeben wird und ausgeführt werden soll, beispielsweise print.
parameters Parameter, die an die Datei/Funktion übergeben werden
NamedAction
name Der Name der Aktion
ResetFormAction
fields Die Namen der Felder, deren Inhalt gelöscht werden sollen.
flags Eigenschaften für die zurückzusetzenden Felder haben müssen.
SubmitFormAction
destination Das Ziel, an das die Feldinhalte gesendet werden sollen.
fields Die Felder, deren Werte verschickt werden.
flags Einstellung für die Art der Übermittlung, beispielsweise PdfAction.SUBMIT_HTML_GET oder PdfAction.SUBMIT_PDF.
URIAction
destination Das Ziel in Form einer URI, auf das die Aktion zeigt.

Die folgenden Events sind immer mit JavaScript-Aktionen verknüpft und werden als solche miteinander verglichen:

  • document close (/DC)

  • document will print (/WP)

  • document did print (/DP)

  • document will save (/WS)

  • document did save (/DS)

Der Zeitpunkt/Event document open (/DocumentOpen) kann mit jeder beliebigen Aktion der oben dargestellten Liste verknüpft werden. Damit ist dann auch klar, dass zwei Open-Actions gemäß dieser Liste miteinander verglichen werden.