Para interactuar con datos dentro de Salesforce® como parte de una cadena, agregue un paso con un comando de conexión de Salesforce. Por ejemplo:
- Cargar, extraer y eliminar datos mediante SOQL y operaciones masivas
- Crear y administrar objetos de Salesforce
- Actualizar y crear registros
Para habilitar estos comandos, un administrador de TI primero crea un conector de Salesforce. El conector interactúa con todas las versiones de Salesforce Sales Cloud (Salesforce Essentials®, Lightning® Professional, Lightning Enterprise y Lightning Unlimited) a través de la API REST.
Eliminación masiva
Para eliminar un gran volumen de registros según un archivo de valores separados por comas (CSV), utilice el comando Eliminación masiva .
Nota: Si no se puede eliminar un registro, el comando devuelve un CSV que enumera los números de fila de los registros fallidos, junto con el motivo del error. Puede utilizar la ramificación para realizar acciones cuando el comando falla o cargar los fallos en Google® Drive para su posterior análisis.
Propiedades
| Propiedad |
Detalle |
| Modo de concurrencia |
Seleccione si desea procesar los registros al mismo tiempo o secuencialmente.
- Para procesar registros al mismo tiempo, seleccione Paralelo.
- Para procesar registros secuencialmente, seleccione Serie.
Nota: Para un trabajo muy grande, seleccione Serie, ya que el volumen de conexiones de base de datos podría provocar que el trabajo falle en modo Paralelo. Sin embargo, el modo serie puede resultar en tiempos de proceso mucho más largos. |
| Nombre del objeto |
Introduzca el tipo de SObject sobre el que se realizará la operación. |
| Archivo de entrada |
Ingrese el archivo que contiene los registros a eliminar. |
| Formato de archivo |
Seleccione si el Archivo de entrada es CSV, JSON o XML. |
| Tamaño del lote |
Introduzca el número de registros a procesar por lote. Le recomendamos que deje el valor predeterminado. |
| Esperar a que se complete |
Para sondear Salesforce y solo pasar al siguiente comando cuando se hayan procesado todos los registros, marque esta casilla. Para activar el comando y pasar inmediatamente al siguiente paso, desmarque esta casilla. |
Resultados
| Resultado |
Tipo de salida |
| Registro de errores de eliminación masiva |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Inserción masiva
Para insertar un gran volumen de registros basados en un archivo CSV, utilice el comando Inserción masiva .
Nota: Si no se puede insertar un registro, el comando devuelve un CSV que enumera los números de fila de los registros fallidos, junto con el motivo del error. Puede utilizar la ramificación para realizar acciones cuando el comando falla o cargar los fallos en Google® Drive para su posterior análisis.
Propiedades
| Propiedad |
Detalle |
| Modo de concurrencia |
Seleccione si desea procesar los registros al mismo tiempo o secuencialmente.
- Para procesar registros al mismo tiempo, seleccione Paralelo.
- Para procesar registros secuencialmente, seleccione Serie.
Nota: Para un trabajo muy grande, seleccione Serie, ya que el volumen de conexiones de base de datos podría provocar que el trabajo falle en modo Paralelo. Sin embargo, el modo serie puede resultar en tiempos de proceso mucho más largos. |
| Nombre del objeto |
Introduzca el tipo de SObject sobre el que se realizará la operación. |
| Archivo de entrada |
Introduzca el archivo que contiene los registros a insertar. |
| Formato de archivo |
Seleccione si el Archivo de entrada es CSV, JSON o XML. |
| Tamaño del lote |
Introduzca el número de registros a procesar por lote. Le recomendamos que deje el valor predeterminado. |
| Esperar a que se complete |
Para sondear Salesforce y solo pasar al siguiente comando cuando se hayan procesado todos los registros, marque esta casilla. Para activar el comando y pasar inmediatamente al siguiente paso, desmarque esta casilla. |
Resultados
| Resultado |
Tipo de salida |
| Registro de errores de inserción masiva |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Consulta masiva
Para consultar un gran volumen de registros, utilice el comando Consulta masiva .
Propiedades
| Propiedad |
Detalle |
| Modo de concurrencia |
Seleccione si desea procesar los registros al mismo tiempo o secuencialmente.
- Para procesar registros al mismo tiempo, seleccione Paralelo.
- Para procesar registros secuencialmente, seleccione Serie.
Nota: Para un trabajo muy grande, seleccione Serie, ya que el volumen de conexiones de base de datos podría provocar que el trabajo falle en modo Paralelo. Sin embargo, el modo serie puede resultar en tiempos de proceso mucho más largos. |
| Nombre del objeto |
Introduzca el tipo de SObject sobre el que se realizará la operación. |
| Consulta SOQL |
Ingrese la consulta SOQL a ejecutar. |
Resultados
| Resultado |
Tipo de salida |
| Resultados de consultas masivas CSV |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Actualización masiva
Para actualizar un gran volumen de registros, utilice el comando Actualización masiva .
Nota: Si un registro no se puede actualizar, el comando devuelve un CSV que enumera los números de fila de los registros fallidos, junto con el motivo del error. Puede utilizar la ramificación para realizar acciones cuando el comando falla o cargar los fallos en Google® Drive para su posterior análisis.
Propiedades
| Propiedad |
Detalle |
| Modo de concurrencia |
Seleccione si desea procesar los registros al mismo tiempo o secuencialmente.
- Para procesar registros al mismo tiempo, seleccione Paralelo.
- Para procesar registros secuencialmente, seleccione Serie.
Nota: Para un trabajo muy grande, seleccione Serie, ya que el volumen de conexiones de base de datos podría provocar que el trabajo falle en modo Paralelo. Sin embargo, el modo serie puede resultar en tiempos de proceso mucho más largos. |
| Nombre del objeto |
Introduzca el tipo de SObject sobre el que se realizará la operación. |
| Archivo de entrada |
Ingrese el archivo que contiene los registros a actualizar. |
| Formato de archivo |
Seleccione si el Archivo de entrada es CSV, JSON o XML. |
| Tamaño del lote |
Introduzca el número de registros a procesar por lote. Le recomendamos que deje el valor predeterminado. |
| Esperar a que se complete |
Para sondear Salesforce y solo pasar al siguiente comando cuando se hayan procesado todos los registros, marque esta casilla. Para activar el comando y pasar inmediatamente al siguiente paso, desmarque esta casilla. |
Resultados
| Resultado |
Tipo de salida |
| Registro de errores de actualización masiva |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Inserción masiva
Para realizar una operación de upsert (ya sea para actualizar registros existentes o crear nuevos basados en una identificación externa) en un gran volumen de registros, utilice el comando Bulk upsert .
Nota: Si no se puede insertar un registro, el comando devuelve un CSV que enumera los números de fila de los registros fallidos, junto con el motivo del error. Puede utilizar la ramificación para realizar acciones cuando el comando falla o cargar los fallos en Google® Drive para su posterior análisis.
Propiedades
| Propiedad |
Detalle |
| Modo de concurrencia |
Seleccione si desea procesar los registros al mismo tiempo o secuencialmente.
- Para procesar registros al mismo tiempo, seleccione Paralelo.
- Para procesar registros secuencialmente, seleccione Serie.
Nota: Para un trabajo muy grande, seleccione Serie, ya que el volumen de conexiones de base de datos podría provocar que el trabajo falle en modo Paralelo. Sin embargo, el modo serie puede resultar en tiempos de proceso mucho más largos. |
| Nombre del objeto |
Introduzca el tipo de SObject sobre el que se realizará la operación. |
| Archivo de entrada |
Introduzca el archivo que contiene los registros a insertar. |
| Formato de archivo |
Seleccione si el Archivo de entrada es CSV, JSON o XML. |
| Tamaño del lote |
Introduzca el número de registros a procesar por lote. Le recomendamos que deje el valor predeterminado. |
| Esperar a que se complete |
Para sondear Salesforce y solo pasar al siguiente comando cuando se hayan procesado todos los registros, marque esta casilla. Para activar el comando y pasar inmediatamente al siguiente paso, desmarque esta casilla. |
| Identificación externa |
Para identificar si un registro ya existe o necesita crearse, ingrese el campo de identificación externa requerido para el objeto involucrado en la inserción y actualización. |
Resultados
| Resultado |
Tipo de salida |
| Registro de errores de inserción masiva |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Crear registro
Para crear un nuevo registro en Salesforce, utilice el comando Crear registro .
Propiedades
| Propiedad |
Detalle |
| Nombre |
Introduzca el nombre del SObject bajo el cual se creará el registro. |
| Campos |
Introduzca los campos del registro a actualizar, en el formato de NOMBRE_CAMPO:VALOR. |
Resultados
| Resultado |
Tipo de salida |
| Nuevo ID de registro |
Cadena |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Eliminar registro
Para eliminar un registro en Salesforce según su ID, utilice el comando Eliminar registro .
Propiedades
| Propiedad |
Detalle |
| ID |
Introduzca el ID del registro a eliminar. Si se desconoce el ID, ingrese un ID externo con el formato EXTERNAL_ID_NAME:VALUE, como por ejemplo Name:John. |
| Nombre |
Introduzca el nombre del SObject bajo el cual se eliminará el registro. |
Resultados
Ninguno
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Descargar informe
Para descargar un informe personalizado como un archivo de valores separados por comas (CSV), utilice el comando Descargar informe .
Propiedades
| Propiedad |
Detalle |
| ID de informe |
Introduzca el ID del informe personalizado que desea descargar. |
Resultados
| Resultado |
Tipo de salida |
| Informe personalizado CSV |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Obtener metadatos del objeto
Para recuperar los campos y metadatos asociados con un objeto de Salesforce, utilice el comando Obtener metadatos del objeto .
Propiedades
| Propiedad |
Detalle |
| Objeto |
Introduzca el nombre del objeto del cual desea recuperar metadatos. |
Salidas
| Resultado |
Tipo de salida |
| Metadatos de objetos |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Obtener registro
Para recuperar un registro de Salesforce según su ID, utilice el comando Obtener registro .
Propiedades
| Propiedad |
Detalle |
| ID |
Introduzca el ID del registro a recuperar. |
| Nombre |
Introduzca el nombre del SObject bajo el cual se recuperará el registro. |
| Campos |
Introduzca los campos del informe que desea incluir (opcional). |
Resultados
| Resultado |
Tipo de salida |
| Obtener registro JSON |
JSON |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Lista de inicios de sesión
Para enumerar los inicios de sesión en el entorno de Salesforce, utilice el comando List logins .
Propiedades
Ninguno
Resultados
| Resultado |
Tipo de salida |
| Lista de inicios de sesión CSV |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Lista de objetos
Para enumerar SObjects desde Salesforce, utilice el comando Listar objetos .
Propiedades
Ninguno
Resultados
| Resultado |
Tipo de salida |
| Lista de objetos CSV |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Informes de lista
Para enumerar informes de Salesforce, utilice el comando Listar informes .
Propiedades
Ninguno
Resultados
| Resultado |
Tipo de salida |
| Lista de informes CSV |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Consulta SOQL
Para ejecutar una consulta SOQL y generar sus resultados como un archivo CSV, utilice el comando SOQL query .
Nota: La sintaxis SOQL es muy similar a SQL. El comando SOQL Query puede extraer grandes volúmenes de datos y devolver conjuntos de datos de 1 millón o más registros a la vez. Si el comando falla porque la consulta es incorrecta o hace referencia a objetos que no existen, las salidas del comando se lo notificarán.
Propiedades
| Propiedad |
Detalle |
| Consulta |
Ingrese la consulta SOQL a ejecutar. |
| Comando de consulta |
Seleccione si desea incluir los registros eliminados.
- Para excluir registros eliminados, seleccione Consulta.
- Para incluir registros eliminados, seleccione Consultar todo.
|
Resultados
| Resultado |
Tipo de salida |
| Salida de consulta SOQL |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
SObject - crear
Para crear un nuevo SObject en Salesforce, utilice el comando SOjbect- create .
Propiedades
| Propiedad |
Detalle |
| Nombre |
Introduzca el nombre del nuevo SObject. Para indicar que se trata de un objeto personalizado, Salesforce agrega automáticamente __c. |
| Campos |
Introduzca los campos de registro a crear, en el formato FIELD_NAME:TYPE, donde TYPE corresponde a un tipo de campo de Salesforce. |
Resultados
Ninguno
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
SObject - eliminar
Para eliminar SObjects en Salesforce, utilice el comando SObject - delete .
Propiedades
| Propiedad |
Detalle |
| Nombre |
Introduzca el nombre de los SObjects a crear. |
Resultados
Ninguno
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
Actualizar registro
Para actualizar los valores de campo de un registro en Salesforce, utilice el comando Actualizar registro .
Propiedades
| Propiedad |
Detalle |
| ID |
Introduzca el ID del registro a actualizar. |
| Nombre |
Introduzca el nombre del SObject bajo el cual se actualizará el registro. |
| Campos |
Introduzca los campos del registro a actualizar, en el formato de NOMBRE_CAMPO:VALOR. |
Resultados
Ninguno
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Correcto |
| 1 |
Error |
Fallo general |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->