CSV Dosyalarınızı Hazırlayın

Genel Bakış

Bu kılavuz, başarılı bir içe aktarma için CSV dosyanızı hazırlamanızda size rehberlik eder. Hataları önlemek için bu adımları izleyin.

Adım 1: Dosya Gereksinimlerini Kontrol Edin

Başlamadan önce dosyanızın şu gereksinimleri karşıladığından emin olun:

Gereksinim	Ayrıntılar
Biçim	CSV, XLSX veya XLS
Boyut sınırı	Dosya başına 10.000 kayıt
Kodlama	UTF-8 önerilir
Yapı	Dosya başına tek bir nesne türü

10.000 kayıttan büyük veri kümeleri için, birden çok dosyaya bölün veya API ile içe aktarma kullanın.

Adım 2: Örnek Dosyayı İndirin

Bu en önemli adımdır. Örnek dosya, Twenty’nin beklediği tam sütun adlarını ve biçimi gösterir.

Nesne görünümüne gidin (Kişiler, Şirketler vb.)
⋮ üzerine tıklayın → Kayıtları içe aktar’ı seçin
Örnek dosyayı indir’e tıklayın
Bu dosyayı şablonunuz olarak kullanın

İpucu: Bunun yerine birkaç mevcut kaydı dışa aktarın. Bu, verilerin nasıl biçimlendirilmesi gerektiğine dair gerçek örnekler sağlar ve içe aktarma sırasında sütun adları otomatik olarak eşleştirilir.

Adım 3: Yinelenen Değerleri Kaldırın

Twenty bazı alanlarda benzersizliği zorunlu kılar. Yinelenenler içe aktarma hatalarına neden olur.

Nesne	Benzersiz Alanlar
Kişiler	`id`, `email`
Şirketler	`id`, `domain`
Özel nesneler	`id` ve benzersiz olarak işaretlediğiniz diğer herhangi bir alan

İçe aktarmadan önce:

E-tablonuzu benzersiz alana göre sıralayın (e-posta veya alan adı)
Yinelenen satırları kaldırın veya birleştirin
Twenty’de zaten var olan yinelenen kayıtları kontrol edin

Geçici olarak silinmiş kayıtlar benzersizliğe dahildir. Komut Menüsü → Silinen kayıtları gör bölümündeki kayıtlar yinelenen hatalarına neden olur. Onları kalıcı olarak silin ya da geri yükleyip güncelleyin.

Adım 4: Her Alan Türünü Doğru Biçimlendirin

Farklı alan türleri belirli biçimler gerektirir. İşte eksiksiz başvuru:

Metin Alanları

Özel bir biçimlendirme gerekmez
Baştaki/sondaki boşluklar otomatik olarak kırpılır

E-posta Alanları

Geçerli e-posta biçiminde olmalıdır: name@domain.com
Benzersiz olmalıdır (dosyada veya Twenty’de yinelenen olmamalıdır)
Ek e-postalar için, E-postalar / Ek E-postalar sütununda şu biçimi kullanın:

["jane@twenty.com","jane.doe@twenty.com"]

Alan Adı Alanları

Önerilen biçim: https://domain.com
Bu, posta kutusu/takvim eşitlemesinde kullanılan biçimle aynıdır (yinelenenleri önler)
Her iki sütunu da doldurun:
- Alan Adı / Alan Adı Etiketi: domain.com
- Alan Adı / Alan Adı URL’si: https://domain.com
Dosyanız içinde ve Twenty’de benzersiz olmalıdır

Telefon Alanları

Telefon, birden çok sütun gerektiren iç içe bir alandır:

Sütun	Örnek
Telefonlar / Birincil Telefon Numarası	`4159095555`
Telefonlar / Birincil Telefon Ülke Kodu	`US`
Telefonlar / Birincil Telefon Arama Kodu	`+1`

Adres Alanları

Adres, birden çok sütundan oluşan iç içe bir alandır (bazıları boş bırakılabilir):

Address / Address 1: Sokak adresinin 1. satırı
Address / Address 2: Sokak adresinin 2. satırı (isteğe bağlı)
Address / City: Şehir adı
Address / State: Eyalet veya il
Address / Country: Ülke adı
Address / Post Code: Posta/ZIP kodu

Tarih Alanları

Dosyanızın tamamında tutarlı bir biçim kullanın:

YYYY-MM-DD (önerilir): 2024-03-15
ISO 8601: 2024-03-15T10:30:00Z

Sayı Alanları

Yalnızca sayılar (metin yok)
Ondalıklar için nokta kullanın: 1234.56
Binlik ayırıcı kullanmayın (şu değil: 1,234.56)

Para Birimi Alanları

Para birimi, her ikisi de doldurulması gereken iki sütun gerektiren iç içe bir alandır:

Sütun	Örnek
Amount / Amount	`1234.56`
Amount / Currency	`USD`

Boole Alanları

Büyük harf kullanın: TRUE veya FALSE

Küçük harf true veya false çalışmaz.

Seçim Alanları

Görünen etiketi değil, seçeneğin API adını kullanın. API adları nasıl bulunur:

Ayarlar → Veri Modeli bölümüne gidin
Nesneyi ve alanı seçin
Gelişmiş modu etkinleştirin (sağ alttaki anahtarı kullanarak)
API adını kopyalayın (ör., OPTION_1, “Option 1” değil)

Yeni seçim seçenekleri otomatik olarak oluşturulmaz. İçe aktarmadan önce Ayarlar → Veri Modeli içinde ekleyin.

Çoklu Seçim Alanları

Dizi biçiminde API adlarını kullanın:

["VALUE1","VALUE2"]

Dizi Alanları

JSON dizi biçimini kullanın:

["value1","value2"]

Puanlama Alanları

Şu biçimi kullanın: RATING_1, RATING_2, RATING_3, RATING_4 veya RATING_5

Bağlantı/URL Alanları

Her iki sütunu da doldurun:

Links / Link Label: Twenty
Links / Link URL: https://twenty.com

İkincil bağlantılar için Links / Secondary Links sütununu kullanın:

[{"url":"https://twenty.com","label":"Twenty"}]

JSON Alanları

Geçerli JSON biçimini kullanın:

{"key":"value","key2":"value2"}

ID Alanları

İsteğe bağlı: Sağlanmazsa Twenty kimlikleri otomatik olarak oluşturur
Biçim: UUID (ör., c776ee49-f608-4a77-8cc8-6fe96ae1e43f)
Kullanım durumu: Yeni kayıtlar oluşturmak yerine mevcut kayıtları güncellemek için ID ekleyin

Adım 5: İlişki Sütunları Ekleyin (Kayıtları Birbirine Bağlıyorsanız)

Kayıtları diğer nesnelere (ör., Kişileri Şirketlere) bağlamak için, ilgili kaydın benzersiz tanımlayıcısını içeren bir sütun ekleyin. Örnek: Kişileri Şirketlere bağlama Kişiler CSV’nize bir sütun ekleyin:

firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co

İlişkiler için önemli kurallar:

Ana kaydın Twenty’de zaten mevcut olması gerekir
Etiketi değil, Alan Adı URL’si biçimini (https://domain.com) kullanın
Yalnızca TEK bir benzersiz tanımlayıcı eşleyin (hem companyId hem de companyDomain eklemeyin)
Çalışma Alanı Üyeleri için, ad yerine e-postalarını kullanın

İçe Aktarma Sırası Önemlidir!Önce “bir” tarafını, sonra “çok” tarafını içe aktarın:

Şirketler önce
Kişiler ikinci (şirket referansıyla)
Fırsatlar üçüncü

Ona referans verebilmeden önce ana kayıt mevcut olmalıdır.

Ayrıntılı talimatlar için İlişkileri Nasıl İçe Aktarırız bölümüne bakın.

Adım 6: Alanların Twenty’de mevcut olduğundan emin olun

İçe aktarma kayıtlar oluşturur, alanlar değil. İçe aktarmak istediğiniz tüm alanlar veri modelinizde zaten mevcut olmalıdır. İçe aktarmadan önce:

Ayarlar → Veri Modeli bölümüne gidin
Nesnenizi seçin
Gereksinim duyduğunuz özel alanları oluşturun
Alan adlarını aynen not edin (sütun başlıklarınızla birebir eşleşmelidir)

Adım 7: Son Kontrol Listesi

Dosyanızı yüklemeden önce şunları doğrulayın:

Dosya CSV, XLSX veya XLS biçiminde

Dosyada 10.000’den az kayıt var

Kodlama UTF-8

Yinelenen e-postalar (Kişiler için) veya alan adları (Şirketler için) yok

Tarihler her yerde tutarlı bir biçim kullanıyor

Alan adları https://domain.com biçimini kullanıyor

Boole alanları TRUE veya FALSE (büyük harf) kullanıyor

Seçim alanları, görünen etiketler değil, API adlarını kullanıyor

Tüm özel alanlar Ayarlar → Veri Modeli içinde mevcut

Ana kayıtlar, alt kayıtlardan önce içe aktarıldı

İlişki sütunları mevcut kayıtlara referans veriyor

Kaçınılması Gereken Yaygın Hatalar

Hata	Çözüm
`TRUE` yerine `true` kullanmak	Boole değerleri büyük harf olmalıdır
Seçim alanlarında görünen etiketleri kullanmak	Ayarlar’da API adlarını bulun ve kullanın
Şirketlerden önce Kişileri içe aktarmak	Her zaman önce ana nesneleri içe aktarın
Para Birimi alanları için para birimi kodunun eksik olması	Hem Amount hem de Currency sütunlarını doldurun
Yanlış alan adı biçimi	`https://domain.com` biçimini tutarlı şekilde kullanın
İlişkiler için birden fazla benzersiz alanı eşlemek	Yalnızca TEK birini eşleyin (alan adı VEYA id, ikisi birden değil)

Sonraki Adımlar

Dosyanız hazır! Şimdi:

Şirketleri İçe Aktarın (bunları önce içe aktarın)
Kişileri İçe Aktarın
İçe aktarma hatalarını düzeltin

Genel Bakış

Veri modeli

Veri Geçişi

Takvim ve E-postalar

İş Akışları

AI

Düzen

Gösterge Panelleri

İzinler ve Erişim

Faturalandırma

Ayarlar

Yasal

Genel Bakış

Adım 1: Dosya Gereksinimlerini Kontrol Edin

Adım 2: Örnek Dosyayı İndirin

Adım 3: Yinelenen Değerleri Kaldırın

Adım 4: Her Alan Türünü Doğru Biçimlendirin

Metin Alanları

E-posta Alanları

Alan Adı Alanları

Telefon Alanları

Adres Alanları

Tarih Alanları

Sayı Alanları

Para Birimi Alanları

Boole Alanları

Seçim Alanları

Çoklu Seçim Alanları

Dizi Alanları

Puanlama Alanları

Bağlantı/URL Alanları

JSON Alanları

ID Alanları

Adım 5: İlişki Sütunları Ekleyin (Kayıtları Birbirine Bağlıyorsanız)

Adım 6: Alanların Twenty’de mevcut olduğundan emin olun

Adım 7: Son Kontrol Listesi

Kaçınılması Gereken Yaygın Hatalar

Sonraki Adımlar

​Genel Bakış

​Adım 1: Dosya Gereksinimlerini Kontrol Edin

​Adım 2: Örnek Dosyayı İndirin

​Adım 3: Yinelenen Değerleri Kaldırın

​Adım 4: Her Alan Türünü Doğru Biçimlendirin

​Metin Alanları

​E-posta Alanları

​Alan Adı Alanları

​Telefon Alanları

​Adres Alanları

​Tarih Alanları

​Sayı Alanları

​Para Birimi Alanları

​Boole Alanları

​Seçim Alanları

​Çoklu Seçim Alanları

​Dizi Alanları

​Puanlama Alanları

​Bağlantı/URL Alanları

​JSON Alanları

​ID Alanları

​Adım 5: İlişki Sütunları Ekleyin (Kayıtları Birbirine Bağlıyorsanız)

​Adım 6: Alanların Twenty’de mevcut olduğundan emin olun

​Adım 7: Son Kontrol Listesi

​Kaçınılması Gereken Yaygın Hatalar

​Sonraki Adımlar

Genel Bakış

Adım 1: Dosya Gereksinimlerini Kontrol Edin

Adım 2: Örnek Dosyayı İndirin

Adım 3: Yinelenen Değerleri Kaldırın

Adım 4: Her Alan Türünü Doğru Biçimlendirin

Metin Alanları

E-posta Alanları

Alan Adı Alanları

Telefon Alanları

Adres Alanları

Tarih Alanları

Sayı Alanları

Para Birimi Alanları

Boole Alanları

Seçim Alanları

Çoklu Seçim Alanları

Dizi Alanları

Puanlama Alanları

Bağlantı/URL Alanları

JSON Alanları

ID Alanları

Adım 5: İlişki Sütunları Ekleyin (Kayıtları Birbirine Bağlıyorsanız)

Adım 6: Alanların Twenty’de mevcut olduğundan emin olun

Adım 7: Son Kontrol Listesi

Kaçınılması Gereken Yaygın Hatalar

Sonraki Adımlar