Table des matières

Utilisation des datasources (sources de données) dans Zebrix

Zebrix vous permet d'utiliser des sources de données au sein de vos pages. De cette façon, plutôt que de saisir manuellement le contenu dans vos zones depuis l'éditeur de page, les contenus des zones sont, soit, synchronisés depuis une source de données externe ou peuvent être éditées depuis l'éditeur de source de données intégré à zebrix.

1. Principe de fonctionnement

Il y a essentiellement deux modes d'utilisation (qui peuvent être complémentaires). Soit vous pouvez créer des sources de données au sein de l'interface de zebrix et les modifier depuis l'interface.

Ou alors, vos sources de données existantes (base de données, données émanant d'un webservice, export CSV, etc.) peuvent être synchronisées avec le serveur zebrix de façon périodique (toute les X minutes/heures) ou lors d'un événement donné. Une fois que zebrix détecte que de ces données changent, il met à jour instantanément le contenu des écrans. Pour effectuer cette synchronisation, soit vous pouvez utiliser les API zebrix, ou alors utiliser une solution logicielle appelée le zebrix connector.

2. Comment créer et gérer les sources de données depuis l'interface de zebrix ?

Voici une vidéo tutoriel qui vous explique en détail comment procéder.

3. Comment synchroniser vos données avec zebrix ?

Il existe deux méthodes pour synchroniser vos données avec zebrix :

  • Le programme “Zebrix Connector” (actuellement en version alpha) est la solution la plus simple. Elle n'engendre aucun coût lié à un développement spécifique. Bien que répondant aux cas d'usage les plus courants, le Zebrix Connector comprend certaines limitations.
  • Le développement d'un programme de synchronisation spécifique s'avère la solution la plus flexible et efficiente mais engendre un coût et un délais de développement qu'il faut prendre en considération. Ce développement peut être pris en charge par l'équipe de développement Zebrix ou par tout développeur de votre choix auquel la marche à suivre pour exploiter les api Zebrix pourra être renseignée.

3.1 Utilisation du "Zebrix Connector"

Le Zebrix Connector est une solution logicielle de synchronisation de données sous Windows facile à prendre en main et composée de deux applicatifs :

  • un configurateur : vous permettant de définir facilement vos “liens de données” (datalinks) et d'affiner les données à synchroniser en appliquant des filtres et conditions.
  • un service Windows : tourne en tâche de fond et assure la synchronisation des données sur base des “liens de données” (datalinks) qui ont été configurés. La synchronisation est déclenchée soit sur base d'un intervalle spécifié (toutes les X secondes/minutes/heures) ou sur base de la détection d'un changement de données (uniquement avec les bases de données orientée fichier (csv, xls)).

Zebrix Connector doit être installé sur un poste Windows (serveur ou station de travail) ayant un accès à la base de données source et sur lequel un lien ODBC sera créé. Le Zebrix Connector est en principe compatible avec tout type de base de données pour lequel un driver 32 bits ODBC est existant pour Windows.

Attention, zebrix connector est uniquement compatible avec les liens ODBC de type “SYSTEM DSN” et exclusivement créés depuis l'utilitaire Windows ODBC en version 32 bits qui se trouve ici : C:\Windows\SysWOW64\odbcad32.exe

Testés par l'équipe Zebrix :

  • CSV
  • XLS (Microsoft Excel)
  • MDB (Microsoft Access)
  • MySQL
  • PostgreSQL
  • Microsoft SQL Server
  • Oracle

Pour les serveurs sous GNU/Linux, Mac OS, Unix ou autre OS ou source de donnée, le Zebrix Connector n'est pas disponible et le développement d'un connecteur spécifique est requis.

3.2 Développement d'un outil de synchronisation spécifique

L'équipe de développement Zebrix est en mesure de développer un connecteur spécifique qui pourra récupérer les données issues de votre SI, les adapter et les synchroniser dans Zebrix. Pour toute information à ce sujet, merci de prendre contact avec votre revendeur Zebrix ou avec support@zebrix.net

Demandes courantes pour un développement spécifique :

  • export CSV, export XML, export JSON
  • MySQL sous Linux ou Unix
  • PostgreSQL sous Linux ou Unix
  • Fichiers de données issus d'un serveur web, FTP ou Webservices

4. Installation du Zebrix Connector

Cliquez sur le fichier . Une fenêtre s'ouvrira. Suivez les instructions suivantes :

  • Début de l'installation, cliquez sur Next

  • Ici vous pouvez choisir de mettre un raccourci sur le bureau

  • Cliquez sur Install et c'est fini.

Un dossier “ZebrixConnector” se créera à la racine de C: avec tous les fichiers utiles à l'exécution du software. On peut vérifier que le service Windows “Zebrix Connector” est bien présent parmi les autres services comme suit

Démarche pour accéder à cette fenêtre : Démarrer > Exécuter > services.msc Sélectionner le service “Zebrix Connector” et cliquez sur Start en haut à gauche pour démarrer le service.

Pour démarrer le Zebrix Connector, cliquez sur l'icone

5. Guide de démarrage du Zebrix Connector

5.1 Ecran d'accueil

Ici on peut voir tous les Datalinks créés avec le Zebrix Connector et les informations les concernant : - son nom - sa fréquence de mise à jour - le nom des colonnes concercées

Les icônes :

  • Bouton création d'un DataLink
  • Bouton modification d'un DataLink
  • Bouton suppression d'un DataLink

5.2.1 Connexion

  • Pour commencer, cliquez sur le bouton de création d'un DataLink.
  • S'ensuit la première partie : la connexion à la base de donnée et choix d'une table

  • La connexion se fait via le driver ODBC créé au préalable. Il peut être créé dans 2 endroits différents :
    • User (utilisateur)
    • System (système)
  • La seconde option concerne le fait s'il faut un login/mot de passe pour se connecter à la base de données
  • Une fois les options choisies, on peut choisir la base de données et la table où l'on intervenir et envoyer les données (voir screen ci-dessous)

5.2.2 Filtres

  • Une fois la connexion effectuée, 2 onglets apparaissent :
    • Filters (Filtres)
    • Update & Save (Mise à jour et sauvegarde
  • On peut voir sur le screen ci-dessous les différents filtres que l'on peut appliquer sur notre table

  • Les différents filtres sont Check all / Uncheck all (tout cocher / tout décocher) ou alors, on ne coche que les colonnes concernées.
  • Number of rows (nombre de lignes) qui permet de limiter le résultat à un nombre voulu de lignes
  • Refresh (Rafraîchir) qui permet de mettre à jour visuellement la table selon les filtres appliqués
  • Il y a 3 Filtres plus “complexes” :
  • Permet sur une colonne donnée de choisir une fourchette de valeur (comprise entre 1 et 3 dans l'exemple qui suit)
  • Permet sur une colonne données de faire une comparaison (supérieur, inférieur, égale,…)

  • Permet sur une colonne donnée de remplacer une valeur par une autre (attention, ceci ne modifie en rien la valeur dans la base de données coté client, ce substitue ne se retrouvera que coté Zebrix)

  • Dans l'exemple suivant, les filtres “between” et “select” ont été mis en place. On veut les volumes qui sont compris entre 1 et 3 inclus (filtre between) et dont le nom de la série est TINTIN en affichant que les 5 premières colonnes.

  • Ensuite, on veut Faux à la place de False, on met donc en place le filtre “replace”

  • Sur cette page, on peut choisir la fréquence de mise à jour (en automatique pour des bases de données de type csv) en secondes, minutes ou heures.
  • On s'identifie auprès de Zebrix afin qu'il reçoive les données filtrées.
  • On nomme le DataLink pour qu'il puisse s'enregistrer correctement. Attention, il ne peut exister deux DataLinks avec un même nom, le nom doit être unique et propre à chaque Datalink.

  • Une fois les données et le timer choisi, il ne reste plus qu'à valider.

  • On peut constater sur le screen suivant que le DataLink est maintenant lister avec les autres.

  • Cliquer sur le bouton de modification permet de revenir à l'état les paramètres qu'on avait choisi lors de la création, ce qui permet de pouvoir effectuer les modifications plus rapidement. Par exemple, si on reprend le suivi de la création du DataLink ci-dessus, faire une modification nous permettrait de modifier directement les différents filtres appliqués (voir screen ci-dessous)

  • Une fois les modifications enregistrées, il suffit de sauvegarder le DataLink comme lors de sa création.
  • Attention : il n'est pas possible de changer la base de données et la table sur lesquelles les différents filtres s'appliquaient ni de modifier le nom du DataLink.

  • Cliquer sur le bouton suppression efface le DataLink du Zebrix Connector et les données correspondantes dans Zebrix.
  • Attention : un DataLink supprimé ne peut être récupéré, il faudra le recréer.

6. Utilisation des datasources sous Zebrix

  • Créez une page
  • Placez une zone
  • Sélection des datasources qui doivent pouvoir être disponibles dans la page
    1. Spécifiez qu'il s'agit d'une zone dynamique
    2. Spécifiez le champs souhaité
    3. Les données de la zone seront automatiquement modifiées à chaque synchronisation.