Zaman Takibi Dışa Aktarma

Zaman takibi verileri, SetGet'ten çıkıp faturalandırma, muhasebe veya raporlama sistemlerinize girdiğinde en değerlidir. SetGet, zaman kayıtlarını CSV ve Excel dosyaları olarak dışa aktarmayı destekler; tam olarak ihtiyacınız olan veriyi dışa aktarmanızı sağlayan filtrelerle birlikte.

Dışa aktarma kapsamları

Dışa aktarmalar iki düzeyden erişilebilir:

Kapsam	Dahil edilen	Erişim yeri
Proje düzeyinde	Tek bir proje için zaman kayıtları	Proje Ayarları > Zaman Takibi > Dışa Aktar
Çalışma alanı düzeyinde	Tüm projeler genelinde zaman kayıtları	Analitik > Zaman Takibi > Dışa Aktar

Proje düzeyinde dışa aktarma, müşteri faturalaması için faydalıdır. Çalışma alanı düzeyinde dışa aktarma, bordro, şirket genelinde raporlama ve projeler arası analiz için faydalıdır.

Kullanıcı arayüzünden dışa aktarma

Adım adım

1. Zaman takibi sayfasına gidin:
   • Çalışma alanı düzeyinde: Kenar çubuğunda Analitik > Zaman Takibi.
   • Proje düzeyinde: Proje > Ayarlar > Zaman Takibi.
2. Veriyi daraltmak için filtreler uygulayın (aşağıdaki "Dışa aktarmadan önce filtreleme" bölümüne bakın).
3. Araç çubuğundaki Dışa Aktar düğmesine tıklayın.
4. Formatı seçin:
   • CSV -- virgüle ayrılmış değerler, herhangi bir elektronik tablo veya veri aracıyla uyumlu.
   • Excel -- biçimlendirme ve sütun başlıklarıyla .xlsx formatı.
5. İndir'e tıklayın.
6. Dosya oluşturulur ve tarayıcınızın varsayılan indirme konumuna indirilir.

Dosya adlandırması

Dışa aktarılan dosyalar şu adlandırma kuralını izler:

Kapsam	Format	Örnek dosya adı
Çalışma alanı	CSV	setget-time-logs-workspace-2026-03-01-to-2026-03-31.csv
Çalışma alanı	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

Dışa aktarmada yer alan sütunlar

Hem CSV hem de Excel dışa aktarmaları aynı sütunları içerir:

Sütun	Açıklama	Örnek değer
issue_identifier	Proje öneki ve sorun numarası	PRJ-142
issue_title	Sorun başlığı	Giriş zaman aşımını düzelt
project	Proje adı	Proje Alfa
member	Zaman kaydeden kişinin tam adı	Alice Johnson
member_email	Üyenin e-posta adresi	alice@example.com
duration_minutes	Dakika cinsinden süre (tamsayı)	150
duration_formatted	Xs Yd olarak süre	2s 30d
logged_date	İşin yapıldığı tarih (YYYY-MM-DD)	2026-03-15
description	Serbest metin açıklama	Kimlik doğrulama PR'ı için kod incelemesi
billable	Girişin faturalanabilir olup olmadığı (true/false)	true
billing_rate	Bu giriş için geçerli saatlik ücret	200.00
billing_amount	Hesaplanan faturalandırma tutarı	500.00
currency	Para birimi kodu	USD
created_at	Girişin oluşturulduğu zaman damgası (ISO 8601)	2026-03-15T14:30:00Z
updated_at	Son düzenlemenin zaman damgası (ISO 8601)	2026-03-15T15:00:00Z

Excel'e özel biçimlendirme

Excel dışa aktarması şunları içerir:

Özellik	Açıklama
Başlık satırı	Kalın, dondurulmuş başlık satırı
Sütun genişlikleri	İçeriği otomatik sığan
Süre sütunu	Hesaplama için sayı (dakika) olarak biçimlendirilmiş
Tarih sütunları	Tarih hücreleri olarak biçimlendirilmiş
Para birimi sütunları	Para birimi simgesi ve iki ondalık ile biçimlendirilmiş
Faturalanabilir sütun	Boolean olarak biçimlendirilmiş

Dışa aktarmadan önce filtreleme

Dışa aktarma, zaman takibi sayfasındaki tüm aktif filtrelere uyar. Hangi verinin dahil edileceğini kontrol etmek için Dışa Aktar'a tıklamadan önce filtreler uygulayın:

Filtre	Seçenekler	Varsayılan
Tarih aralığı	Başlangıç ve bitiş tarihi	Mevcut ay
Proje	Bir veya daha fazla proje	Tüm projeler (çalışma alanı düzeyinde)
Üye	Bir veya daha fazla üye	Tüm üyeler
Faturalanabilir	Tümü, yalnızca faturalanabilir, yalnızca faturalanabilir olmayan	Tümü
Sorun	Belirli sorun(lar)	Tüm sorunlar

İPUCU

Dışa aktarmadan önce filtrelerinizi her zaman doğrulayın. Dışa aktar düğmesi, eşleşen giriş sayısını gösterir (örneğin "142 girişi dışa aktar"), böylece indirmeden önce kapsamı onaylayabilirsiniz.

Yaygın filtre kombinasyonları

Kullanım senaryosu	Filtreler
Aylık müşteri faturası	Proje: Müşteri X, Tarih: bu ay, Faturalanabilir: Evet
Bordro raporu	Tarih: ödeme dönemi, Üye: tümü
Tek sorun denetimi	Sorun: PRJ-142, Tarih: tümü
Faturalanabilir olmayan yük analizi	Faturalanabilir: Hayır, Tarih: bu çeyrek
Bireysel katılımcı zaman çizelgesi	Üye: Alice, Tarih: bu hafta

Programatik dışa aktarma için API uç noktaları

Otomatik iş akışları için, zaman kaydı verilerini programatik olarak almak üzere API'yi kullanın:

Zaman kayıtlarını listele

GET /api/workspaces/{slug}/time-logs/

Sorgu parametreleri:

Parametre	Tür	Açıklama
project_id	string	Proje ID'sine göre filtrele
member_id	string	Üye ID'sine göre filtrele
from_date	string (YYYY-MM-DD)	Tarih aralığının başlangıcı
to_date	string (YYYY-MM-DD)	Tarih aralığının sonu
billable	boolean	Faturalanabilir durumuna göre filtrele
page	integer	Sayfa numarası (varsayılan: 1)
per_page	integer	Sayfa başına sonuç (varsayılan: 50, maksimum: 200)
sort_by	string	Sıralama alanı: logged_date, duration, created_at
sort_order	string	asc veya desc

API üzerinden CSV olarak dışa aktar

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

Listeleme uç noktasıyla aynı sorgu parametrelerini kabul eder. Dosyayı doğrudan Content-Type: text/csv ile döndürür.

API üzerinden Excel olarak dışa aktar

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

Dosyayı Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet ile döndürür.

Proje düzeyinde API dışa aktarma

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

Aynı parametreler, tek bir projeye kapsamlı.

UYARI

API dışa aktarmaları, diğer API uç noktalarıyla aynı hız sınırlamalarına tabidir. Büyük dışa aktarmalar (10.000+ giriş) oluşturulması birkaç saniye sürebilir. API, çok büyük dışa aktarmalar için hazır olduğunda indirme URL'sine işaret eden bir Location başlığı ile 202 durumu döndürür.

Zamanlanmış dışa aktarma kullanım senaryoları

SetGet şu anda yerleşik bir zamanlanmış dışa aktarma özelliğine sahip olmasa da, API'yi kullanarak otomatik yinelenen dışa aktarmalar gerçekleştirebilirsiniz:

Otomatik haftalık zaman çizelgesi

Her pazartesi sabahı çalışacak bir cron görevi veya harici otomasyon aracı kurun:

1. from_date önceki pazartesiye ve to_date önceki pazara ayarlanmış olarak dışa aktarma API'sini çağırın.
2. CSV'yi paylaşılan bir sürücüye kaydedin veya takım liderine e-posta ile gönderin.

Otomatik aylık faturalandırma dışa aktarması

Her ayın birinde çalışan bir süreç kurun:

1. from_date önceki ayın birincisi ve to_date son günü olarak dışa aktarma API'sini çağırın.
2. billable=true ile filtreleyin.
3. CSV'yi muhasebe sistemine veya faturalandırma yazılımına gönderin.

Muhasebe yazılımıyla entegrasyon

Şu gibi araçlarla entegrasyonlar oluşturmak için API'yi kullanın:

Araç	Entegrasyon yaklaşımı
QuickBooks	QuickBooks zaman içeri aktarımı aracılığıyla CSV içerik aktarımı
Xero	Dışa aktarılan sütunları Xero zaman çizelgesi alanlarına eşleme
FreshBooks	Zaman girişleri için CSV içerik aktarımı kullanma
Özel ERP	JSON API'yi çağırın ve veriyi şemanıza uyacak şekilde dönüştürün

İzinler

Rol	Kendi zamanını dışa aktarabilir	Proje zamanını dışa aktarabilir	Çalışma alanı zamanını dışa aktarabilir
Sahip	Evet	Evet	Evet
Yönetici	Evet	Evet	Evet
Üye	Evet	Evet (üye olduğu projeler)	Hayır
Misafir	Hayır	Hayır	Hayır

En iyi uygulamalar

• Dışa aktarmadan önce filtreleyin. Tüm çalışma alanını dışa aktarıp sonra elektronik tabloda filtrelemek işe yarar, ancak önce SetGet'te filtrelemekten daha yavaş ve hataya açıktır.
• Faturalandırma döngünüzle eşleşen tarih aralıkları kullanın. Aylık faturalandırıyorsanız, aylık dışa aktarın. Haftalık ise haftalık. Tutarlı aralıklar uzlaştırmayı kolaylaştırır.
• İndirmeden önce giriş sayısını doğrulayın. Dışa aktar düğmesi sayıyı gösterir. Beklenmedik şekilde düşük veya yüksekse filtrelerinizi kontrol edin.
• Dışa aktarmaları arşivleyin. Her dışa aktarmanın bir kopyasını, ilgili fatura veya bordro raporuyla birlikte denetim amacıyla kaydedin.
• Yinelenen raporlar için API'yi kullanın. Manuel indirmeler tek seferlik ihtiyaçlar için yeterlidir, ancak otomatik dışa aktarmalar unutulan raporları ve insan hatasını azaltır.
• Eksik açıklamaları kontrol edin. Müşteri faturalaması için dışa aktarmadan önce, boş açıklamalı girişleri filtreleyip doldurun. Müşteriler ayrıntılı zaman çizelgelerini takdir eder.

İlgili sayfalar

• Manuel zaman girişi
• Faturalanabilir zaman
• Zamanlayıcı widget'ı
• Zaman takibi genel bakış
• Kontrol panelleri