> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cxplanner.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://help.cxplanner.com/en-us/article/set-up-api-access-sljl5q/).

### 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.