DQE One Standalone peut lire et écrire des données directement dans votre org Salesforce, sans installer le package DQE One. Les données sont lues et écrites via l'API Bulk de Salesforce.
La connexion repose sur deux éléments :
- une External Client App dans Salesforce, utilisant le flux JWT Bearer et un certificat ;
- un connecteur Salesforce dans le Standalone, utilisant la Consumer Key de l'app et la clé privée associée au certificat.
Avant de commencer
Vous avez besoin d'un compte administrateur Salesforce et d'un certificat avec sa clé privée. Si vous n'en avez pas, vous pouvez générer un certificat auto-signé avec OpenSSL :
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out certificate.crtCette commande crée deux fichiers : certificate.crt, à déposer dans Salesforce, et private.key, à renseigner dans le connecteur du Standalone. Conservez la clé privée en lieu sûr et ne la partagez pas.
Étape 1 – Créer l'External Client App dans Salesforce
- Dans Salesforce, allez dans Setup, recherchez External Client App Manager dans Quick Find, puis cliquez sur New External Client App.
- Renseignez un nom et un e-mail de contact pour l'app.
- Complétez les paramètres OAuth comme suit :
| Paramètre | Valeur |
|---|---|
| Enable OAuth | Coché |
| Callback URL | Obligatoire mais non utilisé par ce flux. Toute URL valide convient (ex. https://login.salesforce.com/services/oauth2/success). |
| OAuth Scopes | Manage user data via APIs (api) et Perform requests at any time (refresh_token, offline_access) |
| Enable JWT Bearer Flow | Coché (c'est le paramètre essentiel) |
| Certificat | Déposez le fichier certificate.crt dans la section JWT Bearer Flow |
Laissez les autres paramètres par défaut et enregistrez.
Définir les policies
- Ouvrez l'onglet Policies et cliquez sur Edit.
- Dans OAuth Policies, réglez Permitted Users sur Admin approved users are pre-authorized.
- Dans App Policies, sélectionnez les profils ou permission sets autorisés à utiliser l'app (par exemple System Administrator). L'utilisateur Salesforce utilisé pour la connexion doit appartenir à l'un d'eux.
- Cliquez sur Save.
Récupérer la Consumer Key
- Ouvrez l'onglet Settings, puis OAuth Settings.
- Cliquez sur Consumer Key and Secret.
- Saisissez le code de vérification reçu par e-mail.
- Copiez la Consumer Key. Le Consumer Secret n'est pas nécessaire.
Étape 2 – Créer le connecteur Salesforce dans le Standalone
Dans DQE One Standalone, créez un nouveau connecteur de type Salesforce et renseignez les champs suivants :
| Champ | Valeur |
|---|---|
| Username | Nom d'utilisateur du compte Salesforce utilisé pour la connexion |
| Salesforce Instance Url | URL de votre org, telle qu'affichée dans la barre d'adresse du navigateur, sans slash final |
| External Client App Consumer Key | La Consumer Key copiée à l'étape 1 |
| External Client App Private Key | Le contenu du fichier private.key associé au certificat déposé à l'étape 1 |
Cliquez sur Log In. Une fois la connexion établie, le connecteur est disponible comme source dans vos process.
Utiliser le connecteur dans un process
Lorsque vous sélectionnez le connecteur Salesforce comme source, choisissez l'objet à traiter (par exemple Lead) et mappez les champs. Le Standalone affiche tous les champs de l'objet avec leur label, leur nom API et leur type.
- Sortie : par défaut, les résultats reviennent dans la même org Salesforce. Vous pouvez aussi sélectionner une autre sortie, y compris un autre connecteur Salesforce (une autre org).
- Synchroniser : cochez cette option pour écrire les résultats dans Salesforce. Le Standalone crée automatiquement les champs de retour dans Salesforce s'ils n'existent pas encore.
- Merge : pour remplacer les données d'origine par les résultats, mappez les champs de retour vers les champs d'origine. Le merge n'est disponible que si ce mapping est défini.
Bonne pratique : lancez d'abord le process sans merge et analysez les résultats. Une fois validés, revenez sur le process et cliquez sur Merge, puis sur Sync. Inutile de relancer le traitement : les résultats sont déjà calculés. En phase de test, utilisez un filtre pour limiter le nombre d'enregistrements traités.
Associé à