Shopify Flow-ში გამოყენებული API მონაცემების წინასწარი ნახვა

სამუშაო პროცესების უმეტესობას შენი მაღაზიის მონაცემებთან აქვს წვდომა, რათა მათი გამოყენება პირობებსა და ქმედებებში შეძლო. Shopify Flow მაღაზიის მონაცემებზე წვდომას GraphQL Admin API-ის გამოძახებით იღებს, რაც გაძლევს წვდომას API-ში არსებულ თითქმის ყველა ველზე.

როდესაც სამუშაო პროცესს აგებ, ხშირად წააწყდები API-ზე დაფუძნებულ ველის სახელებსა და აღწერებს, თუმცა შეიძლება დაგჭირდეს ამ მონაცემების მნიშვნელობების ცოდნა. მაგალითად, შეიძლება გინდოდეს იმ აპის სახელის ცოდნა, რომელიც შეკვეთის მონახაზიდან შეიქმნა. გარდა ამისა, შეიძლება გსურდეს დარწმუნდე, რომ შენი სამუშაო პროცესი გამოიტანს იმ მონაცემებს, რომლებსაც მოელი, ან იმ ფორმით, რომლითაც მოელი.

მონაცემთა მნიშვნელობების გადასახედად, Shopify Flow-ში რამდენიმე არჩევანი გაქვს.

ამ გვერდზე

იპოვე ველი Shopify-ს ადმინში

უმეტეს შემთხვევაში, მონაცემების პოვნა Shopify-ს ადმინშია შესაძლებელი. მაგალითად, product.title მოცემულია პროდუქტის გვერდზე.

მიიღე ნიმუში მონაცემები

როდესაც სამუშაო პროცესს აგებ, ნიმუში მონაცემების მიღება უშუალოდ Flow რედაქტორში შეგიძლია. რადგან Flow-ს მონაცემები მოვლენებიდან მოდის, ზუსტი ნიმუში მონაცემების მისაღებად, ჯერ შესაბამისი მოვლენა უნდა აირჩიო:

Flow-ს რედაქტორში გახსენი ქმედება, სადაც გსურს მონაცემების გამოყენება და დააკლიკე: ცვლადის დამატება. ან, პირობის შემთხვევაში, დააკლიკე: კრიტერიუმის დამატება.
დააკლიკე: ნიმუში მონაცემების კონფიგურაცია.
Flow აჩვენებს წინა მოვლენებს სამუშაო პროცესის ტრიგერის საფუძველზე. დააკლიკე: მოვლენების განახლება ბოლო გაშვებებიდან მოვლენების მისაღებად, ან დააკლიკე: აქტიური მოვლენების მოსმენის დაწყება და შემდეგ ხელით აამუშავე ტრიგერი ადმინში ან შესაბამის აპში (აპზე დაფუძნებული ტრიგერებისთვის).
მოვლენის განხორციელების შემდეგ, Flow აჩვენებს მოვლენის დეტალებს. აირჩიე მოვლენა, რომლის გამოყენებაც გსურს ნიმუში მონაცემების მისაღებად. დააკლიკე: გამოიყენე ეს ტრიგერის მოვლენა.
ახლა, მოვლენების დათვალიერებისას, ნიმუში მონაცემები თითოეული ცვლადისთვის უნდა გამოჩნდეს.

შეზღუდვები:

სივრცის შეზღუდვის გამო, სიაში არსებული მონაცემებისთვის Flow აჩვენებს მონაცემებს მხოლოდ სიის პირველი ერთეულიდან.
Flow შეინახავს ერთდროულად არაუმეტეს 5 მოვლენას თითოეულ სამუშაო პროცესზე.
ზოგიერთი ტრიგერისთვის Flow-ს არ შეუძლია ბოლო გაშვებებიდან მოვლენების ამოღება, მაგალითად: დაგეგმილი დრო, მეტაობიექტის ჩანაწერი შეიქმნა, მომხმარებელი შეუერთდა სეგმენტს, ან მომხმარებელმა დატოვა სეგმენტი.

გამოიყენე ველი აქტიურ სამუშაო პროცესში

სამუშაო პროცესში ველების უსაფრთხოდ გამოყენება შეგიძლია ჟურნალის შედეგის ქმედების მეშვეობით. სამუშაო პროცესის გაშვებისას, ქმედება ჟურნალის შედეგი ნებისმიერი ცვლადისა და ტექსტის შედეგს დაბეჭდავს გაშვების ისტორიის გვერდზე. ასევე შეგიძლია გამოიყენო შეტყობინების ქმედებები, როგორიცაა შიდა ელფოსტის გაგზავნა.

ჟურნალის შედეგის ქმედების გამოყენების ნაბიჯები:

აირჩიე ტრიგერი, რომლის ამოქმედებაც ხელითაა შესაძლებელი.
დაამატე ქმედება ჟურნალის შედეგი სამუშაო პროცესს და დაუკავშირე იგი ტრიგერს.
ჟურნალის შედეგის კონფიგურაციაში დააკლიკე: ცვლადის დამატება, რათა დაამატო ის ცვლადები შედეგის სექციაში, რომელთა შემოწმებაც გსურს.
დასრულებისას დააკლიკე: სამუშაო პროცესის ჩართვა.
აამუშავე სამუშაო პროცესი ან მისი ხელით გაშვებით, ან ტრიგერის ამოქმედებით. მაგალითად, თუ იყენებ ტრიგერს შეკვეთა შეიქმნა, შექმენი სატესტო შეკვეთა.
სამუშაო პროცესის გაშვების შემდეგ, შეამოწმე ცვლადების აქტივობების ჟურნალი.

იხილე რესურსის JSON გვერდი

Shopify-ს ადმინში არსებული რესურსების გვერდების უმეტესობა, მაგალითად შეკვეთის, პროდუქტის ან მომხმარებლის გვერდები, გაძლევს იმ მონაცემების ნახვის საშუალებას, რომლებიც ემსახურება გვერდს. ამ მონაცემებს არ აქვს ზუსტად ისეთივე სახელები და ფორმატი, როგორსაც იყენებს Shopify Flow, მაგრამ მნიშვნელობები ემთხვევა GraphQL Admin API-ში არსებულს. მონაცემების გადასახედად, URL-ს დაუმატე .json.

მაგალითად, გადადი შეკვეთაზე — შედი Shopify-ს ადმინში შეკვეთების გვერდზე და დააკლიკე შეკვეთას. შენი ბრაუზერის მისამართების ზოლში შეცვალე გვერდის მისამართი ამიდან:

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

შემდეგზე:

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

შენიშვნა

.json ფორმატი მიჰყვება REST API-ს. REST API-ში ცვლადების სახელების რეგისტრად გამოყენებულია ქვედა ტირეები, მაგალითად line_items. GraphQL და Shopify Flow იყენებენ camelCase-ს (აქლემისებრ რეგისტრს), მაგალითად lineItems. გარდა ამისა, ზოგჯერ ველის სახელები განსხვავდება, მაგალითად properties, customAttributes-ის ნაცვლად. გადაამოწმე ამ მიდგომით ნაპოვნი ინფორმაცია.

გამოიყენე GraphiQL ან მესამე მხარის API ინსტრუმენტი

API-ზე პირდაპირი მოთხოვნის გაგზავნა შეგიძლია მესამე მხარის API ინსტრუმენტის გამოყენებით, როგორიცაა Postman ან Shopify-ს მიერ მოწოდებული უფასო ინსტრუმენტი — GraphiQL. ეს ვარიანტი უზრუნველყოფს ყველაზე ზუსტ შედეგებს, მაგრამ ის მოითხოვს GraphQL მოთხოვნების შექმნის გარკვეულ ცოდნას.

GraphiQL-ისთვის, Shopify გთავაზობს როგორც ვებზე დაფუძნებულ GraphiQL-ის მკვლევარს ზოგადი მონაცემებით, ასევე GraphiQL აპს. GraphiQL-ით შეგიძლია შექმნა GraphQL მოთხოვნა, რომელიც ზუსტად შეესაბამება ველის სახელებს Shopify Flow-ში. თუ აპს გამოიყენებ, მნიშვნელობებიც ზუსტად დაემთხვევა შენს მაღაზიას.

ამ ინსტრუმენტის გამოყენებით შეგიძლია ზუსტად დაადგინო, თუ რა მონაცემებს იყენებს Shopify Flow შენი მაღაზიის რეალური მონაცემებით. მაგალითად, შენ ქმნი შემდეგ მოთხოვნას:

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

შემდეგ შედეგებში ცვლადი order / app / name აჩვენებს შეკვეთისთვის აპის სახელს. ამ შემთხვევაში, შეკვეთა შეიქმნა შეკვეთის მონახაზების აპიდან, ამიტომ მნიშვნელობა არის Draft Orders. არხის შესახებ ინფორმაცია ხელმისაწვდომია მხოლოდ 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"
            }
          }
        }
      ]
    }
  }