Dokumentvorlagen

Mit trademate können Sie Dokumente nach Ihren Wünschen gestalten. So können Sie zum Beispiel festlegen, wie Ihre Rechnungen aussehen sollen. Bitte gehen Sie zum Konfigurieren der Vorlagen in den Händler-Prozess.

In der Liste "Dokumentvorlagen" sehen Sie Ihre Vorlagen. Diese sind bereits standardmäßig gestaltet. Eine individuelle Anpassung ist also optional.

Die Vorlagen sind HTML-Seiten und können in einem WYSIWG-Editor bearbeitet werden. Bitte öffnen Sie zum Bearbeiten einer Vorlage die Detail-Ansicht.

In der Detail-Ansicht gibt es auch einen Workflow-Button mit den Einträgen "Vorschau" und "Zurücksetzen". Sie können die Vorschau nutzen, um sich das fertige PDF anzuschauen. Beim Zurücksetzen wird die Vorlage auf den Anfangszustand zurückgesetzt. Dabei gehen alle Ihre Änderungen verloren.

Schlüsselwörter

In der Vorlage sind manche Wörter englisch, großgeschrieben und in Prozentzeichen gefasst. (%KEYWORD%) Das sind die sogenannten Schlüsselwörter. Bei der Dokument-Erstellung werden die Schlüsselwörter mit dem entsprechenden Inhalt ausgetauscht.

Bitte klicken Sie auf den %KEYWORD%-Button für eine Übersicht aller Schlüsselwörter.

Abschnitte

In manchen Vorlagen gibt es Abschnitte, die durch ein linksbündiges Wasserzeichen gekennzeichnet sind. Bei der Dokument-Erstellung haben solche Abschnitte ein Spezial-Verhalten. Die möglichen Abschnitte werden im Folgenden kurz erläutert.

Kopf Folgeseiten

Dieser Abschnitt wird als Kopf auf jeder Folgeseite ausgegeben. Also auf allen Seiten, die nach der ersten Seite kommen.

Positionen

Dieser Abschnitt wird für jede Position eines Belegs ausgegeben. Wenn Sie zum Beispiel eine Rechnung mit Drei Positionen ausgeben, wird der Abschnitt Drei mal untereinander ausgegeben. In diesem Abschnitt können Sie auch die Schlüsselwörter der "Belegposition" verwenden. (siehe Übersicht der Schlüsselwörter)

Dieser Abschnitt wird in HTML mit dem Attribut data-loop und dem Wert positions ausgezeichnet. Um zum Beispiel alle Artikelnummern untereinander auszugeben, würde man schreiben:

<table>
  <thead>
    <tr>
      <td>Artikelnummer</td>
    </tr>
  </thead>
 <tbody>
   <tr data-loop="positions">
     <td>%ITEM_NUMBER%</td>
   </tr>
  </tbody>
</table>

Dynamische Inhalte

Sie können auch definieren, dass bestimmte Ausgaben entfernt/getauscht werden sollen. Für das Konfigurieren sollten Grundkenntnisse in HTML vorhanden sein.

Im Folgenden soll die Vorgehensweise kurz erläutert werden. Bitte benutzen Sie den <>-Button, um das HTML direkt zu bearbeiten.

Ausblenden

Sie können unerwünschte Ausgaben einfach entfernen. So möchte man zum Beispiel keinen Platz für die Auftragsnummer verschwenden, wenn eine Rechnung gar keine Auftragsnummer hat. Man möchte also den Platz nur einräumen, wenn tatsächlich eine Auftragsnummer vorhanden ist. Der Ausschnitt in der Vorlage sieht wie folgt aus:

Auftragsnummer:

%SALES_ORDER_NUMBER%

<tr>
  <td>Auftragsnummer:</td>
  <td>%SALES_ORDER_NUMBER%</td>
</tr>

Der Ausschnitt soll entfernt werden, wenn %SALES_ORDER_NUMBER% leer ist. Dafür sind zwei Dinge notwendig:

Der unerwünschte Inhalt muss definiert werden. Dafür bekommt das Element ein Attribut data-blacklisted mit dem unerwünschten Wert. In diesem Fall ist der Wert also leer.
Es muss festgelegt werden, welches Element entfernt werden soll, wenn unerwünschte Inhalte auftreten. Dafür bekommt das Element die Stylesheet-Klasse hidden-blacklisted. In diesem Fall ist es die gesamte Zeile (tr-Element).

Der angepasste Code sieht dann wie folgt aus:

<tr class="hidden-blacklisted">
  <td>Auftragsnummer:</td>
  <td data-blacklisted="">%SALES_ORDER_NUMBER%</td>
</tr>

Wenn die Auftragsnummer 0001 unerwünscht ist, würde man schreiben:

<!-- Auftragsnummer 0001 ausblenden -->
<tr class="hidden-blacklisted">
  <td>Auftragsnummer:</td>
  <td data-blacklisted="0001">%SALES_ORDER_NUMBER%</td>
</tr>

Sie können auch mehrere unerwünschte Werte gleichzeitig definieren:

<!-- Auftragsnummer 0001 und 0002 ausblenden -->
<tr class="hidden-blacklisted">
  <td>Auftragsnummer:</td>
  <td data-blacklisted='["0001", "0002"]'>%SALES_ORDER_NUMBER%</td>
</tr>

Gesamte Spalte ausblenden

Die Vorlagen bestehen größtenteils aus Tabellen. Sie können auch eine komplette Spalte ausblenden, wenn dessen Zellen nur unerwünschte Inhalte haben. Zum Beispiel gibt es auf Rechnungen eine Spalte für den Rabatt. Wenn aber keine der Rechnungspositionen einen Rabatt hat, raubt die Spalte nur unnötig Platz. In dem Fall soll die gesamte Spalte entfernt werden. Dafür sind zwei Dinge notwendig:

Der unerwünschte Inhalt muss definiert werden. Dafür definieren Sie auf den Zellen ein Attribut data-blacklisted. In diesem Fall mit dem Wert "0%"
Es muss die Spalte ausgezeichnet werden, die bei ausschließlich unerwünschten Inhalten ausgeblendet werden soll. Dafür muss die Zelle im Tabellenkopf die Stylesheet-Klasse "hidden-blacklisted-only" enthalten.

<table>
  <thead>
    <tr>
      <td>Artikelnummer</td>
      <td class="hidden-blacklisted-only">Rabatt</td>
    </tr>
  </thead>
 <tbody>
   <tr data-loop="positions">
     <td>%ITEM_NUMBER%</td>
     <td data-blacklisted="0%">%DISCOUNT_RATE%%</td>
   </tr>
  </tbody>
</table>

Austauschen

Sie können unerwünschte Ausgaben auch einfach austauschen. So möchte man zum Beispiel einen Rabatt nur ausgeben, wenn dieser größer als Null ist. Dafür sind zwei Dinge notwendig:

Der unerwünschte Wert muss definiert werden. Dafür nehmen Sie bitte das Attribut data-blacklisted. In diesem Fall mit dem Wert "0%".
Der Austauschwert muss festgelegt werden. Dafür bekommt das Element ein Attribut data-blacklisted-substitute. In dem Fall bleibt es leer, weil anstatt "0%" nichts stehen soll.

<td data-blacklisted="0%" data-blacklisted-substitute="">%DISCOUNT_RATE%%</td>

Wenn man die "0%" lieber mit "-" tauschen möchte, würde man schreiben:

<td data-blacklisted="0%" data-blacklisted-substitute="-">%DISCOUNT_RATE%%</td>