Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:datasource [2015/11/12 18:14]
sroy
+++ fr:datasource [2021/08/25 10:29] (Version actuelle)
@@ Ligne 1: / Ligne 1: @@
 ====== - 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.
+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.
 ===== - 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.
+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**.
+===== - 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.
+{{youtube>ne_2FytAjng?large}}
 ===== - Comment synchroniser vos données avec zebrix ? =====
@@ Ligne 22: / Ligne 31: @@
   * ** 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.
+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.
+<WRAP center round important 80%>
+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**
+</WRAP>
 Testés par l'équipe Zebrix :
@@ Ligne 49: / Ligne 63: @@
 ===== - Installation du Zebrix Connector =====
-Dézipper le fichier "Zebrix Connector Install".
+Cliquez sur le fichier {{public_media:zebrix_connector_setup_1.jpg?nolink|}}.
-Une fois fait, vous trouverez le fichier {{:zebrix_connector_-_installer.jpg?nolink&200|}}.
+Une fenêtre s'ouvrira. Suivez les instructions suivantes :
-Double cliquez dessus pour lancer l'installation du logiciel.
+  * Début de l'installation, cliquez sur Next
+{{public_media:zebrix_connector_setup_2.jpg?nolink|}}
+  * Ici vous pouvez choisir de mettre un raccourci sur le bureau
+{{public_media:zebrix_connector_setup_3.jpg?nolink|}}
+  * Cliquez sur Install et c'est fini.
+{{public_media:zebrix_connector_setup_4.jpg?nolink|}}
 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
-{{:zebrix_connector_-_service_windows.jpg?nolink|}}
+{{public_media:zebrix_connector_-_service_windows.jpg?nolink|}}
@@ Ligne 62: / Ligne 91: @@
 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 {{:zebrix_connector_-_executable.jpg?nolink&200|}}
+Pour démarrer le Zebrix Connector, cliquez sur l'icone {{public_media:zebrix_connector_-_executable.jpg?nolink&200|}}
 ===== - Guide de démarrage du Zebrix Connector =====
@@ Ligne 68: / Ligne 97: @@
 ==== - Ecran d'accueil ====
-{{:zebrix_connector_-_accueil.jpg?nolink|}}
+{{public_media:zebrix_connector_-_accueil.jpg?nolink|}}
 Ici on peut voir tous les Datalinks créés avec le Zebrix Connector et les informations les concernant :
@@ Ligne 77: / Ligne 106: @@
 Les icônes :
-  * {{:zebrix_connector_-_btn_creation.jpg?nolink|}} Bouton création d'un DataLink
+  * {{public_media:zebrix_connector_-_btn_creation.jpg?nolink|}} Bouton création d'un DataLink
-  * {{:zebrix_connector_-_btn_modification.jpg?nolink|}} Bouton modification d'un DataLink
+  * {{public_media:zebrix_connector_-_btn_modification.jpg?nolink|}} Bouton modification d'un DataLink
-  * {{:zebrix_connector_-_btn_suppression.jpg?nolink|}} Bouton suppression d'un DataLink
+  * {{public_media:zebrix_connector_-_btn_suppression.jpg?nolink|}} Bouton suppression d'un DataLink
 ==== - Etapes de la création d'un DataLink ====
@@ Ligne 88: / Ligne 117: @@
   * S'ensuit la première partie : la connexion à la base de donnée et choix d'une table
-{{:zebrix_connector_-_creation_-_etape_01.jpg?nolink|}}
+{{public_media:zebrix_connector_-_creation_-_etape_01.jpg?nolink|}}
   * La connexion se fait via le driver ODBC créé au préalable. Il peut être créé dans 2 endroits différents :
@@ Ligne 96: / Ligne 125: @@
   * 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)
-{{:zebrix_connector_-_creation_-_etape_02.jpg?nolink|}}
+{{public_media:zebrix_connector_-_creation_-_etape_02.jpg?nolink|}}
 === - Filtres ===
@@ Ligne 105: / Ligne 134: @@
   * On peut voir sur le screen ci-dessous les différents filtres que l'on peut appliquer sur notre table
-{{:zebrix_connector_-_creation_-_etape_03.jpg?nolink|}}
+{{public_media:zebrix_connector_-_creation_-_etape_03.jpg?nolink|}}
   * Les différents filtres sont Check all / Uncheck all (tout cocher / tout décocher) ou alors, on ne coche que les colonnes concernées.
@@ Ligne 111: / Ligne 140: @@
   * Refresh (Rafraîchir) qui permet de mettre à jour visuellement la table selon les filtres appliqués
   * Il y a 3 Filtres plus "complexes" :
-{{:zebrix_connector_-_filter_between.jpg?nolink|}}
-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ée de choisir une fourchette de valeur (comprise entre 1 et 3 dans l'exemple qui suit)
+{{public_media:zebrix_connector_-_filter_between.jpg?nolink|}}
+  * Permet sur une colonne données de faire une comparaison (supérieur, inférieur, égale,...)
+{{public_media:zebrix_connector_-_filter_comparator.jpg?nolink|}}
+  * 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)
+{{public_media:zebrix_connector_-_filter_replace.jpg?nolink|}}
+  * 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.
+{{public_media:zebrix_connector_-_creation_-_etape_04.jpg?nolink|}}
+  * Ensuite, on veut Faux à la place de False, on met donc en place le filtre "replace"
+{{public_media:zebrix_connector_-_creation_-_etape_05.jpg?nolink|}}
+=== - Timer de la mise à jour et enregistrement du DataLink ===
+  * 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.
+{{public_media:zebrix_connector_-_creation_-_etape_06.jpg?nolink|}}
+  * Une fois les données et le timer choisi, il ne reste plus qu'à valider.
+{{public_media:zebrix_connector_-_creation_-_etape_07.jpg?nolink|}}
+  * On peut constater sur le screen suivant que le DataLink est maintenant lister avec les autres.
+{{public_media:zebrix_connector_-_creation_-_etape_08.jpg?nolink|}}
+==== - Modification d'un DataLink ====
+  * 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)
+{{public_media:zebrix_connector_-_creation_-_etape_05.jpg?nolink|}}
-{{:zebrix_connector_-_filter_comparator.jpg?nolink|}}
+  * 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.
-Permet sur une colonne données de faire une comparaison (supérieur, inférieur, égale,...)
+==== - Suppression d'un DataLink ====
-{{:zebrix_connector_-_filter_replace.jpg?nolink|}}
+  * 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.
-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)
@@ Ligne 129: / Ligne 198: @@
   - Créez une page
   - Placez une zone
-  - Sélection des datasources qui doivent pouvoir être disponibles dans la page {{ :fr_datasource_selection.jpg?nolink |}} {{ :fr_datasource_selectionlist.jpg?nolink |}}
+  - Sélection des datasources qui doivent pouvoir être disponibles dans la page {{ public_media:fr_datasource_selection.jpg?nolink |}} {{ public_media:fr_datasource_selectionlist.jpg?nolink |}}
-  -Spécifiez qu'il s'agit d'une zone dynamique {{ ::fr_datasource_zonetype.jpg?nolink |}}
+  -Spécifiez qu'il s'agit d'une zone dynamique {{ public_media:fr_datasource_zonetype.jpg?nolink |}}
-  -Spécifiez le champs souhaité {{ :fr_datasource_fieldselection.jpg?nolink |}} {{ :fr_datasource_fieldselection2.jpg?nolink |}}
+  -Spécifiez le champs souhaité {{ public_media:fr_datasource_fieldselection.jpg?nolink |}} {{ public_media:fr_datasource_fieldselection2.jpg?nolink |}}
   -Les données de la zone seront automatiquement modifiées à chaque synchronisation.