Shopify Komut Dosyalarını test etme ve hatalarını ayıklama

Komut dosyalarınızı test etmek ve hatalarını ayıklamak için Script Editor'daki hata ayıklama özelliklerini kullanabilirsiniz.

Plan şartı

Shopify Komut Dosyaları ve Script Editor uygulaması yalnızca Shopify Plus planındaki mağazalarda kullanılabilir. Script Editor uygulaması artık Shopify App Store'dan indirilememektedir.

30 Haziran 2026'da Shopify Komut Dosyaları kaldırılacak ve artık çalışmayacaktır. Mevcut Shopify Komut Dosyaları kullanım örnekleriniz için desteğin devam etmesini istiyorsanız mevcut ödeme, kargo veya satır öğesi komut dosyalarınız yerine uyumlu Shopify Functions sürümlerine geçmeniz gerekir. Shopify Komut Dosyalarından Shopify Functions'a geçiş hakkında daha fazla bilgi edinin.

Script Editor, siz komut dosyası yazarken kodunuzu temel hatalara karşı denetler:

Ayrıca, yayınlanan komut dosyalarında oluşan hataları bildirir ve bu hatalar oluştuğunda size bir e-posta gönderir:

Bir komut dosyasını test etmeden veya yayınlamadan önce söz dizimi hataları gibi hataları düzeltmek iyi bir fikirdir. Komut dosyanızda söz dizimi hataları varsa komut dosyanızı test etme işlemi muhtemelen çalışmaz.

Bir komut dosyası hatası hakkında daha fazla bilgiye ihtiyacınız varsa imlecinizi Script Editor'ın kenar boşluğundaki kırmızı x simgesinin üzerine getirin:

Komut dosyalarını çoğaltma

Hata içeren yayınlanmış bir komut dosyasını test etmeniz veya hatalarını ayıklamanız gerekiyorsa komut dosyasını çoğaltın ve çoğaltılan komut dosyasını yayınlayın. Hata ayıklama işlemini, hata meydana geldiğinde yayınlanmış olan komut dosyasında yapmanız gerekir çünkü hata ayrıntıları bu sürüme eklenmiştir.

Bir komut dosyasını çoğalttığınızda, komut dosyasına ekli olan üretim hatası ayrıntıları kopyalanmaz.

Bir komut dosyasını çoğaltmak için:

1. Script Editor'da, çoğaltmak istediğiniz komut dosyasının adına tıklayın.

2. Komut dosyasının bir kopyasını oluşturmak için Çoğalt'a tıklayın.

Üretim hatalarını ayıklama

Bir üretim hatasını ayıklamak için:

1. Hataları içeren komut dosyasını çoğaltın.

2. Mağazanızda müşterilerinizin kullanımına sunulacak bir komut dosyası sürümü olması için çoğaltılan komut dosyasını yayınlayın. Bu adımda, komut dosyasının mağazanızdan yayından kaldırılmasını gerektirecek kadar çok hata içermediği varsayılır.

3. Orijinal komut dosyasını, kendisine eklenmiş olan hata ayrıntılarını kullanarak ayıklayın.

Komut dosyasını test etme

Bir komut dosyası üzerinde çalışırken, mağazanızda yayınlamadan önce çalıştığından emin olmak için komut dosyasını Script Editor içinden test edebilirsiniz.

Bir komut dosyasını test etmek için:

1. Script Editor'da, test etmek istediğiniz komut dosyasını açın.
2. Bir test sepetini düzenlemek için Girişseçeneğine tıklayın. Ayrıca Her ikisi seçeneğine tıklayarak komut dosyası kodunu ve test sepetini aynı anda görebilirsiniz. Giriş görünümü, komut dosyanızı test etmek için sepet düzenleme seçeneklerini gösterir. Komut dosyanızı neye göre test etmek istediğinize bağlı olarak ürün, müşteri, indirim kodu, müşteri bilgisi ve kargo bilgisi ekleyebilirsiniz.
   • Test siparişine ürün aramak ve eklemek için Ürünler bölümüne yazın.
   • Test siparişine indirim kodu aramak ve eklemek için İndirim kodu bölümüne yazın.
   • Test siparişine müşteri aramak ve eklemek için Müşteri bilgileri bölümüne yazın.
   • Test siparişinin kargo adresini değiştirmek için Kargo adresi bölümünde Ekle veya Düzenle'ye tıklayın.
3. Tıklayın Komut dosyasını çalıştır seçeneğine tıklayarak komut dosyasının test sepetinizde yaptığı değişiklikleri görün.
   • Komut dosyanız başarıyla çalışırsa Çıkış bölümü, komut dosyası tarafından uygulanan değişiklikleri gösterecek şekilde güncellenir. Çıkış bölümü değişmezse veya beklenmedik değişiklikler olursa komut dosyanızda hatalar olabilir. Şunu kontrol edin: Konsol kutusunu Ruby kaynak kodu bölümünde kontrol ederek komut dosyası hatalarını çözün:

     

   • Konsol kutusu, komut dosyasının kaynak kullanımını bildirir. Daha karmaşık komut dosyaları daha fazla kaynak kullanır. Komut dosyalarının kullanabileceği sınırlı miktarda CPU ve bellek vardır.
4. İşiniz bittiğinde:
   • komut dosyasının yayınlanmamış taslağını güncellemek ve kaydetmek için Taslağı kaydet'e tıklayın
   • komut dosyasını güncellemek ve yayınlamak için Etkinleştir'e tıklayın.

Hata bildirimleri aboneliğinden çıkma

Bir komut dosyası yayınladığınızda, bu komut dosyasına yönelik bildirim e-postalarına otomatik olarak abone olursunuz. Bu komut dosyasında bir üretim hatası her oluştuğunda hatayla ilgili bir e-posta alırsınız. Ardından, hata hakkında daha fazla bilgi edinmek ve hatayı ayıklamak için Script Editor'ı açabilirsiniz.

Bu e-postalardan birini aldıktan sonra abonelikten çıkabilirsiniz. Abonelikten çıkmak için hataya ilişkin Üretim Hatası sayfasını açın ve Abonelikten çık'a tıklayın.

Sonraki adımlar

Komut dosyanızdan memnun olduğunuzda, onu mağazanızda yayınlayabilirsiniz. Online mağazanızın, komut dosyalarınızın yaptığı değişikliklere yanıt vermesi için Liquid şablon dosyalarınızı da güncelleyebilirsiniz.

Daha fazla bilgi edinin

Aşağıdaki konular hakkında daha fazla bilgi edinin:

• Komut dosyalarınızı yayınlama ve yayından kaldırma
• Liquid şablonlarınızı komut dosyaları için güncelleme
• Shopify Scripts API