Durch die Verbindung von Power BI mit Factorial können Sie alle Unternehmensdaten, die über die öffentliche API von Factorial bereitgestellt werden, abfragen und analysieren.

Wie man Power BI mit Factorial integriert

Die einzige offiziell unterstützte Methode zur Integration mit Power BI ist die Nutzung der Dokumentation unter https://apidoc.factorialhr.com/reference.

Erste Schritte

1. Öffnen Sie in der Seitenleiste die Einstellungen. Scrollen Sie nach unten zum Abschnitt Erweiterte Konfiguration und klicken Sie auf API-Schlüssel. Neuen API-Schlüssel erstellen.
2. Öffnen Sie Power BI Desktop und wechseln Sie in den Power Query-Editor.
   • Klicken Sie auf „Daten abrufen“ > „Weitere“ > „Leere Abfrage“. Fügen Sie die drei Power BI-Skripte (siehe unten) in eine leere Abfrage ein. Jedes Skript ist eine Funktion (eine neue Abfrage).

3. Sobald Sie die drei Funktionen GetPage, GetAllPages und ListDataToTable erstellt haben, führen Sie diese mit Ihrem API-Schlüssel und der BaseURL aus. Die BaseURL finden Sie auf der Referenzseite der Factorial-API (Willkommen bei der Entwicklung mit Factorial). Für jede Ressource (z. B. Employees, ContractVersions, Shifts usw.) führen Sie die Funktion ListDataToTable mit dem API-Schlüssel und der entsprechenden API-URL aus (z. B. https://api.factorialhr.com/api/2024-10-01/resources/attendance/shifts). Als Ergebnis erhalten Sie eine Tabelle pro Ressource, die Sie im Power BI-Bericht verwenden können. Wenn Sie alle benötigten Ressourcen hinzugefügt haben, können Sie die Abfragen mit dem „Speichern“-Button sichern (um sie später z. B. zu erweitern) und abschließend auf „Schließen & Übernehmen“ klicken, um den Editor zu verlassen. Ihre Daten stehen nun zur weiteren Verarbeitung in Power BI bereit.

4. Das war's! Nun können Sie die Daten in der Datenansicht oder in der Berichtsansicht anzeigen. In beiden Fällen nutzen Sie das Menü auf der rechten Seite, um die Spalten aus den Funktionen hinzuzufügen, die Sie im Schritt 3 aufgerufen haben.

Power BI-Skripte

1. Eine Seite von Daten aus der öffentlichen API abrufen – GetPage

= (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 – GetAllPages

= 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. Listendaten in eine Tabelle umwandeln – ListDataToTable

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