Studie: Der ideale Zeitpunkt für den Newsletter Versand! Jetzt Ergebnisse herunterladen >

Abonnenten mit Formularfeldern exportieren - ExportSubscribersWithFormFields

Abonnenten mit Formularfeldern exportieren

Die Methode ExportSubscribersWithFormFields ermöglicht es, eine Liste von Abonnenten mit ihren Abonnentenfeldern und zusätzlich mit all ihren Eingaben, die diese Abonnenten in bestimmten Formularen gemacht haben, auszulesen.

Request Properties

ProfileGuid
Die Id der Abonnentengruppe von welcher alle Abonnenten ausgelesen werden sollen. Wird für diese Eigenschaft kein Wert gesetzt, dann wird nach LastChange gefiltert.
Typ der Eigenschaft: GUID

LastChange
Es werden nur jene Abonnenten ausgelesen, die nach diesem Datum geändert wurden.
Wird auch für diese Eigenschaft kein Wert gesetzt, dann wird nach Conditions gefiltert.
Typ der Eigenschaft: DATETIME

Conditions
Die Bedingungen, die von den Abonnenten erfüllt sein müssen, damit diese ausgelesen werden.
Wird auch für diese Eigenschaft kein Wert gesetzt, dann wird nach SubscriberIds gefiltert.
Typ der Eigenschaft: Condition

SubscriberIds
Eine Liste jener Abonnenten-IDs, die ausgelesen werden sollen.
Wird auch für diese Eigenschaft kein Wert gesetzt, dann werden alle Abonnenten des Mandanten ausgelesen.
Typ der Eigenschaft: Array von GUIDs

ACHTUNG: Von den obenstehenden Request-Properties wird immer nur eines angewendet und zwar das erste das gesetzt wurde. Wenn also beispielweise eine ProfileGuid angegeben wird, dann macht es keinen Sinn zusätzlich noch LastChange zu setzen, da sowieso nur auf ProfileGuid gefiltert wird.


Fields
Eine Liste von Abonnentenfeldern, die ausgelesen werden sollen.
Typ der Eigenschaft: Array von Field

FormGuids
Eine Liste jener Formular-IDs von denen die Formularfelder ausgegeben werden sollen.
Typ der Eigenschaft: Array von GUIDs

Beispiel Request "Abonnenten mit Formularfeldern auslesen"

Der folgende Request gibt alle Abonnenten der angegebenen Abonnentengruppe mit ihren Metafeldern aus. Zusätzlich wird für jeden Abonnenten das Abonnentenfeld mit dem internen Namen „age“ ausgelesen. Außerdem werden für das angegebene Formular alle Formularfeldwerte geliefert.

JSON
//https://sys.mailworx.info/Services/JSON/ServiceAgent.svc/ExportSubscribersWithFormFields
{
    "request": {
        "Language": "DE",
        "SecurityContext": {
            "Username": "username",
            "Password": "*****",
            "Account": "account",
            "Source": "application name"
        },
        "ProfileGuid": "94175568-4ad0-400d-8a69-6f994675ecee",
        "Fields": {
            "Field": {
                "InternalName": "age"
            }
        },
        "FormGuids": {
            "FormGuid": "6cf5fc55-2270-4251-8435-d1388ef6f246"
        }
    }
}
XML
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ser="https://sys.mailworx.info/Services/ServiceAgent.asmx"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Header/>
   <soap:Body>
      <ser:GetMDBDirectories>
 	    <ser:request>
            <ser:Language>DE</ser:Language>
            <ser:SecurityContext>
               <ser:Account>account</ser:Account>
               <ser:Username>username</ser:Username>
               <ser:Password>*****</ser:Password>
               <ser:Source>application name</ser:Source>
            </ser:SecurityContext>
            <ser:Path>folder\sub-folder</ser:Path>
      </ser:request>
      </ser:GetMDBDirectories>
   </soap:Body>
</soap:Envelope>

Response Objekt

Subscribers
Eine Liste von Abonnenten mit ihren Metadaten und den Abonnentenfeldwerten, die über den Request-Parameter Fields zum Auslesen deklariert wurden.

FormFieldValues
Eine Liste mit den Informationen darüber, welche Eingaben die Abonnenten in den Formularen gemacht haben.
Für jedes Formular werden folgende Daten ausgelesen:

  • Die ID des Formulars.
  • Eine Liste von Formularfeld-Namen, die in diesem Formular vorkommen.
  • Eine Liste von den Abonnenten, die dieses Formular ausgefüllt haben, und dazu alle Werte der Formularfelder.