Durch die Verbindung von Power BI mit Factorial können Sie Ihre Unternehmensinformationen abfragen und analysieren. Diese erste Version ermöglicht die Navigation durch alle Mitarbeiter und ihre grundlegenden Informationen.

So integrieren Sie Power BI mit Factorial

Die Verwendung von https://apidoc.factorialhr.com/reference ist derzeit die bevorzugte Art der Integration mit Power BI.

Erste Schritte

1. Gehen Sie in Ihrer Seitenleiste auf Einstellungen, scrollen Sie nach unten zu Erweiterte Konfiguration und klicken Sie auf API-Schlüssel. Erstellen Sie einen neuen API-Schlüssel
   2. Gehen Sie zu PowerBI Desktop und öffnen Sie den Power Query Editor.
   • Klicken Sie auf „Daten abrufen“ > „Mehr“ > „Leere Abfrage“.
     Kopieren Sie die 3 Power BI-Skripte (siehe unten) und fügen Sie sie im Abfrage-Editor in eine „leere Abfrage“ ein. Jedes Skript ist eine Funktion (eine neue Abfrage).

3. Sobald Sie die drei Funktionen haben: GetPage, GetAllPages und ListDataToTable, rufen Sie sie mit Ihrem apikey und der baseURL auf. Die baseURL haben Sie von der Referenz-Website der öffentlichen API von Factorial abgerufen (Willkommen bei der Entwicklung mit Factorial!). Für jede Ressource (z. B. Mitarbeiter, Vertragsversionen, Schichten usw.) rufen Sie einmal die Funktion ListDataToTable auf, wobei Sie den Apikey und die URL des API-Endpunkts (wie https://api.factorialhr.com/api/2024-10-01/resources/attendance/shifts) übergeben. Sie erhalten eine Tabelle pro Ressource, die Sie später zur Erstellung Ihres Berichts in PowerBI verwenden können. Sobald Sie die gewünschten Ressourcen haben, können Sie diese Abfragen mit der Schaltfläche „Speichern“ speichern, falls Sie sie später ändern möchten (z. B. um eine neue Ressource hinzuzufügen), und schließlich „Schließen & Anwenden“, um den Power Query Editor zu verlassen. Mit diesem Schritt sind Ihre Daten bereit, in PowerBI verwendet zu werden.

4. Nun können Sie die Daten in der Datenansicht oder in der Berichtsansicht visualisieren. In beiden Fällen verwenden Sie das Menü auf der rechten Seite, um Spalten aus den in Schritt 3 aufgerufenen Funktionen hinzuzufügen.

PowerBI-Skripte

1. Abrufen einer Seite mit Daten aus der öffentlichen API von einer Ressource

= (baseURL as text, apiKey as text, page as number) =>
let 
    Url = baseURL & "?page=" & Text.From(page),
    Response = Json.Document(Web.Contents(Url,  [Headers=[#"x-api-key"= apiKey ]])),
    Data = Response[data],
    HasNextPage = Response[meta][has_next_page]
in
    [Data = Data, HasNextPage = HasNextPage]

2. Alle Seiten rekursiv abrufen

= let
    Source = (baseURL as text, apiKey as text) =>
let 
  GetAllPages  = (baseURL as text, apiKey as text, page as number, AccumulatedData as list) =>
        let
            CurrentPage = GetPage(baseURL, apiKey, page),
            NewData = List.Combine({AccumulatedData, CurrentPage[Data]}),
            NextStep = if CurrentPage[HasNextPage] then @GetAllPages(baseURL, apiKey, page + 1, NewData) else NewData
        in
            NextStep,
     AllData = GetAllPages(baseURL, apiKey, 1, {})
 in AllData
in
    Source

3. Umwandlung der Listendaten in eine Tabelle

= let
    Source = (baseURL as text, apiKey as text) =>
let
  TableData = Table.FromList(GetAllPages(baseURL, apiKey), Splitter.SplitByNothing(), null, null)
in TableData
in
    Source