Éditeur des types de champs des datasources

Modifié le 28/05/2022 10:52

L'éditeur des types de champs permet de :

  • visualiser le contenu d'un datasource ;
  • sélectionner les colonnes pouvant être utilisées par les widgets pointant dessus ;
  • vérifier la nature de chaque champ (Date, Integer, ...) pour que les données puissent être traitées correctement par les widgets.

Exemple

Nature des champs d'un fichier .CSV contenant le nombre d'incidents annuels traités par le 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

  • Les informations sur la nature des champs des datasources EasyVista sont automatiquement remontées de la base de données.
  • 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.
  • Les noms des colonnes des datasources sont affichés dans la langue de l'utilisateur connecté, en se basant sur le nom des champs de la base de données.
  • Les noms des colonnes des datasources peuvent être modifiés. La personnalisation s'applique uniquement à l'application courante.
  • Diverses options sont proposées pour certains types de champs, permettant d'affiner la nature du champ.

    exemple  

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

    exemple  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

Bonnes pratiques

  • Vérifiez, et corrigez si nécessaire, la nature des champs du datasource. La détection automatique du type de champ peut être incorrecte pour les datasources REST ou les fichiers .CSV.

Accès

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

Description de l'écran

       Field Types Editor.png

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

  • (1) Volet gauche : Liste des champs 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.
  • (2) Volet droit : 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.
    • Apps - Delete 2 icon.png: Permet de réinitialiser le nom de la colonne du datasource et de revenir à la valeur par défaut.
    • Type : Liste des types de champs disponibles. Une liste d'options supplémentaires est automatiquement affichée pour certains types de champs.

Procédure : Comment utiliser l'éditeur des types de champs

Étape 1 : Ouverture de l'éditeur des types de champs pour un datasource

1. Allez sur le datasource souhaité.
L'inspecteur de propriétés est ouvert.

2. Cliquez sur le bouton situé sous la propriété Configure Field Types.
L'éditeur des types de champs est ouvert.
 

Étape 2 : Sélection des champs du datasource à utiliser dans l'application

1. Ajoutez les champs souhaités depuis le volet gauche.

  • Soit cliquez sur le bouton radio en regard du champ pour le placer automatiquement en dernière position du tableau.
  • Soit cliquez sur la poignée de déplacement Apps - Grip icon.png en haut du champ et glissez le champ dans le tableau du volet droit, à l'emplacement souhaité.

          Add field from left pane.png

2. Supprimez les champs à ne plus utiliser depuis le volet droit.

  • Soit cliquez sur Check icon.png dans l'entête de colonne du champ pour le basculer dans le volet gauche.
  • Soit cliquez sur la poignée de déplacement Apps - Grip icon.png en haut de la colonne du champ et glissez le champ vers le volet gauche.
             Delete field from right pane.png
     

Étape 3 : Définition des propriétés des champs

Nature des champs

1. Modifiez si nécessaire la nature de chaque champ via la liste Type située sous chaque entête de colonne.

2. Renseignez les options supplémentaires affichées automatiquement en fonction du type de champ.

Nom des champs

1. Vous souhaitez modifier le nom du champ.

  • Cliquez sur Apps - Edit icon.png dans l'entête de colonne du champ.
  • Saisissez le nouveau nom du champ.

2. Vous souhaitez réinitialiser le nom du champ.

  • Cliquez sur Apps - Delete 2 icon.png.
    La valeur par défaut du nom est affichée dans la langue de l'utilisateur connecté.

Étape 4 : Ordonnancement des colonnes dans le volet droit

1. Cliquez sur la poignée de déplacement Apps - Grip icon.png en haut de la colonne du champ.

2. Déplacez la colonne à l'emplacement souhaité dans le volet droit.
 

Étape 5 : Sauvegarde des informations

1. Cliquez sur OK.
L'éditeur des types de champs est fermé. Automatiquement, tous les widgets pointant sur le datasource sont mis à jour.

Tags :
Powered by XWiki © EasyVista 2022