Plugins:mmdb getemails

Aus Melin DokuWiki

Ruft eine Liste von Emailadressen aus einer MM-Datenbank ab. Das getEmails-PlugIn ist ein wesentlicher Bestandteil in jedem Mail-Workflow da mit diesem PlugIn die Empfängerliste gebildet wird.

Die Emailadressen der ausgelesenen Abonnenten stehen anschließend in der LISTE des Datenobjekts.

Das HASH-Feld USERCOUNT enthält die Zahl der ausgelesen Emailadressen.

[bearbeiten] Kombination von mehreren Newsletterlisten zu einem Gesamtmailing

Es ist möglich mehrere getEmails-PlugIns hintereinanderzuschalten um die Empfängerlisten von mehreren Newsletterlisten zusammenzuführen. Das getEmails-PlugIn sorgt dabei automatisch für eine Dublettenbereinigung damit eine Emailadresse die mehrere Verteiler abonniert hat nur einmal in der Liste steht. Im Logfile wird ausgegeben wieviele Abonnenten neu hinzugefügt wurden.

[bearbeiten] Clusterbildung

Es ist möglich mit dem getEmails-PlugIn nur einen Teil der Empfänger hinzuzufügen. Sinnvoll ist das beispielsweise wenn einen kleinen Teil der Empfänger mit einem Mailing versorgen will und anschließend noch optimieren möchte.

Um die Clusterbildung zu aktivieren muß das Feld

M_CLUSTER_ACTIVATE

gesetzt werden (z.B. auf "1"). Anschließend werden die Abonnenten eines Newsletters in 10 Teile geteilt. Durch das setzen der HASH-Felder

M_CLUSTER_SELECT1
M_CLUSTER_SELECT2
...
M_CLUSTER_SELECT9
M_CLUSTER_SELECT10

kann man auswählen welche Blöcke man selektieren möchte.

Hinweise: Eine weitere Unterselektion ist möglich indem man den WHERE-Parameter über das Grid setzt und selbst kriterien vorgibt wie die Liste zu teilen ist. Die M_CLUSTER_ACTIVATE-Methode vereinfacht diesen Schritt. Ein Beispiel wie die Cluster eingesetzt werden können zeit das Standalone-Theme.

[bearbeiten] Parameter im Workflow-Grid

[bearbeiten] ClientID

databaseFile = MelinDemon.siteDir + "/classify/" + clientID + "/centraldb.xml";

[bearbeiten] NL-ID

Erzwingt die Verwendung eines bestimmten Verteilers. Wird dieser Wert nicht gesetzt wird das HASH-Feld "NEWSLETTER_ID" verwendet.

[bearbeiten] WHERE

Die optinale Angabe im Feld WHERE ergänzt das SELECT-Stamement mit dem die Newsletterabonnenten gezogen werden:

SELECT SYSTEM_CUSTOMER_ID FROM SUBSCRIPTIONS WHERE NEWSLETTER_ID = XX [WHERE-Feld]

[bearbeiten] Hilfreiche SQL-Statements

Im Workflow-Grid kann beim MMDB Emailsender die Option "

Alle Abonnenten die im eigendefinierten Feld UD_

SELECT DISTINCT SC_DETAILS.EMAIL as EMAIL FROM SC_CUSTOM, SC_DETAILS WHERE SC_CUSTOM.SYSTEM_CUSTOMER_ID = SC_DETAILS.SYSTEM_CUSTOMER_ID AND

SC_CUSTOM.M_KEY = 'UD_HALLO' AND SC_CUSTOM.M_VALUE = '2'

[bearbeiten] Verwendung mit externer Datenbank

Das MMDB getEmails PlugIn kann nicht nur mit der MMDB verwendet werden, sondern auch mit einer bereits vorhandenen externen Datenbank. Voraussetzung ist, daß diese als Zusatzdatenbank angelegt ist, und in der Empfängerliste einer Newsletter-ID zugeordnet wurde. Trifft dies zu, so wird die verwendete Datenbank gesetzt und dort die Abonnentenliste gezogen. In den meisten Fällen wird in diesem Fall das Standard-SQL-Statement zum holen der Abonnenten nicht funktionieren und es ist notwendig im Hash der Datei mit M_EMAILSENDER_SUBSCRIBERSQL ein neues SQL-Statement zu definieren (siehe unten).

[bearbeiten] Definition eines eigenen SQL-Statements im Hash um Abonnenten zu holen

Wird nur einer Newsletter-ID übergeben, so holt sich das PlugIn die Abonnentendaten mit dem folgenden SQL-Statement aus der MMDB

SELECT * FROM SUBSCRIPTIONS WHERE NEWSLETTER_ID = '100'

(In diesem Beispiel ist angenommen daß im HASH die NEWSLETTER_ID auf 100 gesetzt wurde.

Es ist auch möglich durch setzen des Hash-Feldes M_EMAILSENDER_SUBSCRIBERSQL ein eigenes Statement zu übergeben mit dem die Abonnentenliste gezogen wird. Beispiel:

SELECT EMAIL FROM mytest WHERE HAS_NEWSLETTER = 1

Wichtig ist hier, daß immer ein Feld EMAIL zurückgeliefert werden muss das die Emailadressen beinhaltet.