Integración de Salesforce mediante la API de REST - Automate_Evolve - Automate_Studio_Manager - Latest

Guía del usuario de Automate Evolve

Product type
Software
Portfolio
Integrate
Product family
Product
Automate > Automate Evolve
Automate > Automate Studio Manager
Version
Latest
Language
Español (España)
Product name
Automate Evolve
Title
Guía del usuario de Automate Evolve
Copyright
2024
First publish date
2018
ft:lastEdition
2024-05-23
ft:lastPublication
2024-05-23T16:32:48.544670

Crear una cuenta de Salesforce

Siga estos pasos para crear una cuenta de Salesforce:

  1. Vaya a https://developer.salesforce.com/signup.

  2. Rellene los detalles.

  3. Haga clic en el botón Registrarme. Recibirá un correo electrónico para la verificación y la configuración de la contraseña.

  4. Configure la contraseña y la pregunta de seguridad e inicie sesión en Salesforce.

  5. Una vez iniciada la sesión, se le presentará la vista Lightning (Rayo); cambie a la vista clásica desde el icono de usuario (en la esquina superior derecha).

Configuración de Salesforce

Para configurar la aplicación de Salesforce conectada, siga estos pasos:

  1. Vaya al icono de configuración (en la parte superior derecha).

  2. Una vez que se abra la ventana de configuración, en el panel de la izquierda, en la sección Build (Creación), vaya a Create (Crear)Apps (Aplicaciones).

  3. En la ventana Apps (Aplicaciones), en la sección Connected Apps (Aplicaciones conectadas), seleccione New (Nueva) para registrar una aplicación conectada nueva.

  4. En la ventana Register New Connected App (Registrar nueva aplicación conectada), rellene los campos necesarios.

  5. En la sección API (Enable OAuth Settings) [API (habilitar configuración de OAuth)], haga clic en la casilla Enable OAuth Settings (Habilitar configuración de OAuth). Para conectar con nuestra organización de ventas tenemos dos opciones: Authorization code flow (Flujo de código de autorización) y Username Password flow (Flujo de nombre de usuario y contraseña); la URL de devolución de llamada mencionada en Enable OAuth Settings (Habilitar configuración de OAuth) es importante si utilizamos el flujo de código de autorización para obtener el token de autenticación). El ámbito de OAuth define el límite en el que se quiere establecer el acceso de los usuarios externos en la organización de ventas (utilizamos Access and manage your data (api) [Acceder y administrar los datos (api)], pero puede establecer el ámbito según sus propias necesidades).

  6. Una vez cumplimentados los datos, haga clic en Save (Guardar). Continúe en la siguiente ventana y espere a que se cree la aplicación.

  7. Una vez creada la aplicación, aparecerá una ventana con los detalles de la aplicación.

Nota: Nota: Se utilizarán los campos Consumer Key (Clave del consumidor) y Consumer Secret (Pregunta secreta del consumidor) para obtener el token de acceso y realizar llamadas API a Salesforce.

Hacer una llamada a la API con Postman

  1. El paso siguiente es obtener el token de acceso. Si se está conectando con su organización de desarrolladores, utilice https://login.salesforce.com/services/oauth2/token como la URL para obtener el token de acceso. Sin embargo, si está usando un espacio aislado, puede utilizar https://test.salesforce.com/services/oauth2/token como la URL del token.

  2. Abra Postman y configure la llamada.

    Asegúrese de seleccionar el botón de radio x-www-form-urlencoded. Añada los cinco pares de clave-valor que se indican a continuación.

    Clave: username | Valor: <su nombre de usuario de inicio de sesión de la organización>

    Clave: password | Valor: <su contraseña de inicio de sesión de la organización>

    Clave: grant_type | Valor: password

    Clave: client_id | Valor: <clave de consumidor de la aplicación conectada de su organización de Salesforce>

    Clave: client_secret | Valor: <pregunta secreta del consumidor de la aplicación conectada de su organización de Salesforce>

    Nota: Nota: Clave- password: también requerirá el token de la pregunta secreta de inicio de sesión.
  3. Una vez que realice la llamada recibirá un error, ya que Salesforce requiere un parámetro adicional para la autenticación.

  4. Para solucionarlo, vaya al sitio de Salesforce en el que ha iniciado sesión y, en el nombre de usuario, vaya a My settings (Mi configuración).

  5. En la página My settings (Mi configuración), en el panel de la izquierda de la sección Personal, seleccione Reset My Security Token (Restablecer mi token de seguridad).

  6. En la página Reset Token (Restablecer token), haga clic en el botón Reset Security Token (Restablecer token de seguridad).

  7. Recibirá un token de seguridad en el correo electrónico que haya registrado.

  8. Anexe la contraseña real del usuario al token de seguridad y realice la llamada.

  9. Se recibirá en la respuesta el token de acceso generado para conectarse a la organización de ventas.

  10. Copie y guarde el token de acceso.

    Nota: Nota: El token de acceso tiene un periodo de validez. Es posible que tenga que regenerar el token de acceso una vez que la llamada de API muestre el error de sesión caducada.
  11. Llame a Salesforce para obtener las diferentes cuentas disponibles.

  12. Copie su URL de Salesforce del correo electrónico recibido y genere la URL de solicitud como:

    Baseurl/services/data/version/query?q=SOQL query

  13. En la pestaña Headers (Encabezados) indique el par clave-valor:

    Clave: Authorization | Valor: Bearer {{Token de acceso}}

  14. Haga clic en Send (Enviar) y recibirá el resultado.

Para obtener más información sobre las consultas y las llamadas a la API de REST, consulte la guía del desarrollador de API de REST.

Conexión con Salesforce a través de Evolve

Para realizar la conexión con Salesforce a través de Evolve, siga estos pasos:

  1. Inicie sesión en el sitio de Evolve y vaya a la aplicación de administrador.

  2. En el panel de la izquierda, vaya a Conexiones.

  3. En la página Conexiones, vaya a la pestaña Orígenes de datos.

  4. Haga clic en Añadir para añadir una conexión de datos nueva. Rellene los datos (utilizamos la API: baseURL/services/data/v49.0/sobjects/Account/{id} para la demostración).

    Nota: Nota: La contraseña debe ser su contraseña real más el token de seguridad tal y como se ha utilizado en el ejemplo anterior de Postman.
  5. Haga clic en Guardar para guardar la conexión de datos.

Usar la conexión de datos creada en una solución de Composer

  1. Vaya a cualquier otra aplicación en el sitio de Evolve.

  2. En el panel de la izquierda, vaya a Soluciones. En la página Soluciones, seleccione la biblioteca de formularios y cree una solución de formulario nueva (mediante el botón Añadir solución).

  3. Vaya a la pestaña Formulario en la solución nueva y añada un id. de nombre de campo de formulario.

  4. Vaya a la pestaña Soluciones y, en Conexiones de datos, añada la conexión de datos e indique los detalles.

    Para crear la URL de API a partir del campo de formulario, siga estos pasos:

    1. En la URL de API, haga clic en los tres puntos de la derecha.

    2. En la página Generador de URL, vuelva a hacer clic en los tres puntos de la derecha para añadir el valor del campo a la URL.

    3. Haga clic en Valor de campo para seleccionar el campo de formulario.

    4. Seleccione el campo de formulario añadido en la página Formularios y haga clic en el botón Aceptar.

    5. La URL se creará así:

      /services/data/v49.0/sobjects/account/[/my:myFields/my:id]

  5. Utilice el esquema de salida como se indica a continuación (por ahora no tenemos ninguna función para obtener el esquema, analizamos los elementos de salida, entrada o error, y creamos el esquema en consecuencia).

    { "Id": "string", "IsDeleted": "bool", "Name": "string", "BillingStreet": "string", "BillingCity": "string", "BillingAddress": { "city": "string", "state": "string", "street": "string" }, "ShippingStreet": "string", "ShippingCity": "string", "ShippingState": "string" } 
  6. Una vez rellenados los datos, haga clic en el botón Aceptar para añadir la conexión de datos.

  7. En la pestaña Soluciones, haga clic con el botón secundario en la conexión de datos creada y seleccione la opción Crear campos de formulario.

  8. En el cuadro de diálogo Asignación de campos, rellene los detalles.

  9. Haga clic en Siguiente.

  10. En el cuadro de diálogo Asignación de campos, puede editar y realizar cualquier cambio en la asignación de campos si es necesario; de lo contrario, haga clic en Aceptar.

  11. Vaya a la pestaña Formulario en la solución de Composer y arrastre los campos necesarios relacionados con la conexión de datos en el formulario.

  12. Añada un botón al formulario y configure un servicio web para que se ejecute al hacer clic en el botón añadido.

    • Añada el elemento de servicio web a la pestaña Formulario.

    • Seleccione el servicio GET en la lista desplegable.

    • Marque la casilla Invocado por el botón.

  13. Vaya a la pestaña Solución → Implementar e inicie la solución.

  14. En el formulario iniciado, rellene el id. para el que desea obtener los datos (id.: 0012w00000UWpwPAAT) y haga clic en el botón añadido para ejecutar el servicio web.

  15. En el formulario deben aparecer los datos consultados.

  16. Se pueden utilizar otras operaciones, como POST, PUT, etc., del mismo modo, según las necesidades.

Para obtener más información, consulte la guía del desarrollador de API de REST.