Salesforce

Beispiele für Verbindungskonfigurationen

In diesem Abschnitt werden die Beispielwerte für die verschiedenen Felder aufgeführt, 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 keine der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Operations-Liste 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 einen Ausgabeparameter. 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 Vorgänge zum Einfügen, Löschen, Aktualisieren und Lesen von Salesforce-Daten ausführen. Zum Ausführen benutzerdefinierter SQL-Abfragen bietet der Connector die Aktion Benutzerdefinierte Abfrage ausführen.

So erstellen Sie eine benutzerdefinierte Abfrage:

1. Folgen Sie der detaillierten Anleitung zum Hinzufügen einer Connectors-Aufgabe.
2. Wenn Sie die Connector-Aufgabe konfigurieren, wählen Sie unter „Art 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 Abschnitt Aufgabeneingabe und gehen Sie dann so vor:
   1. Geben Sie im Feld Zeitlimit nach die Anzahl der Sekunden ein, die gewartet werden soll, bis die Abfrage ausgeführt wird.

      Standardwert: 180 Sekunden.

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

      Standardwert: 25.

   3. Wenn Sie die benutzerdefinierte Abfrage aktualisieren möchten, klicken Sie auf Benutzerdefiniertes Skript bearbeiten. Das Dialogfeld Skripteditor wird geöffnet.

      

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

      Sie können ein Fragezeichen (?) in einer SQL-Anweisung 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 den für die Spalte LastName angegebenen Werten entsprechen:

      SELECT * FROM Employees where LastName=?

   5. Wenn Sie Fragezeichen in Ihrer SQL-Abfrage verwendet haben, müssen Sie den Parameter hinzufügen, indem Sie für jedes Fragezeichen auf + Parameternamen hinzufügen klicken. Bei der Ausführung der Integration werden diese Parameter sequenziell durch die Fragezeichen (?) in der SQL-Abfrage ersetzt. 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.

Der Salesforce-Connector unterstützt keine parametrisierten Werte für die OFFSET-Klausel. Sie können nicht dynamisch durch Abfrageparameter ersetzt werden. Abfrageparameter werden jedoch in der WHERE-Klausel unterstützt.

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.

Aktion „CreateJobv2“

Mit dieser Aktion können Sie einen Job erstellen.

Eingabeparameter der Aktion „CreateJobV2“

Beispiele für die Konfiguration der Aktion CreateJobV2 finden Sie unter Beispiele.

Aktion „UploadJobDataV2“

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

Eingabeparameter der Aktion „UploadJobDataV2“

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

CreateBatch-Aktion

Mit dieser Aktion wird ein Salesforce-Batch erstellt.

Eingabeparameter der Aktion „CreateBatch“

Ausgabeparameter der CreateBatch-Aktion

Beispiele für die Konfiguration der Aktion CreateBatch finden Sie unter Beispiele.

CreateJob-Aktion

Mit dieser Aktion wird ein Salesforce-Objekteintrag hinzugefügt.

Eingabeparameter der Aktion „CreateJob“

Ausgabeparameter der Aktion „CreateJob“

Beispiele 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 GetBatch-Aktion

Beispiele für die Konfiguration der Aktion GetBatch finden Sie unter Beispiele.

GetJob-Aktion

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

Eingabeparameter der GetJob-Aktion

Ausgabeparameter der GetJob-Aktion

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

Aktion „UploadAttachment“

Mit dieser Aktion wird ein Anhang hochgeladen und einer Einheit in Salesforce zugeordnet.

Eingabeparameter der Aktion „UploadAttachment“

Ausgabeparameter der Aktion „UploadAttachment“

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

GetBatchResults-Aktion

Mit dieser Aktion werden die Ergebnisse eines Salesforce-Batches abgerufen.

Eingabeparameter der GetBatchResults-Aktion

Ausgabeparameter der GetBatchResults-Aktion

Beispiele für die Konfiguration der Aktion GetBatchResults finden Sie unter 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 Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

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

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CREATEJOBV2-Vorgangs einen Wert, der dem folgenden ähnelt:

 
  [{
  "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 Job-Datei 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 Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

    {
     "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 ist, hat der Antwortparameter connectorOutputPayload des UploadJobDataV2-Vorgangs einen Wert, der dem folgenden ähnelt:

 
  [{
  "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. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in Feld Input ein:

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

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CreateBatch-Vorgangs einen Wert, der dem folgenden ähnelt:

 
[{
  "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. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in Feld Input ein:

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

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CreateJob-Vorgangs einen Wert, der dem folgenden ähnelt:

 
 [{
  "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. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in Feld Input ein:

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

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des GetBatch-Vorgangs einen Wert, der dem folgenden ähnelt:

 
[{
  "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 Feld Input ein:

   {
     "JobId": "750dL000007EipxQAC"
   } 

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des GetJob-Vorgangs einen Wert, der dem folgenden ähnelt:

 
[{
  "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. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in Feld Input ein:

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

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UploadAttachment-Vorgangs einen Wert, der dem folgenden ähnelt:

 
[{
  "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 Feld Input ein:

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

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des GetBatchResults-Vorgangs einen Wert, der dem folgenden ähnelt:

 
[{
  "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 beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Anhang erstellen

Beim Erstellen einer Anlage für eine Entität wird nur eine Anlage ohne Inhaltsdatei erstellt. Um eine Datei hinzuzufügen, müssen wir die Aktion „Anhang hochladen“ ausführen und dabei 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 Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenzuordnung der Aufgabe auf den OpenDataMapping-Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld field: ein:

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

5. Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

Beispiel: Anhang aktualisieren

Bei einem Anhang zur Aktualisierung einer Entität wird nur der Name oder die Beschreibung des Anhangs aktualisiert. Um eine Datei hinzuzufügen, müssen wir die Aktion „Anhang hochladen“ ausführen und dabei 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 fest, um eine Anlage zu aktualisieren. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Data Mapper der Aufgaben auf EntityID und geben Sie dann 00PdL000000EJKXUA4 in das entsprechende Feld ein.
5. Klicken Sie im Bereich Datenzuordnung der Aufgabe auf den OpenDataMapping-Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld field: ein:

   {
     "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 eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

   {
     "Id": "00PdL000000EJKXUA4"
   }