Rôle
Recueille les valeurs d’exécution, affiche des explications et ajoute les paramètres porteurs de valeurs comme colonnes dans chaque ligne. Les paramètres sont également disponibles pour les conditions, formules et mappages suivants. Vous pouvez afficher le formulaire dans l’assistant, dans une boîte de dialogue distincte ou utiliser les valeurs configurées sans formulaire.
Entrées et sorties
Une entrée, in. Généralement une sortie out avec les colonnes ajoutées. Si un sélecteur radio possède outputs=true, chaque position devient une sortie distincte ; seule la sortie sélectionnée est activée.
Paramètres
| Le paramètre | Réglages et valeurs | Options et limites |
|---|---|---|
wizard | Affiche le bloc comme une étape de l’assistant d’exécution. | Par défaut : disabled |
display | hidden — aucun formulaire, wizard — une étape de l’assistant, dialog — une boîte de dialogue distincte. | Par défaut : not set |
dialog_width | Largeur de la boîte de dialogue en pixels. | Par défaut : 760Limites : 360…1 600 |
dialog_height | Hauteur de la boîte de dialogue en pixels. | Par défaut : 560Limites : 240…1 200 |
dialog_stop_label | Libellé personnalisé du bouton d’arrêt ; une valeur vide utilise le libellé par défaut. | Par défaut : emptyJusqu’à 60 caractères |
dialog_continue_label | Libellé personnalisé du bouton de poursuite. | Par défaut : emptyJusqu’à 60 caractères |
dialog_stop | Autorise l’arrêt de l’exécution depuis la boîte de dialogue. | Par défaut : enabled |
dialog_maximize | Affiche l’option d’agrandissement de la boîte de dialogue. | Par défaut : enabled |
dialog_close | Affiche le bouton de fermeture. | Par défaut : enabled |
title | Le titre présenté à l’utilisateur. | Par défaut : emptyJusqu’à 200 caractères |
description | Une explication aidant l’utilisateur à remplir le formulaire ou à faire un choix. | Par défaut : emptyJusqu’à 4 000 caractères |
columns | Le nombre de colonnes de mise en page du formulaire : de 1 à 4. | Options : 1, 2, 3, 4Par défaut : 1 |
rows | Le nombre de lignes de la grille ; une valeur vide le détermine automatiquement. | Par défaut : not set |
row_gap | L’espacement entre les lignes de la grille. | Par défaut : not set |
column_gap | L’espacement entre les colonnes de la grille. | Par défaut : not set |
fields | De 1 à 100 champs de formulaire ; le flux entier est également limité à 100 paramètres. | Nombre : 1–100 |
Types de champs du formulaire
| Le paramètre | Élément configuré |
|---|---|
| constant | Une valeur d’exécution constante. |
| text / textarea | Texte sur une ou plusieurs lignes. |
| number | Une valeur numérique. |
| date | Une date calendaire. |
| member | Sélectionne un membre de dimension/hiérarchie d’une connexion ; la sélection peut être limitée à un sous-ensemble. |
| toggle | Deux positions avec des valeurs off_value/on_value et des libellés personnalisés. |
| radio | Plusieurs positions avec id, label et value uniques ; affichées sous forme de sélecteur ou de boutons. |
| file | Un fichier joint pouvant être utilisé dans les messages. |
| info | Texte d’information mis en forme et coloré ; ne crée pas de colonne. |
Propriétés des champs
| Le paramètre | Élément configuré |
|---|---|
name / label / hint | Le nom interne, le libellé du formulaire et l’infobulle. |
required / locked / value | Caractère obligatoire, verrouillage de la modification et valeur par défaut. |
row / column / row_span / col_span | La position initiale dans la grille et le nombre de lignes/colonnes occupées. Sans row, le champ est placé automatiquement dans sa colonne. |
connection_id / dimension / hierarchy / subset / private | La source de la liste de membres pour member et le mode de sous-ensemble. |
options / outputs | Les positions du sélecteur radio et l’activation éventuelle de sorties distinctes. Jusqu’à 20 options. |
appearance / option_gap / per_row / align / color | L’apparence des positions du sélecteur, l’espacement, le nombre par ligne, l’alignement et la couleur. |
text / text_format / info_color | Le texte du champ d’information, son format plain/html et sa couleur. |
Configuration étape par étape
- Placez le bloc avant les étapes qui utilisent ses paramètres. Saisissez un titre et une explication.
- Ajoutez des champs avec des noms internes uniques et des libellés clairs. Sélectionnez le type de chaque champ.
- Définissez les valeurs par défaut, les champs obligatoires, les verrouillages de modification et les infobulles.
- Choisissez le mode d’affichage et la disposition. Les positions des champs ne doivent pas se chevaucher.
- Pour sélectionner un membre, précisez la connexion, la dimension, la hiérarchie et, si nécessaire, le sous-ensemble.
- Reliez les paramètres aux filtres, formules ou destinations suivants et vérifiez le formulaire dans une simulation.
Règles et diagnostics
- Les noms de paramètres sont uniques dans tout le flux. Un nom de paramètre ne peut pas écraser une colonne d’entrée ; sinon, PARAMETER_COLUMN_CONFLICT se produit.
- Les valeurs deviennent disponibles après l’exécution du bloc ; les étapes suivantes ne peuvent pas utiliser les paramètres d’une branche qui n’a pas été exécutée ou d’une branche sans relation.
- Un message d’information n’a pas de valeur et ne devient pas une colonne. Un champ de pièce jointe n’a pas de valeur par défaut.
- Un champ obligatoire verrouillé nécessite une valeur par défaut. La grille du formulaire vérifie les limites et les chevauchements.
- Un seul sélecteur radio du bloc peut disposer de sorties distinctes. Si la position sélectionnée n’est pas connectée, cette branche se termine.
- Le mode hidden reste masqué uniquement si chaque champ que l’utilisateur devrait remplir possède déjà une valeur. Sinon, le système affiche le formulaire dans l’assistant.
Exemple de configuration
Créez « Scenario » comme radio avec Budget/Forecast, « Period » comme member de la dimension Month et « Rate » comme number=1. Les valeurs sont ajoutées à chaque ligne ; un filtre suivant utilise « Period » et une formule multiplie Value par param("Rate").
Libellés, disposition et valeurs fournies
Les champs proposent show_label et label_gap pour contrôler le libellé visible et son espacement. Un libellé visuellement masqué reste accessible aux lecteurs d’écran. Les champs d’information peuvent contenir du texte mis en forme et une couleur personnalisée, mais ne créent pas de colonnes. Pour les choix radio affichés comme boutons, définissez le nombre par ligne, l’alignement, la couleur et l’espacement. Prévisualisez le formulaire avant de l’exécuter.
Les planifications, les API et les autres flux peuvent fournir des paramètres. Un sous-flux ou un appel en arrière-plan ne sollicite pas une personne dans un assistant : il utilise les valeurs fournies ou les valeurs par défaut. Les noms fournis doivent correspondre aux noms internes des champs. Un paramètre de lancement antérieur, un champ de la première ligne et une constante sont des sources distinctes qui doivent être sélectionnées explicitement.