Προεπισκόπηση δεδομένων API που χρησιμοποιούνται στο Shopify Flow

Οι περισσότερες ροές εργασίας αποκτούν πρόσβαση σε δεδομένα από το κατάστημά σας, ώστε να μπορείτε να τα χρησιμοποιείτε σε συνθήκες και ενέργειες. Το Shopify Flow αποκτά πρόσβαση στα δεδομένα του καταστήματος καλώντας το GraphQL Admin API, παρέχοντάς σας πρόσβαση σε σχεδόν όλα τα πεδία του API.

Καθώς δημιουργείτε μια ροή εργασίας, συχνά θα συναντάτε ονόματα πεδίων και περιγραφές που βασίζονται στο API, αλλά μπορεί να χρειαστεί να γνωρίζετε τις τιμές αυτών των δεδομένων. Για παράδειγμα, μπορεί να θέλετε να γνωρίζετε το όνομα της εφαρμογής για μια παραγγελία που δημιουργήθηκε από μια πρόχειρη παραγγελία. Επιπλέον, μπορεί να θέλετε να βεβαιωθείτε ότι η ροή εργασίας σας εξάγει τα δεδομένα που αναμένετε ή στη μορφή που αναμένετε.

Για να ελέγξετε τις τιμές των δεδομένων, έχετε πολλές επιλογές στο Shopify Flow.

Σε αυτή τη σελίδα

Βρείτε ένα πεδίο στον Διαχειριστή Shopify

Στις περισσότερες περιπτώσεις, μπορείτε να βρείτε δεδομένα αναζητώντας στον Διαχειριστή Shopify. Για παράδειγμα, το product.title παρατίθεται στη σελίδα Προϊόν.

Λήψη δειγμάτων δεδομένων

Όταν δημιουργείτε μια ροή εργασίας, μπορείτε να λάβετε δείγματα δεδομένων απευθείας από το πρόγραμμα επεξεργασίας του Flow. Επειδή τα δεδομένα του Flow προέρχονται από συμβάντα, για να λάβετε ακριβή δείγματα δεδομένων, πρέπει να ξεκινήσετε επιλέγοντας ένα σχετικό συμβάν:

Στο πρόγραμμα επεξεργασίας του Flow, ανοίξτε μια ενέργεια όπου θέλετε να χρησιμοποιήσετε τα δεδομένα και κάντε κλικ στην επιλογή Προσθήκη μεταβλητής. Εναλλακτικά, σε μια συνθήκη, κάντε κλικ στην επιλογή Προσθήκη κριτηρίων.
Κάντε κλικ στην επιλογή Διαμόρφωση δειγμάτων δεδομένων.
Το Flow εμφανίζει προηγούμενα συμβάντα με βάση το στοιχείο ενεργοποίησης της ροής εργασίας. Κάντε κλικ στην επιλογή Ανανέωση συμβάντων για να ανακτήσετε συμβάντα από πρόσφατες εκτελέσεις ή κάντε κλικ στην επιλογή Έναρξη παρακολούθησης ζωντανών συμβάντων και, στη συνέχεια, ενεργοποιήστε μη αυτόματα το συμβάν στον Διαχειριστή ή στη σχετική εφαρμογή (για στοιχεία ενεργοποίησης που βασίζονται σε εφαρμογές).
Αφού συμβεί το συμβάν, το Flow θα εμφανίσει λεπτομέρειες σχετικά με αυτό. Επιλέξτε το συμβάν που θέλετε να χρησιμοποιήσετε για να λάβετε δείγματα δεδομένων. Κάντε κλικ στην επιλογή Χρήση αυτού του συμβάντος ενεργοποίησης.
Τώρα, καθώς περιηγείστε στα συμβάντα, θα πρέπει να εμφανίζονται δείγματα δεδομένων για κάθε μεταβλητή.

Περιορισμοί:

Λόγω περιορισμών χώρου, για δεδομένα σε μια λίστα, το Flow θα εμφανίζει δεδομένα μόνο από το πρώτο στοιχείο της λίστας.
Το Flow θα αποθηκεύει έως και 5 συμβάντα κάθε φορά, ανά ροή εργασίας.
Το Flow δεν μπορεί να ανακτήσει συμβάντα από πρόσφατες εκτελέσεις για ορισμένα στοιχεία ενεργοποίησης, όπως τα «Προγραμματισμένη ώρα», «Δημιουργήθηκε καταχώριση μετα-αντικειμένου», «Ο πελάτης εντάχθηκε σε τμήμα» ή «Ο πελάτης αποχώρησε από τμήμα».

Χρήση του πεδίου σε μια ζωντανή ροή εργασίας

Μπορείτε να χρησιμοποιήσετε με ασφάλεια τα πεδία σε μια ροή εργασίας, αξιοποιώντας την ενέργεια Έξοδος αρχείου καταγραφής. Όταν εκτελείτε μια ροή εργασίας, η ενέργεια Έξοδος αρχείου καταγραφής εκτυπώνει την έξοδο τυχόν μεταβλητών και κειμένου στη σελίδα Ιστορικό εκτέλεσης. Μπορείτε επίσης να χρησιμοποιήσετε ενέργειες ειδοποίησης, όπως η Αποστολή εσωτερικού email.

Βήματα για τη χρήση της Εξόδου αρχείου καταγραφής:

Επιλέξτε ένα στοιχείο ενεργοποίησης που μπορεί να ενεργοποιηθεί μη αυτόματα.
Προσθέστε μια ενέργεια Έξοδος αρχείου καταγραφής στη ροή εργασίας και συνδέστε τη με το στοιχείο ενεργοποίησης.
Στη διαμόρφωση της Εξόδου αρχείου καταγραφής, κάντε κλικ στην επιλογή Προσθήκη μεταβλητής για να προσθέσετε τις μεταβλητές που θέλετε να εξετάσετε στην ενότητα Έξοδος.
Όταν τελειώσετε, κάντε κλικ στην επιλογή Ενεργοποίηση ροής εργασίας.
Ενεργοποιήστε τη ροή εργασίας, είτε εκτελώντας την μη αυτόματα είτε προκαλώντας την ενεργοποίηση του στοιχείου ενεργοποίησης. Για παράδειγμα, αν χρησιμοποιείτε το στοιχείο ενεργοποίησης Δημιουργήθηκε παραγγελία, δημιουργήστε μια δοκιμαστική παραγγελία.
Αφού εκτελεστεί η ροή εργασίας, ελέγξτε το αρχείο καταγραφής δραστηριότητας για τις μεταβλητές.

Ανατρέξτε στη σελίδα JSON του πόρου

Οι περισσότερες σελίδες πόρων στον Διαχειριστή Shopify, όπως οι σελίδες Παραγγελία, Προϊόν ή Πελάτης, σας επιτρέπουν να προβάλετε τα δεδομένα που εξυπηρετούν τη σελίδα. Αυτά τα δεδομένα δεν έχουν ακριβώς την ίδια ονομασία και μορφή που χρησιμοποιεί το Shopify Flow, αλλά οι τιμές αντιστοιχούν σε αυτές του GraphQL Admin API. Για να ελέγξετε τα δεδομένα, προσθέστε το .json στη διεύθυνση URL.

Για παράδειγμα, μεταβείτε σε μια παραγγελία, πηγαίνοντας στον Διαχειριστή Shopify στη σελίδα Παραγγελίες και κάνοντας κλικ σε μια παραγγελία. Στη διεύθυνση της σελίδας, στη γραμμή διευθύνσεων του προγράμματος περιήγησής σας, αλλάξτε τη διεύθυνση από:

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

Στην ακόλουθη:

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

Χρήση του GraphiQL ή ενός εργαλείου API τρίτου μέρους

Μπορείτε να υποβάλετε ερωτήματα απευθείας στο API χρησιμοποιώντας ένα εργαλείο API τρίτου μέρους, όπως το Postman, ή το δωρεάν εργαλείο που παρέχεται από το Shopify, το GraphiQL. Αυτή η επιλογή παρέχει τα πιο ακριβή αποτελέσματα, αλλά απαιτεί κάποια εξοικείωση με τη δημιουργία ερωτημάτων GraphQL.

Για το GraphiQL, το Shopify προσφέρει τόσο έναν εξερευνητή GraphiQL που βασίζεται στο web με γενικά δεδομένα όσο και την εφαρμογή 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"
            }
          }
        }
      ]
    }
  }