Ana içeriğe atla

​
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:
GereksinimAyrıntılar
BiçimCSV, XLSX veya XLS
Boyut sınırıDosya başına 10.000 kayıt
KodlamaUTF-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.
NesneBenzersiz Alanlar
Kişilerid, email
Şirketlerid, domain
Özel nesnelerid 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: [email protected]
  • 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:
[\"[email protected]\",\"[email protected]\"]

​
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 KoduUS
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
  • MM/DD/YYYY: 03/15/2024
  • DD/MM/YYYY: 15/03/2024
  • 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 / Amount1234.56
Amount / CurrencyUSD

​
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,[email protected],https://acme.com
Jane,Doe,[email protected],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 kullanmakBoole değerleri büyük harf olmalıdır
Seçim alanlarında görünen etiketleri kullanmakAyarlar’da API adlarını bulun ve kullanın
Şirketlerden önce Kişileri içe aktarmakHer 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çimihttps://domain.com biçimini tutarlı şekilde kullanın
İlişkiler için birden fazla benzersiz alanı eşlemekYalnızca TEK birini eşleyin (alan adı VEYA id, ikisi birden değil)

​
Sonraki Adımlar

Dosyanız hazır! Şimdi: