Zum Hauptinhalt springen

Eine Exportvorlage anlegen

Das ist das Herzstück der Vorlagenkonfiguration. Klicken Sie in der Übersicht Export templates auf New (oder auf From library, um von einer fertigen Vorlage auszugehen), füllen Sie das Formular aus und klicken Sie auf Save.

Die Kernfelder​

  • Name (Pflicht) — wie Sie die Vorlage nennen; unter diesem Namen wählen Leute sie beim Exportieren oder Verschicken.
  • System code (Pflicht) — ein kurzer interner Code, an dem SHIPM8 die Vorlage erkennt. Er wird aus dem Namen vorbelegt; erlaubt sind Buchstaben, Ziffern und Unterstriche.
  • Object definition (Pflicht) — die Art Datensatz, auf der die Vorlage läuft (eine Rechnung, ein Hafenanlauf, ein eigenes Objekt und so weiter). Bei manchen Auswahlen, etwa einem Finanzbericht, erscheint eine zusätzliche Auswahlliste, um es genauer zu fassen.
  • Document type (Pflicht) — was die Vorlage erzeugt und wie es ausgeliefert wird, siehe Dokumenttypen.

Der Vorlagentext​

Der Vorlagentext ist der Text selbst. Das Formular zeigt eine schreibgeschützte Vorschau; über Edit template body öffnen Sie den Editor und schreiben ihn.

  • Der Text entsteht mit der Vorlagen-Engine — Platzhalter wie {{ }} und Helfer zum Formatieren. Diese Anleitung ist Ihre Referenz für die Sprache.
  • Bei einem Dokumenttyp E-Mail öffnet sich der Text in einem HTML-Editor, damit Sie die Nachricht gestalten können.
  • Eine praktische Schaltfläche, der Code-Builder, setzt den passenden Platzhalter für die gewählte Objektdefinition ein — Sie müssen sich also keine Feldcodes merken.

Gültigkeitsdaten​

  • Start date / End date — optional. Damit steuern Sie, wann die Vorlage verfügbar ist: etwa eine neue Fassung ab einem Stichtag einschalten oder eine alte ablösen.

Schalter​

  • Enabled — einschalten, damit die Vorlage benutzbar ist. Solange Sie noch bauen, lassen Sie es aus.
  • Enable store — legt von jedem erzeugten Dokument eine Kopie beim Datensatz ab.

Speichern​

Klicken Sie auf Save. Die Vorlage erscheint jetzt in der Übersicht und — sobald Enabled an ist — überall dort, wo ihre Objektdefinition exportiert oder verschickt werden kann.

tip

Bauen Sie mit ausgeschaltetem Enabled, testen Sie im Playground und schalten Sie erst ein, wenn die Ausgabe stimmt.

Optionale Einstellungen

Unter den Kernfeldern steht der Abschnitt Template configuration mit vielen optionalen, tieferen Einstellungen. Eine funktionierende Vorlage speichern Sie auch, ohne sie anzufassen — siehe Vorlagenkonfiguration, wenn Sie sie brauchen.