3.24. Texte - in Ausschnitten einer Seite

Überblick

Es gibt die Situation, dass sich ein bestimmter Text mehrmals auf einer Seite befindet, aber nur eine der Stellen im Test benutzt werden soll. Für diese Anforderung kann der Suchbereich auf einen Teil einer Seite beschränkt werden. Die Syntax dazu ist einfach:

<!-- Compare text inside a clipping area: -->

<testcase name="..">
  <assertThat testDocument="..">
    <hasText on=".." >
      <inClippingArea upperLeftX=".." upperLeftY=".." width=".." height=".." >
        ... <!-- compare text here -->
      </inClippingArea>
    </hasText>
  </assertThat>
</testcase>

Beispiel

Das folgende Beispiel zeigt die Definition und Benutzung eines Seitenausschnitts:

<testcase name="hasTextOnFirstPage_MultipleValidations">
  <assertThat testDocument="content/documentForTextClipping.pdf">
    <hasText on="FIRST_PAGE" >
      <inClippingArea upperLeftX="50" upperLeftY="130" width="170" height="25" > 1
        <startingWith>Content</startingWith>
        <containing>on first</containing>
        <endingWith>page.</endingWith>
      </inClippingArea>
    </hasText>
  </assertThat>
</testcase>

1

Hier wird der Seitenausschnitt definiert. Genaue Informationen dazu liefert das Kapitel 13.6: „Seitenausschnitt definieren“. Die Möglichkeiten, Maß-Einheiten wie MILLIMETER für die Definition zu benutzen, beschreibt Kapitel 13.7: „Maßeinheiten - Points, Millimeter, ...“.

Für Vergleiche von Text in Seitenausschnitten stehen alle Tags zur Verfügung, die auch für ganze PDF-Seiten zur Verfügung stehen. Sie sind in Kapitel 13.3: „Textvergleich“ ausführlich beschrieben.

Die Einschränkung eines Vergleiches auf einen Ausschnitt einer Seite ist sowohl für Text, als auch für Bilder möglich.