> 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/runs.md). # Import çalıştırmaları Çalışmayı başlatma, ilerlemeyi okuma, geçmişi inceleme ve hata durumlarında karar verme. Her **Import Çalıştır** işlemi bağlantı ayarlarının o andaki hâliyle ayrı bir çalışma oluşturur. Eski çalışma sonucu değişmez; yeniden çalıştırmak yeni bir satır ve yeni Staging kayıtları üretir. ## Çalışma geçmişi ![Örnek CSV bağlantısının çalışma geçmişi tablosu](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-7f39adaddd974f52ef698e58938d33d42d4b4d92%2Frun-history.png?alt=media) *Geçmiş, aynı bağlantının farklı çalıştırmalarını sayı ve süre üzerinden karşılaştırır.* | Kolon | Anlamı | | ----------------- | ----------------------------------------------------------------------------------- | | **#** | Bağlantı içindeki çalışma numarasıdır. Satırı seçmek ayrıntıyı açar. | | **Tarih** | Çalışmanın başladığı zamandır. | | **Başlatılan** | Manuel kullanıcı işlemi veya zamanlama gibi tetikleyicidir. | | **Durum** | Çalışmanın aktif mi, tamamlanmış mı, iptal mi, başarısız mı olduğunu gösterir. | | **Çekilen** | Kaynaktan okunabilen ham kayıt sayısıdır. | | **Normalize** | Ortak ürün yapısına dönüştürülebilen kayıt sayısıdır. | | **Import Edilen** | Gerçek kataloğa aktarılmış ürün sayısıdır; Staging'de bekleyenler bu sayıya girmez. | | **Hatalar** | Müdahale bekleyen kayıt veya çalışma hatası sayısıdır. | | **Süre** | Başlangıçtan terminal duruma kadar geçen zamandır. | Sayfa başı seçimi ve ileri/geri düğmeleri uzun geçmişi gezinmek içindir. Eski bir sorunu araştırırken önce hata sayısı olan run'ı, sonra run detayındaki hata özetini ve **Staging'de Gör** bağlantısını kullanın. ## Durumlar | Görünen durum | Kullanıcı açısından anlamı | | ------------------------- | ----------------------------------------------------------------------------------------------------- | | **Bekliyor** | Çalışma kabul edildi, işleme başlaması bekleniyor. Kısa süre bekleyin. | | **Çekiliyor...** | Kaynak dosya veya bağlantı okunuyor. | | **Normalleştiriliyor...** | Kaynak satırlar ürün/varyant yapısına hazırlanıyor. | | **Eşleniyor...** | Alan, seçenek ve kategori kuralları uygulanıyor. | | **AI Eşleştirme...** | Seçili kategori modu AI eşleştirmesi yapıyor; kredi onayı bağlantı ayarlarına göre alınmış olmalıdır. | | **Hazırlanıyor...** | Kayıtlar ve gerekiyorsa yeni seçenek sonuçları Staging için hazırlanıyor. | | **Import Ediliyor...** | Otomatik import açıksa onaylanan kayıtlar gerçek ürüne aktarılıyor. | | **Tamamlandı** | Çalışma terminaldir. Bazı kayıtların Staging'de hata/uyarı beklemesi yine mümkündür. | | **Başarısız** | Çalışma sürdürülemedi. Hata özetini inceleyip ayarları düzeltin ve yeni run başlatın. | | **İptal Edildi** | Aktif çalışma durdurulmuştur. Yazılmış Staging kayıtları otomatik geri alınmış kabul edilmemelidir. | Durum adları ekranda işlem aşamasına göre kısalabilir. **Tamamlandı**, “bütün ürünler kataloğa aktarıldı” anlamına gelmez. ## Run detayını okumak ![Altı kaydı işleyen ve üç hatayı Staging'e bırakan tamamlanmış run](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-917db43028932f8e493e079062cf0de67600598f%2Frun-detail-history.png?alt=media) *Örnek run tamamlanmıştır; 6 kayıt işlenmiş, 3 hata kullanıcı müdahalesine bırakılmış ve gerçek ürüne aktarım henüz yapılmamıştır.* Üst kartlarda tetikleyen kullanıcı, süre, başarı oranı ve hata sayısı görünür. **Pipeline Durumu** toplam ve aşama sayaçlarını gösterir: * **Toplam Çekilecek / Çekilen**, kaynak hacmini; * **Normalize**, yapısal olarak okunabilen kayıtları; * **Eşlenen / Staged**, alan ve kategorileri uygulanıp Staging'e yazılanları; * **Import Edilen**, gerçek ürüne dönüşenleri; * **Başarılı**, **Hatalı**, **Atlanan** ve **Değişmeyen**, kullanıcı açısından sonuç dağılımını gösterir. “Değişmeyen” bir kayıt başarıyla değerlendirilmiş fakat Oly'de yazılacak yeni değer bulunmamış olabilir. “Atlanan” SKU çakışmasında **Atla** kuralı veya işlenemeyen bir hedef nedeniyle oluşabilir. Görsel URL'leri eşlenmişse indirme ilerlemesi ayrı görünür. Bazı görseller başarısız olduğunda ürün kayıtları tamamlanabilir; **Görselleri Tekrar Dene** yalnız başarısız görsel işlerini yeniden başlatır, alan/kategori eşlemesini yeniden çalıştırmaz. REST çalışmalarında istek türü ve güvenli yanıt özeti ayrıntı olarak açılabilir. Kaynak parolası veya token gösterilmez. Dosya run'ında dosya ve okuma ayarları bağlantı yapılandırmasından izlenir. ## Warning, error ve başarısız run * **Warning**, kayıt Staging'e yazılmış ve onaylanabilirken dikkat edilmesi gereken eksikliği bildirir. Örnek: zorunlu **Marka** boşluğu mevcut build'de uyarıdır. * Kayıt **error**'ı tek ürünü bloklar; run'ın tamamı yine **Tamamlandı** olabilir. Örnek: eşlenmeyen kategori, ürün tipi olmayan kategori veya geçersiz seçenek. * Run **Başarısız** ise kaynak/bağlantı veya çalışmanın bütünü terminal hata almıştır; yalnız Staging satırını düzeltmek yeterli olmayabilir. Hata günlüğüyle veri tavsiyelerini ayırın. Bazı satırlar “içe aktarıldı, ancak dikkat gerekiyor” anlamındadır; hata sayısını tek başına run başarısızlığı olarak okumayın. ## İptal ve yeniden deneme Aktif run'da **İptal Et** görünür. İptal terminaldir ve aynı run devam ettirilmez. Ayarları/dosyayı kontrol ettikten sonra bağlantıdan yeni **Import Çalıştır** başlatın. Genel bir “aynı run'ı retry” düğmesi yoktur. Yeni run aynı bağlantıyı yeniden işler ve ayrı geçmiş oluşturur. Yalnız görsel indirme hatalarında **Görselleri Tekrar Dene** bulunabilir. ## Başlatmadan önce yakalayabilecekleriniz * Bağlantı testi: erişim, kimlik doğrulama ve örnek kayıt. * Dosya önizlemesi: ayırıcı, kodlama, başlık, sayfa ve kolonlar. * Veri yapısı önizlemesi: ürün sayısı, SKU ve gruplama. * Mapping önizlemesi: örnek kaynak → dönüştürülmüş hedef. * Son gözden geçirme: eşleme sayıları, kategori modu, SKU çakışması, dil, otomatik onay/import. Bu kontroller kaynak verinin sonraki satırlarının tamamını garanti etmez; ilk run sonrasında Staging hata gruplarını mutlaka inceleyin. ## Yetki Admin, Manager ve Editor run başlatabilir, aktif run'ı iptal edebilir ve görselleri yeniden denemeyi başlatabilir. Viewer geçmiş ve detayları okuyabilir; iptal, görselleri yeniden deneme ve run içindeki Staging işlemleri Viewer için yetki hatasıyla reddedilir. Bir Viewer oturumunda bu düğmelerden birinin görünmesi yazma yetkisi olduğu anlamına gelmez. --- # 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/runs.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.