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:
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");
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
<FS_INDEX name="tt_channels"> <LANGINFOS> <LANGINFO lang="*" label="Empfängerlisten/-Segmente"> </LANGINFO> </LANGINFOS> <SOURCE name="EmailMarketing/ChannelDataAccessPlugin"> </SOURCE> </FS_INDEX>
Beim Update eines bestehenden Projektes sind die folgenden Skripte zu aktualisieren, indem der hier vorgegebene Code in alle Ausgabekanäle kopiert wird:
newsletter/getsemtag
#!executable-class Semtag
newsletter/gettestchannel
#!executable-class TestChannel
newsletter/getumurl
#!executable-class UmUrl
newsletter/newsletter_salutations
#!executable-class Salutations