Workflow/tasks/pdf_text_at_text.md

pdf_text_at_text — Text an gefundener Textstelle schreiben

Zweck: Sucht eine Phrase im PDF und schreibt relativ dazu einen Text — typischer Anwendungsfall: ein „x" in eine Checkbox neben einem gefundenen Formular-Label setzen. Schwester-Task von pdf_sign_at_text, aber ohne Signatur (reine Textausgabe); kann daher beliebig mitten in der Bearbeitungskette stehen. Wird die Phrase nicht gefunden, bricht der Task mit Fehler ab.

Parameter

Name	Pflicht?	Default	Beschreibung
file	ja	—	Zu bearbeitendes PDF (in-place).
search	ja	—	Suchphrase (1+ Wörter); Anker ist das erste Wort des Treffers.
text	ja	—	Zu schreibender Text, z. B. x.
seite	nein	auto	auto = alle Seiten, erste Treffer-Seite; oder Seitennummer.
case_sensitive	nein	false	Groß-/Kleinschreibung beachten.
x_offset_mm	nein	0	X-Versatz in mm relativ zur linken Kante des Fundworts; negativ = links davon.
y_offset_mm	nein	0	Y-Versatz in mm; Y=0 oben, positiv = nach unten.

Eingangswerte: {{latest_pdf_path}} bzw. PDF-Pfad-Variable.

Ausgangswerte:

• latest_pdf_path, latest_pdf_url
• Diagnose: <task_id>_matched_page, <task_id>_matched_x_pt, <task_id>_matched_y_pt (Fundposition in pt, Y top-down), <task_id>_write_x_mm, <task_id>_write_y_mm (tatsächliche Schreibposition in mm)

<task type="pdf_text_at_text" id="kreuz_a">
  <config>
    <file>{{latest_pdf_path}}</file>
    <search>Reisekostenstelle</search>
    <x_offset_mm>-5</x_offset_mm>
    <y_offset_mm>0</y_offset_mm>
    <text>x</text>
  </config>
</task>