Éditeur des types de champs


L'éditeur des types de champs permet d'agir sur un datasource afin de :

  • visualiser son contenu ;
  • sélectionner les colonnes pouvant être utilisées par les widgets pointant dessus ;
  • vérifier l'exactitude de la nature de chaque champ (Date, Integer, ...) et la corriger manuellement si nécessaire afin que les données puissent être traitées correctement par les widgets (la détection automatique du type de champ peut être incorrecte pour certains datasources comme les datasources REST ou les fichiers .CSV).

Exemple

Correction de la nature des champs d'un fichier .CSV contenant le nombre d'incidents annuels traités par les membres du Service Desk

Datasource Type des champs
Reconnaissance automatique Modification manuelle

Field Types Editor - Datasource example.png

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

  • Support Member : type non reconnu
  • 2015 / 2016 / 2017 : Integer
  • Support Member : String
  • 2015 / 2016 / 2017 : Integer ; Séparateur de millier Aucun

Remarques

  • Pour les datasources EasyVista, les informations sur la nature des champs sont automatiquement remontées de la base de données Product name - ev itsm.png.
  • Par défaut, toutes les colonnes du datasource sont sélectionnées.
  • 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.
  • Diverses options sont proposées pour certains types de champs, permettant d'affiner la nature du champ.

Example documentation icon FR.png  

  • Champ de type Integer  ==>  spécifier le caractère Séparateur de millier
  • Champ de type Date  ==>  spécifier le format de la date

Attention

  • Pour un datasource CSV, n’omettez pas de renseigner les séparateurs de données du fichier téléchargé permettant à l'éditeur des types de champs de lire correctement le contenu du fichier.

Example documentation icon FR.png  Dans le datasource de l'exemple ci-dessus, renseignement de la propriété Column Separator Character (caractère identifiant le séparateur de données dans le fichier .CSV, permettant de découper chaque ligne en colonnes)

Not check icon.png   Mauvaise configuration Check icon.png   Bonne configuration

Column Separator Character : ,   (virgule)

==>   L'éditeur affiche une seule colonne (concaténation de toutes les colonnes du datasource)

Bad configuration example.png

Column Separator Character : ;   (point-virgule)

==>   L'éditeur affiche les 5 colonnes du fichier

Good configuration example.png

Best Practice big icon.pngBonnes pratiques

  • Pour ajouter un champ à la sélection du datasource, 2 méthodes sont possibles -  Open url.png voir Description de l'écran
    • Utilisez la poignée de déplacement Apps - Grip icon.png pour positionner le champ à l'endroit souhaité dans le datasource.
    • Utilisez le bouton radio en regard du champ pour le placer automatiquement en dernière position du datasource.

Description de l'écran

         Field Types Editor.png

Accès : dans l'inspecteur de propriétés d'un datasource, clic sur le bouton situé sous la propriété Configure Field Types

L'éditeur des types de champs se décompose en 2 zones :

  • Le volet gauche (1) : liste des champs disponibles, qui ne sont pas sélectionnés dans le datasource.
    • Ces champs ne peuvent pas être affichés dans les widgets pointant sur le datasource.
       
    • Poignée de déplacement Apps - Grip icon.png au-dessus du champ ou bouton radio en regard du champ : Permet de rendre visible le champ dans le datasource, en le basculant dans le volet droit.
       
  • Le volet droit (2) : prévisualisation des champs sélectionnés dans le datasource, et des 15 premiers enregistrements du datasource.
    • Ces champs peuvent être affichés dans les widgets pointant sur le datasource.
       
    • Poignée de déplacement Apps - Grip icon.png au-dessus de l'en-tête de colonne : Permet de déplacer la colonne dans le tableau.
    • Check icon.png : Permet de retirer le champ de la sélection du datasource, en le basculant dans le volet gauche. Vous pouvez également utiliser la poignée de déplacement Apps - Grip icon.png.
    • Apps - Edit icon.png : Permet de renommer le champ. Vous pouvez également cliquer dans l'en-tête de la colonne.
    • Type : Liste des types de champs disponibles. Une liste d'options supplémentaires est automatiquement affichée pour certains types de champs.

Comment utiliser l'éditeur des types de champs

1. Dans l'inspecteur de propriétés d'un datasource, cliquez sur le bouton situé sous la propriété Configure Field Types : l'éditeur des types de champs est ouvert.

2. Sélectionnez les champs que vous souhaitez pouvoir afficher dans les widgets pointant sur le datasource :

  • Pour rendre visible l'un des champs disponibles dans le volet gauche :
    • soit cliquez sur le bouton radio en regard du champ pour le positionner automatiquement après la dernière colonne du datasource ;
    • soit positionnez le curseur sur la poignée de déplacement Apps - Grip icon.png et cliquez-glissez le champ vers la position désirée dans le volet droit.
  • Pour retirer un champ de la sélection du datasource (volet droit) :
    • soit cliquez sur Check icon.png dans l'en-tête de colonne ;
    • soit positionnez le curseur sur la poignée de déplacement Apps - Grip icon.png et cliquez-glissez le champ vers le volet gauche.

3. Vérifiez l'exactitude de la nature de chaque champ du volet droit. Si nécessaire, modifiez-la via la liste Type située sous chaque en-tête de colonne et renseignez les options supplémentaires affichées automatiquement en fonction du type de champ.

4. Ordonnez les colonnes du volet droit dans l'ordre d'affichage souhaité, en utilisant la poignée de déplacement Apps - Grip icon.png au-dessus de l'en-tête de chaque colonne.

5. Si vous souhaitez modifier le nom d'une colonne, soit cliquez sur Apps - Edit icon.png, soit cliquez sur l'en-tête de la colonne.

6. Cliquez sur [ OK ] : l'éditeur des types de champs est fermé. Automatiquement, tous les widgets pointant sur le datasource sont mis à jour.

Tags:
Modifié par Utilisateur inconnu le 2017/10/10 14:00
Créé par Administrator XWiki le 2017/10/10 14:00

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Glossaire

Powered by XWiki ©, EasyVista 2020