Datasource CSV


Apps - Datasource - CSV 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 statiques via un fichier au format CSV (Comma-Separated Values, format structuré de données textuelles) se trouvant sur un serveur local.
Une fois le fichier téléchargé, définissez sa configuration : indiquez notamment quel est le séparateur de données permettant de découper chaque ligne en colonnes.

Remarques

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

  • Il n'y a pas de rafraîchissement automatique des données du datasource : il revient à l'administrateur de l'application de télécharger à nouveau le fichier CSV pour les réactualiser. 
  • Si les données sont susceptibles de varier régulièrement, utilisez un datasource dynamique CSV Online.

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)

EndCsvOnlineFile

Liste des propriétés

Content

LastModifiedUploadedFile

Last Modified Uploaded File : Date de dernier téléchargement du fichier.

ChooseFile

Choose A File : Permet de sélectionner le fichier via la boîte de dialogue Ouvrir. Note : Vous pouvez également sélectionner le fichier via un cliquer-glisser dans la zone.

ChooseFile

Choose A File : Permet de sélectionner le fichier via la boîte de dialogue Ouvrir. Note : Vous pouvez également sélectionner le fichier via un cliquer-glisser dans la zone.

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.
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 Service Apps.

    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.

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

    exemple  Affichage d'un portail avec consultation de catalogues

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.

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.

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

    exemple  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).

Exemple d'intégration

Google Analytics Logo - Google Analytics.png 

Tags:
Modifié par Utilisateur inconnu le 2021/04/08 11:27
Créé par Administrator XWiki le 2014/11/12 22:08

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Powered by XWiki ©, EasyVista 2021