**This is an old revision of the document!**

Using data sources (data sources) in Zebrix

Zebrix lets you use data sources within your pages. This way, instead of manually entering the content in your zones, the contents are synchronized from a data source.

1. How does it work ?

Your existing data sources (databases, data from a webservice, CSV export, etc.) can be synchronized with the server zebrix periodically (every X minutes / hours) or at an event. Once zebrix detects that these data changes, it updates the contents of screens instantaneously.

2. How to synchronize data to zebrix ?

There are two ways to synchronize your data with zebrix:
* The “Zebrix Connector” program (currently in alpha) is the easiest solution. She no costs related to a specific development. While responding to the case of the most common usage, the Zebrix Connector includes certain limitations.
* The development of a specific synchronization program proves the most flexible and efficient solution but generates a cost and development time to be taken into consideration. This development can be supported by the development team Zebrix or by any developer of choice which the how to use the API Zebrix will be filled.

2.1 Usage of the "Zebrix Connector"

The Zebrix Connector is a software solution for synchronizing data on Windows easy to learn and consists of two applications:

  • A configurator: allowing you to easily define your “Data Links” (datalinks) and refine the data to be synchronized by applying filters and conditions.
    * A Windows service: runs in the background and ensures data synchronization based on the “data link” (datalinks) that have been configured.

Synchronization is initiated either on the basis of a specified interval (every X seconds / minutes / hours) or on the basis of the detection of a change of data (only with file oriented databases (csv, xls)). Zebrix Connector must be installed on a Windows computer (server or workstation) with access to the source database and ODBC on which a link will be created. The Zebrix Connector is in principle compatible with any database for which an ODBC driver exists for Windows is. Zebrix tested by the team:

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

For servers with GNU / Linux, Mac OS, Unix or other operating systems or data source, the Connector Zebrix is ​​not available and the development of a specific connector is required.

2.2 Development of a specific synchronization tool

The Zebrix development team is able to develop a specific connector that can retrieve data from your SI, adapt and synchronize in Zebrix. For information about this, thank you to contact your dealer or Zebrix support@zebrix.net Frequently Requested for a specific development:

  • CSV export, XML export, export JSON
    * MySQL on Linux or Unix
    * PostgreSQL on Linux or Unix
    * Data files from a web server, FTP or Web services

3. How to install the Zebrix Connector ?

Click on the file . A windows will open. Please follow instructions:

  • Start of the installation - click next

  • At this step you can choose to add a shortcut on your desktop

  • Click on install and it's done !

Folder “ZebrixConnector” will be created in the root of C: with all relevant files to the execution of software. One can verify that the Windows service “Zebrix Connector” is present among the other services as follows

Approach to access this window: Start> Run> services.msc Select the service “Zebrix Connector” and click Start at the top left to start the service.

To start the configurator click on this icon

4. Zebrix Connector startguide

4.1 homescreen

Here you can see all Datalinks created with Zebrix Connector and information about them:

  1. Its name
    - Its update frequency
    - The names of columns concercées

Icons :

  • To create a new DataLink
  • To edit an existing DataLink
  • To delete a DataLink

4.2.1 Connection

  • To begin, click on the create button a DataLink.
    • Follows the first part: the connection to the database and choosing a table

  • The connection is made via the ODBC driver previously created. It can be created in two different places:
    • User (User)
      * System (System)

      * The second option concerns the fact whether a login / password to connect to the database
      * Once selected options, you can choose the database and the table where we intervene and send the data (see screen below)

4.2.2 Filters

  • After connecting, two tabs appear:
    • Filters (Filters)
      * Update & Save (Update and Backup

      * You can see on the screen below the various filters that can be applied on our table

  • Different filters Check all / Uncheck all (just check / uncheck all) or so, we do not check that the relevant columns.
    • Number of rows (number of lines) which limits the result to a required number of lines
      * Refresh (Refresh) that visually update the table according to the filters applied
      * There are 3 filters more “complex”:
      * Allows a given column select a range of values ​​(between 1 and 3 in the following example)

  • Allow to filter by a value comparaison (>, <, =, ⇐, >=) on a given column

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

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.