34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
|
# `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)
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<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>
|
||
|
|
```
|