Dans BI Builder, vous pouvez utiliser des filtres basés sur des paramètres tels que les flux de tâches et les modèles de processus d'entreprise. Ces filtres vous aident à analyser les données dans le contexte souhaité, par exemple en vous concentrant sur un flux précis ou sur un modèle de processus d'entreprise particulier.
Les filtres fonctionnent avec les paramètres du rapport et ajustent automatiquement les données selon l'emplacement à partir duquel le rapport est ouvert. Par exemple, si le rapport était ouvert depuis le flux « Service juridique », le filtre s'appliquerait immédiatement et n'afficherait que les tâches de cette équipe.
Dans cet article :
Configurer les paramètres d'un rapport dans Bitrix24
Avant d'ajouter des filtres, vous devez configurer les paramètres. Ces paramètres établissent le lien entre le rapport et les données. Par exemple, le paramètre tasks_flows_flow_id transmet l'identifiant du flux de tâches, tandis que bworkflow_template_id transmet l'identifiant du modèle de processus d'entreprise. Vous pouvez définir ces paramètres aussi bien pour les nouveaux rapports que pour ceux qui existent déjà :
- Accédez à la section BI Builder.
- Pour créer un rapport, cliquez sur Nouveau tableau de bord.
- Pour modifier un rapport existant, ouvrez Menu (≡) - Paramètres.
Lors de la création du rapport, indiquez son nom, ajoutez-le aux groupes dans lesquels il sera affiché et définissez les paramètres nécessaires.
Après avoir ajouté un paramètre, vous pouvez choisir d'afficher ou non le rapport dans la section correspondante. Par exemple, si vous utilisez le paramètre d'identifiant de flux, le rapport sera accessible en cliquant sur le statut du flux. Si vous ajoutez l'identifiant du modèle de processus d'entreprise, le rapport apparaîtra dans le formulaire du journal du processus d'entreprise.
Après avoir indiqué les paramètres, vous devez les ajouter à l'ensemble de données. Les graphiques du rapport sont construits à partir de l'ensemble de données, les paramètres doivent donc être inclus dans la requête. S'ils ne sont pas ajoutés, ils ne fonctionneront pas. Ouvrez la section ID des paramètres et notez les codes des variables nécessaires afin de pouvoir les utiliser dans l'ensemble de données.
Créer ou mettre à jour un ensemble de données
Si vous créez un nouveau rapport, vous pouvez renseigner les paramètres directement dans la requête SQL.
- Cliquez sur l'onglet SQL - SQL Lab.
- Sélectionnez le schéma bitrix24.
- Saisissez la requête SQL puis cliquez sur Execute. Ajoutez un modèle Jinja à la requête afin que le rapport applique correctement la valeur du filtre. Par exemple, si le rapport était ouvert depuis le journal d'un processus d'entreprise, Jinja remplacerait son identifiant et le rapport n'afficherait que les données de ce processus. Si le rapport était ouvert séparément, le filtre ne recevrait aucun identifiant et afficherait toutes les données.
Comment utiliser les modèles Jinja Templates dans Constructeur BI
Si vous créez un ensemble de données pour la première fois, consultez l'exemple de requête ci-dessous.
Exemple de requête SQL pour les rapports de flux de tâches
Il s'agit d'une requête SQL permettant d'extraire des données à partir de l'ensemble de données de flux de tâches (flow). Vous pouvez la copier et vérifier comment la sélection fonctionne. La requête affiche les champs principaux du flux et prend en charge le filtrage par le paramètre tasks_flows_flow_id.
SELECT f.id AS "ID de flux", f.name AS "Nom du flux", f.creator_name AS "Nom du créateur de flux", f.planned_completion_time AS "Temps d'achèvement des tâches", f.tasks_ids AS "Tâches dans le flux" FROM flow f WHERE 1=1 {% if url_param('tasks_flows_flow_id') is not none %} AND f.id = {{ url_param('tasks_flows_flow_id') }} {% endif %}
SELECT indique les informations à extraire de l'ensemble de données. Par exemple, la requête SELECT f.id AS "ID de flux" :
- sélectionne l'
iddu flux dans l'ensemble de donnéesflow; - lui attribue le nom
ID de flux; - affiche le résultat dans une colonne séparée du tableau ;
FROM indique l'ensemble de données à partir duquel les données sont extraites. Ici, les données proviennent de flow, qui est une table contenant les informations sur les flux de tâches.
WHERE filtre les résultats. La condition de base 1=1 est utilisée pour ajouter facilement des contraintes supplémentaires.
Ensuite, un modèle Jinja est utilisé. Cette partie vérifie si le paramètre tasks_flows_flow_id est présent dans le rapport. Si le rapport était ouvert depuis un flux, Jinja remplacerait son identifiant et n'afficherait que les données de ce flux. Si le rapport était ouvert directement dans BI Builder, le paramètre ne serait pas transmis et toutes les données seraient affichées.
Exemple de requête SQL pour les rapports de modèles de processus d'entreprise
Il s'agit d'une requête SQL permettant d'extraire des données à partir de trois ensembles de données : tâches de processus d'entreprise (bizproc_task), processus d'entreprise actifs (bizproc_workflow_state) et modèles de processus d'entreprise (bizproc_workflow_template). Vous pouvez la copier et vérifier comment la sélection fonctionne. La requête affiche les informations clés sur les processus d'entreprise actifs et prend en charge le filtrage par le paramètre workflow_template_id, ce qui permet de construire le rapport pour un modèle de processus spécifique.
SELECT t.created_date AS "Date de création de l'affectation", t.status_name AS "Statut de l'affectation", t.user_name AS "Participant à l'affectation", w.started_by_name AS "Initiateur du processus", w.completed AS "Statut d'achèvement du processus", w.duration AS "Temps passé", wt.name AS "Nom du modèle" FROM bizproc_task t LEFT JOIN bizproc_workflow_state w ON t.workflow_id = w.id LEFT JOIN bizproc_workflow_template wt ON wt.id = w.workflow_template_id WHERE 1=1 {% if url_param('workflow_template_id') is not none %} AND wt.id = {{ url_param('workflow_template_id') }} {% endif %} ORDER BY t.created_date DESC;
SELECT indique les données à extraire des ensembles de données. Par exemple, la requête SELECT t.created_date AS "Date de création de l'affectation" :
- sélectionne le champ
created_datede la tâche dans l'ensemble de donnéesbizproc_task; - attribue au champ le nom
Date de création de l'affectation; - affiche le résultat dans une colonne séparée du tableau ;
FROM et LEFT JOIN indiquent les ensembles de données à partir desquels les données sont extraites et la façon dont ils sont reliés.
bizproc_taskcontient les tâches exécutées par les employés ;bizproc_workflow_statestocke les données sur le processus dans lequel la tâche a été créée ;bizproc_workflow_templatedécrit le modèle de processus d'entreprise ;
LEFT JOIN est utilisé pour afficher toutes les tâches, même si certaines ne disposent pas d'informations sur l'état ou le modèle.
WHERE filtre les résultats. La condition 1=1 n'influence pas la sélection et sert à simplifier l'ajout de filtres.
Ensuite, un modèle Jinja est utilisé. Cette partie vérifie si le paramètre workflow_template_id est présent dans le rapport. Si le rapport était ouvert depuis le formulaire du journal d'un processus d'entreprise, Jinja remplacerait l'identifiant et n'afficherait que les données correspondantes. Si le rapport était ouvert directement dans BI Builder, le paramètre ne serait pas transmis et toutes les données seraient affichées.
Enregistrez ensuite le résultat sous forme d'ensemble de données et créez un graphique pour le rapport.
Comment créer et ajouter un graphique basé sur un ensemble de données virtuel à un rapport
Si le rapport existe déjà, vous pouvez simplement modifier l'ensemble de données et y ajouter le paramètre nécessaire.
- Ouvrez l'onglet Datasets et sélectionnez l'un des ensembles de données.
- Cliquez sur Edit.
Modifiez la requête SQL et ajoutez le paramètre en fonction du filtre que vous prévoyez d'utiliser :
- Flux de tâches -
WHERE 1=1 {% if url_param('tasks_flows_flow_id') is not none %} AND f.id = {{ url_param('tasks_flows_flow_id') }} {% endif %}. - Modèles de processus d'entreprise -
WHERE 1=1 {% if url_param('workflow_template_id') is not none %} AND wt.id = {{ url_param('workflow_template_id') }} {% endif %}.
Ajouter des filtres et tester le rapport
Pour ajouter des filtres :
- Ouvrez le rapport en mode édition.
- Cliquez sur Add/edit filters dans le panneau de gauche.
- Indiquez le type et le nom souhaités, puis enregistrez les paramètres.
Vérifiez ensuite le fonctionnement des filtres. Pour cela, ouvrez le rapport dans la section dans laquelle il a été intégré. L'emplacement dépend des paramètres sélectionnés :
Modèles de processus d'entreprise
- Accédez à la section Automation -Processus d'entreprise.
- Sélectionnez le processus d'entreprise souhaité et ouvrez le rapport dans l'onglet Journal.
Flux de tâches
- Accédez à la section Tâches et projets - Flux.
- Dans la colonne Analyses, cliquez sur l'indicateur du flux et ouvrez le rapport.
Résumé
- Les filtres basés sur des paramètres aident à analyser les données dans le contexte souhaité, par exemple pour un flux de tâches ou un modèle de processus d'entreprise spécifique.
- Pour utiliser les filtres, configurez les paramètres du rapport et indiquez la section dans laquelle il sera ouvert.
- Si vous créez un nouveau rapport, vous pouvez ajouter les paramètres directement dans la requête SQL ; si le rapport existe déjà, modifiez l'ensemble de données pour y ajouter les paramètres.
- Ensuite, ajoutez des filtres au rapport, ouvrez-le dans Bitrix24 et vérifiez qu'il affiche uniquement les données du flux ou du processus sélectionné ;
