Artikler om: Integrationer

Integrer CxPlanner med Power BI via Custom Connector

CxPlanner-connectoren til Power BI henter projektdata som opgaver, tjeklister, assets og certifikater ind i Power BI Desktop gennem CxPlanners API. Den bruges, når du skal lave dine egne dashboards og analyser uden for CxPlanner.


  • Din rolle skal være virksomheds-Administrator, og du skal have en gyldig API-nøgle.
  • Du finder connectoren i Power BI Desktop under Get Data, Other, CxPlanner Connector.
  • Den læser projektdata ind i Power BI. Den ændrer ikke data i CxPlanner.


Kun brugere med virksomhedsrollen Administrator og en gyldig API-nøgle kan installere og konfigurere connectoren.


Hvad CxPlanner gør gennem Power BI-connectoren

  • Henter data gennem CxPlanners API.
  • Flader indlejret JSON ud, så det kan bruges i en rapport.
  • Henter store resultater automatisk i bidder (omkring 1000 poster pr. bid).
  • Understøtter modulfiltre og valgfrie forespørgselsparametre.
  • Følger den adgang, API-nøglen har i CxPlanner.


Sådan forbinder du Power BI med CxPlanner

Gør miljøet klar

  1. Installer den nyeste Power BI Desktop.
  2. Opret eller bed om din CxPlanner API-nøgle.


Installer connectoren

  1. Hent filen `Connector.pq`.
  2. Flyt den til `%USERPROFILE%\Documents\Power BI Desktop\Custom Connectors\`.
  3. Opret mappen, hvis den ikke findes.
  4. Åbn Power BI Desktop.
  5. Gå til File, Options and settings, Options, Security, Data Extensions.
  6. Vælg at tillade enhver udvidelse uden validering eller advarsel.
  7. Genstart Power BI Desktop.


Opret forbindelse til CxPlanner

  1. Åbn Get Data, More, Other, CxPlanner Connector.
  2. Udfyld Base URL med `https://app.cxplanner.com\`.
  3. Udfyld Project ID (for eksempel `12345`).
  4. Udfyld din API Key.
  5. Udfyld eventuelt Module (for eksempel `qa`, `assets`, `sitevisit`).
  6. Vælg de tabeller, der skal indlæses, i navigatoren.


Resultat: data fra Power BI-connectoren

Understøttede moduler og endepunkter

Kategori

Tilgængelige endepunkter

Projektstyring

Projects, Project Details, Tasks, Users

Kvalitetssikring

QA Checklists, Checklist Items, Files

Assets

Items, Types, Fields, Certificates

Skabeloner

Checklist Templates, Template Items

Filhåndtering

Files, Folders, Approval Statuses

Firmadata

Company Users, User Details


Understøttede værdier for modulparameteren

  • `systemtestview` (standard)
  • `qa`
  • `qc`
  • `assets`
  • `sitevisit`


Obligatoriske og valgfrie parametre

Parameter

Påkrævet

Beskrivelse

Base URL

Ja

https://app.cxplanner.com

Project ID

Ja

Projektets id

API Key

Ja

Nøgle til API-godkendelse

Module

Nej

Filtrer efter modul

Status

Nej

Statuskoder adskilt med komma

User Email

Nej

Begræns resultatet til én bruger

Checklist Name

Nej

Filtrer efter tjeklistens titel

Valgfrie avancerede id'er er Checklist Template UUID, Asset UUID / Item UUID, Certificate UUID, Task ID og Folder Key eller File Hash.




Foreslåede tabelrelationer

Tabel A

Tabel B

Sammenføjningsfelt

Projects

Tasks

Project ID

Tasks

Users

User UUID / Email

Assets

Certificates

Asset UUID

Checklists

Templates

Template UUID


Eksempler på rapportopsætninger

  • Projektdashboard: indlæs Project Tasks og Project Users.
  • QA-rapportering: sæt Module til `qa`, og indlæs derefter Checklists List og Checklist Items.
  • Asset-overholdelse: indlæs Assets Items, Types og Certificates, og sammenføj på Asset UUID.


Handling

Krævet rolle

Installere connectoren

Virksomheds-Administrator

Oprette API-nøgle

Virksomheds-Administrator

Se projektdata

Projekt-Administrator eller højere

Se asset-data

Projekt-Leder eller højere


Fejlfinding: Power BI-connectoren

Problem

Årsag

Løsning

Fejlen Invalid API Key

Forkert eller udløbet API-nøgle

Kontrollér nøglen i CxPlanner, opret en ny om nødvendigt, og forbind igen i Power BI

Data kommer tilbage tomme

Forkert Project ID, eller API-brugeren mangler projektadgang

Bekræft Project ID, og tilføj API-brugeren til projektet, hvis nøglen er begrænset til udvalgte projekter

Langsom indlæsning

Stort datasæt uden filtre

Tilføj Module eller andre filtre, eller brug trinvis opdatering

Tjeklistedata mangler

Forkert værdi i Module

Sæt Module til qa (eller det modul, dine tjeklister ligger i), og indlæs igen

Connectoren står ikke på listen

Connector.pq er ikke installeret, eller udvidelser er blokeret

Bekræft stien til Custom Connectors, tillad udvidelser under Security, og genstart Power BI Deskto


Når du melder en fejl, så tag Power BI-version, connector-version, fejlmeddelelsen, trinene der genskaber fejlen, og Project ID med, hvis det er muligt.

Opdateret den: 30/10/2026

Hjalp denne artikel dig?

Del din feedback

Annuller

Tak!