Salesforce

Ejemplos de configuración de conexiones

En esta sección se indican los valores de ejemplo de los distintos campos que se configuran al crear la conexión.

Tipo de conexión con nombre de usuario y contraseña

Acciones

Este conector te permite insertar, eliminar, actualizar y leer datos de Salesforce. Para ejecutar consultas de SQL personalizadas, el conector proporciona la acción Ejecutar consulta personalizada.

Para crear una consulta personalizada, sigue estos pasos:

1. Sigue las instrucciones detalladas para añadir una tarea de conectores.
2. Cuando configure la tarea del conector, en el tipo de acción que quiera realizar, seleccione Acciones.
3. En la lista Acción, selecciona Ejecutar consulta personalizada y, a continuación, haz clic en Hecho.

   

4. Despliega la sección Entrada de la tarea y, a continuación, haz lo siguiente:
   1. En el campo Tiempo de espera tras, introduce el número de segundos que deben transcurrir hasta que se ejecute la consulta.

      Valor predeterminado: 180 segundos.

   2. En el campo Número máximo de filas, introduzca el número máximo de filas que se devolverán de la base de datos.

      Valor predeterminado: 25.

   3. Para actualizar la consulta personalizada, haz clic en Editar secuencia de comandos personalizada. Se abrirá el cuadro de diálogo Editor de secuencias de comandos.

      

   4. En el cuadro de diálogo Editor de secuencias de comandos, introduce la consulta de SQL y haz clic en Guardar.

      Puedes usar un signo de interrogación (?) en una instrucción SQL para representar un único parámetro que debe especificarse en la lista de parámetros de la consulta. Por ejemplo, la siguiente consulta SQL selecciona todas las filas de la tabla Employees que coinciden con los valores especificados en la columna LastName:

      SELECT * FROM Employees where LastName=?

   5. Si has usado signos de interrogación en tu consulta SQL, debes añadir el parámetro haciendo clic en + Añadir nombre de parámetro por cada signo de interrogación. Durante la ejecución de la integración, estos parámetros sustituyen secuencialmente los signos de interrogación (?) de la consulta de SQL. Por ejemplo, si has añadido tres signos de interrogación (?), debes añadir tres parámetros en orden de secuencia.

      

      Para añadir parámetros de consulta, siga estos pasos:

      1. En la lista Tipo, seleccione el tipo de datos del parámetro.
      2. En el campo Valor, introduzca el valor del parámetro.
      3. Para añadir varios parámetros, haga clic en + Añadir parámetro de consulta.

   La acción Ejecutar consulta personalizada no admite variables de matriz.

El conector de Salesforce no admite valores parametrizados para la cláusula OFFSET y no se puede sustituir de forma dinámica mediante parámetros de consulta. Sin embargo, se admiten parámetros de consulta en la cláusula WHERE.

En esta sección se enumeran las acciones admitidas por el conector de Salesforce. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción CreateJobv2

Usa esta acción para crear un trabajo.

Parámetros de entrada de la acción CreateJobV2

Para ver un ejemplo de cómo configurar la acción CreateJobV2, consulta Ejemplos.

Acción UploadJobDataV2

Usa esta acción para subir un archivo de trabajo en formato CSV a Salesforce.

Parámetros de entrada de la acción UploadJobDataV2

Para ver un ejemplo de cómo configurar la acción UploadJobDataV2, consulta Ejemplos.

Acción CreateBatch

Esta acción crea un lote de Salesforce.

Parámetros de entrada de la acción CreateBatch

Parámetros de salida de la acción CreateBatch

Para ver un ejemplo de cómo configurar la acción CreateBatch, consulta Ejemplos.

Acción CreateJob

Esta acción añade una entrada de objeto de Salesforce.

Parámetros de entrada de la acción CreateJob

Parámetros de salida de la acción CreateJob

Para ver un ejemplo de cómo configurar la acción CreateJob, consulta Ejemplos.

Acción GetBatch

Esta acción obtiene información sobre un lote de Salesforce.

Parámetros de entrada de la acción GetBatch

Parámetros de salida de la acción GetBatch

Para ver un ejemplo de cómo configurar la acción GetBatch, consulta Ejemplos.

Acción GetJob

Esta acción obtiene información sobre un trabajo de Salesforce.

Parámetros de entrada de la acción GetJob

Parámetros de salida de la acción GetJob

Para ver un ejemplo de cómo configurar la acción GetJob, consulta Ejemplos.

Acción UploadAttachment

Esta acción sube un archivo adjunto y lo asocia a una entidad de Salesforce.

Parámetros de entrada de la acción UploadAttachment

Parámetros de salida de la acción UploadAttachment

Para ver un ejemplo de cómo configurar la acción UploadAttachment, consulta Ejemplos.

Acción GetBatchResults

Esta acción obtiene los resultados de un lote de Salesforce.

Parámetros de entrada de la acción GetBatchResults

Parámetros de salida de la acción GetBatchResults

Para ver un ejemplo de cómo configurar la acción GetBatchResults, consulta Ejemplos.

Ejemplos de acciones

Ejemplo: CreateJobV2

En este ejemplo se crea un trabajo.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateJobV2 y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, debes introducir un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CREATEJOBV2 tendrá un valor similar al siguiente:

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

Ejemplo: UploadJobDataV2

En este ejemplo se sube un archivo de trabajo a Salesforce.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadJobDataV2 y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el 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"
    }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UploadJobDataV2 tendrá un valor similar al siguiente:

 
  [{
  "Uploaded": "true"
  }]

Ejemplo: CreateBatch

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateBatch y, a continuación, haga clic en Hecho.
3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CreateBatch tendrá un valor similar al siguiente:

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

Ejemplo: CreateJob

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateJob y, a continuación, haga clic en Hecho.
3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CreateJob tendrá un valor similar al siguiente:

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

Ejemplo: GetBatch

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción GetBatch y, a continuación, haga clic en Hecho.
3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea GetBatch tendrá un valor similar al siguiente:

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

Ejemplo: GetJob

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción GetJob y, a continuación, haga clic en Hecho.
3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input:

   {
     "JobId": "750dL000007EipxQAC"
   } 

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea GetJob tendrá un valor similar al siguiente:

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

Ejemplo: UploadAttachment

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadAttachment y, a continuación, haga clic en Hecho.
3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UploadAttachment tendrá un valor similar al siguiente:

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

Ejemplo: GetBatchResults

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción GetBatchResults y, a continuación, haga clic en Hecho.
3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea GetBatchResults tendrá un valor similar al siguiente:

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

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Ejemplo: crear un archivo adjunto

Entity create attachment solo crea un archivo adjunto sin contenido. Para añadir un archivo, debemos realizar la acción Upload Attachment (Subir archivo adjunto) proporcionando un contexto de archivo en la entrada.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Adjunto en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Asignador de datos de la Tarea, haz clic en el editor de OpenDataMapping y, a continuación, introduce un valor similar al siguiente en el field:

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

5. Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea Connector:

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

Ejemplo: actualizar un archivo adjunto

La actualización de la entidad solo actualiza el nombre o la descripción del archivo adjunto. Para añadir un archivo, debemos realizar la acción Upload Attachment (Subir archivo adjunto) proporcionando un contexto de archivo en la entrada.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Adjunto en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. Define el ID de entidad para actualizar un archivo adjunto. Para definir el ID de entidad, en la sección Asignador de datos de Tareas, haz clic en EntityID y, a continuación, introduce 00PdL000000EJKXUA4 en el campo correspondiente.
5. En la sección Asignador de datos de la Tarea, haz clic en el editor de OpenDataMapping y, a continuación, introduce un valor similar al siguiente en el field:

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

También puede definir filterClause como 00PdL000000EJKXUA4 en lugar de especificar entityId.

6. Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea Connector:

   {
     "Id": "00PdL000000EJKXUA4"
   }