Shopify Flow'da kullanılan API verilerini önizleme

İş akışı oluşturduğunuzda genellikle mağazanızdaki verileri koşullarda ve işlemlerde kullanmak isteyebilirsiniz. Shopify Flow, GraphQL Admin API'ye çağrı yaparak mağaza verilerine erişir. Böylece API'deki neredeyse tüm alanlara erişebilirsiniz.

Bir iş akışı oluştururken genellikle API'ye dayalı alan adları ve açıklamalarıyla karşılaşırsınız ancak API'den hangi verilerin çıktığını bilmeniz gerekebilir. Örneğin, bir taslak siparişten oluşturulan sipariş için uygulama adını bilmek isteyebilirsiniz. Ayrıca, iş akışınızın beklediğiniz verilerin çıktısını aldığından veya bu çıktıların beklediğiniz biçimde olduğundan emin olmak isteyebilirsiniz.

Shopify Flow'da verileri inceleyebileceğiniz birkaç seçeneğiniz vardır.

Shopify yöneticisinde alan bulma

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

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

Çıktıyı günlüğe kaydet işlemiyle iş akışındaki alanları güvenli bir şekilde kullanabilirsiniz . Bir iş akışını çalıştırdığınızda, Çıktıyı günlüğe kaydet işlemi tüm değişkenlerin ve metinlerin çıktısını Çalıştırma geçmişi sayfasına yazdırır. Ayrıca, Dahili e-posta gönder gibi bildirim işlemlerini de kullanabilirsiniz.

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

1. Manuel olarak tetiklenebilen bir tetikleyici seçin.
2. İş akışına bir Çıktıyı günlüğe kaydet işlemi ekleyin ve tetikleyiciye bağlayın.
3. Çı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
4. Bu işlemi tamamladıktan sonra İş akışını aç'a tıklayın.
5. Manuel olarak çalıştırarak veya tetikleyicinin çalışmasına neden olarak iş akışını tetikleyin. Örneğin, Sipariş oluşturuldu tetikleyicisini kullanıyorsanız test siparişi oluşturun.
6. İş akışı çalıştırıldıktan sonra değişkenlerin etkinlik günlüğünü kontrol edin.

Kaynak JSON sayfasına bakma

Shopify yöneticisindeki Sipariş, Ürün veya Müşteri sayfaları gibi kaynak sayfalarının çoğu, sayfada yayınlanan verileri görüntülemenize olanak sağlar. Bu veriler, Shopify Flow'un kullandığı ad ve biçimin tam olarak aynısı değildir ancak değerler GraphQL Admin API'deki değerlerle eşleşir. Verileri incelemek için URL'ye .json ifadesini ekleyin.

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

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

Şu şekilde değiştirin:

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

Not

.json biçimi REST API'yi izler. REST API'de değişken adlarının yazımında alt çizgi kullanılır. Örneğin, line_items. GraphQL ve Shopify Flow'da camelCasing kullanılır. Örneğin, lineItems. Ayrıca, alan adları bazen değişiklik gösterebilir. Örneğin, properties yerine customAttributes kullanılabilir. Bu yaklaşımı kullanarak bulduğunuz bilgileri doğrulayın.

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

Postman gibi bir üçüncü taraf API aracı veya Shopify tarafından sağlanan ücretsiz araç GraphiQL'yi kullanarak API'yi doğrudan sorgulayabilirsiniz. Bu seçenek en doğru sonuçları sağlar, ancak GraphQL sorguları oluşturmayı bilmenizi gerektirir.

GraphiQL için Shopify, hem genel verilere sahip web tabanlı bir GraphiQL gezgini hem de GraphiQL uygulaması sunar. GraphiQL sayesinde Shopify Flow'da gördüğünüz alan adlarıyla tam olarak eşleşen bir GraphQL sorgusu oluşturabilirsiniz. Uygulamayı kullanıyorsanız değerler mağazanız ile tam olarak eşleşir.

Bu araç ile gerçek mağaza verilerinizi kullanarak Shopify Flow'un 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 örnekte sipariş, taslak siparişler uygulamasından oluşturulmuştur. Böylece değer Draft Orders şeklindedir. Kanal bilgileri yalnızca Point of Sale 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"
            }
          }
        }
      ]
    }
  }