Pratonton data API yang digunakan dalam Shopify Flow

Kebanyakan aliran kerja mengakses data daripada kedai anda agar anda boleh menggunakan data ini dalam syarat dan tindakan. Shopify Flow mengakses data kedai dengan memanggil GraphQL Admin API, lantas membolehkan anda mengakses hampir kesemua medan dalam API tersebut.

Semasa anda membina aliran kerja, anda akan kerap menemukan nama medan dan perihalan berdasarkan API, tetapi anda mungkin perlu mengetahui nilai data tersebut. Contohnya, anda mungkin ingin mengetahui nama aplikasi bagi pesanan yang dicipta daripada pesanan draf. Selain itu, anda mungkin ingin memastikan aliran kerja anda mengeluarkan data yang anda jangkakan, atau dalam bentuk yang anda jangkakan.

Untuk menyemak nilai data, anda mempunyai beberapa pilihan dalam Shopify Flow.

Cari medan dalam pentadbir Shopify

Dalam kebanyakan kes, anda boleh menemukan data dengan mencari dalam pentadbir Shopify. Contohnya, product.title disenaraikan pada halaman Produk.

Dapatkan data sampel

Apabila anda membina aliran kerja, anda boleh mendapatkan data sampel secara langsung dalam editor Flow. Oleh sebab data Flow datang daripada acara, anda mestilah bermula dengan memilih acara yang berkaitan untuk mendapatkan data sampel yang tepat:

1. Dalam editor Flow, buka tindakan tempat anda ingin menggunakan data dan klik Tambah pemboleh ubah. Secara alternatif, pada keadaan, klik Tambah kriteria.
2. Klik Konfigurasikan data sampel.
3. Flow memaparkan acara sebelumnya berdasarkan pencetus aliran kerja. Klik Segar semula acara untuk mengambil acara daripada jalankan terbaharu, atau klik Mula mendengar acara langsung dan kemudian cetus acara secara manual dalam Pentadbir atau aplikasi yang berkaitan (untuk pencetus berasaskan aplikasi).
4. Selepas acara tersebut berlaku, Flow akan memaparkan butiran tentang acara tersebut. Pilih acara yang anda ingin gunakan untuk mendapatkan data sampel. Klik Gunakan acara pencetus ini.
5. Sekarang, semasa anda menyemak imbas acara, data sampel seharusnya dipaparkan bagi setiap pemboleh ubah.

Pengehadan:

• Disebabkan oleh kekangan ruang, bagi data dalam senarai, Flow hanya akan memaparkan data daripada item pertama dalam senarai tersebut.
• Flow akan menyimpan hingga 5 acara pada satu masa, untuk setiap aliran kerja.
• Flow tidak dapat mengambil acara daripada jalankan terbaharu untuk beberapa pencetus, seperti Masa dijadualkan, Entri metaobjek dicipta, Pelanggan menyertai segmen, atau Pelanggan meninggalkan segmen.

Gunakan medan dalam aliran kerja langsung

Anda boleh menggunakan medan tersebut secara selamat dalam aliran kerja dengan memanfaatkan tindakan Output log. Apabila anda menjalankan aliran kerja, tindakan Output log akan mencetak output bagi apa-apa pemboleh ubah dan teks kepada halaman Sejarah jalankan. Anda juga boleh menggunakan tindakan pemberitahuan seperti Hantar e-mel dalaman.

Langkah-langkah untuk menggunakan Output log:

1. Pilih pencetus yang boleh dicetuskan secara manual.
2. Tambahkan tindakan Output log pada aliran kerja dan sambungkannya pada pencetus tersebut.
3. Dalam konfigurasi Output log, klik Tambah pemboleh ubah untuk menambahkan pemboleh ubah yang ingin diperiksa kepada bahagian Output.
4. Apabila selesai, klik Hidupkan aliran kerja.
5. Cetus aliran kerja tersebut, sama ada dengan menjalankannya secara manual atau dengan menyebabkan pencetus diaktifkan. Contohnya, jika anda menggunakan pencetus Pesanan dicipta, kemudian cipta pesanan ujian.
6. Selepas aliran kerja dijalankan, semak log aktiviti untuk pemboleh ubah tersebut.

Rujuk kepada halaman JSON sumber

Kebanyakan halaman sumber dalam pentadbir Shopify, seperti halaman Pesanan, Produk, atau Pelanggan, membolehkan anda melihat data yang menyokong halaman tersebut. Data ini tidak menggunakan penamaan dan format yang sama dengan yang digunakan oleh Shopify Flow, tetapi nilainya sepadan dengan apa-apa yang terdapat dalam GraphQL Admin API. Untuk menyemak data, tambahkan .json pada URL.

Contohnya, navigasi kepada pesanan dengan pergi ke halaman Pesanan dalam pentadbir Shopify dan klik pada pesanan tersebut. Dalam alamat halaman pada bar alamat pelayar anda, tukar alamat tersebut daripada:

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

Kepada yang berikut:

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

Nota

Format .json mengikuti REST API. Format huruf bagi nama pemboleh ubah dalam REST API menggunakan garis bawah, seperti line_items. GraphQL dan Shopify Flow menggunakan camelCasing (kotak unta), seperti lineItems. Selain itu, kadangkala nama medan adalah berbeza, seperti properties dan bukannya customAttributes. Sahkan maklumat yang anda temukan dengan menggunakan pendekatan ini.

Gunakan GraphiQL atau alat API pihak ketiga

Anda boleh membuat pertanyaan API secara langsung dengan menggunakan alat API pihak ketiga seperti Postman atau alat percuma yang disediakan oleh Shopify, iaitu GraphiQL. Pilihan ini memberikan hasil yang paling tepat, tetapi pilihan ini memerlukan sedikit kebiasaan dalam penciptaan pertanyaan GraphQL.

Bagi GraphiQL, Shopify menawarkan penjelajah GraphiQL berasaskan web dengan data generik serta aplikasi GraphiQL. Dengan GraphiQL, anda boleh membina pertanyaan GraphQL yang sepadan dengan tepat dengan nama medan dalam Shopify Flow. Nilainya juga sepadan dengan tepat dengan kedai anda jika anda menggunakan aplikasi tersebut.

Dengan menggunakan alat ini, anda boleh menentukan dengan tepat data yang digunakan oleh Shopify Flow, dengan data kedai sebenar anda. Contohnya, anda mencipta pertanyaan yang berikut:

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

Dalam hasil yang berikut, pemboleh ubah order / app / name memaparkan nama aplikasi bagi pesanan tersebut. Dalam kes ini, pesanan dicipta daripada aplikasi pesanan draf, maka nilainya ialah Draft Orders. Maklumat saluran hanya tersedia untuk aplikasi Point of Sale.

{
  "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"
            }
          }
        }
      ]
    }
  }