Connecter une source de données dans DQE One Standalone

Avant de pouvoir créer un process, un DataPipeline ou un RuleSet, vous devez connecter au moins une source de données. DQE One Standalone prend en charge 7 types de sources : Salesforce, Microsoft Dynamics 365, PostgreSQL, BigQuery, Snowflake, SFTP et le téléversement de fichier CSV.

Où connecter une source de données

Vous pouvez connecter une source de données à partir de deux endroits :

• L'étape Data Source de l'assistant de création de process (ou de DataPipeline, ou de RuleSet) — titre "Choose your data source", avec une section "Connect to your software" indiquant "Select your software plugin and log in to your software. A system administrator account is required."
• My Account → Credentials — une section accordéon ("Update your credentials here") où vous pouvez créer une connexion à l'avance, indépendamment de tout process. Choisissez un connecteur dans la liste Select connector, puis cliquez sur New.

Les deux endroits ouvrent exactement le même formulaire de connexion, donc tout ce qui suit s'applique aux deux points d'entrée.

Réutiliser une connexion existante

Si vous avez déjà connecté une source donnée, la fenêtre de connexion affiche vos identifiants enregistrés sous forme de cartes (avec un point vert ou rouge indiquant si la connexion est actuellement valide) — cliquez sur l'une d'elles pour la réutiliser sans ressaisir quoi que ce soit. Cliquez sur Use another account pour ouvrir un formulaire vide à la place, ou sur Back to existing account pour revenir à la liste enregistrée.

Salesforce

Cliquez sur Connect to Salesforce, puis renseignez :

• Username
• Salesforce Instance Url
• External Client App Consumer Key
• External Client App Private Key — téléversez ou collez votre clé privée au format PEM (doit commencer par -----BEGIN PRIVATE KEY----- et se terminer par -----END PRIVATE KEY-----), délivrée par votre External Client App Salesforce.

Puis cliquez sur Log In.

Il s'agit d'un formulaire d'identifiants direct, pas d'une fenêtre de connexion Salesforce interactive — il n'y a aucun écran de consentement à valider. L'Instance Url doit être un domaine Salesforce réel, sinon la connexion est rejetée.

Où trouver ces informations dans Salesforce

• Username : le nom d'utilisateur Salesforce d'un utilisateur disposant d'un accès API (souvent un utilisateur d'intégration dédié).
• Salesforce Instance Url : l'URL utilisée pour vous connecter à cet org (ex. https://yourcompany.my.salesforce.com), également affichée sous Setup → Company Information.
• External Client App Consumer Key / Private Key : créez une External Client App dans Setup → External Client App Manager → New External Client App, activez OAuth, sélectionnez le JWT Bearer Flow, puis téléversez un certificat numérique. Vous générez vous-même ce certificat et sa clé privée associée au préalable (par exemple avec OpenSSL) — ne téléversez que le certificat sur Salesforce et conservez la clé privée pour la coller ici. Une fois l'app enregistrée, Salesforce affiche sa Consumer Key.

Microsoft Dynamics 365

Cliquez sur Connect to Dynamics, puis renseignez :

• Tenant
• Client Id
• Client Secret
• Scope — l'URL de votre environnement Dynamics (ex. https://yourorg.crm.dynamics.com/.default).

La case Migrate Run & Process est cochée par défaut. Laissez-la cochée la première fois que vous connectez un org Dynamics donné — après la connexion, DQE One Standalone pousse les métadonnées Process/Run vers Dynamics pour qu'elles y soient également suivies (une barre de progression s'affiche pendant l'opération).

Cliquez sur Log In. Une fenêtre de connexion Microsoft s'ouvre — connectez-vous et consentez, puis fermez la page de confirmation affichée ("Successfully Connected"). DQE One Standalone termine la connexion automatiquement une fois cela fait.

Prérequis : votre équipe informatique doit créer une App Registration Azure AD (vous donnant le Tenant ID, le Client ID et le Client Secret ci-dessus) avec une URI de redirection {votre URL DQE One Standalone}/dynamics/code.

Où trouver ces informations dans Azure / Dynamics

• Tenant et Client Id : dans le portail Azure, sous Microsoft Entra ID → App registrations, ouvrez votre app registration — sa page Overview affiche le Directory (tenant) ID et l'Application (client) ID.
• Client Secret : sur la même app registration, allez dans Certificates & secrets → New client secret. Copiez la Value immédiatement — Azure ne l'affiche qu'une seule fois.
• Scope (l'URL de votre environnement) : dans le Power Platform admin center → Environments, ouvrez votre environnement — son Environment URL est affichée sur la page Details.
• URI de redirection : ajoutez-la vous-même sur l'app registration, sous Authentication → Add a platform → Web.

PostgreSQL

Cliquez sur Connect to Postgres, renseignez Host, Port, Username, Password et Database, puis cliquez sur Log In. Assurez-vous que la base est accessible depuis le serveur de DQE One Standalone (accès réseau/pare-feu).

Où trouver ces informations

Ce sont les informations de connexion de votre propre serveur PostgreSQL — demandez à la personne qui gère cette base (votre DBA ou équipe infrastructure) l'hôte, le port, le nom de la base et un identifiant/mot de passe ayant accès à celle-ci.

BigQuery

Cliquez sur Connect to BigQuery. Ouvrez le fichier JSON de la Service Account téléchargé depuis Google Cloud Console et recopiez ces 5 valeurs :

• Client Id
• Client Email
• Project Id
• Private Key Id
• Private Key — téléversez ou collez la valeur au format PEM (le champ private_key du fichier JSON).

Puis cliquez sur Log In.

Où trouver ces informations

Dans Google Cloud Console, allez dans IAM & Admin → Service Accounts, sélectionnez (ou créez) la service account à utiliser, ouvrez son onglet Keys, puis Add Key → Create new key → JSON. Cela télécharge un fichier JSON contenant les 5 valeurs ci-dessus — ouvrez-le et copiez chaque champ dans la case correspondante.

Snowflake

Cliquez sur Connect to Snowflake, puis renseignez :

• Host — l'hôte de votre compte Snowflake, se terminant par .snowflakecomputing.com.
• Client Id
• Client Secret

Cliquez sur Log In. Une fenêtre de connexion Snowflake s'ouvre — connectez-vous et autorisez, puis fermez la page de confirmation. Les connexions Snowflake passent toujours par cette étape (y compris à chaque rafraîchissement silencieux de la connexion en arrière-plan par la suite).

Prérequis : votre administrateur Snowflake doit configurer une Security Integration (client OAuth) vous donnant le Client ID/Secret ci-dessus, avec une URI de redirection {votre URL DQE One Standalone}/snowflake/code.

Où trouver ces informations

Votre Host est l'identifiant de votre compte Snowflake suivi de .snowflakecomputing.com (visible dans l'URL que vous utilisez pour ouvrir Snowflake, ou sous Admin → Accounts). Le Client Id et le Client Secret proviennent de la Security Integration — un ACCOUNTADMIN Snowflake la crée avec une instruction CREATE SECURITY INTEGRATION ... TYPE = OAUTH, puis récupère le secret avec SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('integration_name'). Demandez à votre administrateur Snowflake si vous n'avez pas vous-même l'accès ACCOUNTADMIN.

SFTP

Cliquez sur Connect to SFTP, renseignez Host, Port et Username, puis choisissez une méthode d'authentification :

• Password — saisissez votre Password.
• Key Pair — collez le contenu de votre Private Key, et éventuellement son Private Key Password.

Cliquez sur Log In.

Prérequis : votre hôte SFTP doit être ajouté à une liste blanche avant de pouvoir vous connecter — l'Host que vous saisissez ici doit la correspondre exactement. Cette liste blanche est un paramètre côté serveur de la machine qui héberge DQE One Standalone lui-même, pas quelque chose de configurable depuis l'app :

• Si vous hébergez vous-même DQE One Standalone, c'est votre propre équipe infrastructure qui ajoute l'hôte à la configuration de ce serveur.
• Si c'est DQE Software qui l'héberge pour vous, demandez à votre chef de projet DQE ou au support DQE de l'ajouter.

Si vous voyez un message "not allowed" lors de la connexion, c'est le premier point à vérifier.

Une fois connecté, vous choisirez 4 emplacements sur le serveur SFTP : un Input file, un Output directory, un Logs directory et un Reject directory (les fichiers qui échouent à la lecture pendant un run y sont déplacés). En parcourant les fichiers, vous pouvez saisir un masque de nom de fichier avec les jokers * et ? pour sélectionner plusieurs fichiers correspondants à la fois.

Téléversement de fichier CSV

Dans l'assistant, choisissez Import data files et glissez un fichier CSV sur la zone de dépôt (ou cliquez pour parcourir). Il n'y a aucune étape de connexion ni rien à configurer au préalable — le fichier est téléversé directement.

Gérer les identifiants enregistrés

Allez dans My Account → Credentials pour voir toutes les connexions que vous avez enregistrées, avec leur type de connecteur et leur identifiant masqué. Depuis cet écran, vous pouvez :

• Créer une nouvelle connexion à l'avance (bouton New), sans avoir besoin de démarrer un process au préalable.
• Delete une connexion — possible uniquement si elle n'est utilisée par aucun Process ou RuleSet existant.

Le bouton Edit d'un identifiant enregistré est toujours désactivé — vous ne pouvez pas actuellement modifier les détails d'une connexion enregistrée depuis cet écran. Pour changer des identifiants, supprimez l'ancienne connexion (une fois inutilisée) et créez-en une nouvelle.