Salesforce Marketing Cloud

Beispiel: Alle Assets auflisten

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Assets aus der Liste Entity aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause gemäß den Kundenanforderungen festlegen.

Sie müssen einfache Anführungszeichen (') verwenden, um den Wert für eine Filterklausel einzuschließen. Der Wert muss direkt übergeben werden, z. B. CategoryName='Content Builder'. Dabei ist „CategoryName“ der Spaltenname und „Content Builder“ der Wert.

Mit der Filterklausel können Sie Datensätze anhand der Spalten filtern. Wenn Sie beispielsweise Datensätze filtern möchten, verwenden Sie die folgende Filterklausel: Location='US' und region='us-east1'

In bestimmten Fällen kann das Übergeben einer Entitäts-ID einen Fehler auslösen. In solchen Fällen können Sie die Filterklausel verwenden, z. B. id=172.

Beispiel: Assets-Datensatz abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Assets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf 49851.0 fest. Dies ist der zu übergebende Schlüssel. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Aufgabeneingabe der Aufgabe Connectors auf EntityId und geben Sie dann 49851.0 in das Feld Standardwert ein.

   Der Wert für „Entity ID“ sollte direkt übergeben werden, z. B. „Id= 49851.0“. Hier ist 49851.0 der eindeutige Primärschlüsselwert, der übergeben werden sollte.

Beispiel: Asset-Datensatz löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Assets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf 49851.0 fest. Dies ist der Schlüssel, der übergeben werden soll. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Aufgabeneingabe der Aufgabe Connectors auf EntityId und geben Sie dann 49851.0 in das Feld Standardwert ein.

   Der Wert für „Entity ID“ sollte direkt übergeben werden, z. B. ID= 49851.0. Hier ist 49851.0 der eindeutige Primärschlüsselwert, der übergeben werden sollte.

Beispiel: DataExtensionObject_Custom-Datensatz erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie DataExtensionObject_Custom aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "StudentName":"Cruz",
   "StudentID":"1",
   "Rank":"1"}
   

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
     "StudentID": 1
   } 

Beispiel: Asset-Datensatz erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Assets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Name": "Googlecloud_Created_HTMLEmail_Testing_V1",
     "TypeName": "htmlemail",
     "TypeId": 208.0
   }

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
     "Id": 60188.0
   }

Beispiel: Kampagnendatensatz erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Campaigns aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Name": "Campaigns - Tested via Googlecloud",
     "CampaignCode": "annual2023",
     "Color": "0000ff",
     "Favorite": false
   }

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
     "Id": 247.0
   } 

Beispiel: Journeys-Eintrag erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Journeys aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Version": 1.0,
     "Name": "API_Journey_Googlecloud_Retest_1",
     "CreatedDate": "2023-04-26 04:20:29.87",
     "ModifiedDate": "2023-05-10 07:45:06.04",
     "LastPublishedDate": "2023-04-26 04:37:18.0",
     "Description": "API_Journey_Googlecloud_Retest_1",
     "WorkFlowApiVersion": 1.0,
     "Tags": null,
     "Goals": "",
     "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
     "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
   }

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
     "Id": "aa03afe4-6a28-481f-bec4-564712127414"
   }

Beispiel: Listeneintrag erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie List aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "ID": "04052023.0",
     "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
     "PartnerKey": "null",
     "CreatedDate": "2023-03-16 10:52:48.097",
     "ModifiedDate": "2023-03-17 10:30:34.497",
     "Client_ID": "5.14012689E8",
     "Client_PartnerClientKey": null,
     "ListName": "Googlecloud_Created_Subscriber_List",
     "Description": "null",
     "Category": "15449.0",
     "Type": "Public",
     "CustomerKey": "Googlecloud_BCONE",
     "ListClassification": "ExactTargetList",
     "AutomatedEmail_ID": "null"
   }

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
     "Id": 4052023.0
   }

Beispiel: Abonnentendatensatz erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Subscriber aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "EmailAddress": "baklavainthebalkans@gmail.com",
     "SubscriberKey": "KB1"
   }

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
     "Success": true
   }

Beispiel: DataExtensionObject_Custom-Datensatz aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie DataExtensionObject_Custom aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "StudentName":"Charlie",
   "Rank":"1"
   }
   

5. Legen Sie die Entitäts-ID auf z. B. 103032 fest. Dies ist der Primärschlüssel, der übergeben werden soll. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann 10 in das Feld Standardwert ein.

   Wenn die Entität zusammengesetzte Geschäfts- oder Primärschlüssel hat, können Sie anstelle der entityId auch die filterClause auf Rank='1' and StudentID='10' festlegen.

Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

{
    "StudentID": 1
}

Beispiel: Assets-Datensatz aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity „Assets“ aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Description": "June2023-Updated"
   }
   

5. Legen Sie die Entitäts-ID auf die Entität der Assets fest . Klicken Sie zum Festlegen der Entitäts-ID auf entityId und geben Sie dann 52080 in das Feld Standardwert ein.

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

   {
     "Id": 52080.0
   }
   

Beispiel: Journeys-Datensatz aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Journeys aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. Legen Sie die Entitäts-ID auf die Entität der Journeys fest . Klicken Sie zum Festlegen der Entitäts-ID auf entityId und geben Sie dann 0868BF36-3107-460E-9EF1-09633A0592E8 in das Feld Standardwert ein.

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

   {
     "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
   }
   

Beispiel: Datensatz in einer Liste aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie List aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Description": "UpdatedDescription"
   }
   

5. Legen Sie die Entitäts-ID auf die Entität der Liste fest . Klicken Sie zum Festlegen der Entitäts-ID auf entityId und geben Sie dann 1234 in das Feld Standardwert ein.

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

   {
     "ID": 1234.0
   }