Les requêtes vous permettent de compiler et de découper des données provenant de sources multiples à des fins d'analyse et de création de rapports. Dans cet exemple, vous combinerez les données de la balance générale avec les tableaux de dimensions des comptes et des entités afin d'analyser les transactions pour chaque compte et chaque entité.
Remarque : Si vous ne l'avez pas encore fait, consultez Get Started with Tables pour créer les tableaux utilisés dans cet exercice.
En fonction de votre familiarité avec le langage de requête structuré (SQL), vous pouvez créer une requête à l'aide d'un générateur de requêtes par glisser-déposer ou d'un éditeur de syntaxe ; dans cet exemple, vous utiliserez Builder.
Étape 1. Déterminer les sources de données
Avant de commencer votre requête, réfléchissez aux données que vous devez inclure pour des analyses ou des rapports spécifiques. Votre requête peut inclure des données auxquelles vous accédez dans votre espace de travail Workiva sous forme de tableaux ou de feuilles de calcul. Dans ce cas, vous utiliserez les trois tableaux créés dans l'exercice précédent :
- TB Data, pour les informations relatives à la balance des comptes
- DIM FS Mapping, pour le mappage des comptes financiers
- DIM Entity, pour le mappage des entités
Étape 2. Créer la requête et ajouter ses données
Maintenant que vous savez ce que vous voulez inclure, créez la requête et ajoutez les données des tables :
- Dans Wdata Home, cliquez sur Create , et sélectionnez Query .
- Dans le panneau Sources, cliquez sur New source , et sélectionnez Table.
- Sélectionnez les tables à inclure - dans ce cas, toutes les tables du dossier Get Started Demo - et cliquez sur Add.
Note : Dans le panneau Sources, vous pouvez sélectionner tous les tableaux ou feuilles de calcul dont vous êtes au moins le visualisateur.
Étape 3. Créer des relations entre les sources
Comme votre requête contient plusieurs sources, créez des relations pour montrer comment relier leurs données entre elles. Comme vous vous en souvenez peut-être lorsque vous avez créé les tables, la table de fait de la balance générale comprend des colonnes qui correspondent aux comptes et aux entités des tables de dimension.
- Sélectionnez l'onglet Relationships.
- Sous Sources, développez les tables pour afficher les colonnes source disponibles pour la mise en correspondance avec une relation.
- Pour la jointure 1, déplacez ACCOUNT_ID de TB Data vers la case de gauche, et ACCOUNT_ID de DIM FS Mapping vers la case de droite.
Conseil : Pour trouver une colonne sous Sources, cliquez sur Filtres et recherchez son nom.
- Cliquez sur Add another join.
- Pour Join 2, sélectionnez ENTITY_ID de TB Data dans les colonnes disponibles dans Join 1, et déplacez ENTITY_ID de DIM Entity de Sources vers la case de droite.
- Pour chaque relation, choisissez comment combiner - ou joindre- les données de ses tables. Dans ce cas, pour inclure toutes les données de la table de faits à gauche et seulement les données correspondantes de la table de dimensions à droite, sélectionnez Jointure gauche pour les deux.
Étape 4. Appliquer des filtres à la requête
Pour limiter les résultats de la requête aux enregistrements répondant à des critères spécifiques, ajoutez des filtres à partir de l'onglet Filtres. Dans cet exemple, vous pouvez appliquer des filtres pour inclure uniquement les transactions de 2019 à T1 2020. En fonction de vos besoins en matière de données et de rapports, vous pouvez procéder de plusieurs façons - par période et exercice fiscal, ou par des filtres de dates de début et de fin.
Utiliser les filtres de période et d'exercice
Pour filtrer par période et par année fiscale :
- Déplacez FISCAL_YEAR depuis TB Data vers l'onglet Filters deux fois, puis FISCAL_PERIOD depuis TB Data une fois.
- Pour indiquer d'inclure le 2019 et le T1 2020, définissez la valeur de chaque filtre dans le panneau Field Properties:
- Pour inclure les transactions de 2019, pour le premier filtre FISCAL_YEAR, sélectionnez =, entrez une valeur de 2019, et cliquez sur Apply.
- Pour inclure les transactions de 2020, pour le deuxième filtre FISCAL_YEAR, sélectionnez =, entrez une valeur de 2020, et cliquez sur Apply.
- Pour n'inclure que les transactions du premier trimestre, pour le filtre FISCAL_PERIOD, sélectionnez <=, entrez une valeur de 3 et cliquez sur Apply. Les transactions des trois premiers mois - ou du premier trimestre - de l'exercice fiscal sont ainsi renvoyées.
- Pour appliquer le filtre FISCAL_PERIOD aux seules transactions de 2020 pour le premier trimestre 2020, mettez à jour la chaîne de filtre en
{1} OR {2} AND {3}.
Les transactions qui répondent au premier filtre -FISCAL_YEAR=2019-ou - et aux deux autres filtres combinés -FISCAL_YEAR=2020 etFISCAL_PERIOD <=3 - sont renvoyées.
(Facultatif) Utiliser des filtres de date de début et de fin
Vous pouvez également filtrer par date de début et de fin. Pour ce faire, déplacez PERIOD_ENDING de TB Data vers l'onglet Filters deux fois, et saisissez les critères de chaque filtre dans le panneau Field Properties :
- Pour inclure les transactions de 2019, pour le premier filtre, sélectionnez >= et, dans le panneau Propriétés, entrez le 1er janvier 2019 et cliquez sur Appliquer.
- Pour inclure les transactions à partir de 2020, pour le deuxième filtre, sélectionnez <= et, dans le panneau Propriétés, entrez 31 mars 2020 et cliquez sur Appliquer.
Valeurs des paramètres
Avec ces filtres, la requête toujours n'inclura que les transactions de 2019 et du premier trimestre 2020. Pour prolonger l'utilisation et la durée de vie de cette requête, utilisez des variables - connues sous le nom de paramètres - pour définir les valeurs des filtres de manière dynamique lors de l'exécution de la requête. Par exemple, au lieu des valeurs statiques de l'exercice fiscal, vous pouvez inclure des paramètres qui demandent l'année précédente et l'année en cours lorsque vous exécutez la requête.
Par exemple, pour le premier filtre FISCAL_YEAR:
- Dans l'onglet Filters, sélectionnez la valeur 2019 du filtre.
- Dans le panneau Propriétés du champ, cliquez sur Créer un nouveau paramètre à côté de Valeur.
- Saisissez un nom unique pour identifier le paramètre, par exemple PY ou Previous_Year.
Remarque : Les noms des paramètres ne peuvent contenir que des caractères alphanumériques et des traits de soulignement ; pas d'espaces, de tirets ou de caractères spéciaux.
- Pour Type de filtre, sélectionnez le type de données des valeurs. Par exemple, sélectionnez Entier pour que les années ne soient représentées que par des nombres entiers.
- Saisissez une valeur par défaut de 2019 et cliquez sur Créer.
- Pour Value, sélectionnez le nouveau paramètre et cliquez sur Apply.
Ajouter les paramètres pour les filtres restants :
- Pour le deuxième filtre FISCAL_YEAR:
- Entrez un nom de CY ou Current_Year.
- Sélectionnez le type de filtre Integer.
- La valeur par défaut est 2020.
- Pour le filtre FISCAL_PERIOD:
- Saisissez un nom de Current_Period.
- Sélectionnez le type de filtre Integer.
- Entrer une valeur par défaut de 3.
Étape 5. Sélectionner et trier les champs de la requête
Maintenant que vous avez joint les sources de la requête et réduit la portée de ses données, sélectionnez les informations à inclure dans les résultats :
- Pour sélectionner les informations à inclure dans les résultats, déplacez la colonne correspondante du panneau Sources vers l'onglet Champs.
En l'occurrence :- FISCAL_YEAR et FISCAL_PERIOD de TB Data, pour analyser l'activité mensuelle ou trimestrielle.
- ENTITY_NAME from DIM Entity, pour permettre une ventilation par entité plutôt qu'un rapport consolidé
- FINANCIAL_STATEMENT_LINE_ITEM et DISCLOSURE_LINE_ITEM de DIM FS Mapping, pour permettre la ventilation par mappage des comptes et des postes individuels.
- VALUE à partir de TB Data, pour permettre des résumés des valeurs au niveau du rollup
- Dans le panneau Field Properties, ajustez les en-têtes ou les types de colonnes ou appliquez des agrégations si nécessaire. Par exemple, pour résumer les valeurs basées sur les différentes dimensions, sélectionnez value dans l'onglet Fields et, dans le panneau Field Properties, assurez-vous que Aggregation est Sum of.
- Dans l'onglet Sort, sélectionnez le mode de tri des données dans les résultats. Par exemple, pour trier par année fiscale et par entité, déplacez l'année fiscale et le nom de l'entité de Non trié à Trié, et choisissez de trier leurs données par ordre croissant ou décroissant.
- Pour vérifier que les résultats apparaissent comme vous le souhaitez, cliquez sur Run Query , et acceptez les valeurs des paramètres par défaut.
Étape 6. Sauvegarder la requête
Pour enregistrer la requête :
- Cliquez sur Enregistrer .
- Saisissez un nom et une description uniques pour identifier la requête, par exemple Rapport sommaire de la tuberculose.
- Pour Dossier, sélectionnez le même dossier Get Started Demo comme source de tableau.
- Cliquez sur Save Query.
Prochaines étapes
Après avoir créé votre requête, vous pouvez :
- Créer une vue de ses résultats pour visualiser les données sous la forme d'un graphique ou d'un tableau croisé dynamique avec des données détaillées.
- Connecter ses résultats à une feuille de calcul pour générer des rapports ailleurs dans la plateforme Workiva.
- Mettre en place une chaîne pour exécuter automatiquement la requête et exporter ses résultats, par exemple vers une feuille de calcul.