Shopify Flow'da kullanılan API verilerini önizleme

Çoğu iş akışı, koşullarda ve eylemlerde kullanabilmeniz için mağazanızdaki verilere erişir. Shopify Flow, GraphQL Admin API'sini çağırarak mağaza verilerine erişir ve API'deki neredeyse tüm alanlara erişmenizi sağlar.

Bir iş akışı oluştururken API'yi temel alan alan adları ve açıklamalarıyla sık sık karşılaşırsınız ancak bu verilerin değerlerini bilmeniz gerekebilir. Örneğin, bir taslak siparişten oluşturulmuş bir siparişin uygulama adını bilmek isteyebilirsiniz. Ayrıca, iş akışınızın beklediğiniz verileri veya beklediğiniz biçimde çıkardığından emin olmak isteyebilirsiniz.

Verilerin değerlerini incelemek için Shopify Flow'da çeşitli seçenekleriniz vardır.

Bu sayfada

Shopify yöneticisinde alan bulma

Çoğu durumda verileri Shopify yöneticisine bakarak bulabilirsiniz. Örneğin, product.title, Ürün sayfasında listelenir.

Örnek veri alma

Bir iş akışı oluştururken doğrudan Flow düzenleyicisinden örnek veri alabilirsiniz. Flow'un verileri etkinliklerden geldiği için doğru örnek verileri almak üzere ilgili bir etkinlik seçerek başlamanız gerekir:

Flow düzenleyicisinde, verileri kullanmak istediğiniz bir eylemi açın ve Değişken ekle'ye tıklayın. Alternatif olarak, bir koşulda Ölçüt ekle'ye tıklayın.
Örnek verileri yapılandır'a tıklayın.
Flow, iş akışının tetikleyicisine göre önceki etkinlikleri gösterir. Son çalıştırmalardaki etkinlikleri getirmek için Etkinlikleri yenile'ye tıklayın veya Canlı etkinlikleri dinlemeye başla'ya tıklayıp ardından yönetici panelinde ya da ilgili uygulamada (uygulama tabanlı tetikleyiciler için) etkinliği manuel olarak tetikleyin.
Etkinlik gerçekleştikten sonra Flow, etkinlikle ilgili ayrıntıları görüntüler. Örnek veri almak için kullanmak istediğiniz etkinliği seçin. Bu tetikleyici etkinliği kullan'a tıklayın.
Artık etkinliklere göz atarken her değişken için örnek veriler görüntülenmelidir.

Sınırlamalar:

Alan kısıtlamaları nedeniyle, listedeki veriler için Flow yalnızca listenin ilk öğesindeki verileri görüntüler.
Flow, iş akışı başına aynı anda en fazla 5 etkinlik depolar.
Flow, Zamanlanmış zaman, Meta nesne girişi oluşturuldu, Müşteri segmente katıldı veya Müşteri segmentten ayrıldı gibi bazı tetikleyiciler için son çalıştırmalardaki etkinlikleri getiremez.

Alanı canlı bir iş akışında kullanma

Çıktıyı günlüğe kaydet eyleminden yararlanarak alanları bir iş akışında güvenle kullanabilirsiniz. Bir iş akışını çalıştırdığınızda Çıktıyı günlüğe kaydet eylemi, tüm değişkenlerin ve metinlerin çıktısını Çalıştırma geçmişi sayfasına yazdırır. Dahili e-posta gönder gibi bildirim eylemlerini de kullanabilirsiniz.

Çıktıyı günlüğe kaydetme adımları:

Manuel olarak tetiklenebilen bir tetikleyici seçin.
İş akışına bir Çıktıyı günlüğe kaydet eylemi ekleyin ve bunu tetikleyiciye bağlayın.
Çıktıyı günlüğe kaydet yapılandırmasında, incelemek istediğiniz değişkenleri Çıktı bölümüne eklemek için Değişken ekle'ye tıklayın.
İşiniz bittiğinde İş akışını aç'a tıklayın.
İş akışını manuel olarak çalıştırarak veya tetikleyicinin etkinleşmesini sağlayarak tetikleyin. Örneğin, Sipariş oluşturuldu tetikleyicisini kullanıyorsanız bir test siparişi oluşturun.
İş akışı çalıştıktan sonra etkinlik günlüğünde değişkenleri kontrol edin.

Kaynak JSON sayfasına başvurma

Shopify yöneticisindeki Sipariş, Ürün veya Müşteri sayfaları gibi çoğu kaynak sayfası, sayfaya hizmet eden verileri görüntülemenize olanak tanır. Bu veriler, Shopify Flow'un kullandığı adlandırma ve biçimle tam olarak aynı değildir ancak değerler GraphQL Admin API'dekilerle eşleşir. Verileri incelemek için URL'ye .json ekleyin.

Örneğin, Shopify yöneticisinde Siparişler sayfasına gidip bir siparişe tıklayarak bir siparişe gidin. Tarayıcınızın adres çubuğundaki sayfanın adresini şundan:

https://https://admin.shopify.com/store/<magazaadi>/orders/3804849891234

şu şekilde değiştirin:

https://https://admin.shopify.com/store/<magazaadi>/orders/3804849891234.json

GraphiQL veya üçüncü taraf API aracı kullanma

Postman gibi bir üçüncü taraf API aracını veya Shopify tarafından sağlanan ücretsiz araç olan GraphiQL'i kullanarak API'yi doğrudan sorgulayabilirsiniz. Bu seçenek en doğru sonuçları sağlar ancak GraphQL sorguları oluşturma konusunda biraz bilgi sahibi olmayı gerektirir.

GraphiQL için Shopify, hem genel veriler içeren web tabanlı bir GraphiQL gezgini hem de GraphiQL uygulamasını sunar. GraphiQL ile Shopify Flow'daki alan adlarıyla tam olarak eşleşen bir GraphQL sorgusu oluşturabilirsiniz. Uygulamayı kullanırsanız değerler de mağazanızla tam olarak eşleşir.

Bu aracı kullanarak, Shopify Flow'un gerçek mağaza verilerinizle tam olarak hangi verileri kullandığını belirleyebilirsiniz. Örneğin, aşağıdaki sorguyu oluşturabilirsiniz:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

Aşağıdaki sonuçlarda order / app / name değişkeni, siparişin uygulama adını gösterir. Bu durumda sipariş, taslak siparişler uygulamasından oluşturulduğu için değer Draft Orders şeklindedir. Kanal bilgileri yalnızca Satış Noktası uygulaması için kullanılabilir.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }