Portail de support Workiva

Définir les champs de requêtes

Pour ajouter des colonnes spécifiques ou des sources complètes aux résultats de la requête, sélectionnez-les dans le panneau Sources, cliquez sur Ajouter aux champs ou déplacez-les vers l'onglet Champs.

Après avoir ajouté une colonne à la requête, vous pouvez la sélectionner dans l'onglet Fields pour afficher sa source, son ID et son type de données dans le panneau de droite Field Properties . À partir de ce panneau, vous pouvez également ajuster la façon dont le nom ou les données d'un champ apparaissent dans les résultats de la requête.

1. Pour clarifier les données du champ, sous Header, entrez le nom qui apparaîtra dans les résultats de la requête. Par exemple, si la requête inclut plusieurs champs portant le même nom et provenant de sources différentes, mettez à jour leurs noms pour obtenir un contexte supplémentaire.
2. Pour renvoyer un type de données différent dans les résultats, par exemple pour convertir des données textuelles numériques en décimales ou en entiers, sélectionnez le type de données à utiliser sous Cast Type.

   Note : Les valeurs de balise sont enregistrées sous forme de chaînes de caractères. Pour utiliser une balise comme autre type de données, sélectionnez le type souhaité dans Cast Type.

3. Pour ajuster l'affichage des dates dans un résultat Date ou Horodatage, sous Fonction, sélectionnez l'abréviation à afficher (Jour ou Trimestre, par exemple) ou, pour un Format personnalisé, entrez l'expression de la nouvelle forme de ses valeurs ( %YY-%m pour YYY-mm) :

   Expression	Affiche
   %b	Le nom abrégé du mois, tel que Jan ou Dec
   %M	Le nom complet du mois, tel que janvier ou décembre
   %c	La valeur numérique du mois en un ou deux chiffres, par exemple 1 pour janvier ou 12 pour décembre.
   %m	La valeur numérique du mois sous la forme d'un double chiffre, par exemple 01 pour janvier
   %D	Le jour du mois avec un suffixe anglais, tel que 1st ou 23rd
   %Y	L'année entière en quatre chiffres
   %y	L'année abrégée en deux chiffres

   Note : Par défaut, les dates ou horodatages se mettent en forme ISO 8601.

4. Sous Aggregation Type, sélectionnez si les valeurs du champ doivent être retournées sous forme de calcul - ou d'agrégation - dans les résultats. Par exemple, un champ peut renvoyer un décompte de ses enregistrements ou une moyenne ou une somme de ses montants. Pour fournir un calcul, sélectionnez l'agrégation à effectuer :

   Agrégation	Type de champ ou de moule	Résultat
   Somme des	Nombre	Le total des valeurs du champ
   Nombre de	Tout	Le nombre total d'enregistrements contenant une valeur dans le champ.
   Max de	Entier, Nombre, Date, Horodatage	La plus grande ou la plus récente valeur du champ
   Min de	Entier, Nombre, Date, Horodatage	La valeur la plus petite ou la plus ancienne du champ
   Moyenne de	Entier, Nombre	La moyenne des valeurs du champ

   Note : Pour n'inclure dans le calcul que les enregistrements ayant des valeurs uniques, sélectionnez Utiliser l'agrégation distincte.

5. Cliquez sur Appliquer.

Définir les calculs

Avec un calcul, vous pouvez appliquer automatiquement une formule à plusieurs colonnes sources, à l'aide d'une expression qui inclut :

• Opérateurs, tels que {1} + {2} pour calculer la somme des valeurs des colonnes
• Des fonctions, telles que concat({1}, {2}) pour générer une chaîne de valeurs de colonnes.

1. Déplacez Calcul du panneau Sources vers la requête, puis sélectionnez-le dans la requête.
   
2. Dans le panneau Propriétés , sous Header, entrez la façon dont le nom du calcul doit être saisi dans les résultats de la requête.
   

   Note : Pour définir l'alias du calcul, il faut le saisir dans l'en-tête. Les calculs ne supportent pas la syntaxe qui contient AS pour définir un alias.

3. Déplacez les colonnes à inclure dans le calcul depuis le panneau Sources vers Colonnes incluses dans le panneau Propriétés.

   Conseil : Pour inclure une colonne dans un calcul, vous pouvez également sélectionner le calcul dans la requête, puis sélectionner Ajouter au calcul dans le menu contextuel de la colonne dans le panneau Sources.

4. Sous Calcul, entrez la formule ou l'expression à calculer, en utilisant les opérateurs et les fonctions et les colonnes incluses représentées par le symbole numérique qui leur a été attribué, par exemple {1} + {2}.
   • Pour ajouter rapidement le symbole numérique d'une colonne au calcul, cliquez sur son nom sous Colonnes incluses.
   • Pour ajouter rapidement la syntaxe d'une fonction ou d'un opérateur, sélectionnez-le dans le menu Calcul .
   • Pour faire référence à la valeur d'un paramètre dans le calcul, sélectionnez le paramètre dans le menu Paramètres ou saisissez son nom après deux points, par exemple :ReportingPeriod.

     Note : Pour ajouter un paramètre, sélectionnez Créer un nouveau paramètre dans le menu Paramètres.

5. Cliquez sur Appliquer.

Organiser les champs de requêtes et les calculs

Pour définir la manière dont les champs et les calculs apparaissent dans les résultats de la requête, classez-les dans l'ordre dans lequel ils doivent apparaître. Pour déplacer un champ de requête ou des calculs dans l'onglet Fields, faites-le glisser jusqu'à la position appropriée ou cliquez dessus avec le bouton droit de la souris et sélectionnez de le déplacer vers le haut, vers le bas ou vers le haut ou le bas des champs.

Dupliquer un champ de requête ou un calcul

Pour créer une copie d'un champ de requête ou d'un calcul, par exemple pour l'utiliser avec une agrégation ou une formule différente :

1. Dans l'onglet Champs de la requête, cliquez avec le bouton droit de la souris sur le champ ou le calcul à copier et sélectionnez Dupliquer le champ.
2. Sélectionnez le dupliqué - dont l'en-tête est [nom_du_champ_copié]_copie- et mettez à jour son en-tête et toutes les propriétés supplémentaires dans le panneau de droite Propriétés du champ .
3. Cliquez sur Enregistrer sous .

Supprimer un champ de requête ou un calcul

Pour supprimer un champ ou un calcul d'une requête, dans l'onglet Champs, cliquez sur son Supprimer , ou cliquez dessus avec le bouton droit de la souris et sélectionnez Supprimer le champ.