GetAllRecipients

Beschreibung:

Liefert ein DataCollection-Objekt zurück, um alle Empfänger der Empfänger-Liste abfragen zu können. Hierbei werden auch pro Empfänger die Felder aus der Empfänger-Liste berücksichtigt.

Für jeden Empfänger wird darüber hinaus auch die beiden Felder "status" und "last_change" geliefert, die im DataItem-Objekt abgefragt werden können:

Parametername

Typ

Beschreibung

status

String

Enthält die Information über den aktuellen Status des Empfängers: subscribed, unsubscribed, bounced oder pending, je nach gesetztem Wert der Methode SetOption im EmailTool Objekt.

last_change

DateTime

Liefert Datum/Uhrzeit, wann bei dem Empfänger zuletzt eine Änderung vorgenommen wurde.

Hierbei handelt es sich um das UTC-Format und kann ggf. mit Hilfe von ConvertUTCToLocalDateTime auf das lokale System-Datum umgerechnet werden – Beispiel:

Dim dateTime

dateTime = recipients.GetContentsValueByName("last_change")

cRM.ConvertUTCToLocalDateTime(CDate(dateTime))

Parameter:

Parametername

Typ

Beschreibung

Attributszuordnungsdatei

String

Dieser Parameter ist optional.

Wenn dieser nicht angegeben wird, leer ist oder ein "*" enthält, so werden immer alle Felder der Empfänger-Liste zurückgemeldet. Man kann hier auch eine kommaseparierte Liste an Feldnamen übergeben, um gezielt nur eine Auswahl an Felder zu erhalten - bspw. "Feld1, Feld8"

Alternativ kann aber auch der Dateipfad zur Attributszuordnungsdatei angegeben werden. Die dort eingestellten Felder werden pro Empfänger aus der Empfänger-Liste abgefragt.

Rückgabewert:

DataCollection