Les paramètres sont des variables qui permettent de filtrer les données ou d’afficher des valeurs spécifiques dans un tableau de bord.

Par exemple, si vous ajoutez le paramètre « ID de l'utilisateur actuel » à une requête, chaque employé ne verra que ses propres données. Vous n’avez pas besoin de créer plusieurs tableaux de bord.

Configurer les paramètres de tableau de bord

Vous pouvez ajouter des paramètres lors de la création ou modification d’un tableau de bord.

1. Accédez à la section BI Builder.
2. Pour créer un tableau de bord, cliquez sur Nouveau tableau de bord.
3. Pour modifier un tableau de bord existant, ouvrez Menu (≡) > Paramètres.

Lors de la création du tableau de bord, définissez son nom, ajoutez-le aux groupes et configurez les paramètres nécessaires. Les groupes déterminent où le tableau de bord apparaît et quels employés peuvent y accéder.
Comment configurer les droits d'accès dans BI Builder

Une fois ajoutés, les paramètres peuvent être liés aux outils Bitrix24. Par exemple, si vous utilisez le paramètre ID de flux, le tableau de bord devient accessible lorsque vous cliquez sur le statut du flux. Si vous ajoutez l’ID du modèle de processus d’entreprise, le tableau de bord apparaît dans la fiche du protocole du processus.
BI Builder : configurer les filtres par flux et modèles de processus

Une fois les paramètres définis, ajoutez-les à l’ensemble de données.

Les graphiques du tableau de bord s’appuient sur cet ensemble de données. Les paramètres doivent donc être inclus directement dans la requête SQL. Sinon, ils ne seront pas pris en compte.

1. Ouvrez la section ID des paramètres.
2. Copiez les codes des variables nécessaires.
3. Ajoutez ces codes dans l’ensemble de données du tableau de bord.

Créer un ensemble de données

Après enregistrement, le tableau de bord apparaîtra dans la liste sous forme de brouillon. Dans ce statut, seul le créateur le voit. Vous pouvez modifier les données ou la structure du tableau de bord. Personne ne verra les modifications tant que le tableau de bord n’est pas publié. Pour accéder au BI Builder et créer un ensemble de données, cliquez sur Modifier.

1. Dans le BI Builder, accédez à SQL > SQL Lab.
2. Sélectionnez le schéma bitrix24.
3. Entrez la requête SQL et cliquez sur Exécuter (Run). Vous pouvez ajouter un modèle Jinja à la requête pour modifier dynamiquement les paramètres. Par exemple, vous pouvez définir une condition : si le paramètre de l'utilisateur actuel est absent, la requête affiche toutes les données. Si le paramètre de l'utilisateur actuel est passé dans le lien, la requête affichera uniquement les données de l'employé qui a ouvert le tableau de bord. Ainsi, vous pouvez immédiatement enregistrer l'ensemble de données et l'utiliser dans les tableaux de bord.
   Comment utiliser les modèles Jinja Templates dans BI Builder

WHERE true
{% if url_param('current_user') is not none %}
AND crm_deal.ASSIGNED_BY_ID = {{ url_param('current_user') }}
{% endif %}

Si vous utilisez des valeurs spécifiques dans la requête lors de la création de l'ensemble de données, n'ajoutez pas de paramètres, car ils ne fonctionneront pas. Vous pouvez ajouter des paramètres plus tard, lors de l'édition de l'ensemble de données final.

Si vous créez un ensemble de données pour la première fois, consultez l'exemple de requête.

SELECT crm_deal.ID AS "ID de transaction",
       crm_deal.TITLE AS "Titre de transaction",
       crm_deal.ASSIGNED_BY AS "Responsable"
FROM crm_deal
WHERE crm_deal.ASSIGNED_BY_ID = 4
AND YEAR(crm_deal.DATE_CREATE) = YEAR(CURRENT_DATE)

Enregistrez l'ensemble de données résultant en tant que Dataset et créez un graphique pour le tableau de bord.
Comment créer et ajouter un graphique basé sur un ensemble de données virtuel à un rapport

Modifier l'ensemble de données

Pour ajouter un paramètre, ouvrez l'onglet Datasets, sélectionnez l'ensemble de données créé et cliquez sur Éditer.

Modifiez la requête SQL, ajoutez le paramètre : WHERE crm_deal.ASSIGNED_BY_ID = {{ url_param('current_user') }} et enregistrez les modifications. Lorsque les employés ouvrent un tableau de bord dans Bitrix24, le paramètre insérera automatiquement l'identifiant requis et chaque utilisateur ne verra que ses données.

Vérifier le fonctionnement du tableau de bord

Ouvrez le tableau de bord dans Bitrix24 et vérifiez que les graphiques affichent des informations pour un utilisateur spécifique. Si le paramètre fonctionne correctement, le créateur du tableau de bord ne verra que ses propres transactions.

Publiez le tableau de bord afin que les autres utilisateurs puissent le voir. Ouvrez le Menu (≡) et cliquez sur Publier.

Une fois le tableau de bord publié, demandez aux employés de s'assurer qu'ils ne voient que leurs propres informations. Par exemple, le responsable ne verra pas les transactions des autres employés dans le tableau de bord.