CSV'den İçeri Aktarma
CSV içe aktarıcısı, herhangi bir CSV (virgülle ayrılmış değerler) dosyasından iş öğelerini toplu olarak içe aktarmanıza olanak tanır. Bu en esnek içe aktarıcıdır — herhangi bir araçtan dışa aktarılan verilerle, elle hazırlanmış elektronik tablolarla veya özel veri hatlarıyla çalışır. Bir dosya yükler, sütunları SetGet alanlarıyla eşler, doğrulama sonuçlarını inceler ve içe aktarmayı çalıştırırsınız.
Dosya formatı gereksinimleri
| Gereksinim | Ayrıntı |
|---|---|
| Kodlama | UTF-8 (BOM kabul edilir ancak zorunlu değildir) |
| Sınırlayıcı | Virgül (,) |
| Başlık satırı | İlk satır olarak zorunludur |
| Maksimum dosya boyutu | 10 MB |
| Maksimum satır | Dosya başına 10.000 iş öğesi |
| Alıntılama | Virgül veya yeni satır içeren alanlar çift tırnak içine alınmalıdır |
| Satır sonları | \n (LF) veya \r\n (CRLF) |
Örnek CSV şablonu
Örnek şablonu içe aktarma sayfasından indirin veya bu formatı kullanın:
Title,Description,State,Priority,Assignee,Labels,Due Date,Estimate
"Fix login bug","Users cannot log in when password contains special characters",In Progress,High,alice@example.com,"bug,frontend",2026-04-15,3
"Add dark mode","Implement dark mode toggle in settings",Backlog,Medium,bob@example.com,"feature,ui",2026-05-01,8
"Update API docs","Document the new /v2/projects endpoint",Todo,Low,,"docs",2026-04-20,2Sütun açıklamaları
| Sütun | Zorunlu | Format | Notlar |
|---|---|---|---|
| Title | Evet | Düz metin | İş öğesi başlığı |
| Description | Hayır | Düz metin veya Markdown | İş öğesi açıklaması |
| State | Hayır | Durum adı | Mevcut bir SetGet durumuyla eşleşmeli veya eşlenmelidir |
| Priority | Hayır | Urgent, High, Medium, Low veya None | Büyük/küçük harf duyarsız |
| Assignee | Hayır | E-posta adresi | Bir çalışma alanı üyesinin e-postasıyla eşleşmeli |
| Labels | Hayır | Virgülle ayrılmış liste (tırnak içinde) | Mevcut değilse oluşturulur |
| Due Date | Hayır | YYYY-MM-DD | ISO 8601 tarih formatı |
| Start Date | Hayır | YYYY-MM-DD | ISO 8601 tarih formatı |
| Estimate | Hayır | Tam sayı | Proje ayarlarına bağlı olarak puan veya saat |
| Parent | Hayır | Başka bir satırın başlığı | Alt iş öğesi ilişkisi oluşturur |
Kurulum adımları
Adım 1 -- CSV dosyasını yükleme
- Ayarlar > İçe Aktar'a gidin.
- CSV'yi seçin.
- Dosya Yükle'ye tıklayın ve CSV dosyanızı seçin.
- SetGet dosyayı ayrıştırır ve ilk 10 satırın önizlemesini gösterir.
Adım 2 -- Sütunları alanlara eşleme
SetGet yaygın sütun adlarını otomatik algılar. Otomatik olarak eşlenmeyen sütunlar için hedef alanı manuel olarak seçin.
| CSV sütun başlığı | Otomatik algılanan SetGet alanı |
|---|---|
Title, Name, Summary | İş öğesi başlığı |
Description, Body, Details | Açıklama |
State, Status | Durum |
Priority | Öncelik |
Assignee, Assigned To, Owner | Atanan |
Labels, Tags | Etiketler |
Due Date, Due, Deadline | Son tarih |
Estimate, Points, Story Points | Tahmin |
Hiçbir alanla eşlenmeyen sütunlar yok sayılabilir veya açıklamaya eklenebilir.
Adım 3 -- Hedef projeyi seçme
- Yeni proje oluştur -- proje adı ve tanımlayıcı girin.
- Mevcut projeye aktar -- mevcut bir proje seçin.
Adım 4 -- Durum ve öncelik değerlerini eşleme
CSV'niz SetGet varsayılanlarından farklı durum veya öncelik adları kullanıyorsa bunları eşleyin:
| CSV state value | SetGet state |
|---|---|
Open | Backlog |
Doing | In Progress |
Finished | Done |
| CSV priority value | SetGet priority |
|---|---|
P0 | Urgent |
P1 | High |
P2 | Medium |
P3 | Low |
Adım 5 -- Doğrulama
İçe aktarmadan önce verileri kontrol etmek için Doğrula'ya tıklayın. Doğrulayıcı şunları raporlar:
| Doğrulama kontrolü | Neleri yakalar |
|---|---|
| Eksik başlık | Başlık değeri olmayan satırlar |
| Geçersiz tarih formatı | YYYY-MM-DD formatında olmayan tarihler |
| Bilinmeyen durum | SetGet durumuyla eşlenmeyen durum değerleri |
| Bilinmeyen öncelik | Eşlemede olmayan öncelik değerleri |
| Eşleşmeyen atanan | Hiçbir çalışma alanı üyesiyle eşleşmeyen e-postalar |
| Yinelenen başlıklar | Aynı başlığa sahip satırlar (uyarı, engelleyici değil) |
Hatalar, satır numarası ve sütunuyla birlikte satır satır gösterilir. CSV dosyasındaki hataları düzeltin ve yeniden yükleyin ya da uyarıları kabul ederek devam edin.
İPUCU
İçe aktarmadan önce doğrulama hatalarını düzeltin. Uyarılar kabul edilebilirken hatalar bu satırların atlanmasına neden olur.
Adım 6 -- İçe aktarmayı başlatma
İçe Aktarmayı Başlat'a tıklayın. İlerleme ekranı işlenen satırları ve hatalar nedeniyle atlanan tüm satırları gösterir.
Hata yönetimi
| Hata türü | Davranış |
|---|---|
| Zorunlu alan eksik (başlık) | Satır atlanır |
| Geçersiz tarih | Tarih alanı boş bırakılır; satır içe aktarılır |
| Bilinmeyen durum (eşlenmemiş) | Durum Backlog'a varsayılanı alır; satır içe aktarılır |
| Bilinmeyen öncelik (eşlenmemiş) | Öncelik Yok'a varsayılanı alır; satır içe aktarılır |
| Eşleşmeyen atanan | Atanan boş bırakılır; satır içe aktarılır |
İçe aktarma sonrasında özet rapor, satır numaralarıyla birlikte tüm atlanan satırları ve uyarıları listeler.
İçerik aktarma sonrası doğrulama
- İçe aktarılan iş öğesi sayısını CSV satır sayısıyla (başlık eksi, atlanan satırlar eksi) karşılaştırın.
- Doğru alan değerleri için birkaç öğeyi nokta kontrol edin.
- Etiketlerin oluşturulduğunu doğrulayın.
- Parent sütunu kullanılıyorsa ebeveyn-çocuk ilişkilerini kontrol edin.
UYARI
CSV içe aktarıcısı yinelenenleri algılamaz. Aynı dosyayı iki kez içe aktarmak yinelenen iş öğeleri oluşturur. Yinelenenleri manuel olarak silin veya yeniden içe aktarmadan önce projeyi temizleyin.
Diğer araçlardan veri hazırlama
Özel bir içe aktarıcısı olmayan bir araçtan içe aktarıyorsanız, o araçtan CSV'ye dışa aktarın ve bu içe aktarıcıyı kullanın. Yaygın kaynaklar:
| Kaynak araç | Dışa aktarma yöntemi | Notlar |
|---|---|---|
| Trello | Menü > Daha Fazla > Yazdır ve Dışa Aktar > CSV | Trello Power-Up veya üçüncü taraf dışa aktarma gerektirir |
| Monday.com | Pano menüsü > Excel/CSV'ye Dışa Aktar | Sütunları CSV başlıklarıyla eşler |
| Basecamp | Üçüncü taraf dışa aktarma araçları | Yerel CSV dışa aktarma yok |
| Airtable | Görünüm > CSV'yi İndir | Her görünüm ayrı olarak dışa aktarılabilir |
| Google Sheets | Dosya > İndir > CSV | İçe aktarmadan önce .csv olarak kaydedin |
| Excel | Dosya > Farklı Kaydet > CSV | "CSV UTF-8" formatını seçin |
Dışa aktardıktan sonra, CSV'nin yukarıdaki format gereksinimlerini karşıladığından emin olmak için inceleyin, ardından SetGet'e yükleyin.
Gelişmiş: Üst-alt ilişkiler
Parent sütunu alt iş öğesi ilişkileri oluşturur:
- Parent sütun değerini CSV'deki başka bir satırın tam başlığına ayarlayın.
- Ebeveyn satır da aynı CSV dosyasında bulunmalıdır.
- İç içe geçme bir seviyeyle sınırlıdır (alt iş öğelerinin CSV içe aktarma yoluyla kendi çocukları olamaz).
Örnek:
Title,State,Parent
"Authentication module",Backlog,
"Implement login endpoint",Backlog,"Authentication module"
"Implement logout endpoint",Backlog,"Authentication module"En iyi uygulamalar
- Verilerinizi temizleyin içe aktarmadan önce. Boş satırları kaldırın, kodlama sorunlarını düzeltin ve durum/öncelik adlarını standartlaştırın.
- Örnek şablonu doğru biçimlendirmeyi sağlamak için başlangıç noktası olarak kullanın.
- Küçük bir dosyayla test edin (10-20 satır) büyük bir veri kümesini içe aktarmadan önce.
- E-posta adreslerini standartlaştırın doğru atanan eşlemesi için çalışma alanı üyeleriyle eşleşecek şekilde.
- Kodlamayı kontrol edin -- bozuk karakterler görürseniz dosyanın UTF-8 olarak kaydedildiğinden emin olun.
- BOM'u kaldırın -- bazı araçlar UTF-8 dosyalarının başına BOM (Bayt Sırası İşareti) ekler. SetGet BOM'u düzgün şekilde işler, ancak kaldırmak olası sorunları önler.