DQE One Standalone puede leer y escribir datos directamente en su org de Salesforce, sin instalar el paquete DQE One. Los datos se leen y escriben a través de la API Bulk de Salesforce.
La conexión se basa en dos elementos:
- una External Client App en Salesforce, que utiliza el flujo JWT Bearer y un certificado;
- un conector Salesforce en el Standalone, que utiliza la Consumer Key de la app y la clave privada asociada al certificado.
Antes de empezar
Necesita una cuenta de administrador de Salesforce y un certificado con su clave privada. Si no dispone de uno, puede generar un certificado autofirmado con OpenSSL:
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out certificate.crtEste comando crea dos archivos: certificate.crt, que se carga en Salesforce, y private.key, que se introduce en el conector del Standalone. Guarde la clave privada en un lugar seguro y no la comparta.
Paso 1 – Crear la External Client App en Salesforce
- En Salesforce, vaya a Setup, busque External Client App Manager en Quick Find y haga clic en New External Client App.
- Introduzca un nombre y un correo electrónico de contacto para la app.
- Complete los parámetros OAuth de la siguiente manera:
| Parámetro | Valor |
|---|---|
| Enable OAuth | Marcado |
| Callback URL | Obligatorio, pero no se utiliza en este flujo. Cualquier URL válida sirve (p. ej. https://login.salesforce.com/services/oauth2/success). |
| OAuth Scopes | Manage user data via APIs (api) y Perform requests at any time (refresh_token, offline_access) |
| Enable JWT Bearer Flow | Marcado (es el parámetro clave) |
| Certificado | Cargue el archivo certificate.crt en la sección JWT Bearer Flow |
Deje el resto de parámetros con sus valores por defecto y guarde.
Configurar las policies
- Abra la pestaña Policies y haga clic en Edit.
- En OAuth Policies, establezca Permitted Users en Admin approved users are pre-authorized.
- En App Policies, seleccione los perfiles o permission sets autorizados a usar la app (por ejemplo System Administrator). El usuario de Salesforce utilizado para la conexión debe pertenecer a uno de ellos.
- Haga clic en Save.
Obtener la Consumer Key
- Abra la pestaña Settings y luego OAuth Settings.
- Haga clic en Consumer Key and Secret.
- Introduzca el código de verificación recibido por correo electrónico.
- Copie la Consumer Key. El Consumer Secret no es necesario.
Paso 2 – Crear el conector Salesforce en el Standalone
En DQE One Standalone, cree un nuevo conector de tipo Salesforce y complete los siguientes campos:
| Campo | Valor |
|---|---|
| Username | Nombre de usuario de la cuenta de Salesforce utilizada para la conexión |
| Salesforce Instance Url | URL de su org, tal como aparece en la barra de direcciones del navegador, sin barra final |
| External Client App Consumer Key | La Consumer Key copiada en el paso 1 |
| External Client App Private Key | El contenido del archivo private.key asociado al certificado cargado en el paso 1 |
Haga clic en Log In. Una vez establecida la conexión, el conector está disponible como origen en sus procesos.
Usar el conector en un proceso
Al seleccionar el conector Salesforce como origen, elija el objeto que desea procesar (por ejemplo Lead) y asigne los campos. El Standalone muestra todos los campos del objeto con su etiqueta, su nombre API y su tipo.
- Salida: por defecto, los resultados vuelven a la misma org de Salesforce. También puede seleccionar otra salida, incluido otro conector Salesforce (otra org).
- Sincronizar: marque esta opción para escribir los resultados en Salesforce. El Standalone crea automáticamente los campos de retorno en Salesforce si aún no existen.
- Merge: para sustituir los datos originales por los resultados, asigne los campos de retorno a los campos originales. El merge solo está disponible si esta asignación está definida.
Buena práctica: ejecute primero el proceso sin merge y revise los resultados. Una vez validados, vuelva al proceso y haga clic en Merge y después en Sync. No es necesario volver a ejecutar el proceso: los resultados ya están calculados. Durante las pruebas, utilice un filtro para limitar el número de registros procesados.
Relacionada con