Salesforce

El conector de Salesforce te permite realizar operaciones de inserción, eliminación, actualización y lectura en los datos de Salesforce.

Versiones compatibles

El conector requiere la API de servicios web. La API de servicios web es compatible de forma nativa con las ediciones Enterprise, Unlimited y Developer de Salesforce. La API de Web Services se puede habilitar en la edición profesional por un costo adicional. Para ello, comunícate con Salesforce. El conector usa de forma predeterminada la versión 56.0 de la API de Salesforce.

Antes de comenzar

Antes de usar el conector de Salesforce, realiza las siguientes tareas:

  • En tu proyecto de Google Cloud, haz lo siguiente:
    • Otorga el rol de IAM roles/connectors.admin al usuario que configure el conector.
    • Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

    • Habilita los siguientes servicios:
      • secretmanager.googleapis.com (API de Secret Manager)
      • connectors.googleapis.com (API de conectores)

      Para comprender cómo habilitar servicios, consulta Habilita servicios.

    Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Salesforce en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de conexión no pueden superar los 49 caracteres.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    8. Usar proxy: selecciona esta casilla de verificación a fin de configurar un servidor proxy para la conexión y configurar los siguientes valores:
      • Esquema de autenticación del proxy: Selecciona el tipo de autenticación para autenticar con el servidor proxy. Se admiten los siguientes tipos de autenticación:
        • Básico: Autenticación HTTP básica.
        • Resumen: Autenticación de HTTP de resumen.
      • Usuario de proxy: Un nombre de usuario que se usará para autenticarse con el servidor proxy.
      • Contraseña de proxy: el secreto de Secret Manager de la contraseña del usuario.
      • Tipo de SSL del proxy: el tipo de SSL que se usará para conectarse al servidor del proxy. Se admiten los siguientes tipos de autenticación:
        • Automático: Configuración predeterminada. Si la URL es HTTPS, se usa la opción Túnel. Si la URL es una URL HTTP, se usa la opción NUNCA.
        • Siempre: La conexión siempre está habilitada para SSL.
        • Nunca: La conexión no está habilitada para SSL.
        • Túnel: La conexión se realiza a través de un proxy de túnel. El servidor proxy abre una conexión con el host remoto y el tráfico fluye de un lado a otro a través del proxy.
      • En la sección Proxy Server, ingresa los detalles del servidor proxy.
        1. Haz clic en Agregar destino.
        2. Selecciona un Tipo de destino.
          • Dirección del host: Especifica el nombre de host o la dirección IP del destino.

            Si deseas establecer una conexión privada a tu sistema de backend, haz lo siguiente:

    9. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    10. Haga clic en SIGUIENTE.
  5. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
    1. Tipo de destino: Selecciona un Tipo de destino.
      • Selecciona Dirección de host en la lista para especificar el nombre de host o la dirección IP del destino.
      • Si deseas establecer una conexión privada con tus sistemas de backend, Selecciona Adjunto de extremo de la lista y, luego, selecciona el adjunto de extremo requerido. de la lista Adjunto de extremo.

      Si deseas establecer una conexión pública a tus sistemas de backend con seguridad adicional, puedes configurar direcciones IP salientes estáticas para tus conexiones y, luego, configurar tus reglas de firewall para incluir en la lista de entidades permitidas solo las direcciones IP estáticas específicas.

      Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.

    2. Haga clic en SIGUIENTE.
  6. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Salesforce admite los siguientes tipos de autenticación:

      • OAUTH2_JWT_BEARER
      • Nombre de usuario y contraseña

      2. Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

    2. Haga clic en SIGUIENTE.
  7. Revisa: Revisa tus detalles de conexión y autenticación.
  8. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

  • OAUTH2_JWT_BEARER
    • Clave de consumidor de app conectada: La clave de consumidor proporcionada por Salesforce para la app conectada que creaste.
    • Nombre de usuario: Es el nombre de usuario asociado a la app conectada que creaste.
    • Clave privada: El Secret de Secret Manager que incluye el contenido del archivo de clave privada. La clave privada debe coincidir con la clave o el certificado públicos que se proporcionan a Salesforce.
    Para obtener más información, consulta Crea una conexión de Salesforce mediante JWT.
  • Nombre de usuario y contraseña
    • Nombre de usuario: El nombre de usuario de Salesforce que se usará para la conexión.
    • Contraseña: El Secret de Secret Manager que contiene la contraseña asociada con el nombre de usuario de Salesforce.
    • Token de seguridad: El Secret de Secret Manager que contiene código alfanumérico que distingue entre mayúsculas y minúsculas y que proporciona Salesforce para el usuario.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra de los diversos campos que configuras cuando creas la conexión.

Tipo de conexión del nombre de usuario y la contraseña

Nombre del campo Detalles
Ubicación us-central1
Conector Salesforce
Versión del conector 1
Nombre de la conexión gcp-salesforce-conn
Habilita Cloud Logging Sí
Nivel de registro Error
Cuenta de servicio SERVICEACCOUNT_NAME@developer.gserviceaccount.com
Nivel de verbosidad 5
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Tipo de destino Dirección del host
Host 1 https://login.salesforce.com.
Nombre de usuario NOMBRE DE USUARIO
Contraseña CONTRASEÑA
Versión del Secret 1
Token de seguridad Es el token o código alfanumérico que proporciona Salesforce al usuario.
Versión del Secret 1

Entidades, operaciones y acciones

Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.

  • Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

    Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista Entities estará vacía.

  • Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:

    Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, tales operaciones operaciones no aparecen en la lista Operations.

  • Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Por lo general, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Limitaciones del sistema

El conector de Salesforce puede procesar un máximo de 28 transacciones por segundo. por nodo y throttles cualquier transacción que supere este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) por una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Acciones

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

Para crear una consulta personalizada, sigue estos pasos:

  1. Sigue las instrucciones detalladas para agregar una tarea de conectores.
  2. Cuando configures la tarea del conector, en el tipo de acción que deseas realizar, selecciona Acciones.
  3. En la lista Acción, selecciona Ejecutar consulta personalizada y, luego, haz clic en Listo.

    imagen que muestra la acción execute-custom-query imagen que muestra la acción execute-custom-query

  4. Expande la sección Task input y, luego, haz lo siguiente:
    1. En el campo Timeout after, ingresa la cantidad de segundos que se espera hasta que se ejecute la consulta.

      Valor predeterminado: 180 segundos.

    2. En el campo Cantidad máxima de filas, ingresa la cantidad máxima de filas que se mostrarán desde la base de datos.

      Valor predeterminado: 25.

    3. Para actualizar la consulta personalizada, haz clic en Edit Custom Script (Editar secuencia de comandos personalizada). Se abrirá el diálogo Editor de secuencia de comandos.

      Imagen que muestra custom-sql-query imagen que muestra custom-sql-query

    4. En el diálogo Editor de secuencia de comandos, ingresa la consulta de SQL y haz clic en Guardar.

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

      SELECT * FROM Employees where LastName=?

    5. Si usaste signos de interrogación en tu consulta en SQL, debes agregar el parámetro. Para ello, haz clic en + Agregar nombre del parámetro en cada signo de interrogación. Mientras se ejecuta la integración, estos parámetros reemplazan los signos de interrogación (?) en la consulta en SQL de manera secuencial. Por ejemplo, si agregaste tres signos de interrogación (?), debes agregar tres parámetros en orden de secuencia.

      imagen que muestra add-query-param imagen que muestra add-query-param

      Para agregar parámetros de consulta, haz lo siguiente:

      1. En la lista Tipo, selecciona el tipo de datos del parámetro.
      2. En el campo Valor, ingresa el valor del parámetro.
      3. Para agregar varios parámetros, haz clic en + Agregar parámetro de consulta.

En esta sección, se enumeran las acciones que admite el conector de Salesforce. Para comprender cómo configurar las acciones, consulta Ejemplos de acciones.

Acción CreateJobv2

Usa esta acción para crear un trabajo.

Parámetros de entrada de la acción CreateJobV2

Nombre del parámetro Tipo de datos Obligatorio Descripción
ObjectName String Sí Es el nombre del objeto que se usará para la tarea, como Cuenta, Campaña, Evento, etcétera.
Consulta String No La consulta que se realizará.
Acción String Sí Es el tipo de acción que se usará en la tarea. Los valores válidos son “insert”, “delete”, “update”, “upsert” o “query”.
ExternalIdColumn String No El campo de ID externo en el objeto que se actualiza. Esto es obligatorio para las operaciones de inserción y actualización. Los valores de los campos también deben existir en los datos de trabajo CSV.
ColumnDelimiter String No El delimitador de columnas que se usa para los datos de trabajo CSV. El valor predeterminado es COMMA. Los valores válidos son "BACKQUOTE", "CARET", "COMMA", "PIPE", "SEMICOLON" y "TAB".
LineEnding String No El final de línea que se usa para los datos de trabajo de CSV, que marca el final de una fila de datos. El valor predeterminado es LF. Los valores válidos son "LF" y "CRLF".
MultiPartRequest Booleano No Habilita esta función solo si los datos del archivo CSV no superan los 20,000 caracteres. También debes especificar la ruta de acceso del archivo CSV.
CSVFilePath String No Especifica la ruta de acceso de tu archivo CSV.

Para ver ejemplos sobre 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

Nombre del parámetro Tipo de datos Obligatorio Descripción
ContentUrl String No Es la URL que se usará para las solicitudes de "Subir datos de trabajo" de este trabajo. Solo es válido si el trabajo está en estado Abierto.
CSVFilePath String No Especifica la ruta de acceso de tu archivo CSV.
Contenido String Sí El contenido del archivo CSV como InputStream. Se debe proporcionar solo si CSVFilePath está vacío.

Por ejemplo, sobre 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

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId String Verdadero Es el ID del trabajo al que se agrega el lote.
Agregación String Verdadero La agregación de objetos que se agregan. Especifica la consulta que se usará si se realiza una consulta por lotes.
ContentType String Verdadero Es el tipo de contenido del trabajo. Los siguientes son los valores válidos: CSV, XML, ZIP_CSV y ZIP_XML. Establece el valor en CSV si realizas una consulta por lotes. El valor predeterminado es XML.

Parámetros de salida de la acción CreateBatch

Para ver ejemplos sobre cómo configurar la acción CreateBatch, consulta Ejemplos.

Acción CreateJob

Esta acción agrega una entrada de objeto de Salesforce.

Parámetros de entrada de la acción CreateJob

Nombre del parámetro Tipo de datos Obligatorio Descripción
ObjectName String Verdadero Nombre del objeto que se usará para el trabajo
Acción String Verdadero Es el tipo de acción que se usará en la tarea.

Parámetros de salida de la acción CreateJob

Por ejemplo, sobre 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

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId String Verdadero El ID del trabajo con el que está asociado el lote.
BatchId String Verdadero El ID del lote que se recupera.

Parámetros de salida de la acción GetBatch

Para ver ejemplos sobre cómo configurar la acción GetBatch, consulta Ejemplos.

Acción GetJob

Esta acción permite obtener información sobre un trabajo de Salesforce.

Parámetros de entrada de la acción GetJob

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId String Verdadero Es el ID del trabajo que se recupera.

Parámetros de salida de la acción GetJob

Para ver ejemplos sobre cómo configurar la acción GetJob, consulta Ejemplos.

Acción UploadAttachment

Esta acción sube un adjunto y lo asocia con una entidad en Salesforce.

Parámetros de entrada de la acción UploadAttachment

Nombre del parámetro Tipo de datos Obligatorio Descripción
ObjectId String Verdadero Es el ID del objeto con el que se asociará el documento subido.
Nombre del archivo String Verdadero Es el nombre del archivo adjunto.
Base64Data String Verdadero Es la cadena de datos que se usará como contenido del archivo.

Parámetros de salida de la acción UploadAttachment

Por ejemplo, sobre cómo configurar la acción UploadAttachment, consulta Ejemplos.

Acción GetBatchResults

Esta acción permite obtener los resultados de un lote de Salesforce.

Parámetros de entrada de la acción GetBatchResults

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId String Verdadero El ID del trabajo con el que está asociado el lote.
BatchId String Verdadero Es el ID del lote que se recupera.
ContentType String Verdadero Es el tipo de contenido del trabajo.

Parámetros de salida de la acción GetBatchResults

Por ejemplo, sobre cómo configurar la acción GetBatchResults, consulta Ejemplos.

Ejemplos de acciones

Ejemplo: CreateJobV2

En este ejemplo, se crea un objeto Job.

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CreateJobV2 y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, debes ingresar un valor similar al siguiente en el campo Default Value: 
     {
  "ObjectName": "Contact",
  "Action": "insert"
 }

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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. Selecciona la acción UploadJobDataV2 y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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"
 }

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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. Selecciona la acción CreateBatch y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa 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"
}

    4. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload 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. Selecciona la acción CreateJob y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
    {
  "ObjectName": "Campaign",
  "Action": "insert"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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. Selecciona la acción GetBatch y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el Campo Input: 
    {
  "BatchId": "751dL000003yKlJQAU",
  "JobId": "750dL000007EipxQAC"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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. Selecciona la acción GetJob y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
    {
  "JobId": "750dL000007EipxQAC"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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. Selecciona la acción UploadAttachment y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el Campo Input: 
    {
  "ObjectId": "001dL00000SC6j7QAD",
  "FileName": "My files/salesforce/con.csv",
  "Base64Data": "Y29ubmVjdG9ycyBpcyBiYWNr"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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. Selecciona la acción GetBatchResults y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
    {
  "BatchId": "751dL000004D17FQAS",
  "JobId": "750dL000007XKUhQAO",
  "ContentType": "XML"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload 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: crea un adjunto

    La creación de archivos adjuntos de entidades solo crea un archivo adjunto sin archivo de contenido. Para agregar un archivo, debemos proporcionar un contexto de archivo en la entrada para realizar la acción Upload Attachment.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Archivo adjunto en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Asignador de datos de la Tarea, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el field: 
    {
  "Name": "New Attachment",
  "Description": "New created attachment",
  "ParentId": "001dL00000SC6j7QAD",
  "Body": "Body"
}

  5. Cuando se ejecuta este ejemplo, se muestra una respuesta similar a la siguiente en el conector variable de salida connectorOutputPayload de la tarea:

    {
  "Id": "00PdL000000EJKXUA4"
}

Ejemplo: actualiza un adjunto

    El archivo adjunto de actualización de entidades solo actualiza el nombre o la descripción del archivo adjunto. Para agregar un archivo, debemos proporcionar un contexto de archivo en la entrada para realizar la acción Upload Attachment.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Archivo adjunto en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece el ID de la entidad para actualizar un archivo adjunto. Para establecer el ID de la entidad, en la sección Data mapper de Tasks, haz clic en EntityID y, luego, ingresa 00PdL000000EJKXUA4 en el campo determinado.
  5. En la sección Data mapper de la Task, haz clic en el editor OpenDataMapping y, luego, ingresa un valor similar al siguiente en field:. 
    {
  "Name": "New Attachment",
  "Description": "New updated attachment",
  "Body": "Body"
}

    6. Como alternativa, en lugar de especificar el entityId, también puedes establecer el filterClause como 00PdL000000EJKXUA4.

  6. Si ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "00PdL000000EJKXUA4"
}

Usar Terraform para crear conexiones

Puedes usar Terraform resource para crear una conexión nueva.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Si quieres ver una plantilla de Terraform de muestra para crear conexiones, consulta la plantilla de muestra.

Cuando crees esta conexión con Terraform, debes establecer las siguientes variables en tu archivo de configuración de Terraform:

Nombre del parámetro Tipo de datos Obligatorio Descripción
proxy_enabled BOOLEAN Falso Selecciona esta casilla de verificación para configurar un servidor proxy para la conexión.
proxy_auth_scheme ENUM Falso El tipo de autenticación que se utiliza para autenticarse en el proxy ProxyServer. Los valores admitidos son: BASIC, DIGEST, NONE.
proxy_user STRING Falso Un nombre de usuario que se usará para autenticarse en el proxy ProxyServer.
proxy_password SECRET Falso Es una contraseña que se usará para autenticarse en el proxy de ProxyServer.
proxy_ssltype ENUM Falso Es el tipo de SSL que se usará para conectarse al proxy de ProxyServer. Los valores admitidos son: AUTO, ALWAYS, NEVER, TUNNEL

Usa la conexión de Salesforce en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en la integración de aplicaciones. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Connectors en la integración de Apigee, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Conectores en Application Integration, consulta la Tarea Conectores.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?