Structure du fichier Assistant

Le but de l'Assistant est de présenter à l'utilisateur un questionnaire à remplir.

Le fichier est de type properties sous Java, ce qui correspond à un fichier texte dont chaque ligne donne la valeur d'un paramètre. La ligne est divisée en deux parties logiques séparées par le signe égal '='. À gauche est indiqué une clé, et à droite est indiqué la valeur associée. La clé est constituée de plusieurs parties séparées par un point:

• le domaine de l'assistant,
• un numéro d'ordre de l'onglet, sur un chiffre,
• un numéro d'ordre séquentiel de la rubrique sur deux chiffres,
• un type parmi tab, list, text, checkbox, radiobox, int,
• éventuellement un numéro d'ordre séquentiel de l'option, voir plus loin les options sur plusieurs lignes.

Détail des types

• tab : le formulaire Assistant se présente sous forme d'un questionnaire à onglets, le type tab correspond donc à l'intitulé qui doit être donné à l'onglet. Un élément de type tab est obligatoire dans un formulaire, même s'il n'y a pas d'autre onglet. La valeur affectée est un texte libre qui sera le titre, suivi éventuellement par un sous-titre ou un texte explicatif séparé par un point-virgule.
• list : correspond à un champ de type liste. La valeur affectée contient un texte qui l'intitulé de la liste. Le tilde '~', optionnel, permet d'indiquer sur la même ligne, à la suite de l'intitulé, les différentes options possibles séparées par un point-virgule.
• mlist : est similaire à list mais autorise l'utilisateur à sélection plusieurs options simultanément.
• text : est un champ de texte simple. L'intitulé peut être suivi d'un petit texte explicatif, les deux éléments étant séparé par un point-virgule.
• textarea : similaire à text mais présenté sur plusieurs lignes.
• checkbox : introduit un ensemble de case à cocher, le titre de la rubrique est suivi d'un tilde qui introduit les différentes options séparées par un point-virgule. Il est toujours possible de cocher plusieurs case.
• radiobox : est similaire à checkbox sauf qu'il est impossible de sélectionner plusieurs options simultanément. Habituellement un radiobox est affiché sous la forme d'un rond dans lequel apparaît un point si on sélectionne l'option.
• int : est une rubrique représentant un nombre entier, donc seuls les chiffres sont autorisés.

Options sur plusieurs lignes

Pour list, mlist, checkbox et radiobox il est possible de définir la rubrique avec plusieurs lignes. Exemple extrait de l'assistant Polti:

polti.1.01.radio=Situation
polti.1.01.radio.01=1-Implorer: un personnage en péril implore qu'on le tire de l'embarras. (Andromède / Robin des bois)
polti.1.01.radio.02=2-Sauver: un personnage se propose pour en sauver un ou plusieurs autres. (Jeanne d'Arc / Le Choix de Sophie)
polti.1.01.radio.03=3-Venger un crime: un personnage venge le meurtre d'un autre personnage. (Le Comte de Monte-Cristo
polti.1.01.radio.04=4-Venger un proche: une vengeance au sein d'une même famille. (Hamlet)

Vous noterez au passage que les caractères accentués ou spéciaux peuvent être remplacés par leurs équivalents en codage UTF8.