Ana içeriğe atla

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:
  1. Doğrulama çalışır — Twenty her satırı hatalar için kontrol eder
  2. Hatalar vurgulanır — sorunlu satırlar sarı görünür
  3. Yerinde düzeltebilirsiniz — hücreleri doğrudan içe aktarma arayüzünde düzenleyin
  4. 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ırDeğ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
  1. Hatanın bulunduğu hücreye tıklayın
  2. Benzersiz bir değere değiştirin
  3. İçe aktarmaya devam edin
Seçenek 2: Yinelenen satırı kaldırın
  1. Satırın yanındaki X’e tıklayın
  2. Satır, içe aktarma sırasında atlanacaktır
Seçenek 3: Mevcut kaydı Twenty’nin güncellemesine izin verin
  1. Dosyanızın benzersiz bir tanımlayıcı (email, domain veya id) içerdiğinden emin olun
  2. Benzersiz tanımlayıcı alanını eşleyin
  3. Twenty, yinelenen bir kayıt oluşturmak yerine mevcut kaydı güncelleyecektir
Benzersiz alanları da güncelleyebilirsiniz.
  • id’yi korur ancak email’i değiştirirseniz → e-posta güncellenir
  • email’i korur ancak id’yi değiştirirseniz → id güncellenir
Benzersiz tanımlayıcılardan biri eşleştiği sürece Twenty kaydı günceller.

Bu Hata Nasıl Önlenir

İçe aktarmadan önce:
  1. E-tablonuzu benzersiz alana göre sıralayın
  2. Yinelenen satırları kaldırın
  3. Kayıtların Twenty’de zaten mevcut olup olmadığını kontrol edin
Yumuşak silinmiş kayıtlar benzersizliğe dahildir.Komut Menüsünü kontrol edin → Silinen kayıtları görün. Oradaki kayıtlar benzersizliği yine de uygular. Onları kalıcı olarak silin ya da geri yükleyip güncelleyin.
Daha fazla ayrıntı için: Benzersizlik Kısıtlamaları

Hata: Geçersiz Biçim

Görecekleriniz

Hücre değeri sarı renkle vurgulanır. Hata mesajını görmek için üzerine gelin:
{field name} is not a valid {field type}

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
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com

Alan Adı

Sorun: Tutarsız biçim yinelenmelere neden olabilir Çözüm: https://domain.com biçimini kullanın (önerilir)
⚠️ acme.com         (valid, but not recommended)
⚠️ www.acme.com     (valid, but not recommended)
✅ https://acme.com  (recommended)
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ın
✓ 2024-03-15        (YYYY-MM-DD - recommended)
✓ 03/15/2024        (MM/DD/YYYY)
✓ 15/03/2024        (DD/MM/YYYY)

Telefon

Sorun: Gerekli sütunlar eksik Çözüm: Tüm telefon sütunlarını dahil edin
SütunÖrnek
Phones / Primary Phone Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

Boolean

Sorun: Hatalı boolean değeri Çözüm: Büyük harfle TRUE veya FALSE kullanın
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE

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:
  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ı kullanın (ör. OPTION_1, “Option 1” değil)
❌ High Priority
✓ HIGH_PRIORITY

Para Birimi

Sorun: Tutar veya para birimi kodu eksik Çözüm: Her iki sütunu da doldurun
SütunÖrnek
Amount / Amount1234.56
Amount / CurrencyUSD

Sayı

Sorun: Sayısal olmayan karakterler Çözüm: Yalnızca sayılar, ondalıklar için nokta kullanın
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
Tam biçim başvurusu için: Alan Eşleme Başvurusu

Hata: 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
  1. Boş hücreye tıklayın
  2. Bir değer girin
  3. İçe aktarmaya devam edin
Seçenek 2: Satırı kaldırın
  1. Veri yoksa, satırı atlamak için X’e tıklayın

Bu Hata Nasıl Önlenir

İçe aktarmadan önce, zorunlu alanları belirleyin:
  1. Ayarlar → Veri Modeli bölümüne gidin
  2. Nesnenizi seçin
  3. 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:
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
Bu, Twenty’de o özel tanımlayıcıya sahip bir Şirket olmadığı anlamına gelir.
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
  1. Geçerli içe aktarmayı iptal edin
  2. Ana kayıtları içe aktarın (ör. Şirketler)
  3. Ardından alt kayıtları içe aktarın (ör. Kişiler)
Seçenek 2: Referans değerini düzeltin
  1. Dosyanızdaki referans değerini kontrol edin
  2. Mevcut bir kayıtla tam olarak eşleştiğinden emin olun
  3. Biçimi doğrulayın: alan adları https://domain.com olmalıdır
Seçenek 3: İlişkiyi kaldırın
  1. İlişki olmadan içe aktarmak için hücreyi temizleyin
  2. İlişkiyi daha sonra manuel olarak ekleyin

Bu Hata Nasıl Önlenir

  1. Doğru sırayla içe aktarın:
    • Önce Şirketler
    • İkinci olarak Kişiler (şirket referanslarıyla)
    • Üçüncü olarak Fırsatlar
  2. 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.com kullanın
    • Yazım hatalarını ve büyük/küçük harf duyarlılığını kontrol edin
Var olmayan bir kayda referans verilirse içe aktarma başarısız olur.Her zaman alt nesnelerden önce ana nesneleri içe aktarın.
Daha fazla ayrıntı için: İlişkileri İçe Aktarma

Hata: Dosya Çok Büyük

Görecekleriniz

Bu hata dosyanızı yüklerken görünür — yükleme tamamen engellenir:
Too many records. Up to 10000 allowed
Dosya boyutunu küçültmeden veri inceleme adımına ilerleyemezsiniz.

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
  1. Verilerinizi 10.000 veya daha az kayıttan oluşan dosyalara bölün
  2. Her dosyayı ayrı ayrı içe aktarın
  3. İçe aktarma sırasını koruyun (Şirketler Kişilerden önce)
Seçenek 2: API ile içe aktarmayı kullanın Çok büyük veri kümeleri için, kayıt sınırı olmayan API’yi kullanın. Bkz.: API ile Veri Nasıl İçe Aktarılır

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

  1. Ayarlar → Veri Modeli bölümüne gidin
  2. İçe aktardığınız nesneyi seçin
  3. + Alan Ekle’ye tıklayın
  4. Uygun türde özel alanı oluşturun
  5. 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

  1. Kullanıcı davetini kabul etmedi — kullanıcı henüz Twenty’de mevcut değil
  2. Eski sistemdeki kullanıcı kimliğini kullanma — Twenty başka bir sistemin kimliklerini eşleştiremez
  3. Yanlış e-posta biçimi — e-posta, kullanıcının Twenty hesabıyla eşleşmiyor

Nasıl Düzeltilir

  1. Tüm kullanıcıların Twenty çalışma alanınıza davetlerini kabul ettiğinden emin olun
  2. Kullanıcının e-posta adresini kullanın (adlarını veya eski sistem kimliğini değil)
  3. Twenty’ye katılmak için kullandıkları aynı e-postayı kullanın
Kullanıcılar, içe aktarmadan önce davetleri kabul etmelidir.Bir kullanıcı davetini kabul etmediyse, onlara referans veren kayıtların kullanıcı ilişkileri boş olacaktır.

İç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ır

Alan 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:
  1. Örnek dosyayı indirin — Twenty’nin beklediği tam biçimi görün
  2. Mevcut kayıtları dışa aktarın — dosyanızı çalışır durumdaki verilerle karşılaştırın
  3. Küçük bir partiyle test edin — önce 5-10 satırı deneyin
  4. Referans makaleleri kontrol edin: