• Comment créer une rubrique Enumération et Combinaison sous l'éditeur d'analyses.
• Comment convertir une rubrique existante vers le type Enumération ou Combinaison.

Création d'une rubrique de type Enumération

1. Créez une nouvelle rubrique dans la fenêtre de description des rubriques du fichier de données (option "Description des rubriques" du menu contextuel du fichier sous l'éditeur d'analyses).
2. Choisissez le type "Enumération, Combinaison".
3. Dans l'onglet "Général" de la description de la rubrique, cliquez sur le bouton à droite de la combo "Type", puis sélectionnez "Créer une nouvelle énumération".
   
4. La fenêtre d'édition d'une énumération s'affiche :
   
   • Précisez le nom de l'énumération.
   • Ajoutez des valeurs (bouton ) ou saisissez directement les valeurs dans la table.
   • Pour chaque valeur, précisez éventuellement la valeur associée ou l'alias (un alias est une valeur de l'énumération ayant la même valeur qu'une autre valeur de l'énumération, mais avec un nom différent).

Création d'une rubrique de type Combinaison

1. Créez une nouvelle rubrique dans la fenêtre de description des rubriques du fichier de données (option "Description des rubriques" du menu contextuel du fichier sous l'éditeur d'analyses).
2. Choisissez le type "Enumération,Combinaison"
   
3. Dans l'onglet "Général" de la description de la rubrique, cliquez sur le bouton à droite de la combo "Type", puis sélectionner "Créer une nouvelle combinaison".
4. La fenêtre d'édition d'une combinaison s'affiche :
   
   
   • Précisez le nom de la combinaison.
   • Ajoutez des valeurs (bouton ) ou saisissez directement les valeurs dans la table.
   • Pour chaque valeur, précisez éventuellement la valeur associée ou l'alias.

• "convertir" la rubrique existante en variable de type Enumération ou Combinaison. Cette solution est la plus rigoureuse mais est plus complexe à mettre en oeuvre (surtout si vous avez des fichiers de données en production).
• utiliser une rubrique de type entier ou chaîne pour mémoriser la valeur ou le nom des éléments de l'énumération ou de la combinaison. Cette solution est plus simple à mettre en oeuvre, mais elle n'empêche pas les valeurs indésirables. Elle permet aussi de mémoriser une valeur d'énumération ou de combinaison dans une base non HFSQL (MySQL, Oracle, etc.) où les types Enumération et Combinaison ne sont pas disponibles.

"Convertir" une rubrique en une variable de type Enumération ou Combinaison

1. Ajoutez une nouvelle rubrique "Enumération, Combinaison" dans la description du fichier de données voulu (voir paragraphes précédents).
2. Modifiez les fichiers de données physiques. Cette modification peut être faite :
   • soit directement depuis l'éditeur d'analyses via la "Synchronisation de la Structure et des Données déployées". Utilisez cette solution si vous avez accès directement aux fichiers de données depuis le poste de développement.
   • soit par programmation via la fonction WLangage HModifieStructure. Utilisez cette solution si vous n'avez pas accès aux fichiers de données (applications déployées par exemple).
3. Remplissez la nouvelle rubrique Enumération ou Combinaison à partir du contenu de la rubrique entier (ou chaîne de caractères) originale. Il suffit d'utiliser la fonction WLangage EnumérationDepuisValeur ou CombinaisonDepuisValeur. Cette fonction renvoie l'option d'une énumération ou combinaison à partir d'une valeur donnée.
   Attention : il est nécessaire d'avoir défini une valeur pour chaque option de l'énumération ou de la combinaison. Si le nom de l'option fait office de valeur, utilisez la fonction WLangage EnumérationDepuisNom ou CombinaisonDepuisNom.
   

   // Si la rubrique Etat (entier) contient une valeur valide pour l'énumération
   SI EnumérationVérifieValeur(EEtatCommande, Commande.Etat) ALORS
   	// Remplit la rubrique Enumération avec la valeur correspondante
   	Commande.EtatEnum = EnumérationDepuisValeur(EEtatCommande, Commande.Etat)
   	// Modifie l'enregistrement
   	HModifie(Commande)
   FIN

4. Supprimez l'ancienne rubrique entier ou chaîne de caractères.
5. Eventuellement, renommez la nouvelle rubrique avec le nom de l'ancienne.

Utilisation d'une rubrique de type entier ou chaîne

// Enumération avec valeurs associées
EEtatCommande est une Enumération
	EnAttenteValidation = 1
	EnPréparation = 2
	EnExpédition = 3
	EnLivraison = 4
	Livré = 5
FIN

• entier : dans ce cas, la valeur de l'option (1, 2, ...) sera mémorisée,
• chaîne de caractères : dans ce cas, le nom de l'option (EnAttenteValidation, EnPréparation, ...) sera mémorisé.

• EnumérationDepuisValeur ou EnumérationDepuisNom pour une énumération.
• CombinaisonDepuisValeur ou CombinaisonDepuisNom pour une combinaison.

// Lit l'enregistrement voulu
HLitPremier(Commande)
// Définit une variable de type Enumération
eMaCommande est un EEtatCommande
// Récupère l'énumération depuis la rubrique
eMaCommande = EnumérationDepuisValeur(EEtatCommande, Commande.EtatCommande)

// Définit une variable de type énumération
eMaCommande est un EEtatCommande
// Applique une valeur à la variable
eMaCommande = EnAttenteValidation
// Affecte directement la rubrique avec la variable Enumération
// Equivalent à Commande.EtatCommande = eMaCommande.Valeur
Commande.EtatCommande = eMaCommande

// Mémorise le nom de l'option dans la rubrique
Commande.EtatCommande = eMaCommande..Nom