Skip to content

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:

KapsamDahil edilenErisim yeri
Proje duzeyindeTek bir proje icin zaman kayitlariProje Ayarlari > Zaman Takibi > Disa Aktar
Calisma alani duzeyindeTum projeler genelinde zaman kayitlariAnalitik > 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

  1. Zaman takibi sayfasina gidin:
    • Calisma alani duzeyinde: Kenar cubugunda Analitik > Zaman Takibi.
    • Proje duzeyinde: Proje > Ayarlar > Zaman Takibi.
  2. Veriyi daraltmak icin filtreler uygulayin (asagidaki "Disa aktarmadan once filtreleme" bolumune bakin).
  3. Arac cubugundaki Disa Aktar dugmesine tiklayin.
  4. Formati secin:
    • CSV -- virgule ayrilmis degerler, herhangi bir elektronik tablo veya veri araciyla uyumlu.
    • Excel -- bicimlendirme ve sutun basliklariyla .xlsx formati.
  5. Indir'e tiklayin.
  6. Dosya olusturulur ve tarayicinizin varsayilan indirme konumuna indirilir.

Dosya adlandirmasi

Disa aktarilan dosyalar su adlandirma kuralini izler:

KapsamFormatOrnek dosya adi
Calisma alaniCSVsetget-time-logs-workspace-2026-03-01-to-2026-03-31.csv
Calisma alaniExcelsetget-time-logs-workspace-2026-03-01-to-2026-03-31.xlsx
ProjeCSVsetget-time-logs-project-alpha-2026-03-01-to-2026-03-31.csv
ProjeExcelsetget-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:

SutunAciklamaOrnek deger
issue_identifierProje oneki ve sorun numarasiPRJ-142
issue_titleSorun basligiGiris zaman asimini duzelt
projectProje adiProje Alfa
memberZaman kaydeden kisinin tam adiAlice Johnson
member_emailUyenin e-posta adresialice@example.com
duration_minutesDakika cinsinden sure (tamsayi)150
duration_formattedXs Yd olarak sure2s 30d
logged_dateIsin yapildigi tarih (YYYY-MM-DD)2026-03-15
descriptionSerbest metin aciklamaKimlik dogrulama PR'i icin kod incelemesi
billableGirisin faturalanabilir olup olmadigi (true/false)true
billing_rateBu giris icin gecerli saatlik ucret200.00
billing_amountHesaplanan faturalandirma tutari500.00
currencyPara birimi koduUSD
created_atGirisin olusturuldugu zaman damgasi (ISO 8601)2026-03-15T14:30:00Z
updated_atSon duzenlemenin zaman damgasi (ISO 8601)2026-03-15T15:00:00Z

Excel'e ozel bicimlendirme

Excel disa aktarmasi sunlari icerir:

OzellikAciklama
Baslik satiriKalin, dondurulmus baslik satiri
Sutun genislikleriIcerigi otomatik sigan
Sure sutunuHesaplama icin sayi (dakika) olarak bicimlendirilmis
Tarih sutunlariTarih hucreleri olarak bicimlendirilmis
Para birimi sutunlariPara birimi simgesi ve iki ondalik ile bicimlendirilmis
Faturalanabilir sutunBoolean 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:

FiltreSeceneklerVarsayilan
Tarih araligiBaslangic ve bitis tarihiMevcut ay
ProjeBir veya daha fazla projeTum projeler (calisma alani duzeyinde)
UyeBir veya daha fazla uyeTum uyeler
FaturalanabilirTumu, yalnizca faturalanabilir, yalnizca faturalanabilir olmayanTumu
SorunBelirli 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 senaryosuFiltreler
Aylik musteri faturasiProje: Musteri X, Tarih: bu ay, Faturalanabilir: Evet
Bordro raporuTarih: odeme donemi, Uye: tumu
Tek sorun denetimiSorun: PRJ-142, Tarih: tumu
Faturalanabilir olmayan yuk analiziFaturalanabilir: Hayir, Tarih: bu ceyrek
Bireysel katilimci zaman cizelgesiUye: 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:

ParametreTurAciklama
project_idstringProje ID'sine gore filtrele
member_idstringUye ID'sine gore filtrele
from_datestring (YYYY-MM-DD)Tarih araliginin baslangici
to_datestring (YYYY-MM-DD)Tarih araliginin sonu
billablebooleanFaturalanabilir durumuna gore filtrele
pageintegerSayfa numarasi (varsayilan: 1)
per_pageintegerSayfa basina sonuc (varsayilan: 50, maksimum: 200)
sort_bystringSiralama alani: logged_date, duration, created_at
sort_orderstringasc veya desc

API uzerinden CSV olarak disa aktar

GET /api/workspaces/{slug}/time-logs/export/?format=csv

Listeleme 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=xlsx

Dosyayi 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=csv

Ayni 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:

  1. from_date onceki pazartesiye ve to_date onceki pazara ayarlanmis olarak disa aktarma API'sini cagin.
  2. 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:

  1. from_date onceki ayin birincisi ve to_date son gunu olarak disa aktarma API'sini cagin.
  2. billable=true ile filtreleyin.
  3. CSV'yi muhasebe sistemine veya faturalandirma yazilimina gonderin.

Muhasebe yazilimiyla entegrasyon

Su gibi araclarla entegrasyonlar olusturmak icin API'yi kullanin:

AracEntegrasyon yaklasimi
QuickBooksQuickBooks zaman iceri aktarimi araciligiyla CSV icerik aktarimi
XeroDisa aktarilan sutunlari Xero zaman cizelgesi alanlarina esleme
FreshBooksZaman girisleri icin CSV icerik aktarimi kullanma
Ozel ERPJSON API'yi cagin ve veriyi semaniza uyacak sekilde donusturun

Izinler

RolKendi zamanini disa aktarabilirProje zamanini disa aktarabilirCalisma alani zamanini disa aktarabilir
SahipEvetEvetEvet
YoneticiEvetEvetEvet
UyeEvetEvet (uye oldugu projeler)Hayir
MisafirHayirHayirHayir

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.

Ilgili sayfalar