Prepare Your CSV Files

Verilerinizi Twenty’ye içe aktarmak için biçimlendirmeye yönelik eksiksiz adım adım kılavuz.

​

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.

1. Nesne görünümüne gidin (Kişiler, Şirketler vb.)
2. ⋮ üzerine tıklayın → Kayıtları içe aktar’ı seçin
3. Örnek dosyayı indir’e tıklayın
4. 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:

1. E-tablonuzu benzersiz alana göre sıralayın (e-posta veya alan adı)
2. Yinelenen satırları kaldırın veya birleştirin
3. 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: [e-mail]
• 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:

[\"[e-mail]\",\"[e-mail]\"]

​

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:

1. Ayarlar → Veri Modeli bölümüne gidin
2. Nesneyi ve alanı seçin
3. Gelişmiş modu etkinleştirin (sağ alttaki anahtarı kullanarak)
4. 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,[e-mail],https://acme.com
Jane,Doe,[e-mail],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:

1. Şirketler önce
2. Kişiler ikinci (şirket referansıyla)
3. 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:

1. Ayarlar → Veri Modeli bölümüne gidin
2. Nesnenizi seçin
3. Gereksinim duyduğunuz özel alanları oluşturun
4. 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