Eksport CSV dla BI
Pobranie surowych danych w formacie CSV, do dalszej analizy w zewnętrznych narzędziach BI.
| Pole | Co robi | Wartość domyślna |
|---|---|---|
| Wybierz projekty | które projekty wchodzą do eksportu | brak, wybór jest wymagany |
| Od / Do | okres, z którego pobierane są dane | ostatnie 30 dni |
Bez wskazania projektu eksport się nie uruchomi. Zakres dat można dowolnie zmienić, ale warto pamiętać, że szeroki zakres na dużej organizacji daje plik, który nie otworzy się wygodnie w arkuszu kalkulacyjnym i lepiej trafia wprost do narzędzia BI.
Zawartość pliku
Jeden wiersz odpowiada jednemu zdarzeniu, czyli pojedynczemu commitowi albo pojedynczej zmianie w Jirze czy Confluence. Plik nie zawiera żadnych agregatów: sumowanie i grupowanie należy do narzędzia BI.
Kolumny, w kolejności występowania:
| Kolumna | Zawartość |
|---|---|
id | identyfikator zdarzenia w Q247 |
project | identyfikator projektu Q247, nie jego nazwa |
user | adres e-mail osoby, do której zdarzenie jest przypisane, po rozwiązaniu aliasów, czyli adres konta głównego |
calories | wynik kaloryczny zdarzenia |
creationTime | znacznik czasu w milisekundach od 1 stycznia 1970, bez formatowania |
commitId | identyfikator commita; puste dla zdarzeń z Jiry i Confluence |
authorName | imię i nazwisko autora z Gita |
authorEmail | adres e-mail autora z Gita |
message | wiadomość commita |
changedFiles | liczba zmienionych plików |
inserts | liczba wstawionych linii |
deletions | liczba usuniętych linii |
Format pliku
| Właściwość | Wartość |
|---|---|
| Separator kolumn | przecinek |
| Kodowanie | UTF-8 ze znacznikiem BOM, dzięki czemu Excel poprawnie czyta polskie znaki |
| Separator dziesiętny | kropka |
| Koniec wiersza | znak nowej linii |
| Nazwa pliku | <projekt>_Bi-Export_<od>_<do>_Exported_<data i godzina>.csv, a przy kilku projektach w miejscu nazwy pojawia się Multiple-Projects |
Wiadomość commita jest przed zapisem czyszczona: znaki nowej linii, przecinki i cudzysłowy zamieniane są na spacje, żeby nie rozbijały wiersza.
Zakres danych w pliku
Eksport przechodzi przez część tych samych reguł co dashboardy, ale nie przez wszystkie.
Do pliku nie wchodzą: zdarzenia z pull requestów, konta o statusie Pomijany, commity w całości wykluczone wzorcami plików oraz commity z gałęzi wyłączonych z analizy. Aktywność kont o statusie Inny jest zsumowana pod jedną pozycją zbiorczą.
Do pliku wchodzą natomiast commity wykluczone ze statystyk: ręcznie, progiem widoczności albo automatyczną klasyfikacją cherry-pick, revert i rebase. Plik nie ma kolumny, która by je oznaczała.
Skoro wykluczone commity są w pliku, a na dashboardzie ich nie ma, suma Kalorii policzona w narzędziu BI będzie wyższa niż wartość pokazana w Q247 za ten sam okres. To nie jest błąd eksportu, tylko inny zakres danych.
Jeśli raport ma zgadzać się z dashboardem, wyliczenia rób na danych z dashboardów, a eksport traktuj jako źródło surowe do własnych analiz.
Limity
Jednorazowo można wyeksportować do 60 000 zdarzeń. Q247 sprawdza tę liczbę przed przygotowaniem pliku, więc przekroczenie limitu kończy się komunikatem z prośbą o zawężenie zakresu dat albo wybranie mniejszej liczby projektów, a nie ucięciem pliku w połowie.
Eksport działa w trybie natychmiastowego pobrania: plik powstaje w całości podczas żądania, więc przy szerokim zakresie warto poczekać, zamiast klikać przycisk ponownie.