Skip to main content

Genel Bakış

Bu kılavuz, nesneler arasındaki ilişkileri içe aktarma konusunda size yol gösterir—örneğin, Kişileri Şirketlere ya da Fırsatları Kişilere bağlama.
İçe aktarılabilecekler: Yalnızca tek bir nesne türüne işaret eden bire-çoğa ilişkiler. Birden fazla nesne türüne işaret eden ilişkiler (ör. Notların Kişilere VE Şirketlere bağlanması) henüz içe aktarmada desteklenmiyor.

İlişkileri Anlama

”Bire-Çoğa” İlişki Nedir?

Bir bire-çoğa ilişkide:
  • Bir Şirketin birçok Kişisi (çalışanı) vardır
  • Bir Şirketin birçok Fırsatı vardır
  • Bir Kişinin birçok Görevi vardır
“Bir” taraf ana taraftır. “Çok” taraf alt taraftır.

Twenty’de Yaygın İlişkiler

Adım 1: “Bir” ve “Çok” Tarafları Belirleyin

İçe aktarmadan önce hangi nesnenin ana, hangisinin alt olduğunu belirleyin. Kendinize sorun: “BİR [Nesne A]‘nın ÇOK [Nesne B]‘si var mı?”
  • Bir Şirket → Çok Kişi ✓ (Şirket ana taraftır)
  • Bir Kişi → Çok Şirket ✗ (Bu yanlıştır—bir kişi bir şirkete aittir)

Adım 2: Önce Ana Kayıtları İçe Aktarın

Ana (“bir” taraf) kaydı, ona referans verebilmeden önce Twenty’de mevcut olmalıdır. İçe aktarma sırası:
  1. Önce Şirketler (bağımlılık yok)
  2. İkinci olarak Kişiler (Şirketlere bağlanır)
  3. Üçüncü olarak Fırsatlar (Şirketlere ve/veya Kişilere bağlanır)
  4. Görevler/Notlar (yukarıdakilerin herhangi birine bağlanır)
Ana kayıt mevcut değilse içe aktarma başarısız olur.Şirket referansları olan Kişileri içe aktarmadan önce, Şirketlerin içe aktarılmış olduğunu her zaman doğrulayın.

Adım 3: Ana kaydın benzersiz tanımlayıcısını not edin

Ana kayda benzersiz bir tanımlayıcı kullanarak referans vermeniz gerekir. Kullanılabilir seçenekler:
Önerilir: Şirketler için domain, Kişiler için email kullanın. Bunlar insan tarafından okunabilirdir ve e-tablonuzda doğrulanması kolaydır.

Tanımlayıcıyı Bulma

id gerekiyorsa:
  1. Ana kayıtları Twenty’den dışa aktarın
  2. Dışa aktarma id sütununu içerir
  3. Bu kimlikleri alt kayıtlar dosyanızda kullanın

Adım 4: İlişki Alanının Var Olduğunu Doğrulayın

İçe aktarmadan önce, nesneleriniz arasında ilişki alanının mevcut olduğundan emin olun. Kontrol etmek veya oluşturmak için:
  1. Ayarlar → Veri Modeli bölümüne gidin
  2. Alt nesnenizi seçin (ör. Kişiler)
  3. Ana tarafa işaret eden bir ilişki alanı olup olmadığına bakın (ör. Şirket)
  4. Yoksa oluşturun:
    • + Alan Ekle’ye tıklayın
    • İlişki türünü seçin
    • Ana nesneyi seçin

Adım 5: CSV Dosyanızı Hazırlayın

Alt CSV’nize, ana tarafa benzersiz tanımlayıcısıyla referans veren bir sütun ekleyin.

Örnek: Kişilerin Şirketlere Bağlanması

Kişiler CSV’niz:
companyDomain sütunu, Şirketin alan adına referans verir.

Biçim Gereksinimleri

Alan adı biçimi önemlidir!https://domain.com kullanın (yalnızca domain.com değil). Bu, Twenty’nin Şirket alan adlarını saklama biçimiyle eşleşir ve eşleştirme hatalarını önler.

Önemli Kurallar

  1. Bire bir eşleşme gerekir — değer ana kayda tam olarak uymalıdır
  2. Yalnızca TEK bir benzersiz tanımlayıcıyı eşleyin — hem companyId HEM DE companyDomain eklemeyin
  3. Büyük/küçük harf duyarlıAcme.comacme.com

Adım 6: İlişkiyi Yükleyin ve Eşleyin

  1. Alt nesneye gidin (ör. Kişiler)
  2. Kayıtları içe aktar’ı tıklayın
  3. CSV dosyanızı yükleyin
  4. Alan eşleme adımında:
    • İlişki sütununuzu bulun (ör. companyDomain)
    • Bunu Şirket ilişki alanına eşleyin
  5. Kalan eşlemeleri tamamlayın
  6. Hataları gözden geçirin ve onaylayın
Twenty, her alt kaydı otomatik olarak eşleşen ana kayda bağlar.

Adım 7: İçe Aktarmayı Doğrulayın

İçe aktardıktan sonra:
  1. Birkaç alt kaydı açın (ör. Kişiler)
  2. İlişki alanının doğru ana kaydı gösterdiğini doğrulayın (ör. Şirket)
  3. Bir ana kaydı açın ve ilişkili kayıtlar bölümünü kontrol edin

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

İş Alanı Üyelerine Bağlama

İş Alanı Üyelerine (ekibiniz) bağlarken:
  • Adları yerine e-posta adreslerini kullanın
  • Örnek: owner@yourcompany.com, “John Smith” değil

SSS

İki seçeneğiniz var:
  1. Twenty id değerini kullanın (kimlikleri almak için ana kayıtları dışa aktarın)
  2. Önceki sisteminizden gelen harici bir kimliği saklamak için veri modelinizde özel bir benzersiz alan oluşturun
Evet! Alt kaydın benzersiz tanımlayıcısını (ör. Kişiler için email) ve yeni ilişki değerini ekleyin. İçe aktarma ilişkiyi günceller.
Çoktan-çoka ilişkiler henüz içe aktarmada desteklenmiyor. Bu, 2026’nın ilk yarısı için planlanıyor.
Birden fazla nesne türüne işaret eden ilişkiler henüz içe/dışa aktarma için desteklenmiyor. Bu özellik yol haritamızda.
İçe aktarma, o satır için bir hata gösterir. Aşağıdakileri yapabilirsiniz:
  • Önce ana kaydı içe aktarın, ardından yeniden içe aktarın
  • Referans değerini düzeltin
  • Satırı içe aktarmadan çıkarın
Yaygın nedenler:
  • Yanlış biçim (alan adları için https://domain.com kullanın)
  • Büyük/küçük harf uyumsuzluğu (yazımı tam olarak kontrol edin)
  • Ana kayıt mevcut değil (önce ana kayıtları içe aktarın)
  • Birden fazla tanımlayıcıyı eşleme (yalnızca birini kullanın)
Unutmayın: Yumuşak silinmiş kayıtlar benzersizliğe dahildir.“bulunamadı” hataları alıyorsanız ancak kayıt var gibi görünüyorsa, Komut Menüsü → Silinen kayıtları göster’i kontrol edin. Ana kayıt yumuşak silinmiş olabilir.

Sorun Giderme

Sorun mu yaşıyorsunuz? Şunları kontrol edin: