Nivel 2 · Niveau 2 · Intermédiaire : tri, regroupement & sélection

2.4Paramètres & invites (prompts)

Objetivo: Créer des paramètres et les intégrer au filtre pour un rapport générique et réutilisable.

Tiempo estimado: 11 min · lectura autónoma · Si solo tienes 5 min: lee «Lo esencial en 30s» + el esquema.

Lo esencial en 30 segundos

Paramètre = valeur demandée à l'exécution : nom, invite claire, type — le rapport s'adapte à la saisie.
Usage n°1 = filtrer : le paramètre alimente la sélection — un seul modèle pour toutes les années et régions.
Liste + défaut + serveur : menu de valeurs, valeur courante pré-remplie, filtre côté base — guidé, rapide, sans faute.

Mini-cas filé — Farès et les douze copies du même état

QUERY LENGTH LIMIT EXCEEDED. MAX ALLOWED QUERY : 500 CHARS

Suite du fil rouge 2.3 : le filtre figé de Farès devient interactif — et continue en 2.5.

1. Une valeur demandée à l'exécution

QUERY LENGTH LIMIT EXCEEDED. MAX ALLOWED QUERY : 500 CHARS

2. Usage n°1 : filtrer

QUERY LENGTH LIMIT EXCEEDED. MAX ALLOWED QUERY : 500 CHARS

3. Options et bonnes pratiques

QUERY LENGTH LIMIT EXCEEDED. MAX ALLOWED QUERY : 500 CHARS

Error frecuente de interpretación: « Créer un paramètre suffit à filtrer le rapport ». Non. Un paramètre inutilisé ne change rien : il doit être INTÉGRÉ à la sélection des enregistrements (ou à une formule) pour agir. La règle de Farès : paramètre créé → formule de sélection qui l'utilise → test à l'exécution avec deux valeurs différentes pour prouver que le rapport s'adapte.

Demander, filtrer, adapter

Versión en texto del esquema (SEO / lectores de pantalla / traducción): 1) Farès DEMANDE : deux paramètres — {?Annee} (liste, défaut année en cours) et {?Region} (liste de valeurs) — avec des invites claires. 2) Il FILTRE : la sélection utilise les paramètres au lieu de valeurs en dur, en restant côté serveur pour la performance. 3) Il ADAPTE : le titre affiche les valeurs choisies, un seul modèle couvre toutes les années et régions, testé avec deux saisies différentes. Leçon : un paramètre n'agit que s'il est branché sur la sélection.

🔎 Ejemplo concreto — 🔎 Exemple concret — Un modèle pour toutes les années

L'état de Farès, de la valeur figée au paramètre :

Avant (en dur) : Year({Commandes.DateCommande}) = 2026 → un rapport par année.
Après (paramètre) : Year({Commandes.DateCommande}) = {?Annee}
  and {Clients.Region} = {?Region} → l'utilisateur choisit ; un seul modèle.

Lecture : le paramètre remplace la valeur en dur dans la formule de sélection.

Leçon : proposer une liste de valeurs + une valeur par défaut pour guider la saisie.

Vocabulario de la sección

Paramètre (Parameter)

Une valeur DEMANDÉE à l'utilisateur à l'exécution (année, client, seuil) ; le rapport s'adapte à la saisie. Créé dans l'explorateur (Champs de paramètre).

Ejemplo sencillo: Farès crée {?Annee} : l'utilisateur choisit 2025 ou 2026 à l'exécution.

Lo que no es: une valeur figée en dur dans le filtre.

Reflejo: cas multiples = paramètre, pas copie.

Invite (prompt)

Le texte affiché à l'utilisateur pour saisir le paramètre (« Sélectionnez l'année ») ; à rédiger clairement.

Ejemplo sencillo: L'invite de Farès dit « Sélectionnez l'année », pas « Param1 ».

Lo que no es: le nom technique interne du paramètre.

Reflejo: invite = phrase claire d'action.

Paramètre de filtrage

L'usage le plus courant : le paramètre alimente la SÉLECTION des enregistrements pour n'afficher que les données choisies.

Ejemplo sencillo: La sélection de Farès utilise {?Annee} et {?Region} au lieu de valeurs fixes.

Lo que no es: un paramètre créé mais jamais branché.

Reflejo: paramètre = branché sur la sélection.

Options de paramètre

Type, valeur unique/MULTIPLE, PLAGE, LISTE de valeurs (statique ou dynamique), valeur par DÉFAUT, optionnel.

Ejemplo sencillo: Farès autorise plusieurs régions et pré-remplit l'année en cours.

Lo que no es: une saisie libre obscure sans guide.

Reflejo: liste + défaut d'abord.

En la práctica — En pratique — Créer des paramètres interactifs

Créez un paramètre (explorateur → Champs de paramètre → Nouveau) : nom, INVITE claire (« Sélectionnez l'année »), type, options (unique/multiple, plage, liste de valeurs, défaut).
Intégrez-le à la SÉLECTION des enregistrements (« Date de commande dans l'année {?Annee} ») — de façon à rester côté serveur si possible.
Affichez éventuellement la valeur choisie dans le rapport (titre « Ventes {?Annee} — {?Region} »).
Testez à l'exécution : l'invite apparaît, vous saisissez/choisissez, le rapport s'adapte. Un seul modèle sert tous les cas.

Vous créez des paramètres et invites qui rendent le rapport interactif et RÉUTILISABLE : un seul modèle pour toutes les périodes/clients, personnalisé à l'exécution — un vrai outil.

Script prêt à dire — vendre le modèle unique (30 s)

« Fini les douze copies : un seul état des ventes, avec deux questions au lancement — l'année et la région. Vous choisissez, le rapport filtre et titre en conséquence. Moins de fichiers, une seule correction à faire, et pas de faute de saisie grâce aux listes. Testez : lancez-le pour 2025 Nord puis 2026 Sud. »

À dire en lançant l'état de Farès deux fois avec deux couples de valeurs, titres à l'appui.

Modèle copier-coller — sélection pilotée par paramètres

Year({Commandes.DateCommande}) = {?Annee}
Year({Commandes.DateCommande}) = {?Annee} and {Clients.Region} = {?Region}
{Commandes.DateCommande} in {?PlageDates}
{Clients.Ville} in {?Villes} // paramètre à valeurs multiples

Plage de dates

Farès propose une plage du 01/01 au 31/12 : l'utilisateur saisit deux bornes pour la période.

Plusieurs clients

Paramètre à valeurs multiples : Farès choisit trois clients d'un coup, filtre « dans la liste ».

Seuil de montant

Paramètre seuil avec défaut 1 000 : Farès ne garde que les commandes significatives, modifiable à l'exécution.

Invite obscure

Invite « Param1 : » : personne ne sait quoi saisir — Farès la réécrit « Sélectionnez la région ».

✓ Buenas prácticas

Proposez une liste de valeurs (menu déroulant) plutôt qu'une saisie libre.
Fournissez une valeur par défaut sensée (l'année en cours).
Intégrez le paramètre au filtre en restant côté serveur (performance).

✗ Errores frecuentes

Saisie libre source de fautes (préférez une liste de valeurs).
Un paramètre non intégré au filtre (le rapport ne s'adapte pas).
Une invite obscure qui déroute l'utilisateur.

Puntos clave

Un PARAMÈTRE est une valeur demandée à l'utilisateur à l'exécution via une INVITE ; le rapport s'adapte.
Usage n°1 : FILTRER — le paramètre alimente la sélection. Un SEUL rapport sert tous les cas (générique, réutilisable).
Options : valeurs MULTIPLES, PLAGE, LISTE de valeurs (statique/dynamique), valeur par DÉFAUT. Les paramètres se combinent.
Bonnes pratiques : rester CÔTÉ SERVEUR, soigner l'INVITE, proposer une LISTE de valeurs. Peut aussi titrer le rapport.

Défi 48h — appliquez demain

Sur votre état filtré en dur : créez un paramètre (invite claire, liste, défaut), branchez-le sur la sélection, affichez-le dans le titre, puis testez 2 valeurs différentes à l'exécution.

Lista de salida de la sección