Ga naar hoofdinhoud
Versie: Versie 22

Connectors

Introductie​

Wat is de BI connectivity app?
De BI connectivity app brengt data uit Fortes Change Cloud naar een BI-oplossing, zoals Microsoft Power BI of een datawarehouse. De app maakt het mogelijk om koppelingen te maken op basis van OData: per connector levert FCC een OData-link en authenticatiesleutels waarmee externe tools de data veilig kunnen ophalen.

Wie gebruikt het?

  • Beheerders en BI-specialisten, die connectors aanmaken en sleutels beheren.
  • Rapportbouwers, die de OData-link gebruiken in Power BI of andere tools.

Welke waarde levert het op?

  • FCC-data (portfolio's, projecten, uren, kosten) beschikbaar in je eigen BI-tooling.
  • Gecontroleerde toegang: per connector members en verlopende authenticatiesleutels.
  • Een standaardprotocol (OData) dat door veel tools wordt ondersteund.

Het Connectors-overzicht​

De startpagina van de app toont alle connectors als kaarten. Van hieruit kun je:

  • Add Connector: een nieuwe connector aanmaken.
  • Archived Connectors: gearchiveerde connectors raadplegen.
  • Members: beheren wie toegang heeft tot de app.
  • Een connector openen om de OData-link en sleutels te beheren; zie het artikel Connector.

Deze interactieve guide legt uit hoe je een BI connector toevoegt om een OData-link en authenticatiesleutel aan te maken. De OData-link en authenticatiesleutel kunnen worden gebruikt om FCC te koppelen aan andere systemen.

Veel rapportagetools kunnen data ophalen via het OData-protocol.
Deze guide laat zien hoe je Fortes Change Cloud (FCC) koppelt aan Microsoft Power BI Desktop.
Dezelfde OData-link kan ook worden gebruikt voor andere systemen, zoals datawarehousing-tools.

Stappen​

  1. Klik in Power BI Desktop op Retrieve Data → OData Feed.

  2. Plak de OData-link in het veld URL (zie de vorige sectie voor de OData-link).

  3. In het authenticatiedialoogvenster:

    • Selecteer Basic.
    • Laat het veld Username leeg.
    • Plak de API Key in het veld Password.
    • Klik op Connect.

  4. Power BI toont een lijst met beschikbare tabellen.

    • Bekijk een voorbeeld van de data door een tabel te selecteren.
    • Vink de tabellen aan die je wilt importeren.

  5. Klik op Load om de geselecteerde tabellen te importeren.

    • Zowel de data als de relaties tussen tabellen worden automatisch geïmporteerd in je rapport.

Best practices​

  • Haal alleen de benodigde kolommen op: gebruik $select om de juiste kolommen te selecteren.
  • Haal alleen de benodigde rijen op: gebruik $filter om rijen te selecteren. Een filter op SystemModificationDate kan worden gebruikt om alleen objecten op te halen die sinds een bepaalde datum zijn gewijzigd.
  • Behandel API-sleutels als geheimen: bewaar ze in een credential store, niet in gedeelde documenten, en vervang ze voordat ze verlopen.

Zie Connector voor de volledige queryopties (filtering, paginering, entry endpoints).

Veelgestelde vragen​

Waarom zie ik zoveel foutwaarden in mijn data?
Om de omvang van de data zo klein mogelijk te houden, stuurt de OData-service lege/null-waarden niet mee in de OData-feed naar Power BI Desktop. Wanneer deze waarden niet worden meegestuurd, verschijnen ze in Power BI als 'Error'.

Het verschijnen van deze 'Error' is geen probleem, omdat Power BI aan velden die 'Error' bevatten de waarde null toekent. Indien gewenst kunnen deze 'Error'-velden echter handmatig worden aangepast via de knoppen 'Transform Data' en vervolgens 'Replace Errors', om deze foutvelden te vervangen door een lege tekenreeks of door de waarde null.

Je kunt nu beginnen met het maken van rapporten in Power BI Desktop met de data uit je portfolio. Wanneer er wijzigingen worden aangebracht in het portfolio, kun je de data in het rapport vernieuwen door op de knop Refresh te klikken in het lint op het tabblad Home.

Kan ik meerdere connectors hebben?
Ja. Gebruik aparte connectors per doel of afnemer, zodat toegang en sleutels onafhankelijk van elkaar beheerd (en ingetrokken) kunnen worden.

Meer hulp nodig?​

Neem voor stapsgewijze instructies of hulp bij problemen contact op met je Fortes Change Cloud-beheerder of raadpleeg de in-app help.