Présentation

1. Création d'un état.
2. Modification de cet état pour gérer les paramètres :
   • Récupération des paramètres dans l'événement "Ouverture" de l'état à l'aide de la syntaxe suivante :
     
     PROCEDURE <NomEtat>(<NomParam1>, ...
     <NomParam2>= "<ValeurParDéfautParam2>", ...
     ...
     <NomParamN> = "<ValeurParDéfautParamN>")
     
     Rappel : Certains paramètres passés à une procédure peuvent être optionnels. Lors de la déclaration de la procédure, les paramètres optionnels doivent être décrits en dernière position (à droite), avec une valeur par défaut précédée du signe "=". Pour plus de détails, consultez Paramètre d'une procédure.
   • Utilisation de ces paramètres dans les champs de l'état.
3. Modification si nécessaire de l'application afin de spécifier les différents paramètres.
4. Impression de l'état avec passage des paramètres. Pour plus de détails, consultez le paragraphe Imprimer un état paramétré.

Exemple

• L'état "ETAT_EtatParam" correspond à un mailing publicitaire envoyé aux clients.
• Cet état attend en paramètre le texte du mailing saisi dans le champ de saisie "SAI_TexteMailing".

1. Créez l'état "ETAT_EtatParam" :
   • Cliquez sur parmi les boutons d'accès rapide.
   • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Etat" puis sur "Etat".
   • L'assistant de création d'un état se lance.
   • Dans l'assistant, sélectionnez "Mailing" et validez.
     Cet état est lié au fichier "Client" de votre analyse. Pour plus de détails sur la création d'un état, consultez Les états.
2. Personnalisez cet état.
3. Dans l'événement "Ouverture" de l'état "ETAT_EtatParam", saisissez le code suivant :
   

   // Récupérer le paramètre passé à l'état et
   // passer un paramètre par défaut pour le test de l'état
   PROCÉDURE ETAT_EtatParam(sTexte = "Valeur par défaut")

4. Dans le bloc Corps de cet état, ajoutez le champ Libellé "LIB_TexteMailing" permettant d'afficher le texte du mailing.
5. Dans l'événement "Avant impression" du champ "LIB_TexteMailing", saisissez le code suivant :
   

   // Récupérer le texte du mailing
   LIB_TexteMailing = sTexte

6. Dans une fenêtre de l'application, ajoutez :
   • le champ de saisie "SAI_TexteMailing" permettant à l'utilisateur de saisir le texte du mailing.
   • le bouton "BTN_Imprimer" permettant de lancer l'impression de l'état.

1. Paramétrer la destination de l'impression de l'état grâce à la fonction iDestination (visualisateur de rapports, impression dans un fichier HTML, ...).
2. Préciser les paramètres suivants grâce à la fonction iImprimeEtat :
   • le nom de l'état à imprimer.
   • les paramètres.

• Si l'état est basé sur une vue HFSQL, le nom de cette vue HFSQL doit être indiqué dans la fonction iImprimeEtat, avant les paramètres. Pour plus de détails, consultez Etat sur une vue HFSQL.
• Si l'état est basé sur une zone mémoire, le nom de cette zone mémoire doit être indiqué dans la fonction iImprimeEtat, avant les paramètres. Pour plus de détails, consultez Etat sur une zone mémoire.
• Si l'état est un état borné, la valeur des bornes (minimales et/ou maximales) doit être indiquée dans la fonction iImprimeEtat, avant les paramètres. Pour plus de détails, consultez Etat borné.

Exemple

// Ouvrir le visualisateur de rapports
iDestination(iVisualisateur)
// Imprimer l'état avec passage de paramètre
iImprimeEtat(ETAT_EtatParam, SAI_TexteMailing)