**Ceci est une ancienne révision du document !**

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, les contenus sont synchronisés depuis une source de données.

1. Principe de fonctionnement

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.

2. 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.

2.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 ODBC est existant pour Windows.

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.

2.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

3. Installation du Zebrix Connector

Dézipper le fichier “Zebrix Connector Install”. Une fois fait, vous trouverez le fichier . Double cliquez dessus pour lancer l'installation du logiciel. 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

4. Guide de démarrage du Zebrix Connector

4.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

4.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. 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.