Kodu çalıştır

Kod çalıştır işlemi, JavaScript kodu yürütür. İş akışının önceki adımlarından gelen verileri Kod çalıştır işlemine girdi olarak aktarabilir ve sonraki adımlarda kullanılacak değerleri döndürebilirsiniz.

Bu sayfada

Alanlar

Kod çalıştır işlemi aşağıdaki alanları içerir.

Kod çalıştır işleminde kullanılan alanlar.
Alan	Açıklama
Input	Gerekli. Önceki adımlardan elde edilen verilerin Kod çalıştır eyleminde girdi olarak kullanılmasını sağlayan bir GraphQL sorgusu.
Çıktı	Gerekli. GraphQL'in şema tanımlama dilinde (SDL) tanımlanan, işlem tarafından döndürülecek verilerin temsili.
Kod	Gerekli. Kod çalıştır işleminin yürüteceği JavaScript.

Girdi verileri

Girdi verileri, Kodu çalıştır işleminden önce gerçekleşen adımlardan aktarılabilir. Bu verileri eklemek için Girdi alanına bir GraphQL sorgusu yazabilirsiniz . Sorgudan döndürülen veriler, export default olarak işaretlenen ve genel kullanımda main olarak adlandırılan işlevde input bağımsız değişkeni olarak kullanılabilir.

Girdi sorgusu, Shopify Admin API'ye yönelik bir sorgu değil, Flow ortamı verilerine yönelik bir sorgudur. Bu nedenle giriş verilerine Shopify sorgusu ekleyemezsiniz. Ayrıca, sorgudakiedges ve nodes öğelerini Flow yöneteceğinden, sorgunuza bu veya benzeri sayfalandırma söz dizimleri eklemenize gerek yoktur.

Sipariş notunu ve satır öğesinin başlığını alan örnek bir girdi:

{
  order {
    note
    lineItems {
      title
    }
  }
}

Bu veriler, kodda kullanılabilecek bir input değişkenine dönüştürülür:

export default function main(input) {
  // input.order.note
  // input.order.lineItems[0].title
}

Girdiler ayrıca işlev imzasında da yapılandırılabilir:

export default function main({order}) {
  // order.note
  // order.lineItems[0].title
}

Çıktı verileri

Kod çalıştır işlemi özel veriler de döndürebilir. Kodun geri döndüreceği verilerin türünü tanımlamak için Çıktı alanını ve GraphQL'in Şema tanımlama dilini (SDL) kullanın. Örneğin giftMessage adlı bir dize ve totalGifts adlı bir sayı döndürmek için:

type Output {
  "The message to include in the gift"
  giftMessage: String!
  "The total number of gifts"
  totalGifts: Int!
}

Yorumlar isteğe bağlıdır ancak Flow kullanıcı arabiriminde verileri açıklamak için kullanılır. JavaScript kodunda bu verilerin çıktısını almak için tür ile eşleşen bir nesne döndürün:

export default function main(input) {
  // your code
  return {
    giftMessage: 'Hello',
    totalGifts: 1,
  };
}

Ayrıca, daha karmaşık veriler döndürmek için özel bir tür de tanımlayabilirsiniz. Örneğin, Gift adlı bir dize ve message adlı bir sayı içeren amount adlı bir tür döndürmek için:

type Output {
  "The gift to send"
  gifts: [Gift!]!
}

type Gift {
  "The message to include in the gift"
  message: String!
  "The total number of gifts"
  amount: Int!
}

Bu işlemi takip eden adımlarda bu verilere erişmek için, Kod çalıştır işlem konfigürasyonunda tanımladığınız Output şemasına göre türü belirlenecek olan Kod çalıştır adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz.

Console.log

Hata giderme amacıyla Flow'un iş akışı çalıştırma günlüğüne veri çıktısı almak için console.log öğesini kullanabilirsiniz. Çıktı, iş akışının Çalıştırma günlüğünde görünür. Örneğin, aşağıdakiler geçerlidir:

export default function main(input) {
  console.log('Hello, world!');
  //Hello, world!
  console.log(input);
  // { order: { note: 'Hello', lineItems: [{ title: 'World' }] } }
  console.log(input.order, "is the order");
  // { note: 'Hello', lineItems: [{ title: 'World' }] }
  // is the order

  return {
    giftMessage: 'Hello',
    totalGifts: 1,
  };
}

Kodu çalıştır işleminde console.info, console.error veya diğer işlevleri kullanamazsınız.

Örnek

Kod çalıştır işleminin örneklerini, Flow örnekleri deposunda bulabilirsiniz.

Sınırlamalar

Kod çalıştır işlemi, aşağıdaki sınırlamalara sahiptir:

Kodu çalıştır işlemi, ECMA2020 JavaScript'i destekler. NodeJS veya CommonJS API'lerini veya modülleri içe aktarma işlemini desteklemez.
Kodunuz http çağrıları (fetch) yapamaz.
Rastgele ve saate dayalı işlevler kullanılamaz. scheduledAt veya createdAt gibi tarih verileri, girdi olarak aktarılabilir.
Console.log, tarayıcı konsolunda günlük tutmaz.

Ayrıca aşağıdaki sınırlar da uygulanır:

Girdi verileri sorgusu 5000 karakterle sınırlıdır.
Çıktı verileri şeması 5000 karakterle sınırlıdır.
Çıktı veri yükü ve Console.log çıktısı bir arada 50 kb ile sınırlıdır.
Kod 50.000 karakterden uzun olamaz.
Toplam yürütme süresi 5 saniyeyle sınırlıdır.
Bellek kullanımı 10 MB ile sınırlıdır.

Yol haritası

Flow ekibi, Kod çalıştır işlemine zaman içinde yeni özellikler eklemeyi planlamaktadır. Aşağıdaki tabloda, iyileştirmeler ve tahmini sunum zamanları ana hatlarıyla açıklanmıştır.

Kod çalıştır işlemine yönelik iyileştirmeler için yol haritası
İyileştirme	Açıklama	Tahmini Sunum Zamanı
Günlük kaydı	"Console.log"u kullanarak hata giderme amacıyla Çalıştırma günlüğüne veri çıktısı alma.	Sunuldu.
Harici API çağrıları	API çağrıları için JavaScript'in alma özelliğini kullanma.	2024'ün 3. çeyreği

Geri bildirim

Kod çalıştır işlemi, Shopify Flow'da yeni bir adım türüdür. Geri bildirimleriniz ve sorularınız varsa lütfen bu Flow topluluk gönderisine yorum ekleyin.