Salesforce

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

Tipo di connessione con nome utente e password

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questo connettore consente di eseguire operazioni di inserimento, eliminazione, aggiornamento e lettura sui dati di Salesforce. Per eseguire query SQL personalizzate, il connettore fornisce l'azione Esegui query personalizzata.

Per creare una query personalizzata:

1. Segui le istruzioni dettagliate per aggiungere un'attività di connettori.
2. Quando configuri l'attività del connettore, seleziona Azioni nel tipo di azione che vuoi eseguire.
3. Nell'elenco Azione, seleziona Esegui query personalizzata, quindi fai clic su Fine.

   

4. Espandi la sezione Input attività e poi segui questi passaggi:
   1. Nel campo Timeout dopo, inserisci il numero di secondi di attesa prima dell'esecuzione della query.

      Valore predefinito: 180 secondi.

   2. Nel campo Numero massimo di righe, inserisci il numero massimo di righe da restituire dal database.

      Valore predefinito: 25.

   3. Per aggiornare la query personalizzata, fai clic su Modifica script personalizzato. Si apre la finestra di dialogo Editor di script.

      

   4. Nella finestra di dialogo Editor di script, inserisci la query SQL e fai clic su Salva.

      Puoi utilizzare un punto interrogativo (?) in un'istruzione SQL per rappresentare un singolo parametro che deve essere specificato nell'elenco parametri di ricerca. Ad esempio, la seguente query SQL seleziona tutte le righe della tabella Employees che corrispondono ai valori specificati per la colonna LastName:

      SELECT * FROM Employees where LastName=?

   5. Se hai utilizzato punti interrogativi nella query SQL, devi aggiungere il parametro facendo clic su + Aggiungi nome parametro per ogni punto interrogativo. Durante l'esecuzione dell'integrazione, questi parametri sostituiscono in sequenza i punti interrogativi (?) nella query SQL. Ad esempio, se hai aggiunto tre punti interrogativi (?), devi aggiungere tre parametri in ordine di sequenza.

      

      Per aggiungere parametri di ricerca:

      1. Nell'elenco Tipo, seleziona il tipo di dati del parametro.
      2. Nel campo Valore, inserisci il valore del parametro.
      3. Per aggiungere più parametri, fai clic su + Aggiungi parametro di query.

Il connettore Salesforce non supporta i valori con parametri per la clausola OFFSET e non può essere sostituito dinamicamente utilizzando parametri di ricerca. Tuttavia, i parametri di ricerca sono supportati nella clausola WHERE.

Questa sezione elenca le azioni supportate dal connettore Salesforce. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione CreateJobv2

Utilizza questa azione per creare un job.

Parametri di input dell'azione CreateJobV2

Per un esempio di come configurare l'azione CreateJobV2, consulta Esempi.

Azione UploadJobDataV2

Utilizza questa azione per caricare un file di lavoro in formato CSV su Salesforce.

Parametri di input dell'azione UploadJobDataV2

Per un esempio di come configurare l'azione UploadJobDataV2, vedi Esempi.

Azione CreateBatch

Questa azione crea un batch Salesforce.

Parametri di input dell'azione CreateBatch

Parametri di output dell'azione CreateBatch

Per un esempio di come configurare l'azione CreateBatch, consulta Esempi.

Azione CreateJob

Questa azione aggiunge una voce dell'oggetto Salesforce.

Parametri di input dell'azione CreateJob

Parametri di output dell'azione CreateJob

Per un esempio di come configurare l'azione CreateJob, consulta Esempi.

Azione GetBatch

Questa azione recupera informazioni su un batch Salesforce.

Parametri di input dell'azione GetBatch

Parametri di output dell'azione GetBatch

Per un esempio di come configurare l'azione GetBatch, consulta Esempi.

Azione GetJob

Questa azione recupera informazioni su un job Salesforce.

Parametri di input dell'azione GetJob

Parametri di output dell'azione GetJob

Per un esempio di come configurare l'azione GetJob, consulta Esempi.

Azione UploadAttachment

Questa azione carica un allegato e lo associa a un'entità in Salesforce.

Parametri di input dell'azione UploadAttachment

Parametri di output dell'azione UploadAttachment

Per un esempio di come configurare l'azione UploadAttachment, vedi Esempi.

Azione GetBatchResults

Questa azione recupera i risultati di un batch Salesforce.

Parametri di input dell'azione GetBatchResults

Parametri di output dell'azione GetBatchResults

Per un esempio di come configurare l'azione GetBatchResults, vedi Esempi.

Esempi di azioni

Esempio: CreateJobV2

Questo esempio crea un job.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateJobV2, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi devi inserire un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro CREATEJOBV2 della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
  [{
  "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"
  }] 

Esempio: UploadJobDataV2

Questo esempio carica un file di lavoro su Salesforce.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UploadJobDataV2, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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"
    }

Se l'azione ha esito positivo, il parametro UploadJobDataV2 della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
  [{
  "Uploaded": "true"
  }]

Esempio: CreateBatch

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateBatch, quindi fai clic su Fine.
3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:

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

Se l'azione ha esito positivo, il parametro CreateBatch della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
[{
  "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"
}]

Esempio - CreateJob

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateJob, quindi fai clic su Fine.
3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:

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

Se l'azione ha esito positivo, il parametro CreateJob della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
 [{
  "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"
}]

Esempio - GetBatch

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione GetBatch, quindi fai clic su Fine.
3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:

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

Se l'azione ha esito positivo, il parametro GetBatch della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
[{
  "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"
}]

Esempio: GetJob

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione GetJob , quindi fai clic su Fine.
3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:

   {
     "JobId": "750dL000007EipxQAC"
   } 

Se l'azione ha esito positivo, il parametro GetJob della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
[{
  "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"
}]

Esempio - UploadAttachment

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UploadAttachment, quindi fai clic su Fine.
3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:

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

Se l'azione ha esito positivo, il parametro UploadAttachment della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio - GetBatchResults

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione GetBatchResults, quindi fai clic su Fine.
3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:

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

Se l'azione ha esito positivo, il parametro GetBatchResults della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

 
[{
  "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"
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: creare un allegato

L'allegato di creazione dell'entità crea solo un allegato senza file di contenuti. Per aggiungere un file, dobbiamo eseguire l'azione Carica allegato fornendo un contesto di file nell'input.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Allegato dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'editor Task, fai clic su OpenDataMapping e poi inserisci un valore simile al seguente in field:

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

5. L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

Esempio: aggiorna un allegato

L'allegato di aggiornamento dell'entità aggiorna solo il nome o la descrizione dell'allegato. Per aggiungere un file, dobbiamo eseguire l'azione Carica allegato fornendo un contesto di file nell'input.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Allegato dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Imposta l'ID entità per aggiornare un allegato. Per impostare l'ID entità, nella sezione Data Mapper di Attività, fai clic su EntityID e poi inserisci 00PdL000000EJKXUA4 nel campo specificato.
5. Nella sezione Data Mapper dell'editor Task, fai clic su OpenDataMapping e poi inserisci un valore simile al seguente in field:

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

In alternativa, anziché specificare entityId, puoi anche impostare filterClause su 00PdL000000EJKXUA4.

6. L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
     "Id": "00PdL000000EJKXUA4"
   }