Salesforce

Beispiele für Verbindungskonfigurationen

In diesem Abschnitt finden Sie Beispielwerte für die verschiedenen Felder, die Sie beim Erstellen der Verbindung konfigurieren.

Verbindungstyp „Nutzername und Passwort“

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keinen der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Liste Operations aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und eine Ausgabe . Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Aktionen

Mit diesem Connector können Sie Salesforce-Daten einfügen, löschen, aktualisieren und lesen. Ausführung SQL-Abfragen verwenden, können Sie vom Connector die Funktion Benutzerdefinierte Abfrage ausführen Aktion ausführen.

So erstellen Sie eine benutzerdefinierte Abfrage:

1. Folgen Sie der detaillierten Anleitung zum Hinzufügen einer Connectors-Aufgabe.
2. Wählen Sie beim Konfigurieren der Connector-Aufgabe als Typ der auszuführenden Aktion die Option Aktionen aus.
3. Wählen Sie in der Liste Aktion die Option Benutzerdefinierte Abfrage ausführen aus und klicken Sie dann auf Fertig.

   

4. Maximieren Sie den Bereich Task Input und führen Sie dann die folgenden Schritte aus:
   1. Geben Sie im Feld Zeitüberschreitung nach die Anzahl der Sekunden ein, die bis zur Ausführung der Abfrage gewartet werden soll.

      Standardwert: 180 Sekunden.

   2. Geben Sie im Feld Maximale Zeilenanzahl die maximale Anzahl von Zeilen ein, die von der Datenbank zurückgegeben werden sollen.

      Standardwert: 25.

   3. Klicken Sie auf Benutzerdefiniertes Script bearbeiten, um die benutzerdefinierte Abfrage zu aktualisieren. Das Dialogfeld Skripteditor wird geöffnet.

      

   4. Geben Sie im Dialogfeld Skripteditor die SQL-Abfrage ein und klicken Sie auf Speichern.

      Sie können in einer SQL-Anweisung ein Fragezeichen (?) verwenden, um einen einzelnen Parameter darzustellen, der in der Liste der Abfrageparameter angegeben werden muss. Mit der folgenden SQL-Abfrage werden beispielsweise alle Zeilen aus der Tabelle Employees ausgewählt, die mit den für die Spalte LastName angegebenen Werten übereinstimmen:

      SELECT * FROM Employees where LastName=?

   5. Wenn Sie in Ihrer SQL-Abfrage Fragezeichen verwendet haben, müssen Sie den Parameter hinzufügen, indem Sie bei jedem Fragezeichen auf + Parameternamen hinzufügen klicken. Beim Ausführen der Integration ersetzen diese Parameter die Fragezeichen (?) in der SQL-Abfrage nacheinander. Wenn Sie beispielsweise drei Fragezeichen (?) hinzugefügt haben, müssen Sie drei Parameter in der richtigen Reihenfolge hinzufügen.

      

      So fügen Sie Abfrageparameter hinzu:

      1. Wählen Sie in der Liste Typ den Datentyp des Parameters aus.
      2. Geben Sie im Feld Wert den Wert des Parameters ein.
      3. Wenn Sie mehrere Parameter hinzufügen möchten, klicken Sie auf + Abfrageparameter hinzufügen.

In diesem Abschnitt werden die vom Salesforce-Connector unterstützten Aktionen aufgeführt. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

CreateJobv2-Aktion

Mit dieser Aktion können Sie einen Job erstellen.

Eingabeparameter der Aktion CreateJobV2

So konfigurieren Sie beispielsweise die Aktion CreateJobV2. Siehe Beispiele.

UploadJobDataV2-Aktion

Mit dieser Aktion können Sie eine Jobdatei im CSV-Format in Salesforce hochladen.

Eingabeparameter der Aktion UploadJobDataV2

Ein Beispiel für die Konfiguration der Aktion UploadJobDataV2 finden Sie unter Beispiele.

Aktion „CreateBatch“

Mit dieser Aktion wird ein Salesforce-Batch erstellt.

Eingabeparameter der Aktion „CreateBatch“

Ausgabeparameter der Aktion „CreateBatch“

So konfigurieren Sie beispielsweise die Aktion CreateBatch. Siehe Beispiele.

Aktion „CreateJob“

Dadurch wird ein Salesforce-Objekteintrag hinzugefügt.

Eingabeparameter der Aktion „CreateJob“

Ausgabeparameter der CreateJob-Aktion

Ein Beispiel für die Konfiguration der Aktion CreateJob finden Sie unter Beispiele.

GetBatch-Aktion

Mit dieser Aktion werden Informationen zu einem Salesforce-Batch abgerufen.

Eingabeparameter der GetBatch-Aktion

Ausgabeparameter der Aktion „GetBatch“

So konfigurieren Sie beispielsweise die Aktion GetBatch. Siehe Beispiele.

Aktion „GetJob“

Durch diese Aktion werden Informationen zu einem Salesforce-Job abgerufen.

Eingabeparameter der GetJob-Aktion

Ausgabeparameter der Aktion „GetJob“

Ein Beispiel für die Konfiguration der Aktion GetJob finden Sie unter Beispiele.

Aktion „UploadAttachment“

Durch diese Aktion wird ein Anhang hochgeladen und mit einer Entität in Salesforce verknüpft.

Eingabeparameter der UploadAttachment-Aktion

Ausgabeparameter der UploadAttachment-Aktion

Ein Beispiel für die Konfiguration der Aktion UploadAttachment finden Sie unter Beispiele.

Aktion „GetBatchResults“

Durch diese Aktion werden die Ergebnisse eines Salesforce-Batches abgerufen.

Eingabeparameter der Aktion „GetBatchResults“

Ausgabeparameter der Aktion „GetBatchResults“

So konfigurieren Sie beispielsweise die Aktion GetBatchResults. Siehe Beispiele.

Beispiele für Aktionen

Beispiel: CreateJobV2

In diesem Beispiel wird ein Job erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion CreateJobV2 aus und klicken Sie auf Fertig.
3. Klicken Sie im Abschnitt Task Input der Aufgabe Connectors auf connectorInputPayload. Geben Sie anschließend einen Wert wie den folgenden in das Feld Feld Default Value:

    {
     "ObjectName": "Contact",
     "Action": "insert"
    }

Wenn die Aktion erfolgreich ist, connectorOutputPayload-Antwort der Aufgabe von CREATEJOBV2 hat einen Wert ähnlich dem folgenden:

 
  [{
  "ID": "750dM000005HjdnQAC",
  "State": "Open",
  "JobType": null,
  "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches",
  "ContentType": "CSV",
  "CreatedDate": "2024-08-07T09:16:16.000+0000",
  "CreatedById": "005dM0000061WSFQA2",
  "ConcurrencyMode": "Parallel",
  "SystemModStamp": "2024-08-07T09:16:16.000+0000"
  }] 

Beispiel: UploadJobDataV2

In diesem Beispiel wird eine Jobdatei in Salesforce hochgeladen.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UploadJobDataV2 aus und klicken Sie auf Fertig.
3. Klicken Sie im Abschnitt Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Feld Default Value:

    {
     "Content":   "FirstName,LastName,Email,MobilePhone,External_Id__c\\nGinelle,Merioth,gmerioth0@example.com,851-555-8435,4d13cac0-2c11-48e9-891d-49ee9508a6c7\\nDalli,Tumilson,dtumilson1@example.com,881-555-6742,38bcb24b-247f-498b-9502-c98995a1e04b\\nRobbin,Purveys,rpurveys2@example.com,732-555-6909,35d96c7a-3856-4809-8c49-35ddb9fa7dd9\\nLothaire,Ivanchenkov,livanchenkov3@example.com,144-555-1959,75f63f26-6f4a-406f-a9f4-807f4a8a7b51",
     "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches"
    }

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe UploadJobDataV2 einen Wert, der in etwa so aussieht:

 
  [{
  "Uploaded": "true"
  }]

Beispiel – CreateBatch

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion CreateBatch aus und klicken Sie auf Fertig.
3. Im Bereich Datenzuordnung Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Feld Input:

   {
   "JobId": "750dL000007EipxQAC",
   "Aggregate": "\n    Walter\n    White\n  \n  \n    Rob\n    Brown\n  \n",
   "ContentType": "XML"
   }

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe CreateBatch einen Wert, der in etwa so aussieht:

 
[{
  "ID": "751dL000003ziC5QAI",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-03T04:48:53.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Queued",
  "StateMessage": null,
  "SystemModstamp": "2024-09-03T04:48:53.000Z",
  "TotalProcessingTime": "0"
}]

Beispiel: CreateJob

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion CreateJob aus und klicken Sie auf Fertig.
3. Im Bereich Datenzuordnung Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Feld Input:

   {
     "ObjectName": "Campaign",
     "Action": "insert"
   }

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe CreateJob einen Wert, der in etwa so aussieht:

 
 [{
  "ID": "750dL000007GgD7QAK",
  "JobID": "750dL000007GgD7QAK",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-03T05:31:41.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "0",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "0",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-03T05:31:41.000Z",
  "TotalProcessingTime": "0"
}]

Beispiel: GetBatch

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion GetBatch aus und klicken Sie auf Fertig.
3. Im Bereich Datenzuordnung Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Feld Input:

   {
     "BatchId": "751dL000003yKlJQAU",
     "JobId": "750dL000007EipxQAC"
   }

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe GetBatch einen Wert, der in etwa so aussieht:

 
[{
  "ID": "751dL000003yKlJQAU",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-02T11:44:15.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Failed",
  "StateMessage": "InvalidBatch : Failed to parse XML. Unexpected XML element 'sObject' found at  START_TAG seen ... @1:9 it should be 'sObjects'",
  "SystemModstamp": "2024-09-02T11:44:15.000Z",
  "TotalProcessingTime": "0"
}]

Beispiel: GetJob

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion GetJob aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input ein:

   {
     "JobId": "750dL000007EipxQAC"
   } 

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe GetJob einen Wert, der in etwa so aussieht:

 
[{
  "ID": "750dL000007EipxQAC",
  "JobID": "750dL000007EipxQAC",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-02T11:17:42.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "2",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "2",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-02T11:17:42.000Z",
  "TotalProcessingTime": "0"
}]

Beispiel – UploadAttachment

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UploadAttachment aus und klicken Sie auf Fertig.
3. Im Bereich Datenzuordnung Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Feld Input:

   {
     "ObjectId": "001dL00000SC6j7QAD",
     "FileName": "My files/salesforce/con.csv",
     "Base64Data": "Y29ubmVjdG9ycyBpcyBiYWNr"
   }

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe UploadAttachment einen Wert, der in etwa so aussieht:

 
[{
  "Id": "00PdL000000EJUDUA4"
}]

Beispiel: GetBatchResults

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion GetBatchResults aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input ein:

   {
     "BatchId": "751dL000004D17FQAS",
     "JobId": "750dL000007XKUhQAO",
     "ContentType": "XML"
   }

Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe GetBatchResults einen Wert, der in etwa so aussieht:

 
[{
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}, {
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}]

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird gezeigt, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Anhang erstellen

Mit „Entity create attachment“ wird nur ein Anhang ohne Inhaltsdatei erstellt. Um eine Datei hinzuzufügen, müssen wir die Aktion „Anhang hochladen“ ausführen. Dazu geben wir in der Eingabe einen Dateikontext an.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option „Anhang“ aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Abschnitt Data Mapper der Aufgabe auf OpenDataMapping-Editor und geben Sie in das Feld field:

   {
     "Name": "New Attachment",
     "Description": "New created attachment",
     "ParentId": "001dL00000SC6j7QAD",
     "Body": "Body"
   }
   

5. Wenn Sie dieses Beispiel ausführen, wird im Connector-Typ eine ähnliche Antwort wie die folgende zurückgegeben der connectorOutputPayload-Ausgabevariable der Aufgabe:

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

Beispiel – Anhang aktualisieren

Beim Aktualisieren eines Anhangs wird nur der Name oder die Beschreibung des Anhangs aktualisiert. Um eine Datei hinzuzufügen, müssen wir die Aktion Upload Attachment durchführen, indem wir einen Dateikontext in der Eingabe angeben.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option „Anhang“ aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „Anhang aktualisieren“ fest. Um die Entitäts-ID festzulegen, Klicken Sie im Abschnitt Data Mapper der Aufgaben auf Entitäts-ID und und geben Sie 00PdL000000EJKXUA4 in das entsprechende Feld ein.
5. Klicken Sie im Abschnitt Data Mapper der Aufgabe auf OpenDataMapping-Editor und geben Sie in das Feld field:

   {
     "Name": "New Attachment",
     "Description": "New updated attachment",
     "Body": "Body"
   }
   

Anstelle der entityId können Sie auch die filterClause auf 00PdL000000EJKXUA4 festlegen.

6. Wenn Sie dieses Beispiel ausführen, wird im Connector-Typ eine ähnliche Antwort wie die folgende zurückgegeben der connectorOutputPayload-Ausgabevariable der Aufgabe:

   {
     "Id": "00PdL000000EJKXUA4"
   }