Exportieren von Empfängern

Die Methode ExportSubscribers ermöglicht es, Empfänger aus mailworx zu exportieren.

Request Properties

ProfileGuid
Die Id der Zielgruppe von der die Empfänger ausgelesen werden sollen.
Typ der Eigenschaft: GUID

LastChange
Es werden nur jene Empfänger ausgelesen, die zuletzt nach dem angegebenen Datum geändert wurden.
Typ der Eigenschaft: DATE

Conditions
Die Bedingungen, die von den Empfängern erfüllt sein müssen, damit diese ausgelesen werden. Werden mehrere Bedingungen angegeben, so werden diese mit UND verknüpft.
Typ der Eigenschaft: Liste von Condition

SubscriberIds
Eine Liste jener Empfänger-Ids, deren zugehörige Empfänger ausgelesen werden sollen.
Typ der Eigenschaft: Liste von GUID

Fields
Eine Liste von Empfängerfeldern, die ausgelesen werden sollen.
Typ der Eigenschaft: Liste von Field

Beispiel Request "Exportieren von Empfängern"

Der folgende Request gibt alle Empfänger der angegebenen Empfängergruppe aus die zusätzlich auch den Nachnamen „Mustermann“ haben. Zusätzlich wird für jeden Empfänger das Empfängerfeld mit dem internen Namen „firstname“ ausgelesen.

JSON

//https://sys.mailworx.info/Services/JSON/ServiceAgent.svc/ExportSubscribers
{
  "request": {
    "Language": "DE",
    "SecurityContext": {
      "Account": "account",
      "Username": "username",
      "Password": "*****",
      "Source": "application name"
    },
    "ProfileGuid": "1ad0e7b2-83d2-4631-af34-f7ace5a78924",
    "Conditions":[
      {
        "Field":{
          "__type": "TextField:#Eworx.Mailworx.ServiceInterfaces",
          "InternalName": "lastname"
        },
        "Operator":0,
        "Value":"Mustermann"
      }
    ]
    "Fields": [
      {
        "__type": "TextField:#Eworx.Mailworx.ServiceInterfaces",
        "InternalName": "firstname"
      }
    ]
  }
}

XML

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
xmlns:ser="http://www.mailworx.at/interfaces/serviceagent/"  
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header/>
  <soap:Body>
    <ser:ExportSubscribers>
      <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:ProfileGuid>1ad0e7b2-83d2-4631-af34-f7ace5a78924</ser:ProfileGuid>
        <ser:Conditions>
		  <ser:Condition>
            <ser:Field  xsi:type="ser:TextField">
              <ser:InternalName>lastname</ser:InternalName>
            </ser:Field>
            <ser:Operator>Equals</ser:Operator>
            <ser:Value xsi:type="xsd:string">Mustermann</ser:Value>
          </ser:Condition>
        </ser:Conditions>
        <ser:Fields>
          <ser:Field  xsi:type="ser:TextField">
            <ser:InternalName>firstname</ser:InternalName>
          </ser:Field>
        </ser:Fields>
      </ser:request>
    </ser:ExportSubscribers>
  </soap:Body>
 </soap:Envelope>

Response Objekt

Subscribers
Eine Liste von Empfängern mit ihren Metadaten und den Empfängerfeldwerten, die über den Request-Parameter Fields zum Auslesen deklariert wurden.
Typ der Eigenschaft: Array von Subscriber

Newsletter Anmeldung

Tipps, Tricks und viele weitere nützliche Informationen direkt in Ihre Mailbox. Jetzt mailworx Newsletter abonnieren!