Champs de données
=================

Les champs de données permettent de faire saisir des valeurs dans des champs qui seront ensuite exploitable depuis
votre thème.
Dans cette section nous allons voir comment fonctionne les champs de données et comment on les utilise dans un thème.


Mise en place des champs de données
-----------------------------------

Dans la gestion de votre thème vous avez une catégorie qui s'appelle "Champs de données".

.. image:: ../images/data_fields_screenshot.png

Vous pouvez ajouter autant de champ que vous le souhaitez, il n'y a pas de limite à ce niveau-là.

.. image:: ../images/add_field.png

Quand vous cliquez sur le bouton "Ajouter un champ", une nouvelle ligne avec plusieurs champs apparait.

Le "nom du champ" correspond au libellé du champ qui sera affiché dans la rubrique "Champs" dans votre panel de gestion
de lanceur.
Si l'option "Optionnel" est sélectionné, le champ sera suivi d'une indication "Optionnel" à côté du libellé.

L'identifiant du champ est très important puisque c'est grâce à cette information que vous allez pouvoir accéder
à la donnée qui sera saisie par l'utilisateur de votre thème. Veillez à saisir un identifiant cohérent afin que vous
puissiez facilement la récupérer depuis votre thème.

Le type de champ correspond à une règle de validation qui sera exécutée après modification de votre lanceur.
Si vous sélectionnez par exemple le type "Email", le système vérifiera que l'utilisateur à saisi une adresse au format
valide.

Certains champs une particularité comme par exemple le type "color" qui affichera une palette de couleur simplifiant
la selection de couleur ou par exemple le champ "time" qui demandera l'heure à partir d'une petite fenêtre qui est
réglée sur l'heure actuelle et qui simplifira la saisie de l'heure.

Vous pouvez à tout moment supprimer vos champs grâce au bouton de suppression.

Exploitation des champs de données depuis le thème
--------------------------------------------------

Pour exploiter les champs de données que vous avez ajoutés, il vous suffit de déclarer la variable **dataFields**
comme dans l'exemple ci-dessous.

Cette variable fait l'association entre l'identifiant du champ que vous avez créé dans votre gestion de thème et
la valeur qui a été saisie par l'utilisateur au moment de modifier son lanceur.

Veillez à bien indiquer le bon identifiant correspondant à votre champ auquel cas celui-ci sera erroné et vous n'aurez
pas de valeur.

Vous êtes libre de faire ce que vous voulez de cette information. Vous pouvez la passer à un composant tel que vous pouvez
le voir dans l'exemple ci-dessous.

.. code-block:: java

    public class ApplicationController implements Initializable {
        private Stage stage;
        private boolean doGameFilesInstallationBeforeRunGame = false;
        private boolean doGameFilesInstallationFromLauncherUI = true;
        private boolean isWindowMoveable = true;
        private boolean isWindowMoveableOnOutScreen = true;
        private boolean isStatutServerMCEnabled = false;
        private boolean isNewsMLEnabled = false;

        private HashMap<String, Object> dataFields;

        @FXML
        private ImageView myImageComponent;

        @Override
        public void initialize(URL location, ResourceBundle resources) {
            Object fieldValueFilledByUser = dataFields.get('field ID');
            myImageComponent.setImage(fieldValueFilledByUser);
        }

    }