Intégration PowerBI

Créez des rapports PowerBI avec les données en direct d’un workspace Kantree.

La façon simple : le flux CSV

Pour les petits workspaces, utilisez le flux CSV :

1. Dans le workspace, cliquez sur Intégrations, puis sur Exporter vers des tableurs et des outils de BI.
2. Copiez l’adresse dans Intégration avec les outils BI.
3. Dans PowerBI, ajoutez une source de données Web avec cette adresse.

Pour les gros workspaces (plus de 1 000 cartes), le flux peut échouer. Utilisez plutôt l’API, comme décrit ci-dessous.

Utiliser l’API de Kantree comme source de données

Créez un rapport PowerBI, puis ajoutez une source de données avec une requête vide.

Dans le code ci-dessous, remplacez :

• DOMAIN par l’adresse de votre Kantree (par exemple kantree.io ou societe.kantree.io),
• PROJECT_ID par l’identifiant du workspace, entre guillemets droits : la partie de l’adresse du workspace après /p/. Par exemple, pour https://kantree.io/p/f654c5e7-mobile-app-development, utilisez "f654c5e7-mobile-app-development".

Créez d’abord une fonction. Copiez ce code dans la requête vide :

(Path as text, Page as text) =>
let
    Source = Json.Document(Web.Contents("https://DOMAIN", [ RelativePath = Path, Query = [ page = Page ]])),
    #"Converted to Table" = Table.FromRecords(Source[data])
in
    #"Converted to Table"

Renommez cette requête « getPage ».

Ajoutez une autre requête vide, cliquez sur Éditeur avancé, puis copiez ce code :

let
    Path = "/api/1.0/projects/" & PROJECT_ID & "/export/json",
    Source = Json.Document(Web.Contents("https://DOMAIN", [ RelativePath = Path ])),
    Pages = {1..Source[total_pages]},
    #"Converted to table" = Table.FromList(Pages, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
    #"Changed Type" = Table.TransformColumnTypes(#"Converted to table",{"Column1", type text}),
    #"Invoke Custom Function" = Table.AddColumn(#"Changed Type", "Data", each getPage(Path, [Column1])),
    #"Column Names" = Table.ColumnNames(Table.First(#"Invoke Custom Function")[Data]),
    #"Expanded Data" = Table.ExpandTableColumn(#"Invoke Custom Function", "Data", #"Column Names")
in
    #"Expanded Data"

Cliquez sur Fermer et appliquer, puis construisez votre rapport.

L’authentification

PowerBI se connecte avec une clé d’API Kantree :

1. Dans Kantree, ouvrez Paramètres du compte, puis Développeur.
2. Cliquez sur Créer une clé API. Donnez à la clé un accès en lecture aux workspaces que le rapport utilise, et copiez la clé.
3. Quand PowerBI demande des informations d’identification pour le domaine, choisissez De base. Saisissez la clé d’API comme nom d’utilisateur, et laissez le mot de passe vide.

Si PowerBI ne demande pas d’informations d’identification, ouvrez Options et paramètres, puis Paramètres de la source de données, puis Autorisations globales. Choisissez la source de données Kantree, cliquez sur Modifier les autorisations, puis sur Modifier dans Informations d’identification.