Portail de support Workiva

Avec les paramètres, vous pouvez demander des valeurs à utiliser avec les filtres ou les calculs d'une requête à chaque fois qu'elle est exécutée. En définissant ces valeurs au moment de l'exécution, vous pouvez utiliser une requête dans un contexte différent (compte, région ou période, par exemple) à chaque fois qu'elle est exécutée.

Vous pouvez créer des paramètres personnalisés à utiliser avec une requête spécifique, ou le propriétaire de votre espace de travail peut créer des paramètres globaux à utiliser avec plusieurs requêtes.

Créer des paramètres personnalisés pour une requête

Vous pouvez définir les paramètres d'une requête dans le Builder ou dans l'éditeur SQL. Lorsque vous créez un paramètre, vous pouvez l'utiliser avec plusieurs filtres et calculs dans la requête. 

Étape 1. Créer le paramètre

1. Dans le panneau Parameters , cliquez sur Add, et sélectionnez Create New Parameter.
   
<!--
2. From the Parameters panel, click Create Parameter.
   
-->
3. Pour faciliter l'identification du paramètre, saisissez un nom unique ne comportant que des caractères alphanumériques et pas d'espaces.
4. Dans Filter type, sélectionnez le type de données à filtrer, par exemple Text ou Integer.

Étape 2. Définir les valeurs des paramètres

Lorsqu'une requête est exécutée, ses paramètres peuvent accepter des valeurs libres - en fonction du type de données - ou fournir une liste de valeurs spécifiques à choisir. 

• Pour accepter une valeur libre, saisissez la valeur par défaut (le cas échéant) et cliquez sur Create.
• Pour fournir une liste de valeurs spécifiques :

1. Activer Liste de sélection.
2. Pour activer des valeurs multiples pour le paramètre, cochez la case Multi-Select .
3. Dans List Options, entrez les valeurs à choisir, en appuyant sur Enter après chacune d'elles.

   Remarque : Pour un paramètre de date ou d'horodatage, saisissez chaque option dans le format YYYY-MM-dd.

4. Sélectionnez une valeur par défaut pour le paramètre et cliquez sur Accepter.

   Note : Pour un paramètre à sélection multiple , sélectionnez au moins une valeur par défaut.

5. Cliquez sur Créer pour terminer.

Étape 3. Utiliser le paramètre dans la requête

Pour appliquer la valeur du paramètre à la requête, utilisez-la dans un filtre ou un calcul :

• Pour définir la valeur d'un filtre en fonction du paramètre dans Builder, sélectionnez-le lorsque vous définissez le filtre dans le panneau droit Filter Properties.

  Note : Pour un paramètre à sélection multiple, sélectionner un opérateur de filtre de Is In List ou Is Not In List dans l'onglet Filters.

• Pour utiliser le paramètre avec un filtre dans l'éditeur SQL ou référencer sa valeur dans un calcul, saisissez son nom après deux points (:) dans l'instruction SQL, par exemple :ReportingPeriod.

Utiliser des paramètres globaux dans une requête

Le propriétaire de votre espace de travail peut configurer des paramètres globaux pour des valeurs communes utilisées avec plusieurs requêtes. Pour utiliser des paramètres globaux dans une requête :

1. Dans le panneau Paramètres , cliquez sur Ajouter, et sélectionnez Sélectionner un paramètre global.
   
2. Sélectionnez les paramètres globaux à utiliser dans la requête et cliquez sur Add.
3. Pour modifier le paramètre global, sélectionnez-le et modifiez son nom ou sa valeur en fonction de la requête.

   Note : Pour garantir la cohérence de l'analyse, le propriétaire de l'espace de travail peut verrouiller un paramètre global afin d'empêcher la modification de sa valeur.

4. Pour appliquer la valeur d'un paramètre global à la requête, utilisez-le dans un filtre ou un calcul :

   • Pour définir la valeur d'un filtre en fonction du paramètre dans Builder, sélectionnez-le lorsque vous définissez le filtre dans le panneau droit Filter Properties.

     Note : Pour un paramètre à sélection multiple, sélectionner un opérateur de filtre de Is In List ou Is Not In List dans l'onglet Filters.

   • Pour référencer le paramètre dans l'éditeur SQL, saisissez son nom après les deux points (:) dans l'instruction SQL, par exemple :ReportingPeriod.
   • Pour faire référence à la valeur d'un paramètre dans une instruction SQL de calcul, sélectionnez le paramètre dans le menu Paramètres.

Modifier un paramètre de requête

Pour régler ou gérer les détails d'un paramètre :

1. Dans le panneau Parameters, sélectionnez le paramètre à modifier.
2. Modifiez le nom, le type de données ou les valeurs du paramètre si nécessaire.
3. Cliquez sur Appliquer.

Supprimer un paramètre de requête

Si vous n'avez plus besoin d'un paramètre, vous pouvez le supprimer de la requête. Dans le panneau Paramètres, cliquez sur le nom du paramètre Supprimer , puis cliquez sur Enregistrer .