> 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/tools/image-import.md). # Görselleri toplu içe aktarma Dosya adı kurallarıyla ürün veya varyanta görsel eşleme ve yükleme sonuçlarını inceleme. **Araçlar → Görsel İçe Aktarma**, PNG, JPG veya WebP dosyalarını adlarından ürün/varyant ve sıra bilgisi çıkararak toplu yükler. ![Dosya seçimi ve ayar girişinin bulunduğu Görsel İçe Aktarma ekranı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-106bf296719fa497bbc392c88d079e9783ecef10%2Fimage-import-overview.png?alt=media) *Dosya seçmeden önce adlandırma kuralını yapılandırmak eşleşmeyen görsel riskini azaltır.* ## Eşleştirme kuralları **Ayarları Yapılandır** açıldığında kurallar yukarıdan aşağı denenir; ilk eşleşen kazanır. ![Default kural, segmentler, ayırıcı ve test alanıyla ayar drawer'ı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-540e414d69534c05838d7d668b9aa521c0652649%2Fimage-import-settings.png?alt=media) *Örnek `TSHIRT-001_01.jpg` adında SKU ve sıra segmentleri dosya adından çıkarılır.* Her kuralda: * Ad, kuralı tanımanızı sağlar; **Aktif** kapalıysa kural denenmez. * Yukarı/aşağı okları önceliği değiştirir; çöp simgesi kuralı siler. * **Basit**, dosya adını ayırıcıyla segmentlere böler. **Gelişmiş (Regex)** karmaşık adlar için desen kullanır; yalnız deseni test edebilen kullanıcılar tercih etmelidir. * **Eşleştirme Alanı**, tanımlayıcının **SKU** mu yoksa ürün tiplerinde tanımlı bir Global Attribute mu olduğunu belirler. **Özel alan gir** seçeneğinde yalnız çalışma alanınızda gerçekten bulunan alan anahtarını kullanın; bilinmeyen anahtar hedefi çözemez. * **Dosya Adı Ayırıcı** `_`, `-` veya `.` gibi parçalama karakteridir. * Segmentler **SKU**, varyant değeri, **Sıra Numarası** veya kullanılmayan bölüm gibi anlamlar taşır. **Segment Ekle** yeni parçayı tanımlar. * **Atlama İşareti**, dosya adındaki belirli işareti eşlemeden dışlamak için kullanılır. **Test** alanına her satıra bir örnek dosya adı yazın ve **Testi Çalıştır**'ı seçin. Sonuçta hangi kuralın eşleştiğini, ürün/varyant hedefini ve sıra değerini görmeden **Kaydet**'meyin. ### Örnekten gelişmiş desen üretme **Gelişmiş (Regex)** modunda **Örnekten üret**, karmaşık dosya adını elle desenlemek için yardımcı olur. Bu kontrol bir AI işlemi değildir ve kredi kullanmaz. ![Gelişmiş kural için örnek dosya adı, tanımlayıcı ve sıra metni yardımcısı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-f52e063fa15179807986274373b3862e2e41e9d6%2Fimage-import-pattern-helper.png?alt=media) *Örnekten üret yardımcısı hangi bölümün ürün tanımlayıcısı, hangisinin isteğe bağlı sıra numarası olduğunu işaretlemenizi ister.* 1. **Örnek dosya adı** alanına uzantısıyla birlikte gerçek yapıyı temsil eden sentetik bir ad yazın. 2. **Tanımlayıcı metni** alanına aynı ad içindeki SKU veya seçili alan değerini aynen yazın. 3. Varsa **Sıra numarası metni (opsiyonel)** alanına görsel sırasını belirleyen parçayı girin. 4. **Üret** oluşan deseni **Regex Deseni** alanına yazar; ayarı otomatik kaydetmez. 5. Birden fazla örnek adı **Testi Çalıştır** ile sınayın. Üretilen desen fazla geniş veya dar eşleşiyorsa düzenleyin; ancak sonra **Kaydet**'i kullanın. Sağ üstteki kapatma simgesiyle drawer'ı kapatmak kaydedilmemiş kural değişikliklerini kalıcı hâle getirmez. ## Dosyaları seçme ve işleme 1. Dosyaları sürükleyin veya **Dosya Seç**'i kullanın. 2. Seçim listesinde ad, tür ve varsa kural/eşleşme önizlemesini kontrol edin. 3. Yanlış dosyayı kaldırın veya **Yeni Yükleme** ile seçimi temizleyin. 4. **Yükle ve İşle**'yi seçin. 5. Yükleme ve işleme ilerlemesini bekleyin; sayfayı kapatmadan işin başladığını doğrulayın. Dosyanın uzantısı desteklense bile içerik geçerli bir görsel olmalıdır. Çok büyük, bozuk veya erişilemeyen dosya **Yükleme hatası** alır. ## Kanal uygunluk uyarısı Oly etkin kanalların boyut/en-boy koşullarını kontrol edebilir. Uyarı, görselin yine yükleneceği ancak belirtilen kanallara uygun sayılmayabileceği anlamına gelir. Uyarıyı yok saymak dosyayı otomatik yeniden boyutlandırmaz; kanal için uygun türev veya doğru kaynak görsel hazırlayın. ## Sonuçlar Özet şu sayıları ayırır: * **Toplam Dosya**, seçilen dosya sayısı; * **Eşleşen**, ürün veya varyant hedefi bulunan dosyalar; * **Hatalar**, yüklenemeyen veya çözülemeyen dosyalar; * **Yüklendi**, galeriye başarıyla eklenenler. Hata etiketleri: * **Kural eşleşmedi**: dosya adı aktif kuralların hiçbirine uymadı. * **Hedef bulunamadı / SKU bulunamadı**: ad çözüldü fakat ürün/varyant yok. * **Belirsiz tanımlayıcı**: aynı değer birden fazla hedefe uydu. * **Dosya adı parse edilemedi**: beklenen segment/desen yok. * **Yinelenen atlandı**: aynı görsel/hedef zaten işlenmiş kabul edildi. **Geçmiş İşlemler**, oturumların durumunu, dosya/eşleşme/hata sayılarını ve zamanını gösterir. Başarısız oturumda **Tekrar Dene** yalnız güvenle yeniden işlenebilen işi başlatır. Parçalı yükleme oluşursa Oly eksik partiyi otomatik işleme sokmaz; dosyaları kontrol edip yeni yükleme yapın. ## Ürüne etkisi ve geri alma Başarılı görsel ürün veya varyant galerisinde yeni kayıt olur; dosya sırası belirlenen sıra bilgisini izler. Araç toplu bir “geri al” sağlamaz. Yanlış hedefe eklenen görselleri ilgili ürünün Görseller sekmesinden arşivleyin/kaldırın ve kuralı düzeltmeden aynı paketi yeniden yüklemeyin. ## Yetki Admin, Manager ve Editor görsel yükleyebilir. Ayarların çalışma alanı genelini etkileyebileceğini unutmayın. Viewer'da kontroller görünürse bunu yükleme yetkisi olarak kabul etmeyin. --- # 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/tools/image-import.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.