Λήψη δεδομένων πρόχειρης παραγγελίας

Σε ροές εργασίας που χρησιμοποιούν δεδομένα πρόχειρης παραγγελίας, μπορείτε να χρησιμοποιήσετε την ενέργεια Λήψη δεδομένων πρόχειρης παραγγελίας για να ανακτήσετε πληροφορίες πρόχειρης παραγγελίας από το κατάστημά σας.

Σημείωση

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

Διαμόρφωση

Πεδία

Η ενέργεια Λήψη δεδομένων πρόχειρης παραγγελίας περιέχει τα παρακάτω πεδία, τα οποία χρησιμοποιούνται για τη δημιουργία του ερωτήματος:

Πεδία που χρησιμοποιούνται στις ενέργειες «Λήψη δεδομένων».

Πεδίο	Περιγραφή
Ταξινόμηση δεδομένων κατά	Υποχρεωτικό. Οι παράμετροι βάσει των οποίων ταξινομούνται τα δεδομένα που επιστρέφονται από το ερώτημα αναζήτησης.
Μέγιστος αριθμός αποτελεσμάτων	Υποχρεωτικό. Ο μέγιστος αριθμός αποτελεσμάτων που μπορούν να επιστραφούν από το ερώτημα αναζήτησης που επιλέγετε. Μπορείτε να επιστρέψετε έως και 100 κάθε φορά.
Ερώτημα	Υποχρεωτικό. Επιλέξτε από κοινά ερωτήματα ή επιλέξτε Για προχωρημένους για να δημιουργήσετε το δικό σας.

Συμβολοσειρά ερωτήματος

Αυτό είναι ένα παράδειγμα ερωτήματος για τη λήψη πρόχειρων παραγγελιών που ενημερώθηκαν την τελευταία ημέρα:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Η μεταβλητή updated_at είναι ένα φίλτρο διαθέσιμο στο ερώτημα πρόχειρων παραγγελιών και μπορεί να χρησιμοποιηθεί πολλές φορές ή να συνδυαστεί με άλλες μεταβλητές. Η μεταβλητή Liquid scheduledAt είναι διαθέσιμη σε ροές εργασίας που χρησιμοποιούν το στοιχείο ενεργοποίησης «Προγραμματισμένος χρόνος». Η ετικέτα Liquid date_minus είναι μια ειδική ετικέτα του Flow που σας επιτρέπει να αφαιρείτε χρόνο από μια ημερομηνία.

Κατά την υποβολή ερωτημάτων για δεδομένα, είναι χρήσιμο να γνωρίζετε τα εξής:

• Λίστα διαθέσιμων φίλτρων παραγγελίας
• Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη
• Οι τιμές του πεδίου ερωτήματος δεν τεκμηριώνονται πάντα. Σε ορισμένες περιπτώσεις, μπορείτε να βρείτε τις τιμές ανατρέχοντας στα έγγραφα του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές του πεδίου στα URL στον πίνακα διαχειριστή όταν εφαρμόζετε φίλτρα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτήματος παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και, στη συνέχεια, ελέγξτε το URL.
• Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.
• Να έχετε υπόψη τι συμβαίνει αν το ερώτημά σας αποτύχει. Συχνά, το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).

Επιστρεφόμενα δεδομένα

Όλες οι ενέργειες Λήψη δεδομένων επιστρέφουν μια λίστα με 0 έως 100 πόρους. Ανάλογα με την περίπτωση χρήσης, μπορεί να θέλετε να χρησιμοποιήσετε αυτά τα δεδομένα με διάφορους τρόπους:

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

Για να αποκτήσετε πρόσβαση στα επιστρεφόμενα δεδομένα σε βήματα που ακολουθούν αυτή την ενέργεια, χρησιμοποιήστε τη μεταβλητή με το όνομα Λήψη δεδομένων πρόχειρης παραγγελίας, η οποία είναι μια λίστα με πρόχειρες παραγγελίες. Μπορείτε να χρησιμοποιήσετε αυτή τη μεταβλητή τόσο σε συνθήκες όσο και σε ενέργειες. Για παράδειγμα, μπορείτε να στείλετε τη λίστα των πρόχειρων παραγγελιών σε μια ενέργεια Αποστολή εσωτερικού email όπως αυτή:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Σημείωση

Αν μια ενέργεια Λήψη δεδομένων χρησιμοποιηθεί πολλές φορές σε μία ροή εργασίας, τότε προστίθεται ένας αριθμός στο όνομα της μεταβλητής. Για παράδειγμα, σε μια ροή εργασίας που χρησιμοποιεί την ενέργεια Λήψη δεδομένων παραγγελίας δύο φορές, η πρώτη μεταβλητή για τα επιστρεφόμενα δεδομένα είναι getOrderData και η δεύτερη μεταβλητή είναι getOrderData1. Αυτό το όνομα δεν μπορεί να προσαρμοστεί.

Στοιχεία ενεργοποίησης

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

Λεπτομέρειες API

• Πόρος πρόχειρης παραγγελίας
• Φίλτρα ερωτήματος πρόχειρης παραγγελίας

Πρότυπα

Αποστολή ημερήσιας ειδοποίησης με όλες τις ανοικτές πρόχειρες παραγγελίες

Κάθε μέρα, γίνεται λήψη των ανοικτών πρόχειρων παραγγελιών, καταμέτρησή τους και αποστολή μηνύματος στο Slack. Χρησιμοποιεί το στοιχείο ενεργοποίησης «Προγραμματισμένος χρόνος» και τις ενέργειες «Λήψη πρόχειρων παραγγελιών» και «Καταμέτρηση». Προβολή προτύπου