FirstSpirit Modul EmailMarketing: Release Notes

Owned by Timo Fuchs
Last updated: Apr. 25, 2023
4 min read

Version 6.13.4, 25.04.2023

  • Bugfix: Verbesserte Kompatibilität mit Java 17 und FirstSpirit Version 2023.4

Version 6.13.0, 1.11.2022

  • Bugfix: Eine Suche im Channelconnector nach einer Kombination aus Typ und Suchbegriff funktioniert jetzt zuverlässig.

  • Bugfix: Eine Suche im Formularconnector mit einem Suchbegriff der Leerzeichen enthält funktioniert jetzt korrekt.

  • Neues Feature (funktioniert ab UM Version 7.50): Der Formularconnector listet nur Formulare in der Sprache auf, die zu der aktuellen Inhaltssprache passen. Falls die aktuelle Inhaltssprache nicht ermittelt werden kann wird eine Sprachauswahl angezeigt.

  • Neues Feature: Der die Anzeige des Reports für die Channelauswahl kann wie die Formularauswahl nun über die Projektkomponente “EmailMarketing Configuration” ein- und ausgeschaltet werden.

Falls der Report für die Channelauswahl weiter eingeschaltet bleiben soll muss die Konfiguration der Projektkomponente “EmailMarketing Configuration” im Projekt einmal geöffnet und gespeichert werden.

Version 6.12.1, 10.10.2022

  • Das Modul EmailMarketing unterstützt ab sofort Java 17.

  • Der Modus “Legacy” des FirstSpirit-Servers ist deprecated und wird in zukünftigen Versionen des Moduls nicht mehr unterstützt.

  • Bugfix: Die Funktion “EventFileCollector” bricht nicht mehr ab, wenn das EventFile für eine bestimmte Sprache nicht gefunden wird (bspw. weil die Sprache im Auftrag nicht generiert wird).

  • Bugfix: Die Funktion “EventFileCollector” sendet in Konfigurationen mit mehreren Generierungstasks pro Auftrag die EventFiles nur noch einmal an den UM.

  • Updates diverser Dependencies/Bibliotheken

  • Sonstige kleinere Verbesserungen

Version 6.11.4, 04.05.2022

Sonstige Änderungen

  • Bugfix: Unter bestimmten Umständen werden Absätze mit eingebundenem DataAccessPlugin EmailMarketing/ChannelConnector nicht im ContentCreator angezeigt

Version 6.11.0, 07.02.2022

Neues Feature

Mit der Umstellung der Eingabekomponente zur Auswahl von Listen und Segmenten aus dem Universal Messenger auf eine FS_INDEX-Komponente mit DataAccessPlugin gab es Änderungen in der Kommunikation mit dem Universal Messenger. Früher wurde beim SiteArchitect die Verbindung auf den Webservice des Universal Messenger zum Auslesen der (V)Channels über eine FirstSpirit Servicekomponente serverseitig durchgeführt. Nach der Umstellung auf das DataAccessPlugin erfolgte die Verbindung im Falle des SiteArchitect clientseitig. Das führt bei Infrastrukturen, bei denen FirstSpirit-Redakteur*innen aufgrund von Firewalleinstellungen keine direkte Verbindung zum Universal Messenger haben, zum Problem, dass die Listen/Segmente nicht ausgelesen werden können.

Deswegen wurde ein neuer Service “UMConnectionService” eingeführt, der optional verwendet werden kann. Dieser Service führt die Verbindungen zum Universal Messenger wieder serverseitig durch.

Durch einen Schalter “Verbindung über FirstSpirit Service” in der Projektkomponente kann diese Option aktiviert werden.

In Cloud-Umgebungen ist es i.d.R. sinnvoller, die Option zu deaktivieren und weiterhin eine direkte Verbindung zu erlauben.

Sonstige Änderungen

  • Bugfix: Die Labels in der Auswahl für Listen/Segmente und Formulare werden nun einheitlich in der aktuellen Sprache angezeigt.

Version 6.10.0, 8.12.2021

Neues Feature

Das DataAccessPlugin zur Auswahl eines im Universal Messenger erstellten Formulars ist nun offiziell Bestandteil des Moduls EmailMarketing.

Zur Verwendung muss in der Projektkomponente der Haken “Zeige Formular-Auswahl an” gesetzt werden und die “EmailMarketing WebApp” im ContentCreator geladen sein.

Danach können die Formulare über einen ContentCreator-Report ausgewählt werden:

Um die Formulare auf einer Seite anzuzeigen muss eine entsprechende Absatzvorlage erstellt werden.

Die Formulardefinition kann folgendem Beispiel entsprechen:

<CMS_MODULE> <FS_BUTTON name="st_drop_button" hFill="yes" hidden="no" onClick="class:OpenUMFormularReportExecutable" onDrop="class:DropFormOnSectionExecutable" style="firstspirit" useLanguages="no"> <DROPTYPES> <MIME type="application/x-java-serialized-object" classname="de.pinuts.firstspirit.newsletter.formconnector.UMFormEntry"/> </DROPTYPES> <LANGINFOS> <LANGINFO lang="*" label="Drop the selected form here."/> <LANGINFO lang="DE" label="Um ein Formular zu verknüpfen hier fallen lassen."/> </LANGINFOS> </FS_BUTTON> <FS_INDEX name="st_form_snippet"> <LANGINFOS> <LANGINFO lang="*" label="UMFormular"/> </LANGINFOS> <SOURCE name="EmailMarketing/UMFormsDataAccessPlugin"/> </FS_INDEX> </CMS_MODULE>

Die Ausgabe des Formulars kann folgendermaßen aussehen:

 

<div class="fs-dropzone" $CMS_VALUE(editorId())$ $-- necessary to get section as element in Executable --$ $CMS_VALUE(fsbutton(editorName:"st_drop_button", parameter: { "editorId": editorId( json: true, reloadPreview: true), "formIndexField": "st_form_snippet"}))$ style="height:50px"> </div> $CMS_FOR(for_form, st_form_snippet.values)$$CMS_VALUE(for_form,default:"")$$CMS_END_FOR$

Sonstige Änderungen

  • Optimierung (UMFS-12): In der Auswahl der Listen und Segmente wurden die Begriffe “Channel” und “VChannel” durch “Listen” und “Segmente” ersetzt.

  • Optimierung (UMFS-17): Für bestimmte Fehlkonfigurationen erscheinen nun keine NullPointerExceptions mehr sondern sprechende Fehlermeldungen.

Breaking change

Die Funktion “Statistics” in den Versandaufträgen zum Schreiben des Versanddatums in die Datenquelle wird aufgrund von Einschränkungen in der FirstSpirit API nicht mehr unterstützt. Wir empfehlen daher folgende Vorgehensweise:

  1. Neues Skript “write_statistics” mit folgendem Beispielinhalt anlegen:

    //!Beanshell import java.util.Date; element = context.getElement(); //context.logInfo("Element: " + element.getClass().getName()); if (!element.isLocked()) { element.setLock(true); } formData = element.getFormData(); formData.get(null, "tt_was_sent").set(true); formData.get(null, "tt_was_sent_date").set(new Date()); element.setFormData(formData); element.save(); element.release(); if(element.isLocked()) { element.setLock(false); } context.logInfo("Statistic written to dataset");

  2. Skript in Versandworkflow integrieren

Version 6.9.6, 30.07.2021

  • Anpassungen für Cloud-Umgebungen, bspw. Übergabe von Bildern als base64-encoded String in Event-Datei ohne die Bilder vorher auf einen Webserver zu publizieren

  • Bugfix: Letzte Referenzen auf FS_LIST eliminiert, die in UM-Anbindungen im Legacy-Modus (d.h. ohne GCA:newsletter_settings) verwendet wurden

Version 6.9.2, 09.04.2021

  • Kleinere Bugfixes

Version 6.9.1, 03.03.2021

  • Kleinere Bugfixes

  • Vollständige Beispielimplementation kann als ContentTransport-Feature heruntergeladen und im Projekt integriert werden.

  • Unterstützung der Funktion "One-click unsubscribe" des Universal Messenger

Version 6.9.0, 08.02.2021

  • Bugfix: Bei der Erstinstallation werden wieder die Basiskomponenten im Projekt installiert.

  • Bugfix: Unkonfigurierte Projektkomponente erzeugt keinen Fehler mehr

  • Neues Feature: Link zum Universal Messenger kann auf FirstSpirit Startseite angezeigt werden

 

Version 6.7.0, 09.12.2020

  • Diverse Bugfixes

  • Anpassungen für Betrieb in der Cloud

Version 6.5.0, 03.02.2020

  • ACHTUNG: Mindestanforderung: FirstSpirit Version 2020-01

  • Bugs im DataAccessPlugin wurden gefixt.

  • Im DataAccessPlugin kann über den optionalen Parameter "semtagName" in der FS_INDEX ein Semantic Tag zur Filterung übergeben werden.

  • Unterstützung für FS_LIST entfernt

  • Modul konform mit Isolation-Check HIGHEST

Version 6.1.0, 06.09.2019

  • Unterstützung von Servermodus "isolated"

  • Unterstützung von Java 11

  • Channelauswahl in FirstSpirit über DataAccessPlugin möglich

Beim Update eines bestehenden Projektes sind die folgenden Skripte zu aktualisieren, indem der hier vorgegebene Code in alle Ausgabekanäle kopiert wird:

  1. newsletter/getsemtag

  2. newsletter/gettestchannel

  3. newsletter/getumurl

  4. newsletter/newsletter_salutations