Utiliser Ideanote avec PowerBI
Connectez et synchronisez les données Ideanote avec PowerBI pour des analyses.
Ce guide vous montre comment configurer Ideanote comme source de données dans PowerBI, afin de récupérer vos idées et leurs activités.
Configurer Ideanote comme source de données dans PowerBI
1) Pour commencer, vous devez créer un jeton API sur la plateforme Ideanote, sauf si vous en avez déjà un. Dans votre espace de travail :
1.1) Click ‘Settings’
1.2) Click ‘Account’
1.3) Click ‘API Tokens’
Remarque : Vous pouvez également utiliser le lien direct suivant, en remplaçant yourworkspace par votre sous-domaine réel : https://yourworkspace.ideanote.io/settings/account#api-tokens
1.4) Cliquez sur « Ajouter » si vous n’avez pas encore de jeton API.
1.5) Copiez le jeton API en cliquant sur l’icône « copier », ou en copiant le texte manuellement.
2) Vous devez également connaître l’ID de la collecte d’idées à utiliser comme source de données. Le plus simple est d’accéder à la collecte d’idées et d’extraire l’ID de l’URL. L’ID correspond aux chiffres qui suivent la partie /missions/ de l’URL. Par exemple, dans l’URL https://yourworkspace.ideanote.io/missions/28/cards, 28 correspond à l’ID.
Remarque : vous pouvez également obtenir l’ID en exportant un fichier Excel contenant toutes vos collectes d’idées depuis la page « Accueil » de votre espace de travail, puis en recherchant l’ID dans la colonne FRIENDLY_ID.
2) Si vous connaissez déjà l’ID à partir de l’URL, vous pouvez passer directement à l’étape 3. Sinon, voici les instructions détaillées pour l’obtenir à partir d’un fichier Excel. Depuis la page « Accueil » (la page d’entrée de votre espace de travail) :
2.1) Cliquez sur le bouton situé à côté de « Ajouter » dans la barre d’outils des filtres, qui indique le nombre de collectes d’idées
2.2) Cliquez sur « Exporter au format Excel » dans le menu déroulant qui s’affiche.
2.3) Ouvrez le fichier Excel, repérez votre collecte d’idées et extrayez son ID de la colonne FRIENDLY_ID.
3) Dans PowerBI, ouvrez le rapport auquel vous souhaitez connecter Ideanote, ou créez-en un nouveau à l’aide du bouton « Rapport » sous le titre « Nouveau » de l’onglet « Accueil »
4) In your report:
4.1) Cliquez sur « Obtenir des données » dans la barre d’outils.
4.2) Si un menu déroulant apparaît en dessous, cliquez sur « Plus » en bas. Si aucun menu déroulant n’apparaît et qu’une boîte de dialogue s’ouvre, passez à l’étape (5).
5) Dans la boîte de dialogue qui s’ouvre :
5.1) Cliquez sur « Autre » dans le menu de navigation latéral
5.2) Cliquez sur « Web » dans la liste qui apparaît à côté.
5.3) Enfin, cliquez sur « Connecter » pour continuer.
6) Renseignez les informations sur votre collecte d’idées et le jeton d’autorisation pour l’API dans la boîte de dialogue qui apparaît :
6.1) Cliquez sur le bouton bascule « Avancé » en haut
6.2) Under the first ‘URL parts’ text field, insert the URL https://api.ideanote.io/v1/idea_collections/<idea_collection_id>/ideas.xlsx, where the <idea_collection_id> part if replaced by the ID of your idea collection you identified in step (2). For example, if the ID was 28, the full URL would look like this: https://api.ideanote.io/v1/idea_collections/28/ideas.xlsx
6.3) Sous « Paramètres d’en-tête de requête HTTP (facultatif) », ajoutez un en-tête nommé Authorization
6.4) Comme valeur de l’en-tête Authorization, saisissez :
Bearer <your_api_token>, où <your_api_token> doit être remplacé par le jeton API que vous avez copié à l’étape (1). Par exemple, si votre jeton API est a134566b2501f74fb48d5fdcb14347_1711119239305, la valeur doit être Bearer a134566b2501f74fb48d5fdcb14347_1711119239305
6.5) Enfin, cliquez sur « OK » pour continuer
7) Cliquez sur « Connecter » dans la boîte de dialogue qui apparaît ensuite
8) Dans la boîte de dialogue « Navigateur » qui s’ouvre :
8.1) Faites un clic droit sur « ideas » dans le menu de navigation latéral
8.2) Click ‘Load’
9) Vous êtes maintenant prêt à utiliser vos idées et leurs activités comme source de données
10) Vous pouvez manuellement actualiser les données à tout moment :
10.1) En cliquant sur « Refresh » dans la barre d’outils PowerBI
10.2) Une fenêtre de dialogue s’ouvrira pendant que PowerBI récupère de nouvelles données depuis l’API Ideanote.
10.3) Si votre rapport inclut plusieurs sources de données et que vous souhaitez actualiser uniquement celle d’Ideanote, vous pouvez le faire en :
10.3.1) En cliquant sur les trois points horizontaux à côté de la source de données « idées » dans le panneau latéral « Données »
10.3.2) En cliquant sur « Actualiser les données » dans le menu déroulant qui apparaît en dessous.
Configuration de l’actualisation incrémentielle planifiée des données Ideanote dans PowerBI
Vous pouvez également planifier l’actualisation incrémentielle automatique des données afin que celles d’Ideanote dans PowerBI soient toujours à jour. Pour ce faire, vous devez d’abord suivre les étapes décrites ci-dessus dans « Configuration d’Ideanote comme source de données dans PowerBI » afin de configurer une source de données Ideanote dans PowerBI. Vous pouvez ensuite suivre les étapes ci-dessous :
1) Avant de pouvoir configurer l’actualisation incrémentielle, PowerBI exige impérativement que vous vous assuriez d’abord que votre rapport comporte des paramètres permettant de sélectionner une plage de dates pour la synchronisation des données, et que vous les associiez à la colonne CREATED AT dans la source de données « idées ». La plage de dates doit inclure une date de début et une date de fin. Voici les instructions pour configurer ces paramètres :
1.1) Cliquez sur « Transformer les données » dans la barre d’outils de votre rapport.
1.2) Dans Power Query Editor qui s’ouvre, cliquez sur « Gérer les paramètres » dans la barre d’outils.
1.2.1) Remarque : si vous avez déjà configuré des paramètres pour le début et la fin d’une plage de dates et d’heures, vous pouvez passer à l’étape 1.5.3.
1.3) Dans l’éditeur de paramètres, créez d’abord le paramètre définissant le début de la plage :
1.3.1) Click ‘New’
1.3.2) Donnez-lui un nom descriptif, tel que « RangeStart »
1.3.3) Sous « Type », sélectionnez « Date/Heure »
1.3.4) Sous « Valeur actuelle », indiquez la borne inférieure à prendre en compte pour le modèle. Si vous souhaitez prendre en compte toutes les idées que vous avez collectées, veillez à sélectionner une date égale ou antérieure à la date de création de votre collecte d’idées ou de votre espace de travail.
1.4) Répétez les étapes de 1.3 pour créer le paramètre de fin. Si vous souhaitez que la plage de fin soit pratiquement illimitée, définissez une date très éloignée dans le futur comme paramètre de fin.
1.5) Finally, click ‘OK’.
1.6) Tant que Power Query Editor est toujours ouvert :
1.6.1) Cliquez sur le bouton de filtre de la colonne CREATED AT (voir (1) dans l’image ci-dessus).
1.6.2) Si « Filtres de date/heure » n’apparaît pas comme option dans le menu déroulant, suivez les étapes 1.6.2.1 et suivantes. Si cette option apparaît, vous pouvez passer directement à 1.6.3 :
1.6.2.1) Cliquez avec le bouton droit sur la colonne CREATED AT.
1.6.2.2) Cliquez sur « Modifier le type » dans le menu déroulant qui apparaît.
1.6.2.3) Sélectionnez « Date/Heure » dans le menu déroulant adjacent
1.6.2.4) Cliquez à nouveau sur le bouton de l’icône de filtre dans la colonne CRÉÉ LE. Si tout est correct, l’option « Filtres de date et d’heure » devrait apparaître dans le menu déroulant.
1.6.2.5) Cliquez sur « Filtres de date et d’heure » dans le menu déroulant qui s’affiche
1.6.2.6) Cliquez sur « Filtre personnalisé… » dans le menu déroulant qui apparaît à côté.
1.7) Configurez le filtre pour le début de la plage :
1.7.1) Dans le premier menu déroulant, remplacez « Equals » par « Is after »
1.7.3) Cliquez sur la petite icône au milieu, juste à côté du champ où vous avez sélectionné « Is after » (voir (2) dans l’image ci-dessus).
1.7.4) Dans le menu déroulant qui apparaît, choisissez « Parameter ».
1.7.5) Dans le menu déroulant situé à côté, sélectionnez « RangeStart » (ou le nom que vous avez donné au paramètre) (voir (4) dans l’image ci-dessus).
1.8) En dessous, répétez les mêmes étapes pour définir la fin de la plage de dates :
1.8.1) Dans le premier menu déroulant, sélectionnez « Is before »
1.8.2) Dans le deuxième menu déroulant, sélectionnez « Parameter »
1.8.3) Dans le troisième menu déroulant, sélectionnez « RangeEnd » (ou le nom que vous avez donné au paramètre).
1.8.4) Enfin, cliquez sur « OK » pour continuer.
1.9) Cliquez ensuite sur « Close & Apply » dans la barre d’outils pour enregistrer et appliquer vos modifications.
1.10) Power Query Editor se fermera et vous ramènera à votre rapport. PowerBI actualisera une fois la source de données ; vous pourrez ensuite passer à l’étape 2.
2) Dans le volet latéral « Data » de PowerBI, repérez la source « ideas ».
2.1) Cliquez sur les trois points horizontaux situés à côté de la source « ideas ».
2.2) Dans le menu déroulant qui apparaît en dessous, cliquez sur « Incremental refresh ».
3) Dans la boîte de dialogue qui apparaît :
3.1) Sous « Select table », vérifiez que la source de données « ideas » est sélectionnée
3.2) Vérifiez que l’option « Incrementally refresh this table » est activée.
3.2.1) Remarque : si l’interrupteur « Actualiser cette table de manière incrémentielle » est désactivé (« grisé »), et/ou si un encadré d’avertissement apparaît en haut de l’écran pour indiquer que des paramètres doivent être configurés, revenez en arrière et répétez l’étape (1). Assurez-vous que les paramètres de début et de fin sont correctement associés à la colonne DATE DE CRÉATION dans Power Query Editor. Voici à quoi cela peut ressembler :
3.3) Sous « Archive data starting », indiquez la période historique que vous souhaitez inclure dans le modèle. Toutes les idées dont la date CREATED AT se situe dans cette période seront chargées dans le modèle, sauf si d’autres filtres s’appliquent. Pour en savoir plus, consultez ce lien.
3.4) Sous « Incrementally refresh data starting », indiquez la période d’actualisation. Toutes les idées dont la date CREATED AT se situe dans cette période seront actualisées dans le modèle à chaque actualisation manuelle ou planifiée effectuée par le service Power BI. Pour en savoir plus, consultez ce lien.
3.5) Finally, click ‘Apply’.
4) Nous vous recommandons d’effectuer une dernière actualisation manuelle en suivant l’étape 10 du guide « Configuration d’Ideanote comme source de données dans PowerBI » ci-dessus, afin de vérifier que tout est correct.
5) L’actualisation incrémentielle est maintenant configurée !