Mit Power BI können Sie wertvolle Erkenntnisse aus Ihren Daten gewinnen. Stellen Sie sicher, dass Power BI auf einem Windows-Computer installiert ist.
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
- Ö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.
- Ö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
- 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