Paramétrer les champs libres

Paramétrer les champs libres

Tout d'abord, cliquer sur le carré à damier bleu , puis sur Options


1.Règle de syntaxe

Le paramétrage des champs libres est soumis à quelques règles :

1. L'ensemble des champs doivent toujours être compris entre [ et ]

2. Un champ doit toujours commencer par { suivi de "caption" et se terminer par }

3. Chaque champ est défini par un ensemble de propriétés et les valeurs doivent être séparées par une virgule ,

4. Les propriétés et valeurs doivent être saisies entre guillemets " ", à l'exception des valeurs null, true, false ainsi que les nombres (entiers et décimaux)

2. Composition d'un champ libre

Pour chaque module, il est possible d'ajouter jusqu'à 10 champs libres ou custom fields.  

2.1 Nom du champ libre

Le nom du champ peut être saisi en une ou plusieurs langues, l'affichage dépendra de la langue utilisée par votre navigateur internet. Les langues suivantes sont disponibles :

· "en" : anglais

· "fr" : français

· "de" : allemand

· "it": italien


Remarque: Dans l'exemple ci-dessus, une personne utilisant un navigateur en anglais verra Title. Si vous utilisez un navigateur anglais mais que le nom du champ est uniquement saisi en français dans les paramètres c'est celui-ci qui apparaitra.


2.2 Index

Chaque champ doit contenir un index. Il permet notamment de déplacer ou supprimer des champs libres.




Remarques: La numérotation des "index" commence à 0. Le numéro d'index doit rester lié au champ car lorsque celui-ci est déplacé les données qu'il contient lui restent liées. De même que lorsqu'un champ est supprimé, l'index doit également être supprimé et le numéro ne doit pas être réutilisé.

2.3 Type

Par la suite, il faut lui attribuer un Type. Il en existe 7 :


1. tBool: cases (oui/non) à cocher de type booléen 
   
   

2. tString : une ligne de texte


3. tMultiline : plusieurs lignes de texte avec traitement de texte


4. tDate : sélection d'une date dans le calendrier lié


5. tDecimal : uniquement les nombres entiers et décimaux sont autorisés

Remarque: Seuls les points et tirets sont autorisés.


6. tPhone: composition automatique du numéro sélectionné avec une application téléphonique (p. ex. Skype)


7. tEnum : liste déroulante


2.4 Visibilité

La visibilité ou non d'un champ se fait par l'attribution de la valeur true ou false.

showToCollaborators, détermine si le champ est visible par les utilisateurs dans l’onglet général.







  showInMain, détermine si le champ est visible sur la vue liste d’un module et dans la recherche.





2.5 Validation

validators permet  de rendre obligatoire la saisie d'un champ libre.

Les types de validations sont les suivants :

· required : rendre un champ obligatoire

· integer : contenir uniquement un nombre entier

· positiveinteger : contenir uniquement un nombre entier positif

· negativeinteger : contenir uniquement un nombre entier négatif

· decimal : contenir uniquement un nombre décimal

· positivedecimal : contenir uniquement un nombre décimal positif

· negativedecimal : contenir uniquement un nombre décimal négatif

· phoneNumber : contenir un numéro de téléphone


3. Paramétrage

3.1 Paramétrer une liste déroulante

Ce paramétrage s'effectue en quatre étapes:

1. Définir le nom du champ

2. Définir le type "tEnum", la visibilité du champ (voir les points 2.3 et 2.4) et éventuellement une restriction (voir point 2.6).

3. Définir la visibilité des éléments de la liste déroulante. "showColors" indique si la couleur doit figurer (true) ou non (false) sur la liste déroulante. Attention, si aucune couleur n'est paramétrée dans les valeurs, sous "color", bien penser à mettre "showColors" à false. "showCaptions" indique si le texte doit figurer (true) ou non (false). 

4. Définir les éléments de la liste déroulante. Le contenu de la liste est à déterminer entre "rows": [ et ]. Les quatre lignes comprises entre { et } correspondent à un élément de la liste déroulante (cadre jaune).

· "caption" indique le nom de la valeur

· "color" indique la couleur au format HTML

· "localizedCaption" doit toujours être null

·"alert" doit toujours être false



Astuce : Rendez-vous sur http://htmlcolorcodes.com/fr/ pour retrouver les codes couleur.


Le résultat du paramétrage effectué ci-dessus donne le résultat suivant.


3.2 Paramétrer un type de validation

Le paramétrage de la validation est le suivant:

              · "validators": "std.xxx",



Les xxx correspondent au type de validation (voir liste ci-après). Ci-dessous, un exemple du champ "Taux d'activité" qui doit être obligatoirement rempli.

Remarque: Le "validators" se place toujours après le "type".

Les types de validations sont les suivants :

· required : rendre un champ obligatoire

· integer : contenir uniquement un nombre entier

· positiveinteger : contenir uniquement un nombre entier positif

· negativeinteger : contenir uniquement un nombre entier négatif

· decimal : contenir uniquement un nombre décimal

· positivedecimal : contenir uniquement un nombre décimal positif

· negativedecimal : contenir uniquement un nombre décimal négatif

· phoneNumber : contenir un numéro de téléphone

Astuce: Vous pouvez utiliser plusieurs types de validations en même temps en séparant les validations par &.


      3.3 Modifier l'ordre des champs libres

Pour modifier l'ordre des champs libres, il faut sélectionner le champ à déplacer : un champ libre commence par { suivi de "caption" et se terminer par }
Copier le champ et le coller à l'endroit souhaité.
Attention : ne surtout pas modifier la valeur inscrite dans la partie index.

      3.4 Exemples de paramétrage

La formation suivante vous permet de copier des exemples de paramétrage


    • Related Articles

    • Comprendre et paramétrer les notifications

      0. Vidéo de présentation 1. Créer une notification Pour créer une notification, rendez-vous dans les options, dans l'onglet Notifications. Cliquez sur Nouveau. Seuls les Administrateurs peuvent paramétrer les notifications. 1.1 Titre Donnez un titre ...

    • Gérer les indicateurs

      1. La formation en vidéo 2. Définition La meilleure définition serait « une information choisie, associée à un critère, destinée à en observer les évolutions à intervalles définis. » 3. Affichage d'un indicateur En allant sur le module Indicateurs, ...

    • Exemples de paramétrage des champs libres

      La valeur du X de l'index doit être adaptée en fonction des valeurs des indexes déjà présentes dans votre paramétrage. Ajouter le champ: Date d'anniversaire Ajout du champ "Date d'anniversaire", format date, visible pour les utilisateurs. { "index": ...

    • Paramétrer les valeurs d'une tâche automatisée

      0. Film de présentation Cette formation concerne les modules Contrôles, Indicateurs, Missions, ToDo Manager, Incidents et Améliorations. Pour savoir quel module utiliser pour automatiser des tâches, consultez la formation dédiée. Lorsque vous créez ...

    • Gérer les actualités

      1.    La formation en vidéo 2.    Créer une actualité Se rendre dans le module Actualités. Celui-ci est disponible dans le menu (carré à damier bleu), s’il n’apparait pas dans les onglets par défaut. Puis, cliquer sur Nouveau. Ensuite, vous pouvez : ...