Datasource Online CSV


Apps - Datasource - CSV Online icon.png Ce type de datasource appartient à la catégorie Files de la bibliothèque des datasources. Il permet de récupérer des données dynamiques via un fichier au format CSV (Comma-Separated Values, format structuré de données textuelles) se trouvant soit sur un répertoire FTP, soit dans un service de stockage et partage de fichiers (ex. : Google Drive).

  • Une fois le fichier téléchargé, via son URL, définissez sa configuration : indiquez notamment quel est le séparateur de données permettant de découper chaque ligne en colonnes.
  • Les données du fichier sont ensuite automatiquement mises à jour toutes les fois que le fichier est réactualisé sur le réseau.

Remarques

 Open url.png  voir Remarques générales sur les datasources

  • Les fichiers stockés sur Google Drive doivent être convertis au préalable en fichier CSV pour pouvoir être interprétés par Product name - ev sas.png. Vous pouvez utiliser le générateur à l'adresse suivante : https://sites.google.com/site/gdocs2direct/.

Exemple

ExampleCSVFile

Récupérer à partir d'un fichier CSV le nombre d'incidents et de demandes par employé et par service :

  • Le fichier comporte une ligne d'en-têtes ==> propriété First Line Contains Column Titles cochée
  • Séparateur de colonnes = ; (point-virgule)
Data source
EVApps - datasource CSV - Example Datasource.png

Download Zip icon.png Téléchargez Exemple (fichier CSV)

Liste des propriétés

Content

Base Uri : URL d'accès au fichier CSV publié en ligne -  Open url.png voir Procédure Créer un fichier CSV On line depuis un document Google

Preview

Configure Field Types : Ouvre l'éditeur des types de champs permettant de sélectionner les champs du datasource et de spécifier la nature de chaque champ (Date, Integer, ...) lorsqu'elle ne peut pas être déterminée automatiquement.

  • Le bouton Apps - datasources Properties - Preview button.png situé sous la propriété indique le nombre de lignes (dans la limite de 15) et de colonnes extraites. Cliquez dessus pour ouvrir l'éditeur.
  • Le bouton affiche No data available tant que les éléments obligatoires du datasource ne sont pas sélectionnés.
  • En mode Édition, seuls les 15 premiers enregistrements du datasource sont affichés.
  • En mode Exécution, la totalité des enregistrements du datasource est affichée.
  • Pour un datasource statique, les données affichées sont celles issues du dernier téléchargement de fichier.
  • Pour un datasource dynamique, les données affichées sont celles en cours au moment où vous ouvrez l'application en mode Édition.
SelectFirstRowAsCurrentRecord

Select First Row As Current Record : Indique si le premier enregistrement du datasource est sélectionné par défaut sur les widgets qui l'affichent (case cochée), ou non (case non cochée).

NoDataMessage

No Data Message : Message affiché lorsque le datasource ne contient aucune donnée.

AutoRefresh

Auto Refresh (Note : Uniquement pour un datasource dynamique) : Indique la fréquence de rafraîchissement automatique des données du datasource, en heures/minutes.

  • La réactualisation s'effectue en mode Exécution et en mode Édition, au lancement de l'application et lors d'un réaffichage de la page.
  • Attention : La réactualisation des données provoque une activité supplémentaire sur la plate-forme Product name - ev sas.png.

    Best Practice icon.png

  • Définissez une fréquence de rafraîchissement automatique uniquement lorsque l'application doit rester affichée à l'écran durant une longue période et nécessite d'avoir en permanence les données en temps réel.
             Example documentation icon FR.png  Consultation d'un tableau de bord
  • Ne renseignez pas de fréquence de rafraîchissement automatique lorsque l'application est juste utilisée à un instant t.
             Example documentation icon FR.png  Affichage d'un portail avec consultation de catalogues
FirstLineContainsColumn

First Line Contains Column Titles : Indique si la première ligne du datasource contient les en-têtes des colonnes Dimension et Mesures (case cochée), ou des valeurs (case non cochée)  - Open url.png voir Structure habituelle d'un datasource

Case cochée Case non cochée

Apps - datasources Properties - First line Headers.png

  • La première ligne identifie les entêtes de colonne.

Apps - datasources Properties - First line Values.png

  • Une ligne d'entêtes est créée automatiquement.
  • Les colonnes sont numérotées de 0 à N, afin d'identifier les colonnes Dimension et Mesures dans le Data Transformer.
ColumnSeparatorCharacter

Column Separator Character : Caractère identifiant le séparateur de données dans le fichier .CSV, permettant de découper chaque ligne en colonnes. Il peut s'agir d'une virgule, d'un point-virgule ou d'une tabulation.

  • Cliquez sur le bouton sous la propriété Configure Field Types pour visualiser le résultat de votre paramétrage.

   Example documentation icon FR.png  Ligne du fichier .CSV : Service, Incident par employé

  • Séparateur de données = virgule  ==>  La ligne est découpée en 2 colonnes : Service ; Incident par employé  
  • Séparateur de données = tabulation  ==>  La ligne est découpée en une seule colonne : Service, Incident par employé
ColumnEnclosingCharacter

Column Enclosing Character : Caractère identifiant le délimiteur de texte dans le fichier .CSV (en général des guillemets), utilisé pour éviter tout conflit lié à la présence du séparateur de données (défini via la propriété Column Separator Character) dans une colonne.

  • Cliquez sur le bouton situé sous la propriété Configure Field Types pour visualiser le résultat de votre paramétrage.

   Example documentation icon FR.png  Ligne du fichier .CSV = Incident par employé, "2,7"  ;  Séparateur de données = virgule

  • Délimiteur de texte = guillemets  ==>  La ligne est découpée en 2 colonnes : Incident par employé ; 2,7
  • Délimiteur de texte = non renseigné  ==>  La ligne est découpée en 3 colonnes : Incident par employé ; "2 ; 7"
LineSeparatorCharacter

Line Separator Character : Séquence de caractères permettant d'identifier un changement de ligne dans le fichier .CSV (i.e. un changement d'enregistrement), variant suivant la plate-forme utilisée.

  • Sous Windows : \n\r = CR (Carriage Return) + LF (Line Feed)
  • Sous Linux ou Mac : \n = CR (Carriage Return)
DecimalSeparatorCharacter

Decimal Separator Character : Caractère identifiant le séparateur décimal dans le fichier .CSV (par défaut, un point).

ThousandSeparatorCharacter

Thousand Separator Character : Caractère identifiant le séparateur de millier dans le fichier .CSV (par défaut, un espace).

Master/Detail

SectionMasterDetail

Master Datasource : Nom du datasource maître lié au datasource courant, dans une relation maître-détail.

Master Field : Nom de la clé principale du datasource maître, faisant la liaison avec le datasource courant.

  • Généralement, il s'agit de la colonne PK (Primary Key) de la table Product name - ev itsm.png.

Detail Field : Nom de la colonne du datasource courant identifiant la clé de la table Product name - ev itsm.png.

  • Généralement, il s'agit d'une colonne préfixée par FK (Foreign Key).

Example documentation icon FR.png  Afficher toutes les actions (datasource Détail) d'un incident (datasource Maître) :

  • Master Datasource = datasource Incidents défini via la requête parent Operation/Incidents/All Incidents
  • Master Field = PK identifiant la colonne Incident_ID de la table Incidents
  • Detail Field = FK_AM_ACTION_REQUEST_ID identifiant le numéro de l'action liée à l'incident

Procédure : Comment créer un fichier CSV Online depuis un document Google

1. Ouvrez votre fichier dans Google Docs, Google Sheets ou Google Slides.

2. Cliquez sur Fichier > Publier sur le web.

3. Sélectionnez les données que vous souhaitez mettre en ligne (par défaut, la totalité du fichier est publié) et sélectionnez l'option Valeurs séparées par virgules (.csv).

4. Cliquez sur [ PUBLIER ] et copiez le lien généré.

5. Retournez sur votre application et collez le lien dans la propriété Base Uri du widget. Cliquez sur le bouton situé sous la propriété Preview pour contrôler les données exportées.

Exemples d'intégration

Google Analytics Logo - Google Analytics.png 

Google Sheets Logo - Google Sheets.png 

Tags:
Modifié par Utilisateur inconnu le 2017/09/01 16:48
Créé par Administrator XWiki le 2014/11/12 20:38

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020