Genel Bakış
İçe aktarma çalışmıyor mu? Bu kılavuz, yaygın içe aktarma hatalarını adım adım belirlemenize ve düzeltmenize yardımcı olur.İçe Aktarma Doğrulaması Nasıl Çalışır
Dosyanızı yükledikten ve sütunları eşledikten sonra, Twenty verilerinizi doğrular:- Doğrulama çalışır — Twenty her satırı hatalar için kontrol eder
- Hatalar vurgulanır — sorunlu satırlar sarı görünür
- Yerinde düzeltebilirsiniz — hücreleri doğrudan içe aktarma arayüzünde düzenleyin
- Veya satırları kaldırın — sorunlu kayıtları tamamen atlayın
Hataları arayüzde düzeltin. E-tablonuza geri dönmenize gerek yok. Zamandan tasarruf etmek için içe aktarma sırasında hücreleri doğrudan düzenleyin.
Adım Adım Sorun Giderme
Adım 1: Hata Türünü Belirleyin
Özel hata mesajını görmek için vurgulanmış bir satıra tıklayın. Yaygın hata türleri:| Hata Mesajı | Ne Anlama Gelir |
|---|---|
| Yinelenen değerler sarı renkle vurgulanır | Değer Twenty’de zaten mevcut veya dosyanızda iki kez görünüyor |
{field} is not a valid {type} (sarı hücrenin üzerine gelin) | Veri beklenen biçimle eşleşmiyor |
| Zorunlu alan vurgulanmış | Zorunlu bir alan boş |
Can't connect to {object}. No unique record found... (içe aktarma başarısız) | Başvurulan kayıt mevcut değil |
Too many records. Up to 10000 allowed (yükleme engellendi) | Dosyada 10.000’den fazla kayıt var |
Adım 2: Hatayı Düzeltin
Her hata türü için aşağıdaki özel talimatları izleyin.Hata: Yinelenen Değer
Görecekleriniz
İçe aktarma başlamadan önce içe aktarma arayüzünde yinelenen değerlere sahip satırlar sarı renkle vurgulanır.Ne Anlama Gelir
Benzersiz bir alan (e-posta, alan adı) ya:- Twenty’de zaten mevcut
- Dosyanızda iki kez görünüyor
Nasıl Düzeltilir
Seçenek 1: Yinelenen değeri düzenleyin- Hatanın bulunduğu hücreye tıklayın
- Benzersiz bir değere değiştirin
- İçe aktarmaya devam edin
- Satırın yanındaki X’e tıklayın
- Satır, içe aktarma sırasında atlanacaktır
- Dosyanızın benzersiz bir tanımlayıcı (
email,domainveyaid) içerdiğinden emin olun - Benzersiz tanımlayıcı alanını eşleyin
- Twenty, yinelenen bir kayıt oluşturmak yerine mevcut kaydı güncelleyecektir
Benzersiz alanları da güncelleyebilirsiniz.
id’yi korur ancakemail’i değiştirirseniz → e-posta güncelleniremail’i korur ancakid’yi değiştirirseniz → id güncellenir
Bu Hata Nasıl Önlenir
İçe aktarmadan önce:- E-tablonuzu benzersiz alana göre sıralayın
- Yinelenen satırları kaldırın
- Kayıtların Twenty’de zaten mevcut olup olmadığını kontrol edin
Hata: Geçersiz Biçim
Görecekleriniz
Hücre değeri sarı renkle vurgulanır. Hata mesajını görmek için üzerine gelin:Ne Anlama Gelir
Veriler, o alan türü için beklenen biçimle eşleşmiyor.Nasıl Düzeltilir — Alan Türüne Göre
E-posta
Sorun: Geçersiz e-posta biçimi Çözüm:name@domain.com biçimini kullanın
Alan Adı
Sorun: Tutarsız biçim yinelenmelere neden olabilir Çözüm:https://domain.com biçimini kullanın (önerilir)
Tüm biçimler geçerlidir, ancak e-posta/takvim senkronizasyonunun kullandığı biçimle eşleştiği için
https://domain.com önerilir. Diğer biçimlerin kullanılması yinelenen şirketler oluşturabilir.Tarih
Sorun: Tanınmayan tarih biçimi Çözüm: Dosya genelinde tutarlı bir biçim kullanınTelefon
Sorun: Gerekli sütunlar eksik Çözüm: Tüm telefon sütunlarını dahil edin| Sütun | Örnek |
|---|---|
| Phones / Primary Phone Number | 4159095555 |
| Phones / Primary Phone Country Code | US |
| Phones / Primary Phone Calling Code | +1 |
Boolean
Sorun: Hatalı boolean değeri Çözüm: Büyük harfleTRUE veya FALSE kullanın
Seçim / Çoklu Seçim
Sorun: Değer mevcut seçeneklerle eşleşmiyor Çözüm: Görünen etiketler değil, API adları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ı kullanın (ör.
OPTION_1, “Option 1” değil)
Para Birimi
Sorun: Tutar veya para birimi kodu eksik Çözüm: Her iki sütunu da doldurun| Sütun | Örnek |
|---|---|
| Amount / Amount | 1234.56 |
| Amount / Currency | USD |
Sayı
Sorun: Sayısal olmayan karakterler Çözüm: Yalnızca sayılar, ondalıklar için nokta kullanınHata: Zorunlu Alan Eksik
Görecekleriniz
Satır, zorunlu alan hücresi işaretlenmiş şekilde sarı renkle vurgulanır.Ne Anlama Gelir
Bu satır için zorunlu bir alan boş.Nasıl Düzeltilir
Seçenek 1: Bir değer girin- Boş hücreye tıklayın
- Bir değer girin
- İçe aktarmaya devam edin
- Veri yoksa, satırı atlamak için X’e tıklayın
Bu Hata Nasıl Önlenir
İçe aktarmadan önce, zorunlu alanları belirleyin:- Ayarlar → Veri Modeli bölümüne gidin
- Nesnenizi seçin
- Hangi alanların zorunlu olarak işaretlendiğini kontrol edin
Hata: İlişki Bulunamadı
Görecekleriniz
Bu hata içe aktarma başladıktan sonra görünür — içe aktarma şu tür bir mesajla başarısız olur:Diğer hatalardan farklı olarak, bu hata veri inceleme adımında yakalanmaz. İçe aktarma başlar ve eksik ilişkiyle karşılaştığında başarısız olur.
Ne Anlama Gelir
Twenty’de mevcut olmayan bir kayda bağlanmaya çalışıyorsunuz.Nasıl Düzeltilir
Seçenek 1: Önce ana kayıtları içe aktarın- Geçerli içe aktarmayı iptal edin
- Ana kayıtları içe aktarın (ör. Şirketler)
- Ardından alt kayıtları içe aktarın (ör. Kişiler)
- Dosyanızdaki referans değerini kontrol edin
- Mevcut bir kayıtla tam olarak eşleştiğinden emin olun
- Biçimi doğrulayın: alan adları
https://domain.comolmalıdır
- İlişki olmadan içe aktarmak için hücreyi temizleyin
- İlişkiyi daha sonra manuel olarak ekleyin
Bu Hata Nasıl Önlenir
-
Doğru sırayla içe aktarın:
- Önce Şirketler
- İkinci olarak Kişiler (şirket referanslarıyla)
- Üçüncü olarak Fırsatlar
-
Referans değerlerini doğrulayın:
- Tam tanımlayıcıları almak için ana kayıtları dışa aktarın
- Alan adı biçimi
https://domain.comkullanın - Yazım hatalarını ve büyük/küçük harf duyarlılığını kontrol edin
Hata: Dosya Çok Büyük
Görecekleriniz
Bu hata dosyanızı yüklerken görünür — yükleme tamamen engellenir:Ne Anlama Gelir
Dosyanızda 10.000’den fazla kayıt var.Nasıl Düzeltilir
Seçenek 1: Birden çok dosyaya bölün- Verilerinizi 10.000 veya daha az kayıttan oluşan dosyalara bölün
- Her dosyayı ayrı ayrı içe aktarın
- İçe aktarma sırasını koruyun (Şirketler Kişilerden önce)
Hata: Alan Tanınmadı
Ne Anlama Gelir
Dosyanızdaki bir sütun eşlenemiyor çünkü alan Twenty’de mevcut değil.Nasıl Düzeltilir
- Ayarlar → Veri Modeli bölümüne gidin
- İçe aktardığınız nesneyi seçin
- + Alan Ekle’ye tıklayın
- Uygun türde özel alanı oluşturun
- Dosyanızı yeniden yükleyin
CSV içe aktarma alanları değil, kayıtları oluşturur. İçe aktarmadan önce tüm alanlar mevcut olmalıdır.
Hata: Kullanıcı İlişkisi Boş
Ne Anlama Gelir
Bir kaydı bir kullanıcıya (Sahip, Atanan) atamaya çalışıyorsunuz ancak ilişki eşlenmiyor.Yaygın Nedenler
- Kullanıcı davetini kabul etmedi — kullanıcı henüz Twenty’de mevcut değil
- Eski sistemdeki kullanıcı kimliğini kullanma — Twenty başka bir sistemin kimliklerini eşleştiremez
- Yanlış e-posta biçimi — e-posta, kullanıcının Twenty hesabıyla eşleşmiyor
Nasıl Düzeltilir
- Tüm kullanıcıların Twenty çalışma alanınıza davetlerini kabul ettiğinden emin olun
- Kullanıcının e-posta adresini kullanın (adlarını veya eski sistem kimliğini değil)
- Twenty’ye katılmak için kullandıkları aynı e-postayı kullanın
İçe Aktarma Öncesi Kontrol Listesi
İçe aktarmadan önce bunları kontrol ederek hatalardan kaçının:Dosya Gereksinimleri
Dosya CSV, XLSX veya XLS biçiminde
Dosyada 10.000’den az kayıt var
Dosya UTF-8 kodlaması kullanıyor
Veri Kalitesi
Yinelenen e-postalar yok (Kişiler için)
Yinelenen alan adları yok (Şirketler için)
Tüm tarihler tutarlı biçim kullanır
Tüm alan adları
https://domain.com biçimini kullanırAlan Biçimleri
Boolean alanlar
TRUE veya FALSE kullanır (büyük harf)Seçim alanları, görünen etiketler değil API adlarını kullanır
Telefon alanlarında gerekli tüm sütunlar vardır
Para birimi alanlarında hem Amount hem de Currency Code bulunur
İlişkiler
Ana kayıtlar, alt kayıtlardan önce içe aktarılır
İlişki sütunları mevcut kayıtlara referans verir
Alan adı biçimi, Twenty’nin biçimiyle birebir eşleşir
Veri modeli
Tüm özel alanlar Ayarlar → Veri Modeli’nde mevcut
Seçim seçenekleri içe aktarmadan önce mevcut
Hâlâ Sorun mu Yaşıyorsunuz?
Yukarıdaki çözümleri denediyseniz:- Örnek dosyayı indirin — Twenty’nin beklediği tam biçimi görün
- Mevcut kayıtları dışa aktarın — dosyanızı çalışır durumdaki verilerle karşılaştırın
- Küçük bir partiyle test edin — önce 5-10 satırı deneyin
- Referans makaleleri kontrol edin: