Connexions

L'objet connexion est un composant d'Onyx permettant d'établir une connexion avec une multitude de technologies différentes :

• Base de données
• Fichiers
• API
• ...

L'objet connexion nécessite un nom (code), un département (unité d'organisation), ainsi qu'un type de connexion.

Si l'on souhaite que la connexion soit utilisable dans des scripts SQL, il est nécessaire de cocher la case "Accessible en écriture".

Si la connexion est de type fichier, il est impératif de créer un composant "Serveurs de fichiers".

Il est possible de ne récupérer qu'un seul schéma d'une connexion en renseignant le champ "SchemaFilter".

Après avoir enregistré la connexion, on a accès au volet "Paramètres" dans lequel il sera nécessaire de renseigner tous les paramètres de connexion.

Connexions - Base de données

Cet écran de connexion est identique pour les technologies suivantes :

• PostgreSQL ;
• SSMS ;
• Oracle ;
• MySQL.

Connexions - API

Cette interface permet de se connecter à une API.

Les méthodes "Get" et "Post" sont disponibles. L'option loop permet de récupérer les données par paquets (batch).

Connexions - Fichiers

Pour toutes les connexions à des fichiers, la création d'un serveur de fichiers est nécessaire, sur lequel l'objet connexion pointera.

En adaptant l'option FileMask, il est possible de :

• Récupérer uniquement les fichiers portant l'extension souhaitée (ex : .*.csv) ;
• Récupérer l'ensemble des fichiers du file provider (ex : .*.) ;
• Récupérer un fichier uniquement (ex : monfichier.txt).

Connexions - Fichiers délimités

Cette interface permet de se connecter à tout type de fichier. Toutefois, il est important de choisir judicieusement le "delimiter".

Connexions - Fichiers Excel

Cette interface permet de se connecter à un fichier XLSX.

Connexions - Fichiers PDF

Cette interface permet de se connecter à un fichier PDF.

Connexions - Zuora

Cette interface permet de se connecter à un service Zuora.

Connexions - Salesforce

Cette interface permet de se connecter à un service Salesforce.

Vérifier la connexion

Pour vérifier la connexion, il faut se rendre sur la rubrique "PARAMÈTRES" puis presser le bouton "TESTER".

Récupérer les données d'une connexion

Une fois la connexion créée et testée, récupérer les métadonnées. Pour cela, se rendre sur la page "STRUCTURE DE DONNÉES" et sélectionner le bouton "ANALYSER".

Les objets trouvés sont alors mis à jour dans le tableau. Si l'analyse prend beaucoup de temps et que seuls les objets d'un schéma doivent être importés, alors spécifier un filtre de schéma peut être une solution.

Secrets

Ce composant est compatible avec les secrets.

Les secrets permettent de variabiliser certains champs comme les options de connexion (User, password, host, ...) afin de sécuriser et de rendre ces différents éléments inaccessibles.

Pour utiliser un secret, dans les paramètres de connexion, inscrire dans le champ souhaité la clef du secret entre double accolade :

{{Secret}}