> For the complete documentation index, see [llms.txt](https://docs.useoly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.useoly.com/urun-icerigi/imports/field-and-category-mapping.md). # Alan, görsel ve kategori eşleme Kaynak kolonları ürün alanlarına, seçeneklere, görsellere ve Oly kategorilerine bağlama. Eşleme, kaynaktaki bir değerin Oly'de nerede ve hangi kuralla saklanacağını belirler. Kaynakta kolon bulunması tek başına yeterli değildir; eşlenmeyen değer yok sayılır. ## Alan Eşleme ekranı ![Kaynak alanı ile Oly hedef alanı seçilirken görünen eşleme kartı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-fe53fab04f146568691a1448266b7c65e5758b8a%2Ffield-mapping-detail.png?alt=media) *Sol taraftaki örnek veri kaynak adını; sağdaki kart hedef, seviye, yazma ve dönüşüm kararlarını gösterir.* Her **Eşleme Ekle** kartında: * **Kaynak Alan**, dosya/yanıt içindeki kolon veya yoldur. Örneğin `urun_adi`. * **PIM Alanı**, Oly'deki hedeftir. **SKU** ve **Name** gibi temel alanlarla Global Attribute ve ürün tipine ait alanlar gruplu gösterilir. * **Seviye**, değerin **Ürün** veya **Varyant** üzerinde yaşayacağını belirler. Ürünün bütün varyantlarında ortak marka ürün seviyesindeyken beden gibi eksen değerleri varyant seviyesindedir. * Sil simgesi yalnız o eşleme satırını kaldırır; kaynak dosyayı değiştirmez. ### Temel alanlar Ana SKU, veri yapısındaki **SKU Yolu** ile birlikte doğru kurulmalıdır. **Name** ürün adıdır ve birincil dilde ürün oluşturmak için gereklidir. Aynı kaynak alanı birden fazla hedefe eşlenebilir; her hedef kendi dönüşüm zincirini çalıştırır. Bu kullanım bilinçli olmalıdır: örneğin kısa ad hem Name hem farklı bir etiket alanına gidebilir. ### Yazma Modu | Seçenek | Davranış | Ne zaman kullanılır? | | ----------------------- | ------------------------------------------------- | ----------------------------------------------------------------- | | **Her Zaman** | Oluşturma ve güncellemede kaynağı uygular. | Kaynak her çalışmada yetkiliyse. | | **Sadece Oluşturmada** | Yeni üründe yazar, mevcut ürünü güncellemez. | İlk sınıflandırma gibi sonradan Oly'de yönetilecek alanlarda. | | **Sadece Güncellemede** | Yeni üründe atlar, mevcut üründe yazar. | Ayrı bir oluşturma süreci olan kataloglarda. | | **Boş ise** | Oly'de değer yoksa doldurur; mevcut değeri korur. | Kullanıcı düzeltmelerini ezmeden kaynaktan tamamlama yapmak için. | ### Boş hücre * **Mevcut değeri koru** boş kaynağı “değişiklik yok” kabul eder. Güvenli varsayılandır. * **Alanı temizle** boş kaynağın Oly'deki değeri kaldırmasına izin verir. Kaynak boşluğunun gerçekten silme talimatı olduğu alanlarda kullanın; aksi hâlde veri kaybına yol açabilir. ### Dil Çevrilebilir hedefte dil seçimi, değerin hangi dil sekmesine yazılacağını belirler. Sihirbazın tek/çok alanlı dil modu başlangıcı kolaylaştırır; her eşlemenin dili yine hedefle uyumlu olmalıdır. Çevrilebilir olmayan alanlarda dil seçimi görünmez. ## Dönüşümler **Dönüşüm Ekle**, kaynak değer hedefe yazılmadan önce sırayla çalışan işlemleri ekler. Sıra sonucu değiştirir; sürükleyerek yeniden düzenleyin. Kullanıcıya sunulan dönüşümler şu ihtiyaçları karşılar: * boşluk temizleme, büyük/küçük/başlık biçimi; * başa/sona metin ekleme; * bul/değiştir, düzenli ifade ile değiştirme veya bir bölümü çıkarma; * metnin bir bölümünü alma, ayırma ve belirli parçayı seçme; * kaynak değeri başka değere eşleme, varsayılan veya sabit değer verme; * koşula göre değer üretme; * sayıya çevirme, yuvarlama, çarpma veya bölme; * birden fazla parçayı birleştirme; * HTML içeriğini Rich Text için Markdown'a dönüştürme veya kaynağın zaten Markdown olduğunu belirtme. Oly örnek değeri ve dönüşmüş önizlemeyi kartın altında gösterir. HTML algılandığında öneri çıkabilir; dönüşüm otomatik eklenmez. Birbiriyle çelişen kaynak biçimi dönüşümleri veya Rich Text'i sonradan düz metne çeviren sıra uyarı/hata üretir. Kaydetmeden önce önizlemede işaretlerin ve satır sonlarının beklendiği gibi olduğuna bakın. ## Select ve Multi-Select seçenekleri Seçenekli bir hedefte kaynak etiketi Oly'deki mevcut seçeneğe çözülmelidir. * **Değer eşleme**, örneğin kaynaktaki `M` değerini katalogdaki `Erkek` seçeneğine bağlar. * **Yeni seçenekleri otomatik oluştur** yalnız güvenli biçimde tek bir seçenek sözlüğüne bağlı Select/Multi-Select hedeflerinde görünür. Açıkken bulunmayan kaynak etiketi sözlüğe eklenebilir. * Kontrollü bir sözlükte bu ayarı kapalı tutun ve her kaynak değerini mevcut seçeneğe eşleyin. Böylece `Erkek`, `E`, `Male` gibi eş anlamlılar ayrı katalog seçeneklerine dönüşmez. Documentation örneğinde **Cinsiyet** yalnız tanımlı değerleri kabul eder. Kaynaktaki `Çocuk` değeri eşlenmediğinde kayıt Staging'de **Geçersiz seçenek** hatası alır; otomatik olarak sözlüğe girmez. Sorunu kaynakta düzeltin, eşleme ekleyin veya Staging'de mevcut geçerli seçeneği seçin. ## Resim Eşleştirme ![Alan eşlemelerinin altında açılan resim eşleme kartı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-1f202b409d8a0f702c0f854ee2efa9aa22239f2f%2Fimage-mapping.png?alt=media) *Resim URL'lerinin bir dizi içinde mi yoksa ayrı kolonlarda mı bulunduğunu ve ürün/varyant hedefini belirtin.* * **Dizi**, her ürünün `images` gibi bir listesi olduğunda kullanılır. **Dizi Yolu** zorunludur; gelişmiş alanlarda URL, alt text, sıra ve ana görsel bilgisini taşıyan alt alanlar belirtilebilir. * **Düz alanlar**, `image_url_1`, `image_url_2` gibi ayrı kolonları sırayla ekler. * **Seviye** ürün veya varyant galerisini seçer. Varyant seviyesi seçilirse kaynak eksen değerlerini hedef varyant eksenlerine bağlayın; çözülemeyen görsel yanlış varyanta eklenmez. * Önizleme bulunan örnek URL'leri gösterir. Çalışma sırasında indirme durumu ve hatalar run detayında ayrı ilerler. Eşlenmemiş resim kolonu yok sayılır. URL'nin erişilebilir olması, desteklenen bir görsel döndürmesi ve gerçek müşteri verisi içermemesi gerekir. ## Kategori Eşleme ![Koşul, hedef kategori ve varsayılan kategori kontrolleri](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-450938f720937210eb1bb0ef879c8a592ecbdb93%2Fcategory-mapping-rule.png?alt=media) *Kurallar yukarıdan aşağı çalışır; ilk eşleşen hedef kullanılır. Varsayılan kategori yalnız hiçbir kural eşleşmezse devreye girer.* Kategori ürün tipini de belirlediği için yalnız sınıflandırma değildir: Staging'de hangi alanların ve seçeneklerin doğrulanacağını belirler. ### Kural Tabanlı **Kural Ekle** ile kaynak alan, karşılaştırma ve değer seçin; ardından hedef Oly kategorisini belirtin. Bir kuralda **VE/VEYA**, alt koşul ve grup eklenebilir. Kurallar sıralıdır; aynı ürüne birden çok kural uyarsa ilk eşleşen kazanır. Örnek sentetik eşlemeler: * `kategori` **eşittir** `Tişört` → **Giyim / Üst Giyim / Tişört** * `kategori` **eşittir** `Koşu Ayakkabısı` → ilgili ayakkabı yaprağı **Varsayılan Kategori**, hiçbir kural eşleşmediğinde kullanılır. Farklı ürün ailelerini tek geniş kategoriye yanlışlıkla yığmamak için yalnız gerçekten ortak bir güvenli hedef varsa seçin. ### AI Eşleştirme ve Hibrit * **AI Eşleştirme**, ürün bağlamından kategori önerisi üretir. * **Hibrit (Kurallar + AI Yedek)** önce denetlenebilir kuralları, yalnız eşleşmeyen kayıtlar için AI'yı kullanır. Bu seçeneklerde güncel kredi maliyeti arayüzde gösterilir. Sabit bir maliyet varsaymayın. AI sonucu da geçerli ve ürün tipi bulunan bir kategoriye çözülmelidir; başarısız kayıt Staging'de müdahale bekler. ## Üç kategori sonucu arasındaki fark | Kaynak örneği | Sonuç | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Tişört` | Kural geçerli yaprak kategoriye çözer; ürün tipi kategoriden gelir ve alanlar doğrulanır. | | `Plaj Giyim` | Kaynak değer için kural/hedef yoktur; Staging kaydı **Kategori atanmamış** olur. | | `Sezon Sonu` | Oly'de kategori adı bulunur fakat kategoriye ürün tipi bağlı değildir; ürün alanları doğrulanamaz. Mevcut UI bunu da aynı geniş **Kategori çözümlenemedi** mesajıyla gösterir. | ![Ürün tipi olmayan Sezon Sonu ve diğer geçerli hedeflerin kategori seçiminde görünümü](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-4771d7db5757b6d206a47395f5579bec100d1b86%2Fcategory-assignment.png?alt=media) *Ürün tipi olmayan Sezon Sonu satırı uyarıyla devre dışıdır; gerçek ürün oluşturabilecek yaprak ve ürün tipli bir kategori seçilmelidir.* ## Kontrol listesi İlerlemeden önce: 1. Ana SKU ve Name hedeflerini doğrulayın. 2. Ürün/varyant seviyesini ürün tipi alan davranışıyla karşılaştırın. 3. Boş hücrenin mevcut veriyi temizlemediğinden emin olun. 4. Seçenekli alanların tüm kaynak etiketlerini çözün. 5. Kategori kurallarının sırasını ve varsayılan hedefi örnek satırlarla test edin. 6. Önizlemede kayıt sayısını ve dönüşmüş değerleri kontrol edin. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.useoly.com/urun-icerigi/imports/field-and-category-mapping.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.