Conectar una fuente de datos en DQE One Standalone

Antes de poder crear un process, un DataPipeline o un RuleSet, debe conectar al menos una fuente de datos. DQE One Standalone admite 7 tipos de fuentes: Salesforce, Microsoft Dynamics 365, PostgreSQL, BigQuery, Snowflake, SFTP y la carga de archivos CSV.

Dónde conectar una fuente de datos

Puede conectar una fuente de datos desde dos lugares:

• El paso Data Source del asistente de creación de process (o de DataPipeline, o de RuleSet) — título "Choose your data source", con una sección "Connect to your software" que indica "Select your software plugin and log in to your software. A system administrator account is required."
• My Account → Credentials — una sección acordeón ("Update your credentials here") donde puede crear una conexión de antemano, independientemente de cualquier process. Elija un conector en la lista Select connector, luego haga clic en New.

Ambos lugares abren exactamente el mismo formulario de conexión, por lo que todo lo siguiente se aplica a cualquiera de los dos puntos de entrada.

Reutilizar una conexión existente

Si ya ha conectado una fuente determinada anteriormente, la ventana de conexión muestra sus credenciales guardadas como tarjetas (con un punto verde o rojo que indica si la conexión es válida actualmente) — haga clic en una para reutilizarla sin volver a introducir nada. Haga clic en Use another account para abrir un formulario en blanco, o en Back to existing account para volver a la lista guardada.

Salesforce

Haga clic en Connect to Salesforce y complete:

• Username
• Salesforce Instance Url
• External Client App Consumer Key
• External Client App Private Key — cargue o pegue su clave privada en formato PEM (debe comenzar con -----BEGIN PRIVATE KEY----- y terminar con -----END PRIVATE KEY-----), emitida por su External Client App de Salesforce.

Luego haga clic en Log In.

Se trata de un formulario de credenciales directo, no de una ventana emergente de inicio de sesión interactiva de Salesforce — no hay ninguna pantalla de consentimiento que aceptar. La Instance Url debe ser un dominio real de Salesforce, de lo contrario la conexión se rechaza.

Dónde encontrar esta información en Salesforce

• Username: el nombre de usuario de Salesforce de un usuario con acceso a la API (a menudo un usuario de integración dedicado).
• Salesforce Instance Url: la URL que usa para iniciar sesión en este org (p. ej. https://yourcompany.my.salesforce.com), también mostrada en Setup → Company Information.
• External Client App Consumer Key / Private Key: cree una External Client App en Setup → External Client App Manager → New External Client App, active OAuth, seleccione el JWT Bearer Flow, y cargue un certificado digital. Usted genera el certificado y su clave privada correspondiente de antemano (por ejemplo con OpenSSL) — cargue solo el certificado en Salesforce y conserve la clave privada para pegarla aquí. Una vez guardada la app, Salesforce le muestra su Consumer Key.

Microsoft Dynamics 365

Haga clic en Connect to Dynamics y complete:

• Tenant
• Client Id
• Client Secret
• Scope — la URL de su entorno de Dynamics (p. ej. https://yourorg.crm.dynamics.com/.default).

La casilla Migrate Run & Process está marcada de forma predeterminada. Déjela marcada la primera vez que conecte un determinado org de Dynamics — tras iniciar sesión, DQE One Standalone enviará los metadatos de Process/Run a Dynamics para que también se puedan seguir allí (aparece una barra de progreso mientras esto ocurre).

Haga clic en Log In. Se abrirá una ventana de inicio de sesión de Microsoft — inicie sesión y consienta, luego cierre la página de confirmación que se muestra ("Successfully Connected"). DQE One Standalone terminará de conectarse automáticamente en cuanto lo haga.

Requisito previo: su equipo de TI debe crear un Azure AD App Registration (que le proporcione el Tenant ID, el Client ID y el Client Secret anteriores) con una URI de redirección {su URL de DQE One Standalone}/dynamics/code.

Dónde encontrar esta información en Azure / Dynamics

• Tenant y Client Id: en Azure Portal, en Microsoft Entra ID → App registrations, abra su app registration — su página Overview muestra el Directory (tenant) ID y el Application (client) ID.
• Client Secret: en la misma app registration, vaya a Certificates & secrets → New client secret. Copie el Value inmediatamente — Azure solo lo muestra una vez.
• Scope (la URL de su entorno): en Power Platform admin center → Environments, abra su entorno — su Environment URL se muestra en la página Details.
• URI de redirección: añádala usted mismo en la app registration, en Authentication → Add a platform → Web.

PostgreSQL

Haga clic en Connect to Postgres, complete Host, Port, Username, Password y Database, y luego haga clic en Log In. Asegúrese de que la base de datos sea accesible desde el servidor de DQE One Standalone (acceso de red/ firewall).

Dónde encontrar esta información

Estos son los datos de conexión de su propio servidor PostgreSQL — pregunte a quien administre esa base de datos (su DBA o equipo de infraestructura) por el host, el puerto, el nombre de la base de datos y un usuario/contraseña con acceso a ella.

BigQuery

Haga clic en Connect to BigQuery. Abra el archivo JSON de la Service Account descargado desde Google Cloud Console y copie estos 5 valores:

• Client Id
• Client Email
• Project Id
• Private Key Id
• Private Key — cargue o pegue el valor en formato PEM (el campo private_key del archivo JSON).

Luego haga clic en Log In.

Dónde encontrar esta información

En Google Cloud Console, vaya a IAM & Admin → Service Accounts, seleccione (o cree) la service account a usar, abra su pestaña Keys, luego Add Key → Create new key → JSON. Esto descarga un archivo JSON con los 5 valores anteriores — ábralo y copie cada campo en la casilla correspondiente.

Snowflake

Haga clic en Connect to Snowflake y complete:

• Host — el host de su cuenta de Snowflake, terminado en .snowflakecomputing.com.
• Client Id
• Client Secret

Haga clic en Log In. Se abrirá una ventana de inicio de sesión de Snowflake — inicie sesión y autorice, luego cierre la página de confirmación. Las conexiones de Snowflake siempre pasan por este paso (incluso cada vez que la conexión se renueva silenciosamente en segundo plano después).

Requisito previo: su administrador de Snowflake debe configurar una Security Integration (cliente OAuth) que le proporcione el Client ID/Secret anteriores, con una URI de redirección {su URL de DQE One Standalone}/snowflake/code.

Dónde encontrar esta información

Su Host es el identificador de su cuenta de Snowflake seguido de .snowflakecomputing.com (visible en la URL que usa para abrir Snowflake, o en Admin → Accounts). El Client Id y el Client Secret provienen de la Security Integration — un ACCOUNTADMIN de Snowflake la crea con una instrucción CREATE SECURITY INTEGRATION ... TYPE = OAUTH, y luego recupera el secreto con SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('integration_name'). Pregunte a su administrador de Snowflake si usted no tiene acceso ACCOUNTADMIN.

SFTP

Haga clic en Connect to SFTP, complete Host, Port y Username, y luego elija un método de autenticación:

• Password — introduzca su Password.
• Key Pair — pegue el contenido de su Private Key, y opcionalmente su Private Key Password.

Haga clic en Log In.

Requisito previo: su host SFTP debe añadirse a una lista blanca antes de poder conectarse — el Host que escriba aquí debe coincidir exactamente. Esta lista blanca es una configuración del lado del servidor de la máquina que aloja DQE One Standalone, no algo configurable desde la propia app:

• Si usted mismo aloja DQE One Standalone, es su propio equipo de infraestructura quien añade el host a la configuración de ese servidor.
• Si es DQE Software quien lo aloja por usted, pida a su gestor de proyecto de DQE o al soporte de DQE que lo añada.

Si ve un mensaje "not allowed" al conectar, esto es lo primero que hay que comprobar.

Una vez conectado, elegirá 4 ubicaciones en el servidor SFTP: un Input file, un Output directory, un Logs directory y un Reject directory (los archivos que no se pueden leer durante un run se mueven aquí). Al explorar archivos, puede escribir una máscara de nombre de archivo con los comodines * y ? para seleccionar varios archivos coincidentes a la vez.

Carga de archivos CSV

En el asistente, elija Import data files y arrastre un archivo CSV a la zona de colocación (o haga clic para explorar). No hay ningún paso de inicio de sesión ni nada que configurar de antemano — el archivo se carga directamente.

Gestionar credenciales guardadas

Vaya a My Account → Credentials para ver todas las conexiones que ha guardado, con su tipo de conector e inicio de sesión enmascarado. Desde aquí puede:

• Crear una nueva conexión de antemano (botón New), sin necesidad de iniciar primero un process.
• Delete una conexión — solo posible si no la usa ningún Process o RuleSet existente.

El botón Edit de una credencial guardada está siempre desactivado — actualmente no puede actualizar los detalles de una conexión guardada desde esta pantalla. Para cambiar credenciales, elimine la conexión antigua (una vez que no esté en uso) y cree una nueva.