Erweiterte Optionen

Das sind die tiefsten, technischsten Einstellungen in der Vorlagenkonfiguration einer Exportvorlage. Fast keine Vorlage braucht sie — die Seite gibt es, damit Sie wissen, was gemeint ist, wenn Ihnen eine davon begegnet. Sind Sie unsicher, lassen Sie sie unberührt oder fragen Ihren Administrator.

Sichtbarkeitsbedingung

Steuert, wann die Vorlage angeboten wird, anhand eines Werts am Datensatz. Damit verstecken Sie eine Vorlage, solange der Datensatz nicht im richtigen Zustand ist.

• Visibility condition field code — das Feld am Datensatz, das geprüft wird.
• Visibility condition field value — der Wert oder die Werte, die dieses Feld haben muss, damit die Vorlage erscheint. (Zum Beispiel eine Vorlage „Endrechnung“ nur anbieten, wenn ein Statusfeld auf Approved steht.)

Adresszuordnung

• Address mapping — sagt der Vorlage, welche Felder die Empfängeradressen halten, damit sie weiß, wohin das Ergebnis geht. Praktisch, wenn die Adresse am Datensatz steht, statt jedes Mal eingetippt zu werden.

Datei-IDs einbeziehen

• Include file ids — hängt bestimmte gespeicherte Dateien über ihre ID-Nummern an die Ausgabe. Das ist das ID-Gegenstück zum einfacheren Schalter Include uploaded files auf der Seite Vorlagenkonfiguration.

Filter

Filtering grenzt ein, auf welche Datensätze die Vorlage zutrifft. Sie können mehrere Filterregeln anlegen; ein Datensatz muss passen, damit die Vorlage läuft. Jede Regel hat:

• User input — Yes fragt die Person beim Ausführen nach dem Wert; No nimmt den festen Search value weiter unten.
• Search field, not object — Yes durchsucht ein eigenes Feld; No durchsucht den Hauptdatensatz.
• Field name — das Feld, auf das die Regel schaut.
• Search column — die konkrete Spalte für den Abgleich, wo zutreffend.
• Search operator — wie verglichen wird, etwa equals, not equals, contains, greater than.
• Search value — der Vergleichswert (wird genutzt, wenn User input auf No steht).

Mit den Schaltflächen + und − legen Sie Regeln an oder entfernen sie.

Optionale Auslieferungskonfiguration

Dieselbe Art Regeln wie unter Filtering, aber auf die Auslieferung bezogen statt darauf, welche Datensätze infrage kommen — damit variieren oder beschränken Sie, wie das Ergebnis verschickt wird. Jeder Eintrag bietet Field name, Search column, Search field, not object, Search operator und Search value.

Erforderliche Daten

Required data holt zusätzliche verwandte Daten herein, die der Vorlagentext braucht, die aber nicht zum Hauptdatensatz gehören — etwa Angaben zu einem verknüpften Schiff oder einer Firma. Sie können einen oder mehrere Datensätze anlegen, jeweils mit:

• Mapping key — der Schlüssel, der die zu holenden verwandten Daten benennt.
• Multiple — Yes, wenn mehr als ein verwandter Datensatz zurückkommen kann.
• Output — der Name, unter dem die geholten Daten im Text verfügbar sind.
• Field — das Feld, über das die verwandten Daten dem Datensatz zugeordnet werden.
• Requested fields — die konkreten Felder, die mitkommen sollen, zum Beispiel $nautical_ship_imo, $nautical_ship_general_port.

Jeder Datensatz kann außerdem haben:

• Children — verschachtelte verwandte Daten (Daten, die an den eben geholten Daten hängen), jeweils mit eigenem Child mapping key, Child multiple, Child output und Child field.
• Filtering — dieselben Filterregeln wie oben, um einzugrenzen, welche verwandten Datensätze geholt werden.

caution

Erforderliche Daten, Filter und Auslieferungsregeln ändern, welche Daten die Vorlage sieht und auf welchen Datensätzen sie läuft. Sind sie falsch gesetzt, erzeugt eine Vorlage nichts oder das Falsche — testen Sie nach jeder Änderung sorgfältig im Playground.