Steg 2: Anslut Clockify och definiera globala inställningar

Hämta arbetsytan och definiera globala variabler som används i hela arbetsflödet.

1. Konfigurera Fetch Primary Workspace med Resource inställt på workspace och Limit inställt på 1.
2. Autentiseringsuppgifter krävs: Anslut era clockifyApi-autentiseringsuppgifter i Fetch Primary Workspace.
3. I Define Globals ställer ni in workspace_id till {{ $json.id }}.
4. I Define Globals ställer ni in github_repo.owner och github_repo.name till era GitHub-värden för ägare och repository.
5. Anslut Fetch Primary Workspace → Define Globals → Assign Month Indices.

Steg 3: Bygg månadsloopen och datumintervall

Skapa en rullande lista med månader och beräkna intervall för rapporter.

1. I Assign Month Indices ställer ni in monthIndex till [0, 1, 2] för att bearbeta aktuell månad och de två föregående.
2. I Expand Month List ställer ni in Field to Split Out till monthIndex.
3. I Compute Date Range ställer ni in reportName till =detailed_report_{{ $now.minus($json.monthIndex, 'month').format('yyyy-MM') }}.
4. Ställ in startDate till {{ $now.minus($json.monthIndex, 'month').startOf('month').format('yyyy-MM-dd') }}.
5. Ställ in endDate till {{ $now.minus($json.monthIndex, 'month').endOf('month').format('yyyy-MM-dd') }}.

Steg 4: Begär Clockify-rapporter och lokalisera GitHub-filer

Hämta månadsdata för rapporten och slå upp befintliga filer i GitHub.

1. I Request Monthly Detail ställer ni in URL till https://reports.api.clockify.me/v1/workspaces/{{ $('Define Globals').item.json.workspace_id }}/reports/detailed.
2. Ställ in Method till POST och JSON Body till { "dateRangeStart": "{{ $json.startDate }}T00:00:00Z", "dateRangeEnd": "{{ $json.endDate }}T23:59:59.999Z", "detailedFilter": { "page": 1, "pageSize": 50 }, "exportType": "json" }.
3. Autentiseringsuppgifter krävs: Anslut era clockifyApi-autentiseringsuppgifter i Request Monthly Detail.
4. I Locate GitHub File ställer ni in File Path till reports/{{ $('Compute Date Range').item.json.reportName }}.
5. Autentiseringsuppgifter krävs: Anslut era githubApi-autentiseringsuppgifter i Locate GitHub File.
6. Notera det parallella flödet: Locate GitHub File skickar utdata till både Map New Report Data och Parse File Data parallellt.

Steg 5: Jämför data och uppdatera befintliga rapporter

Tolka befintliga filer, jämför med ny data och uppdatera rapporter vid behov.

1. I Map New Report Data ställer ni in data till {{ $('Request Monthly Detail').item.json.timeentries }}.
2. I Parse File Data ställer ni in Operation till fromJson för att tolka filinnehållet.
3. I Compare Records ställer ni in Merge By Fields för att jämföra data mot data.
4. I Modify GitHub File ställer ni in File Path till reports/{{ $('Compute Date Range').item.json.reportName }}.
5. Ställ in File Content till {{ JSON.stringify($json.data, null, 2) }} och Commit Message till Update report.
6. Autentiseringsuppgifter krävs: Anslut era githubApi-autentiseringsuppgifter i Modify GitHub File.

Steg 6: Skapa nya rapporter när filer saknas

Hantera saknade filer och skapa endast rapporter när det finns data.

1. I Detect Missing File bekräftar ni att villkoret kontrollerar att {{ $json.error }} innehåller could not be found.
2. I Filter Empty Reports säkerställer ni att villkoret kontrollerar att {{ $json.timeentries }} är notEmpty.
3. I Create GitHub File ställer ni in File Path till reports/{{ $('Compute Date Range').item.json.reportName }}.
4. Ställ in File Content till {{ JSON.stringify($json.timeentries, null, 2) }} och Commit Message till Create report.
5. Autentiseringsuppgifter krävs: Anslut era githubApi-autentiseringsuppgifter i Create GitHub File.

Steg 7: Lägg till felhantering

Stoppa arbetsflödet när fel inte är relaterade till saknade filer.

1. Verifiera att Locate GitHub File har beteendet Continue On Fail (den skickar utdata till felgrenen när filen saknas).
2. Anslut falsk-vägen från Detect Missing File till Halt on Error.
3. I Halt on Error ställer ni in Error Message till {{ $json.error }}.

Steg 8: Testa och aktivera ert arbetsflöde

Validera körningen och slå på schemat.

1. Klicka på Execute Workflow för att köra Scheduled Run Trigger manuellt.
2. Bekräfta att Request Monthly Detail returnerar timeentries och att Locate GitHub File hittar filer eller routar saknade filer korrekt.
3. Verifiera GitHub-uppdateringar: Modify GitHub File ska committa uppdaterad JSON, eller så ska Create GitHub File skapa en ny fil under reports/.
4. Ställ arbetsflödet till Active för att aktivera den dagliga körningen kl. 5:00.