Ejemplo de uso del paquete Salesforce y variable de registro

Cree un bot que consulte objetos de Salesforce y escribe datos en un archivo CSV. El bot también utiliza una variable de registro para recuperar datos de registros individuales obtenidos de Salesforce.

Antes de empezar

  • Configure una aplicación conectada en Salesforce si aún no tiene una.
  • El bot utiliza el método de conexión OAuth de la Control Room. Cree una conexión OAuth de la Control Room antes de comenzar a crear el bot. Para obtener más información, consulte acción Autenticación de Salesforce.
  • Configure datos de oportunidades y cuentas de ejemplo en Salesforce. Si no tiene datos de ejemplo, puede importar los datos de los siguientes archivos CSV a Salesforce:
Supongamos que el equipo de ventas de Acme Solutions Pvt Ltd decide automatizar el proceso de obtención de todos los registros de oportunidades que se encuentran en el estado de prospección y luego asignarlos a los representantes de ventas para realizar el seguimiento. El equipo crea un bot que realiza las siguientes tareas:
  • Recupera todas las oportunidades con el estado de Prospección del objeto de Oportunidad en Salesforce.
  • Recupera el nombre de la cuenta del objeto de la cuenta al utilizar el ID de cuenta recuperado de cada registro de oportunidad.
  • Utiliza un registro para capturar datos de registros de oportunidades individuales.
  • Finalmente, escribe los registros en un archivo CSV, que puede procesarse para asignar representantes de ventas.
El bot de muestra utiliza los paquetes Salesforce, Registro, Bucle y Tabla de datos junto con las variables de registro para mostrar cómo realizar las siguientes tareas de automatización:
  • Consulte un objeto de Salesforce mediante la acción Ejecutar SOQL de Salesforce.
  • Obtenga un registro individual de un objeto de Salesforce mediante la acción Obtener registro de Salesforce.
  • Actualice y restablezca las variables de registro.
  • Inserte registros en una variable de tabla de datos.
  • Escriba una tabla de datos en un archivo CSV.

Procedimiento

  1. Cree un bot.
    1. En el panel izquierdo, haga clic en Automatización. Se muestra la lista de formularios y bots disponibles.
    2. Haga clic en Crear nuevo > Task Bot.
    3. En Nombre, introduzca Get Sales Opportunities.
    4. Haga clic en Crear y editar.
  2. Autenticar con Salesforce. Para este tutorial, conexión OAuth de la Control Room se utiliza como Tipo de autenticación. Las instrucciones para configurar la conexión OAuth están fuera del alcance de este tutorial. Si no está familiarizado con la configuración de conexiones OAuth, siga las instrucciones proporcionadas en esta página o puede utilizar OAuth 2 - Credenciales de cliente como el Tipo de autenticación y proporcione el ID de cliente, el secreto del cliente, el nombre de usuario de Salesforce y la contraseña dentro de la acción de autenticación de Salesforce.
    1. En el panel Acciones, busque y agregue la acción Salesforce > Autenticación al Editor de bots.
    2. En Tipo de autenticación, seleccione conexión OAuth de la Control Room.
    3. Haga clic en Seleccionar y seleccione la conexión OAuth que ha configurado con los siguientes detalles:
      • Tipo de Proveedor: Salesforce
      • Nombre de la conexión: la conexión que ha configurado.
      • Tipo de token: Compartido.
    4. En Versión de la API, introduzca el número de versión de la API para la aplicación conectada de Salesforce. Por ejemplo, 50.0.
    5. Deje el Nombre de la sesión como Default.
    6. En Variables asignadas, haga clic en Agregar asignación de variables y, a continuación, asigne la clave IntanceUrl a una variable de cadena denominada InstanceUrl.
  3. Para comprobar si hay errores de autenticación antes de ejecutar otras tareas, utilice las acciones Intentar y Capturar.
    1. En el panel Acciones, busque y agregue la acción Manejador de errores > Intentar al Editor de bots.
    2. Haga clic en el ícono del bloque Capturar .
    3. En Excepción, seleccione Manejador de Errores.
    4. En Asignar Mensaje de Excepción a, haga clic en (x) y cree una variable de cadena denominada ErrorMessage.
    5. Agregue la acción Cuadro de mensaje dentro del bloque Capturar.
    6. En Escribir el mensaje para mostrar, seleccione la variable Mensaje de error y guarde los cambios.
  4. Consulte el objeto de Oportunidad de Salesforce para recuperar registros de oportunidades con el estado Prospección.
    1. En el panel Acciones, busque y agregue la acción Salesforce > Ejecutar SOQL dentro del bloqueIntentar.
    2. En consulta SOQL a ejecutar, introduzca la siguiente consulta. 
      SELECT Id, Name, AccountId, Amount, CloseDate, StageName, NextStep FROM Opportunity WHERE StageName = 'Prospecting'
    3. En Incluir registros eliminados, haga clic en No.
    4. Asegúrese de que Default está definido como el nombre de la sesión.
    5. En Guardar el resultado en una variable, haga clic en (x) y cree una variable de lista denominada list_records_prospecting.
    6. Guarde los cambios.
  5. Recorra a través de la lista de registros de oportunidades recuperadas.
    1. En el panel Acciones, busque y agregue la acción Bucle > Bucle después de la acción Ejecutar SOQL dentro del bloque Intentar.
    2. En Iterador, seleccione Para cada elemento en la lista.
    3. En lista, seleccione la variable list_records_prospecting‌.
    4. En Asignar el valor actual a la variable, haga clic en (x) para crear una variable denominada dict_record_opportunity con el tipo Cualquiera.
      El siguiente es un ejemplo de un registro que se almacena como diccionario. El bot recupera valores solo de los campos Nombre, Nombre de cuenta, Monto, Fecha de cierre, Nombre de etapa y Siguiente paso y deja fuera el resto.
      {attributes,com.automationanywhere.botcommand.data.impl.DictionaryValue@5d804b9c},{Id,0065j00001Q2ISAAA3},{Name,Opportunity #1},{AccountId,0015j00001BU2hnAAD},{Amount,2000.0},{CloseDate,2023-10-05},{StageName,Prospecting},{NextStep,Call to Discuss}
    5. Guarde los cambios.
  6. Antes de recuperar valores de cada campo de un registro, cree dos variables de registro: una para almacenar los valores de cada registro de oportunidad y otra para restablecer la primera variable de registro al final de cada iteración.
    1. En el panel Variables, haga clic en Crear variable.
    2. En Tipo, seleccione Registro.
    3. En Nombre, introduzca out_record_prospecting.
    4. Haga clic en Crear.
    5. Repita los pasos a a d para crear otra variable de registro con los siguientes detalles:
      Tipo: Record
      Nombre: record_empty
  7. Actualice la variable de registro con el nombre de oportunidad del registro actual.
    1. En el panel Acciones, busque y agregue la acción Registro > Agregar columna dentro de la acción Bucle.
    2. En Variable de registro de origen, seleccione out_record_prospecting.
    3. En Tipo de columna, seleccione Cadenay en Valor, introduzca $dict_record_opportunity{Name}$.
    4. Haga clic en Índice Específico, introduzca 0.
    5. En Variable de registro de destino, seleccione out_record_prospecting.
    6. Guarde los cambios.
  8. Los registros de oportunidades recuperados de Salesforce solo contienen los ID de cuenta y no los nombres de cuenta. Recupere el nombre de la cuenta utilizando el ID de cuenta para cada registro.
    1. En el panel Acciones, busque y agregue la acción Salesforce > Obtener registros dentro de la acción Bucle.
    2. En nombre del Objeto, introduzca Account.
    3. Seleccione ID de Registro e introduzca $dict_record_opportunity{AccountId}$.
    4. En Campos y datos, seleccione Lista y haga clic en Agregar.
    5. En Tipo, seleccione Cadena.
    6. En Valor en 0, introduzca Name.
    7. Asegúrese de que Default está definido como el nombre de la sesión de Salesforce.
    8. En Variables Asignadas, haga clic en Agregar Asignación de Variables para asignar la clave Name a una variable de cadenaAccountName. La llamada Get record recupera el nombre de la cuenta al utilizar la clave Nombre y lo almacena en la variable AccountName.
    9. Guarde los cambios.
  9. Agregue una nueva columna y actualice la variable de registro con el nombre de cuenta.
    1. En el panel Acciones, busque y agregue la acción Registro > Agregar columna dentro de la acción Bucle.
    2. En Variable de registro de origen, seleccione out_record_prospecting.
    3. En Tipo de columna, seleccione Cadenay en Valor, introduzca $AccountName$.
    4. Haga clic en Índice Específico, introduzca 1.
    5. En Variable de registro de destino, seleccione out_record_prospecting.
    6. Guarde los cambios.
  10. Agregue una nueva columna y actualice la variable de registro con el monto.
    1. En el panel Acciones, busque y agregue la acción Registro > Agregar columna dentro de la acción Bucle.
    2. En Variable de registro de origen, seleccione out_record_prospecting.
    3. En Tipo de columna, seleccione Númeroy en Valor, introduzca $dict_record_opportunity{Amount}$.
    4. Haga clic en Índice Específico, introduzca 2.
    5. En Variable de registro de destino, seleccione out_record_prospecting.
    6. Guarde los cambios.
  11. Actualice la variable de registro con CloseDate, StageName y NextStep.
    1. Agregue la acción Agregar columna a la acción Bucle y, a continuación, introduzca los siguientes detalles:
      Campo Valor
      Variable de registro de origen out_record_prospecting
      Tipo de columna String
      Valor $dict_record_opportunity{CloseDate}$
      Índice específico 3
    2. Agregue la acción Agregar columna a la acción Bucle y, a continuación, introduzca los siguientes detalles:
      Campo Valor
      Variable de registro de origen out_record_prospecting
      Tipo de columna String
      Valor $dict_record_opportunity{StageName}$
      Índice específico 4
    3. Agregue la acción Agregar columna a la acción Bucle y, a continuación, introduzca los siguientes detalles:
      Campo Valor
      Variable de registro de origen out_record_prospecting
      Tipo de columna String
      Valor $dict_record_opportunity{NextStep}$
      Índice específico 5
    4. Guarde los cambios.
  12. Inserte el registro en una variable DataTable.
    1. Para realizar un seguimiento de las iteraciones y utilizarlo como un número de índice de fila, cree una variable numérica denominada counter y establezca el valor predeterminado en 0.
    2. En el panel Acciones, busque y agregue la acción Tabla de datos > Insertar fila dentro de la acción Bucle.
    3. En Nombre de tabla de datos, haga clic en (x) y cree una variable de tabla denominada table_records.
    4. Haga clic en índice específico e introduzca $counter$.
    5. En Nombre de registro de fila, seleccione out_record_prospecting.
    6. Guarde los cambios.
  13. Incremente la variable counter en 1.
    1. En el panel Acciones, busque y agregue la acción Número > Incrementar dentro de la acción Bucle.
    2. En Escribir número, introduzca $counter$.
    3. En Ingresar valor de incremento, introduzca 1.
    4. En Asignar la salida a variable, seleccione contador.
    5. Guarde los cambios.
  14. Restablezca la variable de registro out_record_prospecting antes de la siguiente iteración.
    1. En el panel Acciones, busque y agregue la acción Registro > Asignar dentro de la acción Bucle.
    2. En Seleccione la variable de registro de origen, seleccione record_empty.
    3. En Seleccione la variable de registro de origen, haga clic en Registro y seleccione out_record_prospecting. Puesto que la variable record_empty no tiene ningún valor, out_record_prospecting se restablecerá.
    4. Guarde los cambios.
  15. Escriba los registros de oportunidad recuperados en un archivo CSV.
    1. En el panel Acciones, busque y agregue la acción Tabla de datos > Escribir en el archivo fuera de la acción Bucle.
    2. En Nombre de tabla de datos, seleccione table_records‌.
    3. En Introducir nombre de archivo, especifique la ruta del archivo CSV. Por ejemplo, C:\bots\opportunities.csv.
    4. Seleccione Crear carpetas/archivos si no existen.
    5. Haga clic en Sobrescribir archivo existente.
    6. Guarde los cambios y ejecute el bot.