snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/tr/user-guide/data-migration/capabilities/error-handling.mdx

@@ -0,0 +1,76 @@
+---
+title: Hata Yönetimi ve Doğrulama
+description: Onaylamadan önce içe aktarma hatalarını doğrudan kullanıcı arayüzünde gözden geçirip düzeltin.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## İçe Aktarma Öncesi Doğrulama
+
+Dosyanızı yükleyip alanları eşledikten sonra, Twenty verilerinizi içe aktarmadan **önce** doğrular. Bu, mevcut verilerinizi etkilemeden hataları yakalayıp düzeltmenizi sağlar.
+
+## Nasıl Çalışır
+
+1. CSV dosyanızı **yükleyin**
+2. Sütunlarınızı Twenty alanlarıyla **eşleyin**
+3. Sarıyla vurgulanan olası hataları **gözden geçirin**
+4. **Hataları düzeltin** doğrudan kullanıcı arayüzünde
+5. İçe aktarmayı **onaylayın**
+
+<VimeoEmbed videoId="1145273857" title="Video gösterimi" />
+
+## Hata Görüntüleme
+
+Sorun içeren satırlar **sarı** renkle vurgulanır. Şunları yapabilirsiniz:
+
+* Hatayı düzeltmek için **hücreyi doğrudan düzenleyin**
+* Tamamen atlamak için **satırı kaldırın**
+
+Bu satır içi düzenleme zaman kazandırır — e-tablonuza geri dönüp hataları düzeltmenize ve yeniden yüklemenize gerek yoktur.
+
+## Yaygın Hata Türleri
+
+### Yinelenen Değerler
+
+**Neden**: Benzersiz bir alan (e-posta, alan adı) Twenty'de zaten mevcut veya dosyanızda iki kez görünüyor.
+
+**Düzeltme**:
+
+* Yinelenen değeri içe aktarma arayüzünde düzenleyin
+* Yinelenen satırlardan birini kaldırın
+
+Benzersizliğin nasıl sağlandığı hakkında daha fazla bilgi için [Benzersizlik Kısıtları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints) bölümüne bakın.
+
+### Geçersiz Biçim
+
+**Neden**: Veriler beklenen biçimle eşleşmiyor (ör. geçersiz e-posta, yanlış tarih biçimi).
+
+**Düzeltme**: Doğru biçimi kullanmak için hücreyi düzenleyin.
+
+Her alan türü için beklenen biçimi görmek üzere [Alan Eşleme](/l/tr/user-guide/data-migration/capabilities/field-mapping) bölümüne bakın.
+
+### Zorunlu Alanlar Eksik
+
+**Neden**: Zorunlu bir alan boş.
+
+**Düzeltme**: Zorunlu alana bir değer girin veya satırı kaldırın.
+
+### İlişki Bulunamadı
+
+**Neden**: Atıf yapılan kayıt mevcut değil (ör. içe aktarılmamış bir Şirket alan adı).
+
+**Düzeltme**:
+
+* Önce ana kayıtları içe aktarın
+* Veya referans değerini düzeltin
+
+Doğru içe aktarma sırası ve kayıtların nasıl ilişkilendirileceği hakkında bilgi için [İlişkileri İçe Aktarma](/l/tr/user-guide/data-migration/capabilities/import-relations) bölümüne bakın.
+
+## Daha Az Hata İçin İpuçları
+
+1. Dosyanızı içe aktarmadan önce beklenen biçimi görmek için **şablonu indirin**
+2. Önce e-tabloda verilerinizi **temizleyin**
+3. İlişkileri içe aktarmak için **dosyaları doğru sırayla içe aktarın** (Şirketler → Kişiler → Fırsatlar)
+4. Tam içe aktarmadan önce **küçük gruplarla test edin**
+5. Yüklemeden önce **yinelenenleri kontrol edin**
+6. **Her dosyayı 10.000 kayıtla sınırlandırın**

packages/twenty-docs/l/tr/user-guide/data-migration/capabilities/field-mapping.mdx

@@ -0,0 +1,198 @@
+---
+title: Alan Eşlemesi
+description: Veri içe aktarma sırasında alan eşlemenin nasıl çalıştığı.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Alan Eşlemesi Nasıl Çalışır
+
+Bir dosya yüklediğinizde, Twenty sütunlarınızı analiz eder ve bunları mevcut alanlarla eşleştirmeye çalışır.
+
+### Otomatik Eşleme
+
+Twenty, sütunları aşağıdakilere göre eşleştirmeye çalışır:
+
+* Sütun başlık adları (tam veya benzer eşleşmeler)
+* Veri türü algılama (tarihler, sayılar, e-postalar)
+* Yaygın alan kalıpları
+
+<Note>**Hızlı ipucu:** İçe aktarmak istediğiniz nesneden birkaç satır dışa aktarın. Dışa aktarılan dosya, Twenty'nin beklediği sütun adlarını tam olarak içerir; bu da içe aktarma sırasında otomatik eşlemeyi sorunsuz hale getirir.</Note>
+
+### Manuel Eşleme Seçenekleri
+
+Her sütun için şunları yapabilirsiniz:
+
+* **Bir alana eşleyin**: Açılır menüden eşleşen Twenty alanını seçin
+* **Eşleme yapmayın**: Sütunu tamamen atlayın (veri içe aktarılmayacaktır)
+
+<Note>**Alanlar, içe aktarmadan önce mevcut olmalıdır.** İçe aktarma alanları değil, kayıtları oluşturur. İçe aktarmadan önce özel alanları **Ayarlar → Veri Modeli** altında oluşturun.</Note>
+
+## Alan Türü Uyumluluğu
+
+Veri Modelinde mevcut olan tüm alan türleri içe aktarma için desteklenir.
+
+`id` değerlerini de içe aktararak yeni kayıtlara belirli bir ID atayabilir veya mevcut olanları güncelleyebilirsiniz.
+
+<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
+
+## Veri Biçimi Gereksinimleri
+
+<Note>**Bazı alanların özel bir sözdizimi vardır.** İçe aktarmayı hazırlamadan önce her alan türü için beklenen sözdizimini görmek adına örnek dosyayı indirmenizi öneririz.</Note>
+
+### Adres Alanları
+
+Adres, birden çok sütuna sahip 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ı
+* **Address / City**: Şehir adı
+* **Address / State**: Eyalet veya il
+* **Address / Country**: Ülke adı
+* **Address / Post Code**: Posta/ZIP kodu
+
+### Dizi Alanları
+
+Aşağıdaki biçimi kullanın:
+
+```
+["value1","value2"]
+```
+
+### Boole Alanları
+
+`TRUE` veya `FALSE` kullanın (büyük harf) - `true` ya da `false` kullanmayın
+
+### Para Birimi Alanları
+
+Para birimi, her ikisi de doldurulması gereken iki sütundan oluşan iç içe bir alandır:
+
+* **Amount / Amount**: Sayısal değer (örn. `1234.56`)
+* **Amount / Currency**: Para birimi kodu (örn. `USD`, `EUR`)
+
+### Tarih Alanları
+
+Desteklenen biçimler:
+
+* `YYYY-MM-DD` (önerilir)
+* `MM/DD/YYYY`
+* `DD/MM/YYYY`
+* ISO 8601 biçimi
+
+### Alan Adı Alanları
+
+* Kopyalar oluşmasını önlemek için `https://domain.com` biçiminin kullanılması önerilir; çünkü posta kutusu ve takvim eşzamanlaştırmalarıyla oluşturulan Şirketler için kullanılan biçim budur
+* Bir `Domain Label` ve `Domain URL` doldurulabilir: en iyi uygulama olarak etikete `domain.com`, URL'ye `https://domain.com` yazmaktır
+* Alan adları, Şirketler nesnesi içinde benzersiz olmalıdır
+* **İçe aktarılacak dosya içinde alan adlarının benzersiz olması gerekir**
+
+### E-posta Alanları
+
+* Geçerli e-posta biçiminde olmalıdır
+* E-postalar, Kişiler nesnesi içinde benzersiz olmalıdır
+* **İçe aktarılacak dosya içinde e-postaların benzersiz olması gerekir**
+* Ek e-postalar için: ana e-posta için **Emails / Primary Email**'i ve şu biçimle **Emails / Additional Emails**'i kullanın:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### ID Alanları
+
+İçe aktarma sırasında bir `id` belirtmek isteğe bağlıdır. Sağlanmazsa Twenty bir tane otomatik olarak oluşturur.
+
+`id` sütununu eşlemeye yönelik kullanım durumları:
+
+* **Belirli bir ID ayarlayın**: Yeni oluşturulan kayıtlar için UUID seçin
+* **Mevcut kayıtları güncelleyin**: Yinelenenler oluşturmak yerine mevcut kayıtlarla eşleştirerek güncelleyin. Bu durumda diğer benzersiz alanları eşlememeniz önerilir: Yalnızca tek bir benzersiz alanı eşlemek daha sorunsuz bir içe aktarma sağlar.
+
+<Note>Bir `id` sağlarsanız, UUID biçiminde olmalıdır (ör. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+### JSON Alanları
+
+Geçerli JSON biçimini kullanın:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Bağlantı Alanları
+
+Alan Adı alanlarına benzer:
+
+* Etiket ve URL sütunlarının ikisini de doldurun: **Links / Link URL** ve **Links / Link Label**
+* Tam URL biçimini kullanın: `https://example.com`
+* İkincil bağlantılar için **Links / Secondary Links** sütununu şu biçimde kullanın:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Çoklu Seçim Alanları
+
+**Görünen etiketleri** değil, **API adlarını** aşağıdaki biçimde kullanın:
+
+```
+["VALUE1","VALUE2"]
+```
+
+API adlarının nerede bulunacağını [buradan](#finding-api-names-for-select-fields) görün.
+
+<Note>Yeni seçim seçenekleri içe aktarma tarafından otomatik olarak oluşturulmaz. İçe aktarmadan önce **Ayarlar → Veri Modeli** içinde ekleyin.</Note>
+
+<Warning>
+**İçe aktarma üzerine yazar; ekleme yapmaz.**
+
+Bir kayıtta halihazırda `VALUE2` ve `VALUE3` seçiliyse ve siz `["VALUE1"]` içe aktarırsanız, içe aktarmadan sonra kayıtta yalnızca `VALUE1` bulunur. Önceki seçimler birleştirilmez, değiştirilir.
+</Warning>
+
+### Sayı Alanları
+
+* Yalnızca sayılar
+* Ondalıklar nokta kullanır: `1234.56`
+* Binlik ayırıcı kullanmayın
+
+### Telefon Alanları
+
+Telefon, birden çok sütundan oluşan ve **doldurulması gereken** iç içe bir alandır
+
+* **Phones / Primary Phone Number**: Telefon numarası (örn. `4159095555`)
+* **Phones / Primary Phone Country Code**: Ülke kodu (örn. `US`)
+* **Phones / Primary Phone Calling Code**: Arama kodu (örn. `+1`)
+
+### Puanlama Alanları
+
+Şu API adı biçimini kullanın: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
+
+### İlişki Alanları
+
+Lütfen şu özel makalemize bakın: [Nesneler Arasındaki İlişkileri İçe Aktarma](/l/tr/user-guide/data-migration/capabilities/import-relations)
+
+### Seçim Alanları
+
+**Görünen etiketi** değil, seçeneğin **API adını** kullanın:
+
+```
+VALUE1
+```
+
+API adlarının nerede bulunacağını [buradan](#finding-api-names-for-select-fields) görün.
+<Note>Yeni seçim seçenekleri içe aktarma tarafından otomatik olarak oluşturulmaz. İçe aktarmadan önce **Ayarlar → Veri Modeli** altında eklenmelidir.</Note>
+
+### Metin Alanları
+
+* Özel biçimlendirme gerekmez
+* Baştaki/sondaki boşluklar kırpılır
+
+## API Adlarını Bulma
+
+Önceden tanımlı seçeneklere sahip Select, Multi-Select ve Array alanları için, görünen etiketler değil, **API adlarını** kullanmalısınız.
+
+### API Adları Nasıl Bulunur
+
+1. **Ayarlar → Veri Modeli** bölümüne gidin
+2. Nesneyi ve alanı seçin
+3. **Gelişmiş mod**u etkinleştirin (ayarlar sayfasının sağ altındaki anahtarı kullanarak)
+4. Her seçenek için API adını görüntüleyin
+
+<VimeoEmbed videoId="1144910809" title="Video gösterimi" />

packages/twenty-docs/l/tr/user-guide/data-migration/capabilities/file-formats.mdx

@@ -0,0 +1,48 @@
+---
+title: Desteklenen Dosya Biçimleri
+description: Twenty'de veri içe aktarma için desteklenen dosya biçimleri.
+---
+
+## Desteklenen Biçimler
+
+Twenty, içe aktarma için üç dosya biçimini destekler:
+
+| Biçim            | Uzantı | Notlar              |
+| ---------------- | ------ | ------------------- |
+| **CSV**          | .csv   | Önerilen, en uyumlu |
+| **Excel**        | .xlsx  | Modern Excel biçimi |
+| **Excel (Eski)** | .xls   | Eski Excel biçimi   |
+
+## Dosya Gereksinimleri
+
+| Gereksinim       | Değer                                    |
+| ---------------- | ---------------------------------------- |
+| **Kodlama**      | UTF-8 önerilir                           |
+| **Kayıt sınırı** | Dosya başına 10.000 kayıt                |
+| **Yapı**         | İlk satır sütun başlıklarını içermelidir |
+| **İçerik**       | Dosya başına bir nesne türü              |
+
+## CSV için En İyi Uygulamalar
+
+* **Ayraç**: Virgül (`,`) veya noktalı virgül (`;`) kullanın
+* **Metin sınırlayıcısı**: Virgül içeren metinler için çift tırnak (`"`) kullanın
+* **Satır sonları**: Windows (CRLF) veya Unix (LF) her ikisi de desteklenir
+* **Boş değerler**: Hücreleri boş bırakın, "NULL" veya "N/A" kullanmayın
+
+## Excel için En İyi Uygulamalar
+
+Excel'den dışa aktarırken:
+
+* Formülleri kaldırın (yalnızca değerleri dışa aktarın)
+* Sondaki boş satırları silin
+* Birleştirilmiş hücre olmadığından emin olun
+* Yalnızca ilk sayfayı kullanın
+
+## Büyük Veri Kümeleri
+
+10.000 kayıttan büyük veri kümeleri için:
+
+* Birden fazla dosyaya bölün
+* Veya sınırsız kayıt için [API içe aktarma](/l/tr/user-guide/data-migration/how-tos/import-data-via-api) kullanın
+
+<Note>Çok büyük geçişler (100.000+ kayıt) için API, CSV içe aktarmadan önemli ölçüde daha hızlı ve daha güvenilirdir.</Note>

packages/twenty-docs/l/tr/user-guide/data-migration/capabilities/import-relations.mdx

@@ -0,0 +1,148 @@
+---
+title: Nesneler Arasındaki İlişkileri İçe Aktarma
+description: Kayıtlar arasındaki ilişkileri CSV ile içe aktarın.
+---
+
+## Genel Bakış
+
+Twenty, CSV içe aktarma sırasında nesneler arasındaki ilişkilerin içe aktarılmasını destekler. Bu, veri geçişinizin bir parçası olarak kayıtları birbirine bağlamanıza olanak tanır (ör. Kişileri Şirketlere iliştirme).
+
+<Note>**Şu anda içe aktarma için desteklenenler**: Her iki tarafta da tek bir nesne türüne işaret eden bire-çok ilişkiler (ör. Kişiler → Şirketler). Birden fazla nesne türüne işaret eden ilişkiler henüz içe/dışa aktarma için desteklenmiyor.</Note>
+
+## Twenty'de İlişkiler Nasıl Çalışır
+
+### Bire-Çok / Çoktan-Bire
+
+Twenty, bir kaydın birden çok başka kayda bağlandığı standart ilişkileri destekler:
+
+* **Bir Şirket → Birçok Kişi**: Bir şirketin birden fazla çalışanı olabilir, ancak her kişi bir şirkete aittir
+* **Bir Şirket → Birçok Fırsat**: Bir şirketin birden fazla fırsatı olabilir, ancak her fırsat bir şirkete aittir
+
+### Birden Fazla Nesne Türüne İşaret Edebilen İlişkiler
+
+Bazı ilişkiler farklı türdeki nesnelere bağlanabilir. Bu iki şekilde çalışır:
+
+**Kalıp 1: Farklı nesne türlerinden birçok kayıt, her biri bir kayda bağlanır**
+
+Birden çok Not veya Görevin her biri aynı anda birden fazla nesne türüne iliştirilebilir:
+
+* **Notlar** aynı anda bir Kişiye, bir Şirkete ve bir Fırsata bağlanabilir
+* **Görevler** aynı anda bir Kişiye, bir Şirkete ve bir Fırsata bağlanabilir
+
+Burada, Notlar/Görevler "çok" tarafındadır. Her biri, her nesne türü için bir kayda bağlanır.
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+**Kalıp 2: Farklı nesne türlerinden çok sayıda kayıttan bağlantı alan tek bir kayıt**
+
+Bir Proje, farklı nesne türleri genelinde birden fazla kayıttan bağlantı alabilir:
+
+* **Bir Proje** kendisine bağlı birçok Kişi, kendisine bağlı birçok Şirket ve kendisine iliştirilmiş birçok Not barındırabilir
+
+Burada Proje, "bir" tarafındadır. Farklı nesnelerden birden çok kayıt aynı Projeye bağlanabilir.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**İçe/Dışa Aktarma sınırlaması**: Birden fazla nesne türüne işaret eden ilişkiler (ör. Notlar → Kişiler/Şirketler/Fırsatlar) CSV içe aktarma veya dışa aktarmada **henüz desteklenmiyor**.
+
+* **İçe aktarma**: Her iki tarafta da tek bir nesne türüne işaret eden bire-çok ilişkiler içe aktarılabilir
+* **Dışa aktarma**: Birden fazla nesne türüne işaret eden ilişkilere ait sütunlar şu anda boş bırakılır
+
+Bu özellik yol haritamızda.
+</Warning>
+
+### Bugün Neler Desteklenmiyor
+
+**Çoktan-Çoka ilişkiler** henüz mevcut değil. Örneğin, şu anda aşağıdaki gibi bir ilişki oluşturamazsınız:
+
+* Birçok Kişi birçok Projeye bağlıdır
+
+<Note>Çoktan-Çoka ilişkiler 2026 H2 için planlanıyor.</Note>
+
+## İçe Aktarma Sırasında Kayıtları Bağlama
+
+<Note>**Hatırlatma**: Yalnızca her iki tarafta da tek bir nesne türüne işaret eden bire-çok ilişkiler içe aktarılabilir (ör. Kişiler → Şirketler). Birden fazla nesne türüne işaret eden ilişkiler (ör. Notlar → Kişiler/Şirketler/Fırsatlar) henüz desteklenmiyor.</Note>
+
+### Adım 1: "Bir" ve "Çok" Tarafları Belirleyin
+
+Önce, ilişkinin "bir" tarafında hangi nesnenin, "çok" tarafında hangi nesnenin olduğunu belirleyin.
+
+**Örnek**:
+
+* **Şirket** "bir" tarafıdır (bir şirketin birçok çalışanı vardır)
+* **Kişiler** "çok" tarafıdır (her kişi bir şirkete aittir)
+
+### Adım 2: "Bir" Tarafındaki Kayıtların Mevcut Olduğundan Emin Olun
+
+"Çok" tarafını içe aktarmadan önce, "bir" tarafındaki kayıtlar Twenty'de zaten mevcut olmalıdır.
+
+* Önce "bir" tarafındaki kayıtları içe aktarın veya oluşturun (ör. Şirketler)
+* Benzersiz tanımlayıcılarını doğrulayın. Bu şu olabilir:
+  * `id` (Twenty'nin UUID'si)
+  * Benzersiz olarak ayarlanmış bir alan (ör. Şirketler için `domain` veya önceki sisteminizden bir dış kimlik)
+
+<Warning>Var olmayan bir kayda referans verilirse içe aktarma başarısız olur.</Warning>
+
+### Adım 3: CSV Dosyanızı Hazırlayın
+
+"Çok" tarafındaki CSV dosyanıza, "bir" tarafındaki kayda referans veren bir sütun ekleyin.
+
+**Örnek**: Şirketlere bağlanan bir Kişiler CSV dosyası için:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Önemli**:
+
+* Değer, Şirket kaydındaki benzersiz alanla **tam olarak eşleşmelidir**
+* Alan adları için **Alan Adı URL'si**ni (ör. `https://acme.com`) kullanın, Alan Adı Etiketini değil
+* Her ilişki için yalnızca **bir** benzersiz tanımlayıcıyı eşleyin: bu, daha sorunsuz bir içe aktarma sağlar
+
+### Adım 4: İlişki Alanının Mevcut Olduğundan Emin Olun
+
+Dosyanızı yüklemeden önce, nesneleriniz arasında ilişki alanının mevcut olduğundan emin olun.
+
+Eğer mevcut değilse:
+
+1. **Ayarlar → Veri Modeli** bölümüne gidin
+2. Nesnenizi seçin (ör. Kişiler)
+3. Hedef nesneyi işaret eden bir ilişki alanı oluşturun (ör. Şirket)
+
+### Adım 5: İlişkiyi Yükleyin ve Eşleyin
+
+1. CSV dosyanızı içe aktarma arayüzü üzerinden yükleyin
+2. Alan eşleme adımında, ilişki sütununuzu bulun (ör. `companyDomain`)
+3. Bunu ilişki alanına eşleyin (ör. Şirket)
+4. Twenty, her kaydı otomatik olarak eşleşen ana kayda bağlar
+
+### İlişkiler İçin Kullanılabilir Benzersiz Alanlar
+
+| Nesne                               | Kullanılabilir Benzersiz Alanlar                      |
+| ----------------------------------- | ----------------------------------------------------- |
+| **Şirketler**                       | `id`, `domain`, herhangi bir özel benzersiz alan      |
+| **Kişiler**                         | `id`, `email`, herhangi bir özel benzersiz alan       |
+| **İş Alanı Üyeleri**                | `id`, `email` (isim değil)                            |
+| **Diğer standart ve özel nesneler** | `id`, benzersiz olarak işaretlenmiş herhangi bir alan |
+
+<Note>**Çalışma Alanı Üyelerine Bağlama**: İlişki Çalışma Alanı Üyelerini işaret ediyorsa (Twenty'ye giriş yapan ekibiniz), onlara adlarıyla değil, **e-posta adresleriyle** referans verin.</Note>
+
+<Note>Tablolarda okunabilir ve bakımı kolay olduğundan, Şirketler için `domain` ve Kişiler için `email` kullanmanızı öneririz.</Note>
+
+<Note>**Hatırlatma**: Yumuşak silinmiş kayıtlar (Komut Menüsü → Silinen kayıtları görüntüle altında görünür) benzersizlik ölçütlerine dahildir. Silinmiş bir kayıtla aynı benzersiz değere sahip bir kaydı içe aktarırsanız, silinmiş kayıt geri yüklenir. Daha fazla bilgi için [Benzersizlik Kısıtları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints) bölümüne bakın.</Note>
+
+## İçe Aktarma Sırası Kuralı
+
+<Warning>
+**Her zaman önce "bir" tarafı içe aktarın!**
+
+1. Önce **Şirketler** (bağımlılık yok)
+2. İkinci olarak **Kişiler** (Şirketlere bağlı)
+3. Üçüncü olarak **Fırsatlar** (Şirketlere/Kişilere bağlı)
+4. **Özel nesneler** (bağımlılıklarına uyarak)
+
+Ona referans verebilmeden önce ana kayıt mevcut olmalıdır.
+</Warning>

packages/twenty-docs/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints.mdx

@@ -0,0 +1,72 @@
+---
+title: Benzersizlik Kısıtlamaları
+description: Twenty'nin içe aktarma sırasında veri benzersizliğini nasıl sağladığı.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Genel Bakış
+
+Yinelenen kayıtları önlemek ve veri bütünlüğünü sağlamak için Twenty bazı alanlarda benzersizliği uygular. Başarılı içe aktarmalar için bu kısıtlamaları anlamak kritiktir.
+
+## Varsayılan Benzersiz Alanlar
+
+| Nesne             | Benzersiz Alanlar                 |
+| ----------------- | --------------------------------- |
+| **Kişiler**       | `id`, `email`                     |
+| **Şirketler**     | `id`, `domain`                    |
+| **Özel nesneler** | Yalnızca `id` (varsayılan olarak) |
+
+<Note>`id` alanı Twenty'nin dahili tanımlayıcısıdır, her kayıt için otomatik olarak oluşturulur. UUID biçimini kullanır (ör. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+## Özel Benzersiz Alanlar
+
+Ek benzersiz alanları **Ayarlar → Veri Modeli** altında tanımlayabilirsiniz:
+
+1. **Ayarlar → Veri Modeli** bölümüne gidin
+2. Nesneyi seçin
+3. Bir alana tıklayın
+4. Alan ayarlarında **Unique** özelliğini etkinleştirin
+
+### Özel Benzersiz Alanlar için Kullanım Senaryoları
+
+* **Harici ID'ler**: Diğer sistemlerden gelen ID'leri saklayın (Salesforce ID, HubSpot ID)
+* **İş tanımlayıcıları**: Çalışan numaraları, müşteri kodları
+* **Alternatif iletişim bilgileri**: LinkedIn profili, telefon numarası
+
+<Note>`id` alan adı Twenty'nin dahili ID'si için ayrılmıştır. Harici tanımlayıcılar için `externalId` veya `legacyId` gibi farklı bir ad kullanın.</Note>
+
+## İçe Aktarma Davranışı
+
+### Yeni Kayıtlar Oluşturma
+
+Benzersiz alan değeri mevcut değilse yeni bir kayıt oluşturulur.
+
+### Mevcut Kayıtları Güncelleme
+
+Benzersiz alan değeri mevcut bir kayıtla eşleşirse, o kayıt yeni verilerle **güncellenir**.
+<Warning>**Mevcut kayıtları güncellemek** için, **yalnızca bir benzersiz alanı** eşleştirmeniz önerilir.</Warning>
+
+### Yumuşak Silinmiş Kayıtlar
+
+<Warning>
+**Silinmiş kayıtlar benzersizliğe dahildir.**
+
+Yumuşak silinmiş kayıtlar (Komut Menüsü → Silinen kayıtları görüntüle altında görünür) benzersizlik kontrollerine dahildir. Silinmiş bir kayıtla aynı benzersiz değere sahip bir kaydı içe aktarırsanız, silinmiş kayıt yeni verilerle **geri yüklenir**.
+</Warning>
+
+## İçe Aktarma Sırasında Yinelenenleri Tespit Etme
+
+Doğrulama aşamasında:
+
+* Dosyanızdaki yinelenenler sarı renkle vurgulanır
+* İçe aktarmayı başlatmadan önce yinelenen satırları arayüzden düzenleyebilir veya kaldırabilirsiniz
+
+<VimeoEmbed videoId="1145246326" title="Video gösterimi" />
+
+## En İyi Uygulamalar
+
+1. İçe aktarmadan önce dosyanızdan **yinelenenleri kaldırın**
+2. İçe aktarmadan önce Twenty'de **mevcut kayıtları kontrol edin**
+3. Diğer sistemlerden geçiş yaparken **harici ID'leri kullanın**
+4. Mevcut kayıtları güncellemek istiyorsanız **benzersiz alanları dahil edin**

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/export-faq.mdx

@@ -0,0 +1,32 @@
+---
+title: Veri Dışa Aktarma SSS
+description: Veri dışa aktarmayla ilgili sıkça sorulan sorular.
+---
+
+<AccordionGroup>
+<Accordion title="İptalden önce, özel nesneler, özel alanlar, ilişkiler, notlar, görevler, fırsatlar, ekler, iş akışları, izinler ve denetim geçmişi de dahil olmak üzere tüm çalışma alanı verilerini dışa aktarabilir miyiz?">
+Çalışma alanı verileri, bazı istisnalarla birlikte iptalden önce dışa aktarılabilir: panolar, iş akışları ve izinler manuel olarak aktarılmalıdır; denetim günlükleri aktarılamaz.
+</Accordion>
+<Accordion title="Hangi öğeler şu anda dışa aktarılamaz veya taşınamaz?">
+Çoğu öğe, bazı istisnalarla dışa aktarılabilir veya taşınabilir:
+* iş akışları, panolar ve tüm ayarlar (API anahtarları, webhook'lar, denetim günlükleri, kullanıcı ayarları vb.) manuel olarak taşınmalıdır
+* Uygulama tarafından oluşturulan nesneler ve alanlar, söz konusu uygulama farklı bir çalışma alanına kurularak taşınabilir. Manuel olarak taşınmamalıdır
+* İş akışı sürümleri ve iş akışı çalıştırmaları gibi bazı kayıtlar hiç aktarılamaz ve kaybolmaları beklenir
+* Bazı nesneler, örneğin mesaj ve takvimle ilgili nesneler, bir hesap bağlandığında oluşturuldukları ve periyodik olarak eşitlendikleri için dışa aktarılmamalıdır. Hesabınızı bağladığınızda tekrar eşitleneceklerdir (ilgili hesaba erişiminiz olduğu sürece; eğer bu, şirketinizden ayrılan bir ekip üyesinin hesabıysa, bu durumda bu mesajlar dışa aktarılmalıdır, aksi takdirde kaybolacaklardır)
+</Accordion>
+<Accordion title="Resmi bir buluttan kendi barındırılan ortama geçiş prosedürü veya destekli bir geçiş hizmeti var mı?">
+Şu an itibarıyla, buluttan kendi barındırılan ortama resmi bir geçiş prosedürü yoktur. Genel fikir şudur:
+* önce, uygulamaya ait nesneleri ve alanları tanıtmak için uygulamaları yükleyin
+* kullanıcılar tarafından eklenen özel nesneleri ve alanları çoğaltın
+* Tüm verileri bir çalışma alanından diğerine taşımak için API anahtarları veya yapay zeka araçlarıyla bir komut dosyası kullanın
+* taşınamayan tüm nesneler manuel olarak aktarılmalıdır
+
+Lütfen birkaç noktaya dikkat edin:
+* İstek/dakika sınırına ulaşmadan önce Pro planda dakikada en fazla 50, Organization planda dakikada en fazla 100 istek gönderebilirsiniz
+* her API isteğinde en fazla 200 kayıt olabilir
+* Created by, Timeline activities ve Updated by gibi alanlardaki bazı veriler içe aktarma sırasında kaybolacak ve sistem tarafından üzerine yazılacak.
+</Accordion>
+<Accordion title="Dışa aktarılan dosyalar açık ve belgelenmiş formatlarda mı sağlanıyor?">
+Arayüzde dışa aktarılan dosyalar Excel formatındadır ve tüm API istekleri JSON formatında kaydedilebilir.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/export-your-data.mdx

@@ -0,0 +1,209 @@
+---
+title: Verilerinizi Dışa Aktarın
+description: Twenty'den veri dışa aktarmaya yönelik eksiksiz, adım adım kılavuz.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Genel Bakış
+
+Yedekleme, raporlama veya geçiş için çalışma alanı verilerinizi CSV'ye dışa aktarın.
+
+**Kullanım alanları:**
+
+* **Düzenli yedeklemeler** — verilerinizin kopyalarını saklayın
+* **Harici raporlama** — verileri Excel, Google Sheets veya BI araçlarında analiz edin
+* **Geçiş** — verileri başka bir sisteme taşıyın
+* **Toplu güncellemeler** — kayıtları güncellemek için dışa aktarın, düzenleyin ve yeniden içe aktarın
+
+## Bilmeniz Gerekenler
+
+### Dışa Aktarma Sınırları
+
+* Dışa aktarma başına **en fazla 20.000 kayıt**
+* Yalnızca **görünür sütunlar** dışa aktarılır
+* Yalnızca **filtrelenmiş kayıtlar** dışa aktarılır (mevcut görünümünüze göre)
+
+<Note>Daha büyük dışa aktarmalar için (20.000+ kayıt), toplu halde dışa aktarmak üzere filtreleri kullanın veya [API](/l/tr/developers/extend/api)'yi kullanın.</Note>
+
+### İzinler
+
+Verileri dışa aktarmak için **"Export CSV"** iznine ihtiyacınız var. Bu seçeneğiniz yoksa çalışma alanı yöneticinizle iletişime geçin.
+
+## Adım 1: Nesneye gidin
+
+Dışa aktarmak istediğiniz nesneye gidin:
+
+* **People** — kişiler için
+* **Companies** — kuruluşlar için
+* **Opportunities** — anlaşmalar için
+* **Özel nesneler** — oluşturduğunuz herhangi bir nesne
+
+## Adım 2: Görünümünüzü yapılandırın
+
+**Önemli:** Dışa aktarma, yalnızca mevcut görünümünüzde görünenleri içerir.
+
+### Sütun Ekle/Kaldır
+
+1. **Options → Fields**'a tıklayın (veya sütunların sonundaki **+** simgesine)
+2. Dışa aktarmak istediğiniz alanları işaretleyin
+3. Gerek duymadığınız alanların işaretini kaldırın
+
+### Kayıtları Filtrele (İsteğe bağlı)
+
+Yalnızca verilerin bir alt kümesine ihtiyacınız varsa:
+
+1. **Filter**'a tıklayın
+2. Filtre koşulları ekleyin (ör. "Created date > January 1, 2024")
+3. Yalnızca eşleşen kayıtlar dışa aktarılır
+
+### Kayıtları Sırala (İsteğe bağlı)
+
+1. Sıralamak için bir sütun başlığına tıklayın
+2. Dışa aktarma, sıralama düzeninizi takip eder
+
+<Note>**Dışa aktarma için özel bir görünüm oluşturun.** Her seferinde yeniden yapılandırmamak için özellikle dışa aktarmaya göre yapılandırılmış bir görünümü kaydedin.</Note>
+
+## Adım 3: Verileri dışa aktarın
+
+1. Tablonun sağ üst köşesindeki **⋮** simgesine tıklayın
+2. **Export view**'i seçin
+3. CSV dosyasının nereye kaydedileceğini seçin
+4. İndirmenin tamamlanmasını bekleyin
+
+## Neler Dışa Aktarılır
+
+| Dahil                               | Dahil Değil                      |
+| ----------------------------------- | -------------------------------- |
+| Tüm görünür sütunlar                | Gizli sütunlar                   |
+| Mevcut filtrelerle eşleşen kayıtlar | Filtreyle hariç tutulan kayıtlar |
+| Özel alan değerleri                 | Görünümde olmayan alanlar        |
+| Kayıt ID'leri                       | Dosya ekleri                     |
+| İlişki ID'leri                      | Görseller                        |
+
+### İlişki Alanları
+
+İlişki ID'leri yalnızca bir ilişkinin **"çok" tarafında** dışa aktarılır:
+
+* **People dışa aktarması**, `companyId` sütununu içerir (People → Company ilişkisi)
+* **Companies dışa aktarması**, `peopleIds` içermez (Companies ilişkide "tek" taraftır)
+
+Bu, Company bağlantısını koruyarak yeniden içe aktarmak için People dışa aktarmasını kullanabileceğiniz anlamına gelir; ancak ilişkileri yeniden oluşturmak için Companies'ten sonra People'ı yeniden içe aktarmanız gerekir.
+
+## Belirli Amaçlar İçin Dışa Aktarma
+
+### Yedeklemeler İçin
+
+1. **Tüm alanların** görünür olduğu bir görünüm oluşturun
+2. Tüm kayıtları dahil etmek için tüm filtreleri kaldırın
+3. Her nesne türünü ayrı ayrı dışa aktarın
+4. Dışa aktarmaları güvenli bir konumda saklayın
+5. Tekrarlayan bir hatırlatıcı ayarlayın (haftalık/aylık)
+
+### Harici Raporlama İçin
+
+1. Analiz için yalnızca ihtiyaç duyduğunuz alanları dahil edin
+2. İlgili verilere odaklanmak için filtreler uygulayın
+3. Analiz edeceğiniz alana göre sıralamayı düşünün
+
+### Toplu Güncellemeler İçin
+
+1. Güncellemek istediğiniz kayıtları dışa aktarın
+2. Benzersiz tanımlayıcıyı dahil edin (`email`, `domain` veya `id`)
+3. Dışa aktarılan dosyayı düzenleyin
+4. Kayıtları güncellemek için yeniden içe aktarın
+   Bkz: [Mevcut Kayıtlar Nasıl Güncellenir](/l/tr/user-guide/data-migration/how-tos/update-existing-records-via-import)
+
+### Geçiş İçin
+
+Başka bir sisteme geçiş yapmak için dışa aktarıyorsanız:
+
+1. **Her nesneyi ayrı ayrı dışa aktarın** — People, Companies, Opportunities, vb.
+2. **ID alanlarını dahil edin** — bunlar ilişkilerin korunmasına yardımcı olur
+3. **Alan eşlemelerini belgeleyin** — Twenty alanlarının hedef sisteminize nasıl eşlendiğini not edin
+
+## Büyük Veri Kümelerini Yönetme (20.000+ Kayıt)
+
+Dışa aktarma sınırı 20.000 kayıttır. Daha büyük veri kümeleri için:
+
+### Seçenek 1: Partiler halinde dışa aktarma
+
+1. Bir filtre ekleyin (ör. "Created date" aralıkları)
+2. İlk partiyi dışa aktarın
+3. Filtreyi değiştirin
+4. Sonraki partiyi dışa aktarın
+5. Dosyaları hesap tablonuzda birleştirin
+
+**Partiler için örnek filtreler:**
+
+* Tarih aralığına göre (Ocak, Şubat, Mart...)
+* Sahibine göre (Ekip üyesi A, Ekip üyesi B...)
+* Duruma göre (Aktif, Pasif...)
+
+### Seçenek 2: API'yi kullanın
+
+API'nin kayıt sınırı yoktur:
+
+1. API anahtarınızı **Settings → Developers** bölümünden alın
+2. Kayıtları sorgulamak için GraphQL API'sini kullanın
+3. Sonuçları uygulamanızda işleyin
+
+Bkz: [API Belgeleri](/l/tr/developers/extend/api)
+
+## İpuçları ve En İyi Uygulamalar
+
+### Dışa Aktarma Görünümleri Oluşturun
+
+Özellikle dışa aktarma için yapılandırılmış görünümleri kaydedin:
+
+1. Sütunları ve filtreleri yapılandırın
+2. **View options** → **Save as new view** seçeneğine tıklayın
+3. Adını "Export - [Purpose]" olarak verin
+
+### Dışa Aktarmalarınızı Güvenceye Alın
+
+Dışa aktarılan dosyalar hassas veriler içerebilir:
+
+* Güvenli konumlarda depolayın
+* Artık gerekmediğinde eski dışa aktarmaları silin
+* Dışa aktarma dosyalarını paylaşırken dikkatli olun
+
+### Dışa Aktarmadan Önce Kontrol Edin
+
+<Check>Doğru sütunlar görünür</Check>
+<Check>Filtreler doğru ayarlanmış (veya tam dışa aktarma için kaldırılmış)</Check>
+<Check>Dışa aktarma iznine sahipsiniz</Check>
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="Dışa aktarmamda bazı sütunlar neden eksik?">
+    Yalnızca görünür sütunlar dışa aktarılır. Dışa aktarmadan önce ihtiyaç duyduğunuz sütunları **Options → Fields** üzerinden ekleyin.
+  </Accordion>
+
+  <Accordion title="Dışa aktarmamda neden tüm kayıtlar yok?">
+    Filtrelerinizi kontrol edin. Dışa aktarma, yalnızca mevcut görünüm filtrelerinizle eşleşen kayıtları içerir. Tüm kayıtları dışa aktarmak için filtreleri kaldırın.
+  </Accordion>
+
+  <Accordion title="20.000'den fazla kayıt dışa aktarabilir miyim?">
+    Tek bir dışa aktarmada mümkün değil. Partiler halinde dışa aktarmak için filtreleri kullanın veya daha büyük veri kümeleri için API'yi kullanın.
+  </Accordion>
+
+  <Accordion title="Dışa aktarma dosyasının biçimi nedir?">
+    CSV (Virgülle Ayrılmış Değerler). Excel, Google Sheets veya herhangi bir hesap tablosu uygulamasında açılır.
+  </Accordion>
+
+  <Accordion title="İlişki ID'leri dahil mi?">
+    Evet, ancak yalnızca ilişkilerin "çok" tarafında. Örneğin, bir People dışa aktarması `companyId` içerir, ancak bir Companies dışa aktarması people ID'lerini içermez.
+  </Accordion>
+
+  <Accordion title="Dışa aktarmaları otomatikleştirebilir miyim?">
+    Doğrudan UI üzerinden değil. Otomatik dışa aktarma iş akışları oluşturmak için API'yi kullanın.
+  </Accordion>
+</AccordionGroup>
+
+## Sonraki Adımlar
+
+* [Mevcut Kayıtlar Nasıl Güncellenir](/l/tr/user-guide/data-migration/how-tos/update-existing-records-via-import) — dışa aktarmanızı düzenleyin ve yeniden içe aktarın
+* [API ile Veri Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-data-via-api) — büyük veri kümeleri için
+* [API Belgeleri](/l/tr/developers/extend/api) — özel dışa aktarma iş akışları oluşturun

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/fix-import-errors.mdx

@@ -0,0 +1,430 @@
+---
+title: İçe aktarma hatalarını düzeltin
+description: CSV içe aktarma hatalarını çözmeye yönelik eksiksiz bir sorun giderme kılavuzu.
+---
+
+## 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
+
+<Note>**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.</Note>
+
+## 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**
+
+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
+
+<Note>
+**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.
+</Note>
+
+### 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
+
+<Warning>
+**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.
+</Warning>
+
+Daha fazla ayrıntı için: [Benzersizlik Kısıtlamaları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints)
+
+---
+
+## 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)
+```
+
+<Note>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.</Note>
+
+#### Tarih
+
+**Sorun:** Tanınmayan tarih biçimi
+**Çözüm:** Dosya genelinde tutarlı bir şekilde `YYYY-MM-DD` biçimini kullanın
+
+```
+✓ 2024-03-15        (YYYY-MM-DD)
+❌ 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 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 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 / Amount**   | `1234.56` |
+| **Amount / Currency** | `USD`     |
+
+#### 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](/l/tr/user-guide/data-migration/capabilities/field-mapping)
+
+---
+
+## 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.
+
+<Note>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.</Note>
+
+### 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
+
+<Warning>
+**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.
+</Warning>
+
+Daha fazla ayrıntı için: [İlişkileri İçe Aktarma](/l/tr/user-guide/data-migration/capabilities/import-relations)
+
+---
+
+## 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](/l/tr/user-guide/data-migration/how-tos/import-data-via-api)
+
+---
+
+## 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
+
+<Note>CSV içe aktarma alanları değil, kayıtları oluşturur. İçe aktarmadan önce tüm alanlar mevcut olmalıdır.</Note>
+
+---
+
+## 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
+
+<Warning>
+**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.
+</Warning>
+
+---
+
+## İçe Aktarma Öncesi Kontrol Listesi
+
+İçe aktarmadan önce bunları kontrol ederek hatalardan kaçının:
+
+### Dosya Gereksinimleri
+
+<Check>Dosya CSV, XLSX veya XLS biçiminde</Check>
+<Check>Dosyada 10.000'den az kayıt var</Check>
+<Check>Dosya UTF-8 kodlaması kullanıyor</Check>
+
+### Veri Kalitesi
+
+<Check>Yinelenen e-postalar yok (Kişiler için)</Check>
+<Check>Yinelenen alan adları yok (Şirketler için)</Check>
+<Check>Tüm tarihler tutarlı biçim kullanır</Check>
+<Check>Tüm alan adları `https://domain.com` biçimini kullanır</Check>
+
+### Alan Biçimleri
+
+<Check>Boolean alanlar `TRUE` veya `FALSE` kullanır (büyük harf)</Check>
+<Check>Seçim alanları, görünen etiketler değil API adlarını kullanır</Check>
+<Check>Telefon alanlarında gerekli tüm sütunlar vardır</Check>
+<Check>Para birimi alanlarında hem Amount hem de Currency Code bulunur</Check>
+
+### İlişkiler
+
+<Check>Ana kayıtlar, alt kayıtlardan önce içe aktarılır</Check>
+<Check>İlişki sütunları mevcut kayıtlara referans verir</Check>
+<Check>Alan adı biçimi, Twenty'nin biçimiyle birebir eşleşir</Check>
+
+### Veri modeli
+
+<Check>Tüm özel alanlar Ayarlar → Veri Modeli'nde mevcut</Check>
+<Check>Seçim seçenekleri içe aktarmadan önce mevcut</Check>
+
+---
+
+## 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:**
+   * [Alan Eşleme](/l/tr/user-guide/data-migration/capabilities/field-mapping)
+   * [Benzersizlik Kısıtlamaları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints)
+   * [İlişkileri İçe Aktarma](/l/tr/user-guide/data-migration/capabilities/import-relations)
+   * [Hata İşleme](/l/tr/user-guide/data-migration/capabilities/error-handling)

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/import-companies-via-csv.mdx

@@ -0,0 +1,201 @@
+---
+title: CSV ile Şirketleri İçe Aktarın
+description: Twenty'ye şirketleri içe aktarmaya yönelik eksiksiz, adım adım kılavuz.
+---
+
+## Genel Bakış
+
+Bu kılavuz, şirketlerinizi Twenty'ye içe aktarma sürecinde size yol gösterir. **Önce Şirketler içe aktarılmalıdır** çünkü Kişiler ve Fırsatlar Şirketlerle ilişkilendirilir.
+
+## Başlamadan Önce
+
+### Ön Koşul Kontrol Listesi
+
+<Check>
+Dosyanız CSV, XLSX veya XLS biçiminde
+</Check>
+
+<Check>
+Dosyada 10.000'den az kayıt var
+</Check>
+
+<Check>
+Dosyanızda yinelenen alan adı yok
+</Check>
+
+<Check>
+Tüm özel alanlar **Ayarlar → Veri Modeli**'nde mevcut
+</Check>
+
+<Note>
+10.000'den fazla şirketi içe aktarmanız mı gerekiyor? Birden çok dosyaya bölün veya [API ile içe aktarma](/l/tr/user-guide/data-migration/how-tos/import-data-via-api) kullanın.
+</Note>
+
+## Adım 1: Şirket Verinizi Hazırlayın
+
+### Zorunlu ve Önerilen Alanlar
+
+| Alan             | Zorunlu mu?  | Biçim                | Notlar                        |
+| ---------------- | ------------ | -------------------- | ----------------------------- |
+| **Ad**           | Önerilen     | Metin                | Şirketin görünen adı          |
+| **Alan Adı**     | Önerilen     | `https://domain.com` | Benzersiz tanımlayıcı         |
+| **Adres**        | İsteğe bağlı | Birden çok sütun     | Aşağıya bakın                 |
+| **Çalışanlar**   | İsteğe bağlı | Sayı                 | Çalışan sayısı                |
+| **Özel Alanlar** | İsteğe bağlı | Değişir              | Veri Modeli'nde mevcut olmalı |
+
+### Alan Adı Biçimi
+
+<Warning>
+**Alan adları için `https://domain.com` biçimini kullanın.**
+
+Bu, Şirketler e-posta/takvim eşitlemesinden otomatik olarak oluşturulduğunda kullanılan biçimle eşleşir ve daha sonra yinelenmeleri önler.
+</Warning>
+
+**Alan adı sütunları:**
+
+* **Domain / Domain Label**: `acme.com`
+* **Domain / Domain URL**: `https://acme.com`
+
+### Adres Biçimi
+
+Adres, birden çok sütuna sahip iç içe bir alandır:
+
+```
+Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
+123 Main Street,San Francisco,CA,USA,94105
+```
+
+### Örnek CSV Yapısı
+
+```csv
+name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
+Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
+Widget Co,https://widgets.co,widgets.co,New York,USA,50
+```
+
+<Note>
+**İpucu:** İçe aktarma sırasında **Örnek dosyayı indir**'i tıklayın ve Twenty'nin beklediği tam sütun adlarını görün.
+</Note>
+
+## Adım 2: İçe Aktarma Özelliğine Erişin
+
+**Seçenek 1: Şirketler görünümünden**
+
+1. Sol kenar çubuğunda **Şirketler**'e gidin
+2. Sağ üstteki **⋮** simgesine tıklayın
+3. **Kayıtları İçe Aktar**'ı seçin
+
+**Seçenek 2: Komut Menüsünü kullanma**
+
+1. Mac'te `Cmd + K` veya Windows'ta `Ctrl + K` tuşlarına basın
+2. "import" yazın
+3. **Kayıtları İçe Aktar**'ı seçin
+4. **Şirketler**'i seçin
+
+## Adım 3: Dosyanızı Yükleyin
+
+1. **Dosya seç**'e tıklayın
+2. CSV, XLSX veya XLS dosyanızı seçin
+3. Twenty'nin dosyanızı analiz etmesini bekleyin
+
+## Adım 4: Sütunlarınızı Eşleyin
+
+Twenty, sütunlarınızı alanlarla eşleştirmeyi otomatik olarak dener. Gözden geçirin ve ayarlayın:
+
+1. **Otomatik eşlemeleri kontrol edin** — doğru olduklarını doğrulayın
+2. **Yanlış eşlemeleri düzeltin** — doğru alanı seçmek için açılır menüye tıklayın
+3. **Sütunları atlayın** — içe aktarmak istemediğiniz sütunlar için **Do not map** seçeneğini seçin
+
+### Önemli Eşleme Kuralları
+
+* **Alan Adı**: **Domain / Domain URL**'ye eşleyin (Domain Label değil)
+* **Adres**: Her bir bölümü ilgili özel sütununa eşleyin (Şehir, Eyalet vb.)
+* **Seçim alanları**: Değerler mevcut seçeneklerle eşleşmelidir (yoksa bir sonraki adımda eşleyeceksiniz)
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{genişlik:'100%'}} />
+
+## Adım 5: Seçim Alanı Değerlerini Eşleyin
+
+Seçim veya Çoklu Seçim alanlarınız varsa:
+
+1. Twenty, değerlerinizi mevcut seçeneklerin yanında gösterir
+2. Dosyanızdaki her değeri bir Twenty seçeneğiyle eşleştirin
+3. Gerekiyorsa yeni seçenekler oluşturun
+
+<Note>
+Seçim alanı seçenekleri, görüntü etiketlerini değil, **API adlarını** kullanır. API adlarını görmek için **Settings → Data Model** → **Advanced mode**'u etkinleştirin.
+</Note>
+
+## Adım 6: Hataları Gözden Geçirin ve Düzeltin
+
+İçe aktarmayı tamamlamadan önce Twenty verilerinizi doğrular:
+
+1. **Next Steps**'e tıklayın
+2. Hata içeren satırlar **sarı** renkle vurgulanır
+3. **Hataları doğrudan düzeltin** — bir hücreye tıklayın ve değeri düzenleyin
+4. **Sorunlu satırları kaldırın** — o satırı atlamak için X'e tıklayın
+
+### Yaygın Şirket İçe Aktarma Hataları
+
+| Hata                         | Neden                           | Çözüm                                           |
+| ---------------------------- | ------------------------------- | ----------------------------------------------- |
+| **Yinelenen alan adı**       | Alan adı Twenty'de zaten mevcut | Dosyadan kaldırın veya mevcut kaydı güncelleyin |
+| **Geçersiz alan adı biçimi** | Yanlış biçim                    | `https://domain.com` kullanın                   |
+| **Gerekli alan eksik**       | Gerekli alan boş                | Değeri doldurun veya satırı kaldırın            |
+
+## Adım 7: İçe Aktarmayı Tamamlayın
+
+1. İçe aktarma özetini gözden geçirin
+2. İçe aktarmak için **Onayla**'ya tıklayın
+3. İçe aktarmanın tamamlanmasını bekleyin
+4. Birkaç kaydı kontrol ederek doğrulayın
+
+## Şirketleri İçe Aktardıktan Sonra
+
+Artık Şirketlere bağlanan kayıtları içe aktarabilirsiniz:
+
+1. **[Kişileri İçe Aktarın](/l/tr/user-guide/data-migration/how-tos/import-contacts-via-csv)** — bunları alan adı kullanarak Şirketlere bağlayın
+2. **Fırsatları içe aktarın** — bunları Şirketlerle ilişkilendirin
+3. **İçe aktarmayı doğrulayın** — verilerin doğru olduğundan emin olmak için birkaç kaydı rastgele kontrol edin
+
+## Mevcut Şirketleri Güncelleme
+
+Yeni şirketler oluşturmak yerine şirketleri güncellemek için:
+
+1. Dosyanıza `domain` veya `id` sütununu ekleyin
+2. Twenty, kayıtları bu benzersiz tanımlayıcıya göre eşleştirir
+3. Mevcut şirketler güncellenir; yenileri oluşturulur
+
+Ayrıntılar için [Mevcut Kayıtlar Nasıl Güncellenir](/l/tr/user-guide/data-migration/how-tos/update-existing-records-via-import) bölümüne bakın.
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="Neden iki Şirketin alan adı aynı olamaz?">
+    Alan adı, Twenty'de benzersiz bir tanımlayıcıdır. Bu, yinelenen şirketleri önler ve e-posta eşitlemesinin e-postaları doğru şirketle doğru şekilde ilişkilendirmesini sağlar.
+  </Accordion>
+
+  <Accordion title="Alan adı olmayan şirketlerim varsa ne yapmalıyım?">
+    Alan adını boş bırakabilirsiniz. Ancak, daha iyi veri kalitesi ve otomatik e-posta ilişkilendirmesi için mümkün olduğunda alan adlarını eklemenizi öneririz.
+  </Accordion>
+
+  <Accordion title="Kişilerle ilişkilendirilmeden şirketleri içe aktarabilir miyim?">
+    Evet! Önce şirketleri içe aktarabilir, ardından Kişileri içe aktarabilir ve şirketin etki alanını kullanarak bunları ilişkilendirebilirsiniz.
+  </Accordion>
+
+  <Accordion title="Zaten var olan bir etki alanını içe aktarırsam ne olur?">
+    Mevcut bir şirketle eşleşen bir benzersiz tanımlayıcı (etki alanı veya id) dahil ederseniz, Twenty yinelenen bir kayıt oluşturmak yerine o şirketi günceller.
+  </Accordion>
+
+  <Accordion title="'duplicate domain' hatalarını nasıl düzeltirim?">
+    Dosyanızdan yineleneni kaldırın ya da mevcut kaydı güncellemek için şirketin `id` değerini ekleyin.
+  </Accordion>
+</AccordionGroup>
+
+## Sorun Giderme
+
+Sorun mu yaşıyorsunuz? Şunları kontrol edin:
+
+* [İçe Aktarma Hataları Nasıl Düzeltilir](/l/tr/user-guide/data-migration/how-tos/fix-import-errors)
+* [Alan Eşleme Başvurusu](/l/tr/user-guide/data-migration/capabilities/field-mapping)
+* [Benzersizlik Kısıtlamaları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx

@@ -0,0 +1,242 @@
+---
+title: CSV ile Kişileri İçe Aktarın
+description: Twenty'ye kişileri içe aktarmaya yönelik eksiksiz, adım adım kılavuz.
+---
+
+## Genel Bakış
+
+Bu kılavuz, kişilerinizi (Kişiler) Twenty'ye içe aktarma sürecinde size yol gösterir.
+
+## Başlamadan Önce
+
+### Ön Koşul Kontrol Listesi
+
+<Check>
+Dosyanız CSV, XLSX veya XLS biçiminde
+</Check>
+
+<Check>
+Dosyada 10.000'den az kayıt var
+</Check>
+
+<Check>
+Dosyanızda yinelenen e-posta adresi yok
+</Check>
+
+<Check>
+**Şirketler önce içe aktarılmış** (Kişileri Şirketlere bağlayacaksanız)
+</Check>
+
+<Check>
+Tüm özel alanlar **Ayarlar → Veri Modeli**'nde mevcut
+</Check>
+
+<Warning>
+**Kişilerden Önce Şirketleri İçe Aktarın**
+
+Kişileri Şirketlere bağlamak istiyorsanız, önce Şirketleri içe aktarın. Şirkete referans verebilmeden önce şirketin mevcut olması gerekir.
+</Warning>
+
+## Adım 1: Kişi Verinizi Hazırlayın
+
+### Zorunlu ve Önerilen Alanlar
+
+| Alan             | Zorunlu mu?  | Biçim             | Notlar                        |
+| ---------------- | ------------ | ----------------- | ----------------------------- |
+| **E-posta**      | Önerilen     | `name@domain.com` | Benzersiz olmalı              |
+| **Ad**           | Önerilen     | Metin             |                               |
+| **Soyadı**       | Önerilen     | Metin             |                               |
+| **Şirket**       | İsteğe bağlı | Alan adı veya ID  | Mevcut bir Şirkete bağlanır   |
+| **Telefon**      | İsteğe bağlı | Birden çok sütun  | Aşağıya bakın                 |
+| **İş Unvanı**    | İsteğe bağlı | Metin             |                               |
+| **Özel Alanlar** | İsteğe bağlı | Değişir           | Veri Modeli'nde mevcut olmalı |
+
+### E-posta Biçimi
+
+* Geçerli e-posta biçiminde olmalıdır: `name@domain.com`
+* **Benzersiz olmalı** — dosyanızda veya Twenty'de yinelenen olmamalı
+* Ek e-postalar için **Emails / Additional Emails** sütununu kullanın:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Telefon Biçimi
+
+Telefon, birden çok sütun gerektiren **iç içe bir alan**dır:
+
+| Sütun                                   | Örnek        |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### Şirketlerle Bağlantı Kurma
+
+Şirketin benzersiz tanımlayıcısını içeren bir sütun ekleyin:
+
+| Sütun Adı       | Biçim      | Örnek                                  |
+| --------------- | ---------- | -------------------------------------- |
+| `companyDomain` | URL biçimi | `https://acme.com`                     |
+| `companyId`     | UUID       | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Note>
+**Alan Adı URL biçimini kullanın** (`https://acme.com`), etiketi değil. Bu, Şirketlerin Twenty'de nasıl saklandığıyla uyumludur.
+</Note>
+
+### Örnek CSV Yapısı
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
+John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
+```
+
+<Note>
+**İpucu:** İçe aktarma sırasında **Örnek dosyayı indir**'i tıklayın ya da Twenty'nin beklediği tam sütun adlarını görmek için mevcut birkaç Kişiyi dışa aktarın.
+</Note>
+
+## Adım 2: İçe Aktarma Özelliğine Erişin
+
+**Seçenek 1: Kişiler görünümünden**
+
+1. Sol kenar çubuğunda **Kişiler**'e gidin
+2. Sağ üstteki **⋮** simgesine tıklayın
+3. **Kayıtları İçe Aktar**'ı seçin
+
+**Seçenek 2: Komut Menüsünü kullanma**
+
+1. Mac'te `Cmd + K`, Windows'ta `Ctrl + K` tuşlarına basın
+2. "import" yazın
+3. **Kayıtları İçe Aktar**'ı seçin
+4. **Kişiler**'i seçin
+
+## Adım 3: Dosyanızı Yükleyin
+
+1. **Dosya seç**'e tıklayın
+2. CSV, XLSX veya XLS dosyanızı seçin
+3. Twenty'nin dosyanızı analiz etmesini bekleyin
+
+## Adım 4: Sütunlarınızı Eşleyin
+
+Twenty, sütunlarınızı alanlarla eşleştirmeyi otomatik olarak dener. Gözden geçirin ve ayarlayın:
+
+1. **Otomatik eşlemeleri kontrol edin** — doğru olduklarını doğrulayın
+2. **Yanlış eşlemeleri düzeltin** — doğru alanı seçmek için açılır menüye tıklayın
+3. **Sütunları atlayın** — içe aktarmak istemediğiniz sütunlar için **Do not map** seçeneğini seçin
+
+### Önemli Eşleme Kuralları
+
+| Sütun Türü       | Eşlenecek Alan                 | Notlar                                                |
+| ---------------- | ------------------------------ | ----------------------------------------------------- |
+| Şirket referansı | **Company** ilişki alanı       | Alan adını YA DA id'yi kullanın, ikisini birden değil |
+| E-posta          | **E-posta**                    | Birincil e-posta adresi                               |
+| Ek e-postalar    | **Emails / Additional Emails** | Dizi biçimi                                           |
+| Telefon          | Ayrı sütunlar                  | Numara, Ülke Kodu, Arama Kodu                         |
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{genişlik:'100%'}} />
+
+### Şirket İlişkisinin Eşlenmesi
+
+Şirket sütununu eşlerken:
+
+1. Şirket referans sütununuzu bulun (ör. `companyDomain`)
+2. Bunu **Company** ilişki alanına eşleyin
+3. Twenty, her Kişiyi eşleşen Şirkete bağlar
+
+<Warning>
+**İlişkiler için yalnızca BİR benzersiz tanımlayıcıyı eşleyin.**
+
+Hem `companyId` hem de `companyDomain` eşlemeyin. Birini seçin — tercihen insanlar tarafından okunabildiği için alan adını.
+</Warning>
+
+## Adım 5: Seçim Alanı Değerlerini Eşleyin
+
+Seçim veya Çoklu Seçim alanlarınız varsa (örn. Potansiyel Müşteri Kaynağı):
+
+1. Twenty, değerlerinizi mevcut seçeneklerin yanında gösterir
+2. Dosyanızdaki her değeri bir Twenty seçeneğiyle eşleştirin
+3. Gerekiyorsa yeni seçenekler oluşturun
+
+<Note>
+Seçim alanı seçenekleri, görüntü etiketlerini değil, **API adlarını** kullanır. API adlarını görmek için **Settings → Data Model** → **Advanced mode**'u etkinleştirin.
+</Note>
+
+## Adım 6: Hataları Gözden Geçirin ve Düzeltin
+
+İçe aktarmayı tamamlamadan önce Twenty verilerinizi doğrular:
+
+1. **Next Steps**'e tıklayın
+2. Hata içeren satırlar **sarı** renkle vurgulanır
+3. **Hataları doğrudan düzeltin** — bir hücreye tıklayın ve değeri düzenleyin
+4. **Sorunlu satırları kaldırın** — o satırı atlamak için X'e tıklayın
+
+### Yaygın Kişi İçe Aktarma Hataları
+
+| Hata                        | Neden                                       | Çözüm                                               |
+| --------------------------- | ------------------------------------------- | --------------------------------------------------- |
+| **Yinelenen e-posta**       | E-posta Twenty'de veya dosyada zaten mevcut | Yineleneni kaldırın veya mevcut kaydı güncelleyin   |
+| **Geçersiz e-posta biçimi** | E-posta biçimi hatalı                       | `name@domain.com` olarak düzeltin                   |
+| **İlişki bulunamadı**       | Şirket mevcut değil                         | Önce Şirketleri içe aktarın veya referansı düzeltin |
+| **Gerekli alan eksik**      | Gerekli alan boş                            | Değeri doldurun veya satırı kaldırın                |
+
+## Adım 7: İçe Aktarmayı Tamamlayın
+
+1. İçe aktarma özetini gözden geçirin
+2. İçe aktarmak için **Onayla**'ya tıklayın
+3. İçe aktarmanın tamamlanmasını bekleyin
+4. Birkaç kaydı ve Şirket bağlantılarını kontrol ederek doğrulayın
+
+## Kişileri İçe Aktardıktan Sonra
+
+Kişileriniz artık Twenty'de! Sonraki adımlar:
+
+1. **Şirket bağlantılarını doğrulayın** — doğru Şirkete bağlı olduklarını teyit etmek için birkaç Kişi kaydını açın
+2. **Fırsatları içe aktarın** — gerekiyorsa bunları Kişiler ve Şirketlerle ilişkilendirin
+3. **E-posta eşitlemesini ayarlayın** — kişi kayıtlarında e-posta geçmişini görmek için posta kutunuzu bağlayın
+
+## Mevcut Kişileri Güncelleme
+
+Yeni kişiler oluşturmak yerine kişileri güncellemek için:
+
+1. Dosyanıza `email` veya `id` sütununu ekleyin
+2. Twenty, kayıtları bu benzersiz tanımlayıcıya göre eşleştirir
+3. Mevcut kişiler güncellenir; yenileri oluşturulur
+
+Ayrıntılar için [Mevcut Kayıtlar Nasıl Güncellenir](/l/tr/user-guide/data-migration/how-tos/update-existing-records-via-import) bölümüne bakın.
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="Neden iki Kişinin aynı e-postası olamaz?">
+    E-posta, Twenty'de benzersiz bir tanımlayıcıdır. Bu, yinelenen kişileri önler ve e-posta eşitlemesinin e-postaları doğru kişiyle doğru şekilde ilişkilendirmesini sağlar.
+  </Accordion>
+
+  <Accordion title="E-postası olmayan kişilerim varsa ne yapmalıyım?">
+    E-postayı boş bırakabilirsiniz. Ancak, daha iyi veri kalitesi ve e-posta eşitleme işlevi için mümkün olduğunda e-postaları eklemenizi öneririz.
+  </Accordion>
+
+  <Accordion title="İçe aktarma sırasında Kişileri Şirketlerle nasıl ilişkilendiririm?">
+    Şirketin alan adı (örn. `https://acme.com`) veya ID'si ile bir sütun ekleyin. Eşleme sırasında bu sütunu Şirket ilişki alanına bağlayın.
+  </Accordion>
+
+  <Accordion title="Şirket henüz mevcut değilse ne yapmalıyım?">
+    Önce Şirketleri içe aktarın, ardından Kişileri içe aktarın. Şirkete referans verebilmeden önce şirketin mevcut olması gerekir.
+  </Accordion>
+
+  <Accordion title="Önceki CRM'imden ID'yi içe aktarabilir miyim?">
+    Evet! Dış ID'yi saklamak için veri modelinizde "unique" olarak işaretlenmiş özel bir alan oluşturun. Not: `id` alan adı Twenty'nin dahili ID'si için ayrılmıştır.
+  </Accordion>
+
+  <Accordion title="'relation not found' hatalarını nasıl düzeltirim?">
+    Referans verdiğiniz Şirket mevcut değil. Ya önce Şirketi içe aktarın ya da alan adının/ID'nin mevcut bir Şirketle birebir eşleştiğini kontrol edin.
+  </Accordion>
+</AccordionGroup>
+
+## Sorun Giderme
+
+Sorun mu yaşıyorsunuz? Şunları kontrol edin:
+
+* [İçe Aktarma Hataları Nasıl Düzeltilir](/l/tr/user-guide/data-migration/how-tos/fix-import-errors)
+* [İlişkiler Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Alan Eşleme Başvurusu](/l/tr/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/import-data-via-api.mdx

@@ -0,0 +1,176 @@
+---
+title: API ile Veri İçe Aktarma
+description: Büyük ölçekli veri içe aktarmaları için Twenty'nin API'lerini ne zaman ve nasıl kullanacağınız.
+---
+
+## Genel Bakış
+
+Twenty, programatik veri içe aktarma için hem **GraphQL** hem de **REST API'leri** sunar. Veri hacminiz için CSV içe aktarma pratik değilse veya otomatik, yinelenen içe aktarmalara ihtiyacınız varsa API'yi kullanın.
+
+## API içe aktarması ne zaman kullanılır
+
+| Senaryo                           | Önerilen Yöntem                   |
+| --------------------------------- | --------------------------------- |
+| 10.000 kaydın altında             | CSV İçe Aktarma                   |
+| 10.000 - 50.000 kayıt             | CSV İçe Aktarma (dosyalara bölün) |
+| **50.000+ kayıt**                 | **API İçe Aktarma**               |
+| Tek seferlik geçiş                | Her ikisi de (hacme bağlı olarak) |
+| **Yinelenen içe aktarmalar**      | **API İçe Aktarma**               |
+| **Gerçek zamanlı eşitleme**       | **API İçe Aktarma**               |
+| **Diğer sistemlerle entegrasyon** | **API İçe Aktarma**               |
+
+<Note>Yüz binlerce kayıttan oluşan veri kümeleri için API, birden çok CSV içe aktarımından belirgin şekilde daha hızlı ve daha güvenilirdir.</Note>
+
+## API Hız Sınırları
+
+Twenty, sistem kararlılığını sağlamak için hız sınırlarını uygular:
+
+| Sınır                        | Değer               |
+| ---------------------------- | ------------------- |
+| **Dakika başına istek**      | 100                 |
+| **Toplu çağrı başına kayıt** | 60                  |
+| **Maksimum aktarım hızı**    | ~6.000 kayıt/dakika |
+
+<Warning>
+**İçe aktarmanızı bu sınırlara göre planlayın.**
+
+Maksimum aktarım hızında 100.000 kayıt için yaklaşık 17 dakikalık içe aktarma süresi bekleyin. Hata yönetimi ve yeniden denemeler için tampon süre ekleyin.
+</Warning>
+
+## Başlarken
+
+### Adım 1: API Anahtarınızı Alın
+
+1. **Ayarlar → Geliştiriciler**'e gidin
+2. **+ API anahtarı oluştur**'a tıklayın
+3. Anahtarınıza açıklayıcı bir ad verin
+4. API anahtarını hemen kopyalayın (tekrar gösterilmeyecektir)
+5. Güvenli bir şekilde saklayın
+
+<Warning>
+**API anahtarınızı gizli tutun.**
+
+API anahtarınıza sahip olan herkes çalışma alanı verilerinize erişebilir ve bunları değiştirebilir. Asla kod depolarına eklemeyin ve herkese açık olarak paylaşmayın.
+</Warning>
+
+### Adım 2: API'nizi Seçin
+
+Twenty iki API türünü destekler:
+
+| API         | En uygun                                                     | Dokümantasyon                           |
+| ----------- | ------------------------------------------------------------ | --------------------------------------- |
+| **GraphQL** | Esnek sorgular, ilişkili verileri getirme, karmaşık işlemler | [API Belgeleri](/l/tr/developers/extend/api) |
+| **REST**    | Basit CRUD işlemleri, alışıldık REST kalıpları               | [API Belgeleri](/l/tr/developers/extend/api) |
+
+Her iki API de şunları destekler:
+
+* Kayıt oluşturma, okuma, güncelleme ve silme
+* **Toplu işlemler** — çağrı başına en fazla 60 kayıt oluşturma veya güncelleme
+
+**İçe aktarmalar için toplu işlemleri kullanın**, hız sınırları içinde aktarım hızını en üst düzeye çıkarmak için.
+
+### Adım 3: İçe Aktarma Sıralamanızı Planlayın
+
+CSV içe aktarmalarda olduğu gibi, ilişkiler için **sıra önemlidir**:
+
+1. Önce **Şirketler** (bağımlılık yok)
+2. İkinci olarak **Kişiler** (Şirketlere bağlanabilir)
+3. Üçüncü olarak **Fırsatlar** (Şirketlere ve Kişilere bağlanabilir)
+4. **Görevler/Notlar** (yukarıdakilerin herhangi birine bağlanabilir)
+5. **Özel nesneler** (bağımlılıklarına uyarak)
+
+## En İyi Uygulamalar
+
+### İsteklerinizi Gruplandırın
+
+* Kayıtları tek tek göndermeyin
+* API çağrısı başına **en fazla 60 kaydı** gruplandırın
+* Bu, hız sınırları içinde aktarım hızını en üst düzeye çıkarır
+
+### Hız Sınırlarını Yönetme
+
+* İstekler arasında gecikmeler uygulayın (sürekli içe aktarmalar için en az 600 ms)
+* Sınırlara ulaştığınızda üstel geri çekilme kullanın
+* 429 (Too Many Requests) yanıtlarını izleyin
+
+### Önce Verileri Doğrulayın
+
+* İçe aktarmadan önce verilerinizi temizleyin ve doğrulayın
+* Gerekli alanların doldurulduğunu kontrol edin
+* Biçimlerin Twenty'nin gereksinimlerine uyduğunu doğrulayın (bkz. [Alan Eşleme](/l/tr/user-guide/data-migration/capabilities/field-mapping))
+
+### Her Şeyi Günlüğe Kaydedin
+
+* İçe aktarılan her kaydı günlüğe kaydedin (ID'ler dahil)
+* Hataları tam bağlamla günlüğe kaydedin
+* Bu, sorunları ayıklamaya ve tamamlandığını doğrulamaya yardımcı olur
+
+### Önce Test Edin
+
+* Küçük bir grupla test edin (10-20 kayıt)
+* Verilerin Twenty'de doğru göründüğünü doğrulayın
+* Ardından tam içe aktarmayı çalıştırın
+
+### Yinelenenleri Önlemek İçin Upsert Kullanın
+
+GraphQL API, **toplu upsert** destekler — kayıt varsa günceller, yoksa oluşturur. Bu, içe aktarmaları yeniden çalıştırırken yinelenenlerin oluşmasını önler.
+
+## Nesne ve Alan Adlarını Bulma
+
+Kullanılabilir nesneleri ve alanları görmek için:
+
+1. **Ayarlar → API ve Webhook'lar**'a gidin
+2. **Metadata API**'yi inceleyin
+3. Tüm standart ve özel nesneleri alanlarıyla birlikte görüntüleyin
+
+Dokümantasyon, tüm standart ve özel nesneleri, alanlarını ve beklenen veri türlerini gösterir.
+
+## Profesyonel Hizmetler
+
+Karmaşık API geçişleri için iş ortaklarımız yardımcı olabilir:
+
+| Hizmet                            | Neler Dahil                                 |
+| --------------------------------- | ------------------------------------------- |
+| **Veri Modeli Tasarımı**          | en uygun veri yapınızı tasarlama            |
+| **Geçiş Betikleri**               | içe aktarma betiklerini yazma ve çalıştırma |
+| **Veri Dönüşümü**                 | karmaşık eşlemeleri ve temizliği yönetme    |
+| **Doğrulama ve Kalite Güvencesi** | geçişin tamamlandığını doğrulama            |
+
+**En uygun:**
+
+* 100.000+ kayıttan oluşan geçişler
+* Karmaşık veri dönüşümleri
+* Sıkı zaman çizelgeleri
+* Geliştirici kaynağı olmayan ekipler
+
+[contact@twenty.com](mailto:contact@twenty.com) adresinden bizimle iletişime geçin veya [Uygulama Hizmetlerimizi](/l/tr/user-guide/getting-started/capabilities/implementation-services) keşfedin.
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="GraphQL ile REST arasındaki fark nedir?">
+    GraphQL, tek bir sorguda tam olarak ihtiyaç duyduğunuz verileri talep etmenizi sağlar ve karmaşık işlemler için daha uygundur. REST, standart HTTP yöntemlerini (GET, POST, PUT, DELETE) kullanır ve geleneksel API'lerle çalıştıysanız daha aşina gelebilir.
+  </Accordion>
+
+  <Accordion title="API aracılığıyla mevcut kayıtları güncelleyebilir miyim?">
+    Evet! Kayıdın `id`si ile güncelleme mutasyonları (GraphQL) veya PUT/PATCH isteklerini (REST) kullanın.
+  </Accordion>
+
+  <Accordion title="Yinelenenleri nasıl ele alırım?">
+    Önce benzersiz tanımlayıcıları (e-posta, etki alanı) kullanarak mevcut kayıtları sorgulayın. Varsa güncelleyin, yoksa oluşturun.
+  </Accordion>
+
+  <Accordion title="API aracılığıyla kayıtları silebilir miyim?">
+    Evet, silme mutasyonları (GraphQL) veya DELETE isteklerini (REST) kullanın.
+  </Accordion>
+
+  <Accordion title="Python veya Node.js için bir SDK var mı?">
+    Şu anda yok, ancak her iki API de herhangi bir dildeki herhangi bir HTTP istemcisiyle çalışır.
+  </Accordion>
+</AccordionGroup>
+
+## API Belgeleri
+
+Tam uygulama ayrıntıları, kod örnekleri ve şema başvurusu için:
+
+* [API Belgeleri](/l/tr/developers/extend/api)

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx

@@ -0,0 +1,225 @@
+---
+title: CSV ile Nesneler Arasındaki İlişkileri İçe Aktarma
+description: CSV içe aktarma sırasında kayıtları bağlamaya yönelik eksiksiz adım adım kılavuz.
+---
+
+## 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.
+
+<Note>**İç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.</Note>
+
+## İ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 | Şirket            | Fırsatlar         |
+| Kişiler → Görevler    | Kişi              | Görevler          |
+| Kişiler → Notlar      | Kişi              | Notlar            |
+
+## 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)
+
+<Warning>
+**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.
+</Warning>
+
+## 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 Nesne                 | Kullanılabilir Benzersiz Tanımlayıcılar                                |
+| ------------------------- | ---------------------------------------------------------------------- |
+| **Şirketler**             | `id` (UUID), `domain` (önerilir) veya herhangi bir özel benzersiz alan |
+| **Kişiler**               | `id` (UUID), `email` veya herhangi bir özel benzersiz alan             |
+| **Çalışma Alanı Üyeleri** | `id` (UUID), `email` (isim değil)                                      |
+| **Özel Nesneler**         | `id` (UUID) veya benzersiz olarak işaretlenmiş herhangi bir alan       |
+
+<Note>**Önerilir:** Şirketler için `domain`, Kişiler için `email` kullanın. Bunlar insan tarafından okunabilirdir ve e-tablonuzda doğrulanması kolaydır.</Note>
+
+### 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:**
+
+```csv
+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çimi       | `https://acme.com`                     |
+| E-posta     | Standart e-posta | `john@acme.com`                        |
+| Kimlik      | UUID             | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Warning>
+**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.
+</Warning>
+
+### Ö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
+
+| Hata                             | Sorun                                          | Çözüm                                                             |
+| -------------------------------- | ---------------------------------------------- | ----------------------------------------------------------------- |
+| **Yanlış içe aktarma sırası**    | Şirketlerden önce Kişileri içe aktarmak        | Her zaman önce ana kayıtları, sonra alt kayıtları içe aktarın     |
+| **Yanlış alan adı biçimi**       | `https://acme.com` yerine `acme.com` kullanmak | `https://` ile tam URL biçimini kullanın                          |
+| **Birden fazla benzersiz alan**  | Hem `companyId` HEM DE `companyDomain` eşlemek | Yalnı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ıtlar**      | Ana 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ğu** | Dosyada `Acme.com`, Twenty'de ise `acme.com`   | Bire 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
+
+```csv
+taskName,assignedTo
+Follow up with client,john@yourcompany.com
+Review proposal,jane@yourcompany.com
+```
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="Ana kaydımın alan adı veya e-postası yoksa ne olur?">
+    İ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
+  </Accordion>
+
+  <Accordion title="Mevcut kayıtlardaki ilişkileri güncelleyebilir miyim?">
+    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.
+  </Accordion>
+
+  <Accordion title="Çoktan-çoka ilişkileri içe aktarabilir miyim?">
+    Çoktan-çoka ilişkiler henüz içe aktarmada desteklenmiyor. Bu, 2026'nın ilk yarısı için planlanıyor.
+  </Accordion>
+
+  <Accordion title="Birden fazla nesne türüne bağlantı verebilir miyim (ör. Notları Kişilere VE Şirketlere)?">
+    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.
+  </Accordion>
+
+  <Accordion title="Ana kayıt mevcut değilse ne olur?">
+    İç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
+  </Accordion>
+
+  <Accordion title="İlişkim neden doğru şekilde bağlanmıyor?">
+    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)
+  </Accordion>
+</AccordionGroup>
+
+<Warning>
+**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.
+</Warning>
+
+## Sorun Giderme
+
+Sorun mu yaşıyorsunuz? Şunları kontrol edin:
+
+* [İçe Aktarma Hataları Nasıl Düzeltilir](/l/tr/user-guide/data-migration/how-tos/fix-import-errors)
+* [İlişkileri İçe Aktarma Yetenekleri](/l/tr/user-guide/data-migration/capabilities/import-relations)
+* [Benzersizlik Kısıtlamaları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx

@@ -0,0 +1,289 @@
+---
+title: Diğer CRM'lerden Taşınma
+description: Verilerinizi herhangi bir CRM'den Twenty'ye taşımak için adım adım kılavuz.
+---
+
+## Genel Bakış
+
+Bu kılavuz, verilerinizi herhangi bir CRM'den Twenty'ye taşıma sürecinde size yol gösterir. Süreç, verilerinizi denetlemeyi, Twenty çalışma alanınızı hazırlamayı, mevcut sisteminizden dışa aktarmayı ve Twenty'ye içe aktarmayı içerir.
+
+<Note>Görünümler, iş akışları ve izinler geçişten sonra manuel olarak yeniden oluşturulmalıdır. Bu yapılandırma çalışması için zaman planlayın.</Note>
+
+## Adım 1: Mevcut Verilerinizi Denetleyin
+
+Geçiş, yeni bir başlangıç için bir fırsattır. Gereksiz karmaşayı taşımayın.
+
+**Tutulacaklar:**
+
+* Aktif kişiler ve şirketler
+* Açık fırsatlar ve anlaşmalar
+* Önemli notlar ve aktiviteler
+* Gerçekten kullandığınız özel alanlar
+
+**Geride bırakılacaklar:**
+
+* Güncelliğini yitirmiş kişiler (2 yıldan uzun süredir aktivite yok)
+* Yinelenen kayıtlar
+* Test verileri
+* Kullanılmayan özel alanlar
+
+## Adım 2: Veri Modelinizi Eşleyin
+
+Mevcut CRM'iniz ile Twenty arasında bir eşleme belgesi oluşturun:
+
+| CRM'iniz         | Twenty                 |
+| ---------------- | ---------------------- |
+| Hesap / Kuruluş  | **Şirket**             |
+| İrtibat / Kişi   | **Kişiler**            |
+| Anlaşma / Fırsat | **Fırsat**             |
+| Aktivite         | **Görev** veya **Not** |
+| Özel Nesne       | **Özel Nesne**         |
+
+**Her alan için şunları belgeleyin:**
+
+* Kaynak alan adı
+* Hedef Twenty alanı
+* Gerekli biçim dönüştürmeleri (tarihler, telefon numaraları vb.)
+
+<Note>İçe aktarma sırasında bu eşleme belgesini elinizin altında bulundurun—sütunları eşlerken ona başvuracaksınız.</Note>
+
+## Adım 3: Twenty Çalışma Alanınızı Kurun
+
+Verileri içe aktarmadan önce Twenty çalışma alanınızı hazırlayın:
+
+### Özel Nesneler ve Alanlar Oluşturun
+
+1. **Ayarlar → Veri Modeli** bölümüne gidin
+2. Gereksinim duyduğunuz özel nesneleri oluşturun
+3. Standart ve özel nesnelere özel alanlar ekleyin
+4. Alan ayarlarını yapılandırın (benzersiz, zorunlu, seçenekler vb.)
+
+<Warning>
+**Alanlar içe aktarmadan önce mevcut olmalıdır.**
+
+CSV içe aktarma alanları değil, kayıtları oluşturur. İçe aktarmadan önce tüm özel alanları Ayarlar → Veri Modeli içinde oluşturun.
+</Warning>
+
+### Ekibinizi Davet Edin
+
+<Warning>
+**Kullanıcıları verileri içe aktarmadan ÖNCE davet edin.**
+
+Verileriniz kullanıcı referansları içeriyorsa (Hesap Sahibi, Atanan vb.), bu kullanıcıların içe aktarmadan önce Twenty'de mevcut olması gerekir. Aksi halde bu ilişkiler eşlenemez.
+</Warning>
+
+1. **Ayarlar → Üyeler** bölümüne gidin
+2. Tüm ekip üyelerini davet edin
+3. **Herkesin davetini kabul etmesini bekleyin**
+4. Tüm kullanıcıların Üyeler listenizde göründüğünü doğrulayın
+
+## Adım 4: Mevcut CRM'inizden Dışa Aktarın
+
+Verilerinizi mevcut CRM'inizden dışa aktarın:
+
+1. **Dışa Aktar** işlevini arayın (genellikle Ayarlar, Veri Yönetimi veya Yönetici altında)
+2. Mümkün olduğunda **CSV biçimine** dışa aktarın
+3. Her nesne türünü ayrı ayrı dışa aktarın (Şirketler, Kişiler, Anlaşmalar vb.)
+4. Taşımak istediğiniz tüm alanları dahil edin
+
+**Şu nesneleri dışa aktarın (referans için bu sırayla):**
+
+1. Şirketler / Hesaplar / Kuruluşlar
+2. Kişiler / Bireyler
+3. Anlaşmalar / Fırsatlar
+4. Notlar ve Aktiviteler
+5. Özel nesneler
+
+## Adım 5: Verilerinizi Temizleyin ve Biçimlendirin
+
+Dışa aktarılan her CSV'yi bir hesap tablosu uygulamasında açın ve Twenty için hazırlayın.
+
+### Yinelenenleri Kaldırın
+
+1. Benzersiz alana göre sıralayın (Kişiler için e-posta, Şirketler için alan adı)
+2. Yinelenen satırları kaldırın veya birleştirin
+3. Twenty'de halihazırda yinelenen olmadığını doğrulayın
+
+### Alanları Doğru Biçimlendirin
+
+| Alan tipi          | Gerekli Biçim                                   |
+| ------------------ | ----------------------------------------------- |
+| **Alan Adı**       | `https://domain.com`                            |
+| **E-posta**        | `name@domain.com` (benzersiz olmalıdır)         |
+| **Tarih**          | `YYYY-MM-DD`                                    |
+| **Telefon**        | Üç sütun: Numara, Ülke Kodu, Arama Kodu         |
+| **Boolean**        | `TRUE` veya `FALSE` (büyük harf)                |
+| **Seçim Alanları** | Görüntü etiketleri değil, API adlarını kullanın |
+
+<Warning>
+**Alan adı biçimi kritiktir.**
+
+`https://domain.com` kullanın (`domain.com` veya `www.domain.com` değil). Bu, Twenty'nin biçimiyle eşleşir ve e-posta/takvim eşzamanlamasını bağladığınızda yinelenmeleri önler.
+</Warning>
+
+Tüm alan türleri için tam biçimlendirme gereksinimleri için [CSV Dosyalarınızı Nasıl Hazırlarsınız](/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files) bölümüne bakın.
+
+### İlişki Sütunları Ekleyin
+
+Kayıtları bağlamak için (ör. Kişileri Şirketlere), ana kaydın benzersiz tanımlayıcısını içeren bir sütun ekleyin.
+
+**Örnek: Şirket bağlantılı Kişiler CSV'si**
+
+```csv
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+Kayıtları bağlamaya ilişkin ayrıntılı talimatlar için [İlişkiler Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) bölümüne bakın.
+
+### Kullanıcı Referanslarını Güncelleyin
+
+Verileriniz kullanıcı atamaları içeriyorsa (Sahip, Atanan):
+
+1. **Kullanıcının e-posta adresini** içeren bir sütun ekleyin (yalnızca eski sistemdeki kimlikleri değil)
+2. Kullanıcıların Twenty çalışma alanınıza katılmak için kullandıklarıyla aynı e-posta adreslerini kullanın
+
+Tam biçimlendirme kılavuzu için [CSV Dosyalarınızı Nasıl Hazırlarsınız](/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files) bölümüne bakın.
+
+## Adım 6: Twenty'ye İçe Aktarın
+
+<Warning>
+**İçe Aktarma Sırası Önemlidir!**
+
+Her zaman şu sırayla içe aktarın:
+1. Önce **Şirketler** (bağımlılık yok)
+2. İkinci olarak **Kişiler** (Şirketlere bağlanır)
+3. Üçüncü olarak **Fırsatlar** (Şirketlere/Kişilere bağlanır)
+4. **Notlar ve Görevler** (kayıtlara bağlanır)
+5. **Özel nesneler** (bağımlılıklarına uyarak)
+
+Ona referans verebilmeden önce ana kayıt mevcut olmalıdır.
+</Warning>
+
+### Her Nesneyi İçe Aktarın
+
+Her CSV dosyası için, sırayla:
+
+1. Twenty'de nesneye gidin
+2. **⋮ → Kayıtları içe aktar**'ı tıklayın
+3. CSV dosyasını yükleyin
+4. Sütunları alanlarla eşleyin:
+   * Kullanıcı e-posta sütunlarını uygun ilişki alanlarına eşleyin
+   * İlişki sütunlarını (ör. `companyDomain`) ilişki alanlarına eşleyin
+5. Kullanıcı arayüzündeki hataları gözden geçirin ve düzeltin
+6. İçe aktarmayı onaylayın
+7. Sonraki dosyaya geçmeden önce birkaç kaydı doğrulayın
+
+**Ayrıntılı kılavuzlar:**
+
+* [Şirketler Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-companies-via-csv)
+* [Kişiler Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [İlişkiler Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+
+## Adım 7: Büyük Geçişler (50.000+ Kayıt)
+
+Büyük geçişler için:
+
+| Hacim                 | Önerilen Yaklaşım                |
+| --------------------- | -------------------------------- |
+| 10.000 kaydın altında | Tek CSV içe aktarma              |
+| 10.000 - 50.000 kayıt | Birden fazla CSV dosyasına bölün |
+| 50.000+ kayıt         | API'yi kullanın                  |
+
+**API içe aktarmaları için:**
+
+* Büyük veri kümeleri için daha hızlı ve daha güvenilir
+* Toplu işlemleri destekler (çağrı başına 60 kayda kadar)
+* Bkz.: [API ile Veri Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-data-via-api)
+
+## Adım 8: Geçiş Sonrası Kurulum
+
+Verileri içe aktardıktan sonra çalışma alanı yapılandırmanızı tamamlayın:
+
+### Görünümleri Yeniden Oluşturun
+
+* Kaydedilmiş görünümleri filtreler, sıralamalar ve sütun yapılandırmalarıyla yeniden oluşturun
+* Gereksinim duyduğunuz kanban veya takvim görünümlerini oluşturun
+
+### İş Akışlarını Yeniden Oluşturun
+
+* Otomasyonlarınızı **Ayarlar → İş Akışları** içinde yeniden oluşturun
+* En kritik iş akışlarıyla başlayın
+* Kullanmaya başlamadan önce her birini test edin
+
+### Rolleri ve İzinleri Yapılandırın
+
+* Rolleri **Ayarlar → Üyeler → Roller** bölümünde yapılandırın
+* Kullanıcıları uygun rollere atayın
+
+### E-posta ve Takvimi Bağlayın
+
+* Her kullanıcı kendi hesabını **Ayarlar → Hesaplar** bölümünde bağlar
+* Twenty, e-postaları kişi kayıtlarıyla eşzamanlamaya başlayacaktır
+* Bkz. [E-posta ve Takvim](/l/tr/user-guide/calendar-emails/overview)
+
+### Ekibinizi Eğitin
+
+* Yeni arayüzü birlikte gözden geçirin
+* Takıma özgü süreçleri belgelendirin
+
+## Sık Görülen Sorunlar ve Çözümleri
+
+| Sorun                      | Neden                              | Çözüm                                                                                                    |
+| -------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| **Yinelenen hatalar**      | E-posta/alan adı zaten mevcut      | Dosyadan yinelenenleri kaldırın veya mevcut kayıtları güncellemek için benzersiz bir tanımlayıcı ekleyin |
+| **İlişki bulunamadı**      | Ana kayıt mevcut değil             | Önce ana nesneleri içe aktarın (Şirketler Kişilerden önce)                                               |
+| **Eksik alanlar**          | Özel alan mevcut değil             | İçe aktarmadan önce alanı Ayarlar → Veri Modeli içinde oluşturun                                         |
+| **Seçim alanı hataları**   | Görüntü etiketlerinin kullanılması | API adlarını kullanın (bulmak için Ayarlar'da Gelişmiş modu etkinleştirin)                               |
+| **Kullanıcı ilişkisi boş** | Kullanıcı daveti kabul etmedi      | Verileri içe aktarmadan önce tüm kullanıcıların davetleri kabul ettiğinden emin olun                     |
+
+Ayrıntılı sorun giderme adımları için [İçe Aktarma Hataları Nasıl Düzeltilir](/l/tr/user-guide/data-migration/how-tos/fix-import-errors) bölümüne bakın.
+
+## Taşındıktan Sonra Kontrol Listesi
+
+### Veri Bütünlüğü
+
+<Check>Tüm kayıtlar içe aktarıldı (sayıları kaynak sistemle karşılaştırın)</Check>
+<Check>İlişkiler düzgün çalışıyor (Kişiler Şirketlere bağlı)</Check>
+<Check>Kullanıcı atamaları doğru eşlendi (Sahip, Atanan)</Check>
+<Check>Özel alanlar dolduruldu</Check>
+<Check>Beklenmeyen yinelenen yok</Check>
+
+### Yapılandırma
+
+<Check>Görünümler yeniden oluşturuldu</Check>
+<Check>İş akışları yeniden oluşturuldu ve test edildi</Check>
+<Check>Roller ve izinler yapılandırıldı</Check>
+<Check>E-posta/takvim eşzamanlaması bağlandı</Check>
+
+### Ekip Hazırlığı
+
+<Check>Ekibe yeni sistem konusunda eğitim verildi</Check>
+<Check>Eski CRM erişim planı kararlaştırıldı (referans için saklansın mı? Ne zaman devre dışı bırakılacak?)</Check>
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="İş akışlarını otomatik olarak taşıyabilir miyim?">
+    Şu anda mümkün değil. İş akışları Twenty'de manuel olarak yeniden oluşturulmalıdır.
+  </Accordion>
+
+  <Accordion title="Dosya ekleri ne olacak?">
+    Dosya ekleri CSV dışa aktarmalarına dahil edilmez. Bunları manuel olarak yeniden yüklemeniz, API aracılığıyla taşımanız veya yardım için ekibimizle iletişime geçmeniz gerekecek.
+  </Accordion>
+
+  <Accordion title="Geçiş sırasında her iki sistemi de çalışır durumda tutabilir miyim?">
+    Evet, geçişin tamamlandığını doğrulayana kadar eski CRM'inizi çalışır durumda tutmanızı öneririz. Sadece her iki yerde de yeni veriler oluşturmamaya dikkat edin.
+  </Accordion>
+
+  <Accordion title="Geçiş genellikle ne kadar sürer?">
+    Veri hacmine ve karmaşıklığına bağlıdır. Küçük geçişler (10.000 kaydın altında) birkaç saat içinde yapılabilir. Büyük geçişler, veri temizliği ve test dahil olmak üzere birkaç gün sürebilir.
+  </Accordion>
+</AccordionGroup>
+
+## Yardıma mı ihtiyacınız var?
+
+<Tip>
+  Geçişiniz için yardıma mı ihtiyacınız var? Verilerinizi, pipeline'larınızı ve kullanıcılarınızı uçtan uca taşımak için [sertifikalı bir Twenty iş ortağı bulun](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm).
+</Tip>

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx

@@ -0,0 +1,173 @@
+---
+title: Kendi Barındırma'dan Bulut'a Geçiş
+description: Twenty kendi barındırmalı örneğinizi Twenty Cloud’a taşımak için adım adım kılavuz.
+---
+
+## Genel Bakış
+
+Bu kılavuz, verilerinizi Twenty kendi barındırmalı örneğinizden Twenty Cloud’a taşıma sürecinde size adım adım yol gösterir. Süreç; bulut çalışma alanınızı kurmayı, verilerinizi dışa aktarmayı ve yeniden içe aktarmayı içerir.
+
+<Note>Görünümler, iş akışları ve roller geçişten sonra manuel olarak yeniden oluşturulmalıdır. Bu yapılandırma çalışması için zaman planlayın.</Note>
+
+## Adım 1: Bulut Çalışma Alanınızı Oluşturun
+
+1. [app.twenty.com](https://app.twenty.com) adresine gidin ve yeni bir çalışma alanı oluşturun
+2. İlk kurulum sihirbazını tamamlayın
+3. Yeni çalışma alanı URL’nizi not edin
+
+## Adım 2: Veri Modelinizi Yeniden Oluşturun
+
+Verileri içe aktarmadan önce özel nesnelerinizi ve alanlarınızı yeniden oluşturun:
+
+1. Bulut örneğinizde **Ayarlar → Veri Modeli**’ne gidin
+2. Kendi barındırmalı kurulumunuzla eşleşen özel nesneler oluşturun
+3. Standart ve özel nesnelere özel alanlar ekleyin
+4. Alan ayarlarını yapılandırın (benzersiz, zorunlu vb.)
+
+<Note>Referans için kendi barındırmalı veri modelinizin ekran görüntülerini alın veya her iki örneği yan yana açık tutun.</Note>
+
+## Adım 3: Tüm Kullanıcıları Davet Edin
+
+<Warning>
+**Kritik: Kullanıcıları verileri içe aktarmadan ÖNCE davet edin.**
+
+Kullanıcılar, onları referans alan (ör. Hesap Sahibi alanları) herhangi bir kaydı içe aktarmadan önce davetlerini kabul etmelidir. Eğer kullanıcılar henüz mevcut değilse bu ilişkiler eşleştirilemez.
+</Warning>
+
+1. Bulut örneğinizde **Ayarlar → Üyeler**’e gidin
+2. Kendi barındırmalı sistemde hesabı olan tüm ekip üyelerini davet edin
+3. **Herkesin daveti kabul etmesini bekleyin**
+4. Tüm kullanıcıların Üyeler listenizde göründüğünü doğrulayın
+
+## Adım 4: Verileri Kendi Barındırmalı Sistemden Dışa Aktarın
+
+Kendi barındırmalı örneğinizden her bir nesneyi dışa aktarın:
+
+1. Her bir nesneye gidin (Şirketler, Kişiler, Fırsatlar vb.)
+2. Görünümü, taşımak istediğiniz **tüm sütunları** gösterecek şekilde yapılandırın
+3. **⋮ → Görünümü Dışa Aktar**’a tıklayın
+4. Her CSV dosyasını anlaşılır bir adla kaydedin (ör. `companies-export.csv`)
+
+**Bu sırayla dışa aktarın** (içe aktarım sırasında referans için):
+
+1. Şirketler
+2. İnsanlar
+3. Fırsatlar
+4. Özel nesneler (bağımlılıklarına uyarak)
+5. Görevler, Notlar
+
+## Adım 5: Çalışma Alanı Üyesi Referanslarını Güncelleyin
+
+Dışa aktarılan CSV’ler, kendi barındırmalı örneğinizden kullanıcı kimliklerini (ID) içerir. Bu kimlikler bulut örneğinizle eşleşmeyeceğinden, bunları e-postalarla değiştirmeniz gerekir.
+
+**Kullanıcı referansları (Sahip, Atanan vb.) içeren her CSV dosyası için:**
+
+1. CSV’yi bir elektronik tablo uygulamasında açın
+2. Her kullanıcı ID sütununun yanına yeni bir sütun ekleyin (ör. `accountOwnerId` yanına `accountOwnerEmail`)
+3. Her kullanıcının **e-posta adresini** doldurun
+4. Eski ID sütununu silebilir veya bırakabilirsiniz (içe aktarma sırasında atlanacaktır)
+
+**Örnek:**
+
+Önce:
+
+```csv
+name,domain,accountOwnerId
+Acme Corp,https://acme.com,old-uuid-123
+```
+
+Sonra:
+
+```csv
+name,domain,accountOwnerEmail
+Acme Corp,https://acme.com,john@yourcompany.com
+```
+
+<Note>Kullanıcıların bulut çalışma alanı davetini kabul etmek için kullandıklarıyla aynı e-posta adreslerini kullanın.</Note>
+
+## Adım 6: İçe Aktarma Sıralamanızı Planlayın
+
+İlişkileri korumak için dosyaları doğru sırayla içe aktarın:
+
+1. Önce **Şirketler** (bağımlılık yok)
+2. İkinci olarak **Kişiler** (Şirketlere bağlı)
+3. Üçüncü olarak **Fırsatlar** (Şirketler ve Kişilere bağlı)
+4. **Özel nesneler** (bağımlılıklarına uyarak)
+5. Son olarak **Görevler ve Notlar** (diğer kayıtlara bağlı)
+
+İlişkileri korumaya ilişkin ayrıntılar için [İlişkileri Nasıl İçe Aktarırız](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) bölümüne bakın.
+
+## Adım 7: Buluta İçe Aktarın
+
+Her CSV dosyası için, sırayla:
+
+1. Bulut örneğinizde ilgili nesneye gidin
+2. **⋮ → Kayıtları içe aktar**’ı tıklayın
+3. CSV dosyasını yükleyin
+4. Sütunları alanlarla eşleyin:
+   * Kullanıcı e-posta sütunlarını uygun ilişki alanlarına eşleyin
+   * Diğer sütunları her zamanki gibi eşleyin
+5. Herhangi bir hatayı gözden geçirin ve düzeltin
+6. İçe aktarmayı onaylayın
+7. Sonraki dosyaya geçmeden önce birkaç kaydı doğrulayın
+
+## Adım 8: Yapılandırmayı Yeniden Oluşturun
+
+Verileri içe aktardıktan sonra, aşağıdakileri manuel olarak yeniden oluşturun:
+
+### Görünümler
+
+* Kaydedilmiş görünümleri filtreler, sıralamalar ve sütun yapılandırmalarıyla yeniden oluşturun
+* Herhangi bir kanban veya takvim görünümünü ayarlayın
+
+### İş Akışları
+
+* **Ayarlar → İş Akışları** içinde otomasyonları yeniden oluşturun
+* Her iş akışını kullanmadan önce test edin
+
+### Roller ve İzinler
+
+* Rolleri **Ayarlar → Üyeler → Roller** bölümünde yapılandırın
+* Kullanıcıları uygun rollere atayın
+
+### Entegrasyonlar
+
+* Her kullanıcı için e-posta ve takvim eşzamanlamasını yeniden bağlayın
+* Herhangi bir API entegrasyonunu yeni API anahtarlarıyla yeniden yapılandırın
+
+## Taşındıktan Sonra Kontrol Listesi
+
+<Check>Tüm veriler başarıyla içe aktarıldı</Check>
+<Check>Nesneler arasındaki ilişkiler doğru çalışıyor</Check>
+<Check>Kullanıcı atamaları (Sahip, Atanan) doğru şekilde eşlendi</Check>
+<Check>Görünümler yeniden oluşturuldu</Check>
+<Check>İş akışları yeniden oluşturuldu ve test edildi</Check>
+<Check>Roller ve izinler yapılandırıldı</Check>
+<Check>E-posta/takvim eşzamanlaması yeniden bağlandı</Check>
+<Check>API entegrasyonları yeni anahtarlarla güncellendi</Check>
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="İş akışlarını otomatik olarak taşıyabilir miyim?">
+    Şu anda mümkün değil. İş akışları bulut örneğinizde manuel olarak yeniden oluşturulmalıdır.
+  </Accordion>
+
+  <Accordion title="Dosya ekleri ve görseller ne olacak?">
+    Dosya ekleri CSV dışa aktarmalarına dahil edilmez. Herhangi bir eki manuel olarak yeniden yüklemeniz, API aracılığıyla taşımanız ya da büyük geçişlerde yardım için ekibimizle iletişime geçmeniz gerekecek.
+  </Accordion>
+
+  <Accordion title="Geçiş sırasında her iki örneği de çalışır halde tutabilir miyim?">
+    Evet, buluta geçişin tamamlandığını doğrulayana kadar kendi barındırmalı örneğinizi çalışır durumda tutmanızı öneririz. Sadece her iki yerde de yeni veriler oluşturmamaya dikkat edin.
+  </Accordion>
+
+  <Accordion title="Bir kullanıcı davetini henüz kabul etmediyse ne olur?">
+    O kullanıcıya referans veren kayıtların içe aktarımı başarısız olur veya ilişki boş kalır. Verileri içe aktarmadan önce tüm kullanıcıların davetleri kabul ettiğinden emin olun.
+  </Accordion>
+</AccordionGroup>
+
+## Yardıma mı ihtiyacınız var?
+
+<Tip>
+  Büyük veya karmaşık bir çalışma alanını mı taşıyorsunuz? Taşıma sürecinin başından sonuna kadar yönetilmesi için [sertifikalı bir Twenty iş ortağı edinin](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud). *(Veya ekibimizi de sürece dahil edin: [contact@twenty.com](mailto:contact@twenty.com).)*
+</Tip>

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx

@@ -0,0 +1,267 @@
+---
+title: CSV Dosyalarınızı Hazırlayın
+description: Verilerinizi Twenty'ye içe aktarmak için biçimlendirmeye yönelik eksiksiz adım adım kılavuz.
+---
+
+## 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:
+
+| Gereksinim       | Ayrıntılar                      |
+| ---------------- | ------------------------------- |
+| **Biçim**        | CSV, XLSX veya XLS              |
+| **Boyut sınırı** | Dosya başına 10.000 kayıt       |
+| **Kodlama**      | UTF-8 önerilir                  |
+| **Yapı**         | Dosya başına tek bir nesne türü |
+
+<Note>10.000 kayıttan büyük veri kümeleri için, birden çok dosyaya bölün veya [API ile içe aktarma](/l/tr/user-guide/data-migration/how-tos/import-data-via-api) kullanın.</Note>
+
+## 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
+
+<Note>**İ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.</Note>
+
+## 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.
+
+| Nesne             | Benzersiz Alanlar                                                |
+| ----------------- | ---------------------------------------------------------------- |
+| **Kişiler**       | `id`, `email`                                                    |
+| **Şirketler**     | `id`, `domain`                                                   |
+| **Özel nesneler** | `id` 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
+
+<Warning>**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.</Warning>
+
+## 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: `name@domain.com`
+* 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:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### 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 alan**dır:
+
+| Sütun                                        | Örnek        |
+| -------------------------------------------- | ------------ |
+| **Telefonlar / Birincil Telefon Numarası**   | `4159095555` |
+| **Telefonlar / Birincil Telefon Ülke Kodu**  | `US`         |
+| **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`
+* 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 / Amount**   | `1234.56` |
+| **Amount / Currency** | `USD`     |
+
+### Boole Alanları
+
+Büyük harf kullanın: `TRUE` veya `FALSE`
+
+<Warning>Küçük harf `true` veya `false` çalışmaz.</Warning>
+
+### 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)
+
+<Note>Yeni seçim seçenekleri otomatik olarak oluşturulmaz. İçe aktarmadan önce **Ayarlar → Veri Modeli** içinde ekleyin.</Note>
+
+### Ç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,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**İlişkiler için önemli kurallar:**
+
+* Ana kaydın Twenty'de zaten mevcut olması gerekir
+* **Etiket**i 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
+
+<Warning>
+**İç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.
+</Warning>
+
+Ayrıntılı talimatlar için [İlişkileri Nasıl İçe Aktarırız](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) 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:
+
+<Check>Dosya CSV, XLSX veya XLS biçiminde</Check>
+<Check>Dosyada 10.000'den az kayıt var</Check>
+<Check>Kodlama UTF-8</Check>
+<Check>Yinelenen e-postalar (Kişiler için) veya alan adları (Şirketler için) yok</Check>
+<Check>Tarihler her yerde tutarlı bir biçim kullanıyor</Check>
+<Check>Alan adları `https://domain.com` biçimini kullanıyor</Check>
+<Check>Boole alanları `TRUE` veya `FALSE` (büyük harf) kullanıyor</Check>
+<Check>Seçim alanları, görünen etiketler değil, API adlarını kullanıyor</Check>
+<Check>Tüm özel alanlar Ayarlar → Veri Modeli içinde mevcut</Check>
+<Check>Ana kayıtlar, alt kayıtlardan önce içe aktarıldı</Check>
+<Check>İlişki sütunları mevcut kayıtlara referans veriyor</Check>
+
+## Kaçınılması Gereken Yaygın Hatalar
+
+| Hata                                                       | Çözüm                                                              |
+| ---------------------------------------------------------- | ------------------------------------------------------------------ |
+| `TRUE` yerine `true` kullanmak                             | Boole değerleri büyük harf olmalıdır                               |
+| Seçim alanlarında görünen etiketleri kullanmak             | Ayarlar'da API adlarını bulun ve kullanın                          |
+| Şirketlerden önce Kişileri içe aktarmak                    | Her 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çimi                                     | `https://domain.com` biçimini tutarlı şekilde kullanın             |
+| İlişkiler için birden fazla benzersiz alanı eşlemek        | Yalnızca TEK birini eşleyin (alan adı VEYA id, ikisi birden değil) |
+
+## Sonraki Adımlar
+
+Dosyanız hazır! Şimdi:
+
+* [Şirketleri İçe Aktarın](/l/tr/user-guide/data-migration/how-tos/import-companies-via-csv) (bunları önce içe aktarın)
+* [Kişileri İçe Aktarın](/l/tr/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [İçe aktarma hatalarını düzeltin](/l/tr/user-guide/data-migration/how-tos/fix-import-errors)

packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx

@@ -0,0 +1,198 @@
+---
+title: İçe Aktarma Yoluyla Mevcut Kayıtları Güncelleyin
+description: CSV içe aktarma kullanarak kayıtları toplu olarak güncelleme için eksiksiz adım adım kılavuz.
+---
+
+## Genel Bakış
+
+Birçok kaydı aynı anda güncellemeniz mi gerekiyor? Tek tek düzenlemek yerine, mevcut kayıtları toplu olarak güncellemek için CSV içe aktarmayı kullanın.
+
+**Kullanım alanları:**
+
+* Birden fazla kişi için iş unvanlarını güncelleyin
+* Şirket bilgilerini toplu olarak değiştirin
+* Yeni özel alanlara veri ekleyin
+* Birçok kayıttaki veri hatalarını düzeltin
+
+## Nasıl Çalışır
+
+Var olan bir kayıtla eşleşen bir **benzersiz tanımlayıcı** içeren bir dosyayı içe aktardığınızda, Twenty yinelenen bir kayıt oluşturmak yerine o kaydı günceller.
+
+| Eğer benzersiz tanımlayıcı... | Twenty şunu yapar...                                     |
+| ----------------------------- | -------------------------------------------------------- |
+| Mevcut bir kayıtla eşleşir    | Mevcut kaydı **güncelle**                                |
+| Herhangi bir kayıtla eşleşmez | Yeni bir kayıt **oluştur**                               |
+| Dosyanızda eksik              | Yeni bir kayıt **oluştur** (otomatik oluşturulan ID ile) |
+
+<Warning>
+**Çoklu Seçim alanları birleştirilmez, üzerine yazılır.**
+
+Bir kayıtta `Option A` ve `Option B` seçiliyse ve siz `["Option C"]` içe aktarırsanız, içe aktarmadan sonra kayıtta yalnızca `Option C` bulunur. İçe aktarma önceki tüm seçimlerin yerini alır—onlara ekleme yapmaz.
+
+Mevcut değerleri korumak için, hepsini içe aktarımınıza dahil edin: `["Option A","Option B","Option C"]`
+</Warning>
+
+## Adım 1: Mevcut Verilerinizi Dışa Aktarın
+
+Önce, güncellemek istediğiniz kayıtları dışa aktarın:
+
+1. Nesneye gidin (Kişiler, Şirketler vb.)
+2. **İhtiyacınız olan sütunları ekleyin** — güncellemek istediğiniz alanları göstermek için **Options → Fields**'a tıklayın
+3. **Gerekirse filtreleyin** — yalnızca güncellemek istediğiniz kayıtlara daraltın
+4. **⋮** → **Görünümü Dışa Aktar**'a tıklayın
+5. CSV dosyasını kaydedin
+
+<Note>**Neden önce dışa aktarmalısınız?** Dışa aktarılan dosya doğru biçimdedir, benzersiz tanımlayıcıları içerir ve içe aktarma sırasında otomatik olarak eşleştirilir.</Note>
+
+### Neler Dışa Aktarılır
+
+* Geçerli görünümünüzdeki tüm görünür sütunlar
+* Kaydın benzersiz tanımlayıcıları (`id`, `email`, `domain`)
+* Değiştirebileceğiniz mevcut alan değerleri
+
+## Adım 2: CSV Dosyasını Düzenleyin
+
+Dışa aktarılan dosyayı hesap tablosu uygulamanızda açın (Excel, Google Sheets vb.):
+
+1. **Benzersiz tanımlayıcı sütununu koruyun** — `id`, `email` veya `domain` alanlarını silmeyin
+2. Değiştirmek istediğiniz sütunlardaki değerleri **güncelleyin**
+3. **Güncellemeniz gerekmeyen sütunları kaldırın** (isteğe bağlı, ancak daha temizdir)
+4. **Benzersiz tanımlayıcı değerlerini değiştirmeyin** — aksi halde Twenty yeni kayıtlar oluşturur
+
+### Örnek: İş Unvanlarını Güncelleme
+
+**Dışa aktarılan dosya:**
+
+```csv
+id,email,firstName,lastName,jobTitle
+550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
+550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
+550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
+```
+
+**Düzenlemelerinizden sonra:**
+
+```csv
+id,email,firstName,lastName,jobTitle
+550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
+550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
+550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
+```
+
+<Warning>
+**Benzersiz tanımlayıcı değerlerini değiştirmeyin.**
+
+`john@acme.com` adresini `john.smith@acme.com` olarak değiştirirseniz, Twenty mevcut kaydı güncellemek yerine yeni bir kayıt oluşturur.
+</Warning>
+
+## Adım 3: Güncellenen Dosyayı İçe Aktarın
+
+1. Nesneye gidin
+2. **⋮** → **Kayıtları içe aktar**'ı tıklayın
+3. Düzenlediğiniz CSV dosyasını yükleyin
+4. **Benzersiz tanımlayıcının eşlendiğinden emin olun** — `email`, `domain` veya `id` alanlarının doğru şekilde eşlendiğini doğrulayın
+5. Alan eşlemelerini gözden geçirin
+6. Hataları kontrol edin
+7. **Onayla**'ya tıklayın
+
+Twenty, kayıtları benzersiz tanımlayıcıya göre eşleştirir ve yeni değerlerle günceller.
+
+## Doğru Benzersiz Tanımlayıcıyı Seçme
+
+| Nesne             | Önerilen                    | Alternatif | Notlar                                  |
+| ----------------- | --------------------------- | ---------- | --------------------------------------- |
+| **Kişiler**       | `e-posta`                   | `id`       | E-posta insan tarafından okunabilirdir  |
+| **Şirketler**     | `alan Adı`                  | `id`       | Alan adı insan tarafından okunabilirdir |
+| **Özel nesneler** | Herhangi bir benzersiz alan | `id`       | Özel benzersiz alanınızı kullanın       |
+
+<Note>**Yalnızca TEK bir benzersiz tanımlayıcı kullanın.** Hem `email` HEM de `id` eşlemeyin. Bu, karışıklığa ve hatalara neden olabilir.</Note>
+
+### Özel Benzersiz Alanları Kullanma
+
+Benzersiz olarak işaretlenmiş özel bir alanınız varsa (başka bir sistemden gelen harici bir ID gibi):
+
+1. Bu alanı dışa aktarma ve içe aktarma işlemlerinize dahil edin
+2. İçe aktarma sırasında onu eşleyin
+3. Twenty, o alana göre eşleştirme yapar
+
+## Adım 4: Güncellemeleri Doğrulayın
+
+İçe aktardıktan sonra:
+
+1. Güncellenen kayıtlardan birkaçını açın
+2. Değişikliklerin uygulandığını doğrulayın
+3. Yinelenen kayıtların oluşturulmadığını kontrol edin
+
+## Dosyanızda Olmayan Alanlar Ne Olacak?
+
+**İçe aktarma dosyanıza dahil edilmeyen alanlar değişmeden kalır.**
+
+| Dosyanız şunları içerir...   | Sonuç                                                     |
+| ---------------------------- | --------------------------------------------------------- |
+| `email`, `jobTitle`          | Yalnızca `jobTitle` güncellenir; diğer alanlar aynı kalır |
+| `email`, `jobTitle`, `phone` | `jobTitle` ve `phone` güncellenir                         |
+
+Bu, yalnızca değiştirmek istediğiniz alanları (artı benzersiz tanımlayıcıyı) dahil etmeniz gerektiği anlamına gelir.
+
+## Güncellemeleri ve Yeni Kayıtları Birleştirme
+
+Aynı içe aktarma işleminde mevcut kayıtları güncelleyebilir VE yeni kayıtlar oluşturabilirsiniz:
+
+```csv
+email,firstName,lastName,jobTitle
+john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
+newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)
+```
+
+## Kaçınılması Gereken Yaygın Hatalar
+
+| Hata                                    | Sorun                                                                 | Sonuç                                   | Çözüm                                                 |
+| --------------------------------------- | --------------------------------------------------------------------- | --------------------------------------- | ----------------------------------------------------- |
+| **Benzersiz tanımlayıcıyı değiştirmek** | `john@acme.com` `john.smith@acme.com` olarak değiştirildi             | Güncellemek yerine yeni kayıt oluşturur | Benzersiz tanımlayıcıları değiştirmeden bırakın       |
+| **Birden fazla benzersiz alan**         | Hem `email` HEM DE `id` alanlarını eşleme                             | Olası eşleştirme çakışmaları            | Yalnızca TEK bir benzersiz tanımlayıcıyı eşleyin      |
+| **Benzersiz tanımlayıcı yok**           | Dosyada yalnızca `firstName`, `lastName`, `jobTitle` var              | Tüm satırlar yeni kayıtlar oluşturur    | Her zaman `email`, `domain` veya `id` öğesini ekleyin |
+| **Büyük/küçük harf uyumsuzluğu**        | Dosyada `John@acme.com` var ancak Twenty'de `john@acme.com` bulunuyor | Yeni kayıt oluşturur                    | Tam değerleri almak için Twenty'den dışa aktarın      |
+
+## SSS
+
+<AccordionGroup>
+  <Accordion title="Bazı kayıtlar henüz yoksa ne olur?">
+    Benzersiz tanımlayıcıları mevcut kayıtlarla eşleşmeyen kayıtlar, yeni kayıtlar olarak oluşturulacaktır. Bu, aynı içe aktarma işleminde güncelleme ve oluşturma yapmanıza olanak tanır.
+  </Accordion>
+
+  <Accordion title="Bir alan değerini temizleyebilir/boşaltabilir miyim?">
+    Evet, CSV'nizde hücreyi boş bırakın. İçe aktarma, mevcut kayıttaki o alanın değerini temizleyecektir.
+  </Accordion>
+
+  <Accordion title="İçe aktarmaya dahil etmediğim alanlara ne olur?">
+    İçe aktarma dosyanızda olmayan alanlar mevcut kayıtlarda değişmeden kalır. Yalnızca dahil ettiğiniz alanlar güncellenir.
+  </Accordion>
+
+  <Accordion title="İlişki alanlarını (ör. Şirket) güncelleyebilir miyim?">
+    Evet! İlişkinin benzersiz tanımlayıcısını (ör. `companyDomain`) ekleyin ve ilişki alanına eşleyin. İlişki güncellenecektir.
+  </Accordion>
+
+  <Accordion title="Hangi kayıtların güncelleneceğini ve hangilerinin oluşturulacağını nasıl anlarım?">
+    İçe aktarmayı gözden geçirme adımında, Twenty benzersiz tanımlayıcı eşleşmelerine göre kaç kaydın güncelleneceğini ve kaçının oluşturulacağını gösterir.
+  </Accordion>
+
+  <Accordion title="Toplu bir güncellemeyi geri alabilir miyim?">
+    Otomatik geri alma yoktur. Toplu güncellemeler yapmadan önce verilerinizi yedek olarak dışa aktarmanızı öneririz.
+  </Accordion>
+</AccordionGroup>
+
+## En İyi Uygulamalar
+
+1. **Önce dışa aktarın** — doğru biçimi sağlamak için her zaman bir dışa aktarmayla başlayın
+2. **Güncellemeden önce yedekleyin** — toplu değişiklikler yapmadan önce verilerinizi dışa aktarın
+3. **Birkaç kayıtla test edin** — büyük bir toplu işlem yapmadan önce 5-10 kaydı güncellemeyi deneyin
+4. **İnsan tarafından okunabilir tanımlayıcılar kullanın** — `email` ve `domain`, `id`'den daha kolay doğrulanır
+5. **Yalnızca gerekli sütunları dahil edin** — daha az sütun, hata olasılığını azaltır
+
+## Sorun Giderme
+
+Sorun mu yaşıyorsunuz? Şunları kontrol edin:
+
+* [İçe Aktarma Hataları Nasıl Düzeltilir](/l/tr/user-guide/data-migration/how-tos/fix-import-errors)
+* [Benzersizlik Kısıtlamaları](/l/tr/user-guide/data-migration/capabilities/uniqueness-constraints)
+* [Alan Eşleme Başvurusu](/l/tr/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/tr/user-guide/data-migration/overview.mdx

@@ -0,0 +1,83 @@
+---
+title: Veri Geçişi
+description: CSV dosyaları veya API aracılığıyla CRM verilerinizi içe ve dışa aktarın.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## İçe Aktarma Yöntemleri
+
+Twenty, veri içe aktarmak için iki ana yöntemi destekler:
+
+| Yöntem                  | En Uygun                                 | Hacim Sınırı              |
+| ----------------------- | ---------------------------------------- | ------------------------- |
+| **CSV İçe Aktarma**     | Standart geçişler, düzenli güncellemeler | Dosya başına 10.000 kayıt |
+| **API ile İçe Aktarma** | Büyük ölçekli geçişler, otomasyon        | Sınırsız                  |
+
+<Note>Çok büyük veri kümeleri (yüz binlerce kayıt) için API'yi kullanın. Gerekirse bu betiklerin çalıştırılmasına [uygulama ortaklarımız](/l/tr/user-guide/getting-started/capabilities/implementation-services) yardımcı olabilir.</Note>
+
+## CSV İçe Aktarmanın Temelleri
+
+CSV, XLSX veya XLS dosyaları kullanarak herhangi bir nesnenin verilerini içe aktarabilirsiniz. Her dosya **yalnızca bir tür nesne** içermelidir (ör. yalnızca Kişiler kayıtları).
+
+<Note>**Alanlar içe aktarmadan önce mevcut olmalıdır.** Bir CSV dosyası yüklemek kayıtlar oluşturur, ancak alanları oluşturmaz. Gerekiyorsa özel alanları önce **Ayarlar → Veri Modeli** altında oluşturun.</Note>
+
+### Adımlar
+
+1. Veri içe aktarmak istediğiniz nesneye gidin
+2. Sağ üstteki **⋮** simgesine tıklayın (bu Komut Menüsü'dür) ve **Kayıtları İçe Aktar**'a tıklayın
+3. Verinizin beklenen biçimde olduğundan emin olmak için şablon dosyasını indirin
+4. Biçimlendirilmiş CSV dosyanızı yükleyin
+5. Sütunlarınızı Twenty alanlarına eşleştirin
+6. Hataları (sarıyla vurgulanan) gözden geçirin ve kullanıcı arayüzünde doğrudan düzenleyerek düzeltin
+7. İçe aktarmayı onaylayın
+
+### Nesneler Arasındaki İlişkileri İçe Aktarma
+
+CSV içe aktarma işlevini kullanarak nesneler arasındaki ilişkileri içe aktarabilirsiniz. İlgili nesneye, bu nesnedeki benzersiz bir alanı kullanarak referans vermeniz gerekir: `id`, People ve Çalışma Alanı Üyeleri için `email`, şirketler için `domain`, diğer nesneler için veri modelinde benzersiz olarak ayarlanmış herhangi bir başka alan.
+
+<Note>**Silinen kayıtlar benzersizlik hesabına dahildir.** Geçici olarak silinen kayıtlar (Komut Menüsü → Silinen kayıtları gör altında görünür) benzersizlik kontrollerine dahildir. Silinmiş bir kayıtla aynı benzersiz değere sahip bir kaydı içe aktarırsanız, silinmiş kayıt geri yüklenir.</Note>
+
+<Warning>
+**İçe Aktarma Sırası Önemlidir!**
+
+İlişkili nesneleri içe aktarırken dosyaları şu sırayla yükleyin:
+1. **Şirketler** önce (ilişkilerin "bir" tarafı)
+2. İkinci olarak **Kişiler** (companyId üzerinden Şirketlere bağlı)
+3. Üçüncü olarak **Fırsatlar** (Şirketlere/Kişilere bağlı)
+4. **İlişkileri olan özel nesneler** en son
+
+Neden? Bire-çok ilişkinin "bir" tarafı, ona referans verebilmeden önce mevcut olmalıdır. Örneğin, o şirketin kimliğine sahip bir Kişi içe aktarmadan önce Şirket kaydının mevcut olması gerekir.
+</Warning>
+
+Nasıl ilerleyeceğinize ilişkin adım adım yönergeler için lütfen [bu makaleye](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) bakın.
+
+## Verileri Dışa Aktar
+
+Yedekleme, raporlama veya geçiş için çalışma alanı verilerinizi dışa aktarın.
+
+### Adımlar
+
+1. Dışa aktarmak istediğiniz nesneye gidin
+2. Görünümü ihtiyaç duyduğunuz sütunlarla yapılandırın
+3. **⋮** → **Görünümü Dışa Aktar**'a tıklayın
+4. CSV dosyasını kaydedin
+
+<Note>**Yalnızca görünür sütunlar dışa aktarılır.** CSV dosyası yalnızca mevcut görünümünüzde gösterilen sütunları içerir. Hangi verilerin dahil edileceğini kontrol etmek için dışa aktarmadan önce sütunları ekleyin veya gizleyin.</Note>
+
+<Note>**Dışa aktarma sınırları**: Her dışa aktarma için en fazla 20.000 kayıt.</Note>
+
+## İzinler
+
+Veri içe ve dışa aktarma belirli izinler gerektirir:
+
+* **İçe Aktarma**: "Import CSV" iznini gerektirir
+* **Dışa Aktarma**: "Export CSV" iznini gerektirir
+
+Bu izinlere sahip değilseniz çalışma alanı yöneticinizle iletişime geçin.
+
+## Sonraki Adımlar
+
+* [CSV dosyalarınızı hazırlayın](/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files)
+* [Nesneler arasındaki ilişkileri içe aktarın](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Büyük veri kümeleri için API üzerinden içe aktarın](/l/tr/user-guide/data-migration/how-tos/import-data-via-api)