Les champs d'une requête définissent les informations qui apparaissent dans les résultats. Dans le panneau Sources , vous pouvez sélectionner les données à inclure dans une requête :
- Colonnes sources fournissent des données directement à partir de tableaux et de feuilles de calcul auxquels vous pouvez accéder dans la plateforme Workiva. Lorsque vous ajoutez une colonne source à une requête, vous pouvez modifier la façon dont ses données apparaissent dans les résultats, par exemple en utilisant un type de données différent ou en effectuant un calcul sur ses valeurs.
- Calculs renvoie une valeur basée sur plusieurs colonnes sources, par exemple pour additionner leurs montants ou concaténer une chaîne de valeurs.
Note : Pour ajouter une colonne source à une requête, vous devez au moins avoir accès à sa table ou à sa feuille en tant que visualiseur. Pour faciliter la navigation dans le panneau Sources, cliquez sur Expand All ou Collapse All pour afficher ou masquer toutes les colonnes. Pour trouver un tableau ou une colonne spécifique, cliquez sur Show Filters et effectuez une recherche par son nom.
Définir les champs de la requête
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 Add to Fields ou déplacez-les vers l'onglet Fields.
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.
- Pour clarifier les données du champ, sous Header, saisissez le nom qui apparaîtra dans les résultats de la requête. Par exemple, si la requête comprend plusieurs champs portant le même nom et provenant de sources différentes, mettez à jour leurs noms pour obtenir un contexte supplémentaire.
- 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 des étiquettes sont sauvegardé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.
- Pour modifier la façon dont les dates apparaissent dans un résultat Date ou Horodatage, sous Fonction, sélectionnez l'abréviation à afficher, par exemple Jour ou Trimestre ; ou, pour un Format personnalisé, entrez l'expression du nouveau format de ses valeurs, par exemple
%YY-%mpour YYY-mm:Expression Affiche %bLe nom abrégé du mois, tel que Jan ou Dec %MLe nom complet du mois, tel que janvier ou décembre %cLa valeur numérique du mois en un ou deux chiffres, par exemple 1 pour janvier ou 12 pour décembre. %mLa valeur numérique du mois sous la forme d'un double chiffre, par exemple 01 pour janvier. %DLe jour du mois avec un suffixe anglais, tel que 1st ou 23rd %YL'année entière en quatre chiffres %yL'année abrégée en deux chiffres Note : Par défaut, les dates ou les horodatages apparaissent dans le format ISO 8601.
- Sous Aggregation Type, choisissez de renvoyer ou non un calcul - ou une agrégation - des valeurs du champ 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 de Nombre Total des valeurs du champ Compte de Tout Le nombre total d'enregistrements avec une valeur dans le champ Max. de Entier, Nombre, Date, Horodatage La valeur la plus importante ou la plus récente 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 Remarque : Pour n'inclure dans le calcul que les enregistrements ayant des valeurs uniques, sélectionnez Utiliser l'agrégation distincte.
- 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 comprend :
- Opérateurs, tels que
{1} {2}pour calculer la somme des valeurs des colonnes - Fonctions, telles que
concat({1}, {2})pour générer une chaîne de valeurs de colonnes.
To add a calculation to a query's results, select Calculation on the Sources panel, and then click Add to Fields or move it to the Fields tab. After you add the calculation to the query, select it on the Fields tab, and set up its formula from the Field Properties panel:
-->
- Déplacez Calculation du panneau Sources vers la requête, puis sélectionnez-le dans la requête.
- Dans le panneau Propriétés , sous Header, indiquez comment le nom du calcul doit apparaître dans les résultats de la requête.
Note : Pour définir l'alias du calcul, saisissez-le dans l'en-tête. Les calculs ne supportent pas la syntaxe qui contient
ASpour définir un alias. - 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.
- 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 jeton 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 Calculation .
- 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.
- Cliquez sur Appliquer. <!--
Note: To quickly add a column's numerical token to the calculation, click its name under Included Columns.
Organiser les champs de requête 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'à sa position appropriée ou cliquez dessus avec le bouton droit de la souris et choisissez 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 :
- 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.
- Sélectionnez la copie - dont l'en-tête est
[nom_du_champ_copié]_copie- et mettez à jour son en-tête et toutes les autres propriétés dans le panneau de droite Propriétés du champ . - Cliquez sur Enregistrer .
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 Supprimer , ou cliquez avec le bouton droit de la souris sur le champ et sélectionnez Supprimer le champ.