action Ejecutar SOQL de Salesforce

Para buscar información específica en sus datos de Salesforce, ejecute el comando Idioma de consulta de objeto de Salesforce (Salesforce Object Query Language, SOQL) desde Automation 360 usando la action Ejecutar SOQL de Salesforce.

SOQL es similar a Idioma de consulta estructurada (SQL, del inglés Structured Query Language) pero está adaptado a los datos de Salesforce. Para obtener más información sobre SOQL, consulte Salesforce Execute SOQL.

Para obtener información específica de los datos de Salesforce, ejecute una consulta desde Automation 360.

Para enviar una consulta SOQL a Salesforce utilizando la action Ejecutar SOQL, realice los siguientes pasos:
Nota: Asegúrese de que se ha autentificado antes de solicitar cualquier action de Salesforce. Para obtener más información sobre la autenticación, consulte action Autenticación de Salesforce.

Procedimiento

  1. En el panel Acciones, seleccione Salesforce > Ejecutar SOQL y coloque en el lienzo.
    Acción ejecutar SOQL de Salesforce
  2. Escriba los siguientes campos:
    1. Introduzca la consulta SOQL a ejecutar, por ejemplo Seleccione Estado Desde Caso Donde Id = '5004W000026rD4HQAU'.
      Nota: Para Objetos personalizados de Salesforce, asegúrese de proporcionar el nombre de la API en lugar del Nombre de visualización del objeto. Por ejemplo, proporcione el Nombre de la API: AAIRPA__Salesforce_Connection__c y no el nombre para mostrar: Conexión con Salesforce” Para obtener más información sobre cómo encontrar el nombre de la API, consulte https://help.salesforce.com/s/articleView?id=000327123&type=1.
    2. Seleccione una de las siguientes opciones:
      • Si desea incluir los registros eliminados, seleccione Sí.
      • Si no quiere incluir los registros eliminados, seleccione No.
    3. Introduzca Predeterminado como nombre de la sesión.
    4. Guardar el resultado en una variable. Por ejemplo, todos los campos de los registros pueden almacenarse en una lista (List_SOQL)
  3. Verifique que pueda ejecutar el bot en modo Depuración con un punto de ruptura establecido en una action junto a Ejecutar SOQL. Por ejemplo, en el ejemplo proporcionado anteriormente, hay una action de Cuadro de mensaje. Abra la variable List_SOQL para ver los resultados.
    Salesforce verifica la acción Ejecutar SOQL
    Todo el conjunto de resultados se devuelve como respuesta de la acción Ejecutar SOQL de Salesforce y no hay limitación en el número de registros devueltos.
    Nota: La respuesta puede tener un alto volumen de datos que potencialmente podría degradar el rendimiento de su automatización.
    Nota: La salida se recupera como una lista de tipo Dictionary. Para leer un registro (fila) individual de esta lista, debe recorrer todos los elementos del diccionario utilizando la acción Loop y leer o extraer los registros (filas) individualmente. Por ejemplo, la salida de la acción Obtener varios registros se guarda en la variable list_of_records_any. Si la variable contiene cinco registros, cada registro se pasa a la acción Bucle para que se procese uno a la vez.Acción de bucle para obtener múltiples registros