Commande ACCEPT
Crée une boîte de dialogue invitant de manière interactive les utilisateurs à saisir une ou plusieurs valeurs d'introduction de script. Chaque valeur d'introduction est stockée dans une variable nommée de type caractère.
Remarque
L'utilisation de la commande ACCEPT pour saisir des mots de passe n'est pas sécurisée. Il faudrait utiliser la Commande PASSWORD à la place.
La commande ACCEPT n'est pas prise en charge par les outils d'analyse d'AX Serveur.
Vous pouvez créer une boîte de dialogue interactive plus avancée avec la Commande DIALOG.
Syntaxe
ACCEPT {texte_message <FIELDS catégorie_élément_projet> TO nom_variable} <...n>
Paramètres
| Nom | Description |
|---|---|
| texte_message |
Libellé affiché dans la boîte de dialogue qui invite l'utilisateur à intervenir. Doit être une chaîne entre guillemets ou une variable de type caractère. Lorsque vous saisissez plusieurs invites, vous pouvez les séparer par des virgules. L'utilisation de virgules n'est pas obligatoire, mais cela améliore la lisibilité du script : ACCEPT "Préciser une date de début :" TO v_date_début, "Préciser une date de fin :" TO v_date_fin |
| FIELDS catégorie_élément_projet optionnel |
Crée une liste déroulante d'éléments de projet pour la saisie de l'utilisateur plutôt qu'une zone de texte. L'utilisateur peut sélectionner un seul élément de projet, un seul champ ou une seule variable dans la liste. catégorie_élément_projet indique les types d'élément à afficher dans la liste. Par exemple, saisir xf affiche toutes les tables du projet dans la liste. Entourez project_item_category de guillemets : FIELDS "xf" Pour obtenir les codes que vous avez utilisés pour spécifier des catégories, reportez-vous à la section Codes pour les catégories d'élément de projet. Vous pouvez spécifier plus d'un code dans la même invite, mais vous ne pouvez pas mélanger des éléments de projet, des champs ou des variables. |
| TO nom_variable |
Nom de la variable de type de caractère à utiliser pour stocker l'entrée utilisateur. Si la variable n'existe pas, elle est créée. Si la variable existe déjà, sa valeur actuelle est affichée dans la boîte de dialogue comme valeur par défaut. Remarque Vous ne pouvez pas utiliser des caractères qui n'existent pas en anglais, tels que é, dans les noms de variables utilisées pour substituer des variables. Les noms de variables contenant des caractères n'existant pas en anglais provoqueront l'échec du script. La commande ACCEPT crée uniquement des variables de type caractère. Si vous devez avoir des entrées d'un autre type de données, vous devez convertir la variable caractère dans le type requis dans le traitement suivant du script. Pour plus d'informations, consultez la section Type de données d'entrée. |
Exemples
L'utilisateur est invité à sélectionner la table Analytics à ouvrir
Il vous faut une boîte de dialogue qui invite l'utilisateur à sélectionner le nom de la table à ouvrir. Le script ouvre ensuite la table sélectionnée par l'utilisateur :
ACCEPT "Sélectionne la table à ouvrir :" FIELDS "xf" TO v_nom_table OPEN %v_nom_table%
Les symboles de pourcentage sont requis, car ils indiquent que le nom de la table à ouvrir est stocké dans la variable v_nom_table. Si les symboles de pourcentage sont omis, le script tente d'ouvrir une table nommée "v_nom_table".
Utilisation de plusieurs boîtes de dialogue pour recueillir les entrées requises
Vous souhaitez créer une boîte de dialogue distincte pour chaque valeur que l'utilisateur du script doit saisir.
Utilisez une seule chaîne d'invite dans chaque instance de la commande ACCEPT. Le script génère des boîtes de dialogue séparées pour indiquer chacun des éléments suivants :
- un nom de table
- un champ sur lequel effectuer l'échantillonnage
- un intervalle d'échantillonnage
- une valeur de départ aléatoire
ACCEPT "Saisir le nom de la table à analyser" TO v_nom_table OPEN %v_nom_table% ACCEPT "Sélectionner le champ à échantillonner" FIELDS "N" TO v_champ_à_échantillonner ACCEPT "Saisir l'intervalle d'échantillonnage" TO v_intervalle_échantillonnage ACCEPT "Saisir la valeur de départ aléatoire" TO v_valeur_départ_aléatoire SAMPLE ON %v_champ_à_échantillonner% INTERVAL v_intervalle_échantillonnage FIXED v_valeur_départ_aléatoire RECORD TO Sortie_échantillonnage OPEN
Lorsque le script s'exécute
- La première boîte de dialogue demande le nom de la table.
- La deuxième boîte de dialogue, avec FIELDS "N", demande une sélection de champ à partir d'une liste déroulante de champs numériques.
- La troisième boîte de dialogue demande la valeur de l'intervalle.
- La quatrième boîte de dialogue demande la valeur de départ aléatoire.
Utilisation d'une boîte de dialogue unique avec plusieurs invites pour recueillir les entrées requises
Vous souhaitez créer une seule boîte de dialogue pour toutes les valeurs que l'utilisateur du script doit saisir.
Vous utilisez plusieurs invites séparées par des virgules dans la commande ACCEPT pour demander à l'utilisateur plusieurs valeurs d'entrée. La même boîte de dialogue contient des invites pour la date de départ et pour la date de fin d'une plage de dates :
ACCEPT "Préciser une date de début :" TO v_date_début, "Préciser une date de fin :" TO v_date_fin
Remarques
Interactivité
La commande ACCEPT permet de créer un script interactif. Pendant le traitement de la commande ACCEPT, le script s'interrompt et une boîte de dialogue invite l'utilisateur à saisir des entrées utilisées par Analytics lors d'un traitement ultérieur.
Vous pouvez créer des boîtes de dialogue indépendantes qui invitent l'utilisateur à entrer un seul élément à la fois ou bien créer une seule boîte de dialogue qui invite à entrer plusieurs éléments.
DIALOG et ACCEPT
La commande DIALOG vous permet de créer une boîte de dialogue interactive plus avancée qui peut avoir un ou plusieurs des types de contrôles suivants :
- zone de texte
- case à cocher
- Cases d'option
- liste déroulante de valeurs personnalisées
- liste de projets
Vous pouvez également personnaliser la mise en page de la boîte de dialogue. Pour plus d'informations, consultez la section Commande DIALOG.
Codes pour les catégories d'élément de projet
Utilisez les codes suivants pour indiquer la catégorie d'élément de projet à afficher dans une liste déroulante.
Catégories de projet
|
Code |
Catégorie |
|---|---|
|
xf |
Tables |
|
xb |
Scripts |
|
xi |
Index |
|
xr |
Vues et rapports |
|
xw |
Environnements_de_travail |
Catégories de champ
|
Code |
Catégorie |
|---|---|
|
C |
Champs de type caractère |
|
N |
Champs numériques |
|
D |
Champs de type DateHeure |
|
L |
Champs logiques |
Catégories de variable
|
Code |
Catégorie |
|---|---|
|
c |
Variables de type caractère |
|
n |
Variables numériques |
|
d |
Variables de type DateHeure |
|
l |
Variables logiques |
Type de données d'entrée
ACCEPT stocke l'entrée utilisateur dans une ou plusieurs variables de type caractère. Si une saisie numérique ou de type DateHeure est requise, vous pouvez utiliser les fonctions VALUE( ) ou CTOD( ) pour convertir le contenu d'une variable de type caractère en valeur numérique ou en valeur DateHeure :
SET FILTER TO BETWEEN(%v_champ_date%; CTOD(%v_date_début%); CTOD(%v_date_fin%))
Dans l'exemple, les dates de début et de fin pour ce filtre sont stockées sous type de valeurs caractère. Elles doivent être converties en valeurs date afin d'être utilisées avec un champ date utilisant un type de données DateHeure.
Entourer le nom de la variable par des symboles de pourcentage (%) remplace la valeur de type caractère contenue par la variable pour le nom de la variable. La fonction CTOD( ) convertit alors la valeur de type caractère en une valeur de date.
Place de la commande ACCEPT
Dans la mesure du possible, il est recommandé de placer toutes les commandes ACCEPT au début d'un script. Si vous demandez la saisie de toutes les données au début, le script peut s'exécuter sans entrave une fois les informations requises saisies par l'utilisateur.
Remarque
Vous ne pouvez pas utiliser la commande ACCEPT dans la commande GROUP.
