Lesen aus Salesforce-Marketing-Cloud-Entitäten

Voraussetzung

Ein Salesforce-Marketing-Cloud-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen wie Activity oder Campaigns. Die folgende Tabelle zeigt die unterstützten Entitäten.

Unterstützte Entitäten für Quelle:

Entität	Schnittstelle	Kann gefiltert werden	Unterstützt Limit	Unterstützt „Sortieren nach“	Unterstützt „* SELECT“	Unterstützt Partitionierung
Ereignisbenachrichtigung-Callback	REST	Nein	Nein	Nein	Ja	Nein
Seed-Liste	REST	Nein	Ja	Nein	Ja	Nein
Einrichtung	REST	Ja	Ja	Nein	Ja	Nein
Domänenverifizierung	REST	Ja	Ja	Ja	Ja	Nein
Verschachtelte Objekt-Tags	REST	Ja	Nein	Nein	Ja	Nein
Kontakt	REST	Nein	Ja	Nein	Ja	Nein
Abonnement für Ereignisbenachrichtigung	REST	Nein	Nein	Nein	Ja	Nein
Messaging	REST	Nein	Ja	Nein	Ja	Nein
Aktivität	SOAP	Nein	Nein	Nein	Ja	Ja
Bounce-Ereignis	SOAP	Nein	Nein	Nein	Ja	Ja
Klickereignis	SOAP	Nein	Nein	Nein	Ja	Ja
Inhaltsbereich	SOAP	Nein	Nein	Nein	Ja	Ja
Datenerweiterung	SOAP	Nein	Ja	Nein	Ja	Ja
Email	SOAP	Nein	Ja	Nein	Ja	Ja
Ereignis Weitergeleitete E-Mail	SOAP	Nein	Ja	Nein	Ja	Ja
E-Mail weiterleiten OptInEvent	SOAP	Nein	Ja	Nein	Ja	Ja
Link	SOAP	Nein	Ja	Nein	Ja	Ja
Link senden	SOAP	Nein	Ja	Nein	Ja	Ja
Auflisten	SOAP	Nein	Ja	Nein	Ja	Ja
Liste von Abonnenten	SOAP	Nein	Ja	Nein	Ja	Ja
Ereignis Nicht gesendet	SOAP	Nein	Ja	Nein	Ja	Ja
Ereignis Öffnen	SOAP	Nein	Ja	Nein	Ja	Ja
Senden	SOAP	Nein	Ja	Nein	Ja	Ja
Ereignis Gesendet	SOAP	Nein	Ja	Nein	Ja	Ja
Subscriber	SOAP	Nein	Ja	Nein	Ja	Ja
Ereignis Umfrage	SOAP	Nein	Ja	Nein	Ja	Ja
Ereignis Abonnement beenden	SOAP	Nein	Ja	Nein	Ja	Ja
Prüfungsereignisse	REST	Nein	Ja	Ja	Ja	Nein
Kampagnen	REST	Nein	Ja	Ja	Ja	Nein
Interaktionen	REST	Nein	Ja	Ja	Ja	Nein
Inhalts-Assets	REST	Nein	Ja	Ja	Ja	Nein

Beispiel für REST:


salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)

Beispiel für SOAP:


salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Activity",
        "API_VERSION": "v1",
        "INSTANCE_URL": "https://**********************.soap.marketingcloudapis.com"
    }
)

Entitäts- und Felddetails zu Salesforce Marketing Cloud:

In den folgenden Tabellen werden die Salesforce-Marketing-Cloud-Entitäten beschrieben. Es gibt REST-Entitäten mit statischen Metadaten und SOAP-Entitäten mit dynamischen Metadaten.

REST-Entitäten mit statischen Metadaten:

Entität	Feld	Datentyp	Unterstützte Operatoren
Ereignisbenachrichtigung-Callback	callbackId	Zeichenfolge
	callbackName	Zeichenfolge
	URL	Zeichenfolge
	maxBatchSize	Ganzzahl
	Status	Zeichenfolge
	statusReason	Zeichenfolge
Seed-Liste	id	Zeichenfolge
	Name	Zeichenfolge
	description	Zeichenfolge
	activeSeedCount	Ganzzahl
Einrichtung	customerKey	Zeichenfolge
	Name	Zeichenfolge
	description	Zeichenfolge
	locationType	Zeichenfolge	'='
	awsFileTransferSpeicherort	Struct
Domain-Verifizierung	enterpriseId	Ganzzahl
	Status	Zeichenfolge	'='
	domainType	Zeichenfolge	'='
	memberId	Ganzzahl
	emailSendTime	DateTime
	Domain	Zeichenfolge
	isSendable	Boolesch
Verschachtelte Objekt-Tags	id	Ganzzahl
	modifiedDate	DateTime
	tags	Auflisten
	Name	Zeichenfolge
	description	Zeichenfolge
	parentId	Ganzzahl
Kontakt	values	Auflisten
Abonnement für Ereignisbenachrichtigung	subscriptionName	Zeichenfolge
	callbackId	Zeichenfolge
	callbackName	Zeichenfolge
	eventCategoryTypes	Auflisten
	-Filter	Auflisten
	URL	Zeichenfolge
	maxBatchSize	Ganzzahl
	subscriptionId	Zeichenfolge
	Status	Zeichenfolge
	statusReason	Zeichenfolge
Messaging	deliveryTime	DateTime
	id	Zeichenfolge
	messageId	Zeichenfolge
	Status	Zeichenfolge
	to	Struct
Interaktionen	Status	Zeichenfolge	'='
	id	Zeichenfolge
	Schlüssel	Zeichenfolge
	Name	Zeichenfolge
	lastPublishedDate	DateTime
	description	Zeichenfolge
	version	Ganzzahl
	workflowApiVersion	Ganzzahl
	createdDate	DateTime
	modifiedDate	DateTime
	goals	Struct
	stats	Struct
	entryMode	Zeichenfolge
	defaults	Struct
	executionMode	Struct
	definitionId	Zeichenfolge
Inhalts-Assets	id	Ganzzahl
	customerKey	Zeichenfolge
	objectId	Zeichenfolge
	contentType	Zeichenfolge
	assetType	Struct
	Name	Zeichenfolge
	description	Zeichenfolge
	owner	Struct
	createdDate	DateTime
	createdBy	Struct
	modifiedDate	DateTime
	modifiedBy	Struct
	thumbnail	Struct
	category	Struct
	meta	Struct
	Ansichten	Struct
	availableViews	Struct
	data	Struct
	legacyData	Struct
	modelVersion	Ganzzahl
	Version	Ganzzahl
	Gesperrt	Boolesch
	FileProperties	Struct
	Tags (Markierungen)	Auflisten
	Inhalt	Zeichenfolge
	Design	Zeichenfolge
	SuperContent	Zeichenfolge
	CustomFields	Struct
	Blöcke	Struct
	MinBlocks	Ganzzahl
	MaxBlocks	Ganzzahl
	Kanäle	Struct
	AllowedBlocks	Auflisten
	Slots	Struct
	BusinessUnitAvailability	Struct
	sharingProperties	Struct
	sharingProperties.sharedWith	Struct
	sharingProperties.sharingType	Zeichenfolge
	Vorlage	Struct
	Datei	Zeichenfolge
	GenerateFrom	Zeichenfolge
Prüfungsereignisse	id	Ganzzahl
	createdDate	DateTime
	memberId	Ganzzahl
	enterpriseId	Ganzzahl
	employee	Struct
	objectType	Struct
	operation	Struct
	object	Struct
	transactionId	Zeichenfolge
Kampagnen	id	Ganzzahl
	createdDate	DateTime
	modifiedDate	DateTime
	Name	Zeichenfolge
	description	Zeichenfolge
	campaignCode	Zeichenfolge
	color	Zeichenfolge
	favorite	Boolesch

SOAP-Entitäten mit dynamischen Metadaten:

Entität	Datentyp	Unterstützte Operatoren
Aktivität	Zeichenfolge	LIKE,!=,=
	Struct
	Ganzzahl	!=,=,>=,<=,<,>
	Double	!=,=,>=,<=,<,>
	Boolesch	!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
Bounce-Ereignis	Ganzzahl	!=,=,>=,<=,<,>
	DateTime	>=,<=,<,>,=,BETWEEN
	Zeichenfolge	LIKE,!=,=
	Struct
Klickereignis	Ganzzahl	!=,=,>=,<=,<,>
	DateTime	>=,<=,<,>,=,BETWEEN
	Zeichenfolge	LIKE,!=,=
	Struct
Inhaltsbereich	Struct
	Zeichenfolge	LIKE,!=,=
	Ganzzahl	!=,=,>=,<=,<,>
	DateTime	>=,<=,<,>,=,BETWEEN
	Boolesch	!=,=
Datenerweiterung	DateTime	>=,<=,<,>,=,BETWEEN
Datenerweiterung	Zeichenfolge	LIKE,!=,=
Email	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Boolesch	!=,=
	Struct
Ereignis Weitergeleitete E-Mail	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
E-Mail weitergeleitet OptInEvent	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Link	Ganzzahl	!=,=,>=,<=,<,>
Link senden	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	Double	!=,=,>=,<=,<,>
Auflisten	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Liste von Abonnenten	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Ereignis Nicht gesendet	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Ereignis Öffnen	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Senden	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Boolesch	!=,=
	Struct
Ereignis Gesendet	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Subscriber	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Ereignis Umfrage	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Struct
Ereignis Abonnement beenden	Ganzzahl	!=,=,>=,<=,<,>
	Zeichenfolge	LIKE,!=,=
	DateTime	>=,<=,<,>,=,BETWEEN
	Boolesch	!=,=
	Struct

Partitionierung von Abfragen

In Salesforce Marketing Cloud unterstützen die Felder Integer und DateTime Datentyp die feldbasierte Partitionierung.

Sie können die zusätzlichen Spark-Optionen PARTITION_FIELD,LOWER_BOUND, UPPER_BOUND und NUM_PARTITIONS angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern wird die ursprüngliche Abfrage in NUM_PARTITIONS Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.

PARTITION_FIELD: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll.
LOWER_BOUND: ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.

Für das Timestamp-Feld akzeptieren wir das Spark-Zeitstempelformat, das in Spark-SQL-Abfragen verwendet wird.

Beispiele für gültigen Wert:
```
“2024-05-07T02:03:00.00Z"
```
UPPER_BOUND: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds.
NUM_PARTITIONS: Die Anzahl an Partitionen.

Beispiel:


salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "ListSubscriber",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "CreatedDate",
        "LOWER_BOUND": "2023-09-07T02:03:00.000Z",
        "UPPER_BOUND": "2024-05-07T02:03:00.000Z",
        "NUM_PARTITIONS": "10"
    }
)

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Konfigurieren von Verbindungen mit Salesforce Marketing Cloud

Schreiben in Entitäten von Salesforce Marketing Cloud