Zaman Takibi Disa Aktarma
Zaman takibi verileri, SetGet'ten cikip faturalandirma, muhasebe veya raporlama sistemlerinize girdiginde en degerlidir. SetGet, zaman kayitlarini CSV ve Excel dosyalari olarak disa aktarmayi destekler; tam olarak ihtiyaciniz olan veriyi disa aktarmanizi saglayan filtrelerle birlikte.
Disa aktarma kapsamlari
Disa aktarmalar iki duzeyden erisilebilir:
| Kapsam | Dahil edilen | Erisim yeri |
|---|---|---|
| Proje duzeyinde | Tek bir proje icin zaman kayitlari | Proje Ayarlari > Zaman Takibi > Disa Aktar |
| Calisma alani duzeyinde | Tum projeler genelinde zaman kayitlari | Analitik > Zaman Takibi > Disa Aktar |
Proje duzeyinde disa aktarma, musteri faturalamasi icin faydalidir. Calisma alani duzeyinde disa aktarma, bordro, sirket genelinde raporlama ve projeler arasi analiz icin faydalidir.
Kullanici arayuzunden disa aktarma
Adim adim
- Zaman takibi sayfasina gidin:
- Calisma alani duzeyinde: Kenar cubugunda Analitik > Zaman Takibi.
- Proje duzeyinde: Proje > Ayarlar > Zaman Takibi.
- Veriyi daraltmak icin filtreler uygulayin (asagidaki "Disa aktarmadan once filtreleme" bolumune bakin).
- Arac cubugundaki Disa Aktar dugmesine tiklayin.
- Formati secin:
- CSV -- virgule ayrilmis degerler, herhangi bir elektronik tablo veya veri araciyla uyumlu.
- Excel -- bicimlendirme ve sutun basliklariyla
.xlsxformati.
- Indir'e tiklayin.
- Dosya olusturulur ve tarayicinizin varsayilan indirme konumuna indirilir.
Dosya adlandirmasi
Disa aktarilan dosyalar su adlandirma kuralini izler:
| Kapsam | Format | Ornek dosya adi |
|---|---|---|
| Calisma alani | CSV | setget-time-logs-workspace-2026-03-01-to-2026-03-31.csv |
| Calisma alani | Excel | setget-time-logs-workspace-2026-03-01-to-2026-03-31.xlsx |
| Proje | CSV | setget-time-logs-project-alpha-2026-03-01-to-2026-03-31.csv |
| Proje | Excel | setget-time-logs-project-alpha-2026-03-01-to-2026-03-31.xlsx |
Disa aktarmada yer alan sutunlar
Hem CSV hem de Excel disa aktarmalari ayni sutunlari icerir:
| Sutun | Aciklama | Ornek deger |
|---|---|---|
issue_identifier | Proje oneki ve sorun numarasi | PRJ-142 |
issue_title | Sorun basligi | Giris zaman asimini duzelt |
project | Proje adi | Proje Alfa |
member | Zaman kaydeden kisinin tam adi | Alice Johnson |
member_email | Uyenin e-posta adresi | alice@example.com |
duration_minutes | Dakika cinsinden sure (tamsayi) | 150 |
duration_formatted | Xs Yd olarak sure | 2s 30d |
logged_date | Isin yapildigi tarih (YYYY-MM-DD) | 2026-03-15 |
description | Serbest metin aciklama | Kimlik dogrulama PR'i icin kod incelemesi |
billable | Girisin faturalanabilir olup olmadigi (true/false) | true |
billing_rate | Bu giris icin gecerli saatlik ucret | 200.00 |
billing_amount | Hesaplanan faturalandirma tutari | 500.00 |
currency | Para birimi kodu | USD |
created_at | Girisin olusturuldugu zaman damgasi (ISO 8601) | 2026-03-15T14:30:00Z |
updated_at | Son duzenlemenin zaman damgasi (ISO 8601) | 2026-03-15T15:00:00Z |
Excel'e ozel bicimlendirme
Excel disa aktarmasi sunlari icerir:
| Ozellik | Aciklama |
|---|---|
| Baslik satiri | Kalin, dondurulmus baslik satiri |
| Sutun genislikleri | Icerigi otomatik sigan |
| Sure sutunu | Hesaplama icin sayi (dakika) olarak bicimlendirilmis |
| Tarih sutunlari | Tarih hucreleri olarak bicimlendirilmis |
| Para birimi sutunlari | Para birimi simgesi ve iki ondalik ile bicimlendirilmis |
| Faturalanabilir sutun | Boolean olarak bicimlendirilmis |
Disa aktarmadan once filtreleme
Disa aktarma, zaman takibi sayfasindaki tum aktif filtrelere uyar. Hangi verinin dahil edilecegini kontrol etmek icin Disa Aktar'a tiklamadan once filtreler uygulayin:
| Filtre | Secenekler | Varsayilan |
|---|---|---|
| Tarih araligi | Baslangic ve bitis tarihi | Mevcut ay |
| Proje | Bir veya daha fazla proje | Tum projeler (calisma alani duzeyinde) |
| Uye | Bir veya daha fazla uye | Tum uyeler |
| Faturalanabilir | Tumu, yalnizca faturalanabilir, yalnizca faturalanabilir olmayan | Tumu |
| Sorun | Belirli sorun(lar) | Tum sorunlar |
TIP
Disa aktarmadan once filtrelerinizi her zaman dogrulayin. Disa aktar dugmesi, eslesen giris sayisini gosterir (ornegin "142 girisi disa aktar"), boylece indirmeden once kapsami onaylayabilirsiniz.
Yaygin filtre kombinasyonlari
| Kullanim senaryosu | Filtreler |
|---|---|
| Aylik musteri faturasi | Proje: Musteri X, Tarih: bu ay, Faturalanabilir: Evet |
| Bordro raporu | Tarih: odeme donemi, Uye: tumu |
| Tek sorun denetimi | Sorun: PRJ-142, Tarih: tumu |
| Faturalanabilir olmayan yuk analizi | Faturalanabilir: Hayir, Tarih: bu ceyrek |
| Bireysel katilimci zaman cizelgesi | Uye: Alice, Tarih: bu hafta |
Programatik disa aktarma icin API uc noktalari
Otomatik is akislari icin, zaman kaydi verilerini programatik olarak almak uzere API'yi kullanin:
Zaman kayitlarini listele
GET /api/workspaces/{slug}/time-logs/Sorgu parametreleri:
| Parametre | Tur | Aciklama |
|---|---|---|
project_id | string | Proje ID'sine gore filtrele |
member_id | string | Uye ID'sine gore filtrele |
from_date | string (YYYY-MM-DD) | Tarih araliginin baslangici |
to_date | string (YYYY-MM-DD) | Tarih araliginin sonu |
billable | boolean | Faturalanabilir durumuna gore filtrele |
page | integer | Sayfa numarasi (varsayilan: 1) |
per_page | integer | Sayfa basina sonuc (varsayilan: 50, maksimum: 200) |
sort_by | string | Siralama alani: logged_date, duration, created_at |
sort_order | string | asc veya desc |
API uzerinden CSV olarak disa aktar
GET /api/workspaces/{slug}/time-logs/export/?format=csvListeleme uc noktasiyla ayni sorgu parametrelerini kabul eder. Dosyayi dogrudan Content-Type: text/csv ile dondurur.
API uzerinden Excel olarak disa aktar
GET /api/workspaces/{slug}/time-logs/export/?format=xlsxDosyayi Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet ile dondurur.
Proje duzeyinde API disa aktarma
GET /api/workspaces/{slug}/projects/{project_id}/time-logs/export/?format=csvAyni parametreler, tek bir projeye kapsamli.
WARNING
API disa aktarmalari, diger API uc noktalariyla ayni hiz sinirlamarina tabidir. Buyuk disa aktarmalar (10.000+ giris) olusturulmasi birkac saniye surebilir. API, cok buyuk disa aktarmalar icin hazir oldugunda indirme URL'sine isaret eden bir Location basligi ile 202 durumu dondurur.
Zamanlanmis disa aktarma kullanim senaryolari
SetGet su anda yerlesik bir zamanlanmis disa aktarma ozelligine sahip olmasa da, API'yi kullanarak otomatik yinelenen disa aktarmalar gerceklestirebilirsiniz:
Otomatik haftalik zaman cizelgesi
Her pazartesi sabahi calisacak bir cron gorevi veya harici otomasyon araci kurun:
from_dateonceki pazartesiye veto_dateonceki pazara ayarlanmis olarak disa aktarma API'sini cagin.- CSV'yi paylasilan bir surucuye kaydedin veya takim liderine e-posta ile gonderin.
Otomatik aylik faturalandirma disa aktarmasi
Her ayin birinde calisan bir surec kurun:
from_dateonceki ayin birincisi veto_dateson gunu olarak disa aktarma API'sini cagin.billable=trueile filtreleyin.- CSV'yi muhasebe sistemine veya faturalandirma yazilimina gonderin.
Muhasebe yazilimiyla entegrasyon
Su gibi araclarla entegrasyonlar olusturmak icin API'yi kullanin:
| Arac | Entegrasyon yaklasimi |
|---|---|
| QuickBooks | QuickBooks zaman iceri aktarimi araciligiyla CSV icerik aktarimi |
| Xero | Disa aktarilan sutunlari Xero zaman cizelgesi alanlarina esleme |
| FreshBooks | Zaman girisleri icin CSV icerik aktarimi kullanma |
| Ozel ERP | JSON API'yi cagin ve veriyi semaniza uyacak sekilde donusturun |
Izinler
| Rol | Kendi zamanini disa aktarabilir | Proje zamanini disa aktarabilir | Calisma alani zamanini disa aktarabilir |
|---|---|---|---|
| Sahip | Evet | Evet | Evet |
| Yonetici | Evet | Evet | Evet |
| Uye | Evet | Evet (uye oldugu projeler) | Hayir |
| Misafir | Hayir | Hayir | Hayir |
En iyi uygulamalar
- Disa aktarmadan once filtreleyin. Tum calisma alanini disa aktarip sonra elektronik tabloda filtrelemek ise yarar, ancak once SetGet'te filtrelemekten daha yavas ve hataya aciktir.
- Faturalandirma dongunuzle eslesen tarih araliklari kullanin. Aylik faturalandiriyorsaniz, aylik disa aktarin. Haftalik ise haftalik. Tutarli araliklar uzlastirmayi kolaylastirir.
- Indirmeden once giris sayisini dogrulayin. Disa aktar dugmesi sayiyi gosterir. Beklenmedik sekilde dusuk veya yuksekse filtrelerinizi kontrol edin.
- Disa aktarmalari arsivleyin. Her disa aktarmanin bir kopyasini, ilgili fatura veya bordro raporuyla birlikte denetim amaciyla kaydedin.
- Yinelenen raporlar icin API'yi kullanin. Manuel indirmeler tek seferlik ihtiyaclar icin yeterlidir, ancak otomatik disa aktarmalar unutulan raporlari ve insan hatasini azaltir.
- Eksik aciklamalari kontrol edin. Musteri faturalamasi icin disa aktarmadan once, bos aciklamali girisleri filtreleyip doldurun. Musteriler ayrintili zaman cizelgelerini takdir eder.