Zum Hauptinhalt springen

Vorlagen — die Grundlagen

Für Vorlagen brauchen Sie keine Entwicklerkenntnisse. Wer schon einmal einen Serienbrief an hundert Leute geschickt hat — jeden mit seinem Namen angeredet — kennt die Idee bereits.

Eine Vorlage ist ein Text, den Sie einmal schreiben, mit ein paar Lücken darin. SHIPM8 füllt diese Lücken automatisch, mit den Daten des jeweiligen Schiffes, Kunden oder Hafenanlaufs.

Platzhalter​

Die Lücken heißen Platzhalter und werden in doppelte geschweifte Klammern gesetzt: {{ }}. Läuft die Vorlage, wird jeder Platzhalter durch einen echten Wert ersetzt.

Hier eine Anlaufmeldung:

Dear {{customer.name}},

Your vessel {{vessel.name}} is expected at {{port.name}} on {{eta}}.

Mit den Daten eines Hafenanlaufs wird daraus:

Dear Blue Tide Shipping,

Your vessel Ocean Star is expected at Amsterdam on 22-07-2025.

Gleiche Vorlage, andere Daten, jedes Mal eine andere Nachricht. Das ist die ganze Idee — alles Weitere baut darauf auf.

Wo SHIPM8 Vorlagen einsetzt​

Vorlagen stecken hinter den Texten, die SHIPM8 für Sie erzeugt:

  • Meldungen — die E-Mails und Nachrichten zu Ereignissen wie einer geänderten ETA.
  • Rechnungen — Aufbau und Wortlaut der Rechnungsdokumente.
  • Exporte — Word-, PDF-, Excel- und andere Dokumente aus Ihren Daten.

Überall, wo Sie so etwas bearbeiten, bearbeiten Sie eine Vorlage.

Etwas mehr als Platzhalter​

Meistens reichen Platzhalter. Manchmal ist ein roher Wert aber nicht vorzeigbar — ein Datum, das als 2025-07-22T00:00:00 gespeichert ist, oder ein Betrag, der als € 1.250,00 erscheinen soll. Dafür gibt es Helfer, die Werte formatieren und umformen, zum Beispiel:

{{dateFormat eta 'dd-MM-yyyy'}}      →  22-07-2025
{{currencyFormat amount 'EUR'}}      →  EUR 1.250,00

Es gibt Helfer für Datum, Geld, Text, Listen, einfache Wenn-dann-Logik und mehr. Zum Anfangen brauchen Sie sie nicht — wenn es so weit ist, ist der Rest dieses Abschnitts eine vollständige Referenz, sortiert danach, was Sie gerade vorhaben.

Ausprobieren: der Playground​

Am besten lernt man durch Probieren, und SHIPM8 hat dafür einen sicheren Ort. Im Bereich Content distribution finden Sie den Templating Playground.

Dort fügen Sie links eine Vorlage ein und rechts Beispieldaten (als JSON), klicken auf Apply und sehen sofort das Ergebnis — ohne eine echte Meldung oder Rechnung anzurühren. Das ist der einfachste Weg, ein Beispiel von diesen Seiten auszuprobieren und zu sehen, was es tut.

tip

Sehen Sie den Bereich Content distribution nicht, hat Ihr Konto womöglich keinen Zugriff darauf. Fragen Sie Ihren Administrator, wenn Sie den Playground nutzen möchten.

Wie es weitergeht​

  • Vorlagen schreiben — Platzhalter, Schleifen und wie Sie an verschachtelte Daten kommen.
  • Daten auswählen mit JSONPath — wie Sie genau auf das Feld zeigen, das Sie meinen, auch bei Namen mit Leerzeichen.
  • Die übrigen Seiten sind eine Referenz der Helfer für Formatierung, Listen, Logik und Berechnungen — schlagen Sie nach, wenn Sie sie brauchen.