Ana içeriğe atla

​
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

İlişki”Bir” Taraf (Ana)“Çok” Taraf (Alt)
Şirketler → KişilerŞirketİnsanlar
Şirketler → FırsatlarŞirketFırsatlar
Kişiler → GörevlerKişiGörevler
Kişiler → NotlarKişiNotlar

​
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:
Ana NesneKullanılabilir Benzersiz Tanımlayıcılar
Şirketlerid (UUID), domain (önerilir) veya herhangi bir özel benzersiz alan
Kişilerid (UUID), email veya herhangi bir özel benzersiz alan
Çalışma Alanı Üyeleriid (UUID), email (isim değil)
Özel Nesnelerid (UUID) veya benzersiz olarak işaretlenmiş herhangi bir alan
Ö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: 
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
companyDomain sütunu, Şirketin alan adına referans verir.

​
Biçim Gereksinimleri

TanımlayıcıBiçimÖrnek
Alan AdıURL biçimihttps://acme.com
E-postaStandart e-postajohn@acme.com
KimlikUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
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.com ≠ acme.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

HataSorunÇözüm
Yanlış içe aktarma sırasıŞirketlerden önce Kişileri içe aktarmakHer zaman önce ana kayıtları, sonra alt kayıtları içe aktarın
Yanlış alan adı biçimihttps://acme.com yerine acme.com kullanmakhttps:// ile tam URL biçimini kullanın
Birden fazla benzersiz alanHem companyId HEM DE companyDomain eşlemekYalnızca TEK bir benzersiz tanımlayıcıyı eşleyin
İlişki alanı eksikİlişki alanı veri modelinde yokİçe aktarmadan önce Ayarlar → Veri Modeli içinde oluşturun
Mevcut olmayan kayıtlarAna kayıt Twenty’de mevcut değilÖnce ana kayıtları içe aktarın veya yazım hatalarını kontrol edin
Büyük/küçük harf uyumsuzluğuDosyada Acme.com, Twenty’de ise acme.comBire bir büyük/küçük harf eşleşmesini sağlayın

​
İş Alanı Üyelerine Bağlama

İş Alanı Üyelerine (ekibiniz) bağlarken:
  • Adları yerine e-posta adreslerini kullanın
  • Örnek: owner@yourcompany.com, “John Smith” değil
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

​
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: