Zum Hauptinhalt springen
Versendet der Shop seine E-Mails nicht selbst, sondern über ein externes Mailsystem, schickt er diesem nicht die fertige Mail, sondern die Daten, aus denen das System die Mail baut. Dafür gibt es ein eigenes Template, hinterlegt als ExternMailTemplate. Die Anhänge sind der Teil dieser Daten, der sich nicht einfach als Text übergeben lässt. Die MAIL-Tags liefern sie: je Anhang den Dateinamen, die Art des Anhangs und den Inhalt in Base64-Kodierung. Das Shopsystem führt zwei getrennte Listen. In der einen stehen die Dateianhänge, in der anderen die Anhänge, die aus einem HTML-Template erzeugt wurden. Beide werden gleich behandelt, jede hat ihre eigenen vier Tags. Wegweiser: Shop-E-Mails über ein externes Mailsystem versenden

​
Die Anhänge durchlaufen

MAIL-FileAttachment und MAIL-HTMLAttachment sind Schleifen über die jeweilige Liste. Als Klammerung prüfen sie, ob überhaupt Anhänge dieser Art vorliegen.
Für die HTML-Anhänge gilt dasselbe mit MAIL-HTMLAttachment.
Die beiden Tags sind keine Einzel-Tags. ~MAIL-FileAttachment~ gibt nichts aus, sondern gilt als ungültiges Tag. Die Angaben zu einem Anhang holen Sie ausschließlich über die drei Suffix-Tags, und diese nur innerhalb der Schleife.Die drei Suffix-Tags brauchen die Schleife zwingend. Stehen sie nur innerhalb der Klammerung {MAIL-FileAttachment} ohne die Schleife darin, greift das Shopsystem auf einen Eintrag vor dem Listenanfang zu. Was dabei herauskommt, ist unbestimmt. Öffnen Sie deshalb immer {@MAIL-FileAttachment}.

​
Die Angaben je Anhang

Die HTML-Variante heißt entsprechend MAIL-HTMLAttachment_Name, MAIL-HTMLAttachment_Type und MAIL-HTMLAttachment_ContentB64.

​
Die Arten von Anhängen

Über die Art lassen sich Anhänge im übergebenen Datensatz unterschiedlich behandeln, beispielsweise um das SEPA-Mandat anders zu benennen als ein Datenblatt. Das Shopsystem selbst unterscheidet beim Versand nicht danach. ContentB64 liefert den Inhalt immer Base64-kodiert, auch bei den HTML-Anhängen, deren Inhalt eigentlich Text ist. Das externe Mailsystem bekommt damit für beide Listen dasselbe Format.

​
Die Schleife läuft nur einmal

Nach dem Durchlauf leert das Shopsystem die Liste. Eine zweite Schleife über dieselben Anhänge liefert nichts mehr, und auch die Klammerung {MAIL-FileAttachment} greift danach nicht mehr. Beide Listen verhalten sich so, jede für sich.Daraus folgt die Reihenfolge im Template: erst prüfen, dann durchlaufen. Wenn Sie nach der Schleife noch einmal wissen müssen, ob es Anhänge gab, merken Sie sich das vorher in einem Design-Parameter.
Referenz: DC- (Parameter)

​
Die Tags im Überblick

Alle Tags gelten ausschließlich im Template für das externe Mailsystem. Auf anderen Templates liegen die Anhangslisten nicht vor, und die Tags bleiben unaufgelöst.

​
Verwandte Themen

  • Wegweiser: Shop-E-Mails über ein externes Mailsystem versenden
  • Wegweiser: Shop-E-Mails gestalten
  • Referenz: DC- (Parameter)