Λήψη καταχωρήσεων μετα-αντικειμένου
Μπορείτε να χρησιμοποιήσετε την ενέργεια Λήψη καταχωρήσεων μετα-αντικειμένου για να ανακτήσετε μια λίστα καταχωρήσεων για ένα μετα-αντικείμενο από το κατάστημά σας με βάση το προαιρετικό ερώτημα. Ανατρέξτε στην τεκμηρίωση για τα μετα-αντικείμενα για περισσότερες πληροφορίες.
Διαμόρφωση
Πεδία
Η ενέργεια Λήψη καταχωρήσεων μετα-αντικειμένου περιέχει μια αναπτυσσόμενη λίστα για τον καθορισμό του ορισμού μετα-αντικειμένου καθώς και τα ακόλουθα πεδία, τα οποία χρησιμοποιούνται για τη δημιουργία του ερωτήματος:
| Πεδίο | Περιγραφή |
|---|---|
| Ταξινόμηση δεδομένων κατά | Υποχρεωτικό. Οι παράμετροι βάσει των οποίων ταξινομούνται τα δεδομένα που επιστρέφονται από το ερώτημα αναζήτησης. |
| Μέγιστος αριθμός αποτελεσμάτων | Υποχρεωτικό. Ο μέγιστος αριθμός αποτελεσμάτων που μπορούν να επιστραφούν από το ερώτημα αναζήτησης που επιλέγετε. Μπορείτε να επιστρέψετε έως 100 κάθε φορά. |
| Ερώτημα | Απαιτείται. Επιλέξτε από κοινά ερωτήματα ή επιλέξτε Για προχωρημένους για να δημιουργήσετε το δικό σας. |
Συμβολοσειρά ερωτήματος
Αυτό είναι ένα παράδειγμα ερωτήματος για τη λήψη καταχωρήσεων μετα-αντικειμένου, αν η τιμή ενός πεδίου email αντιστοιχεί στη διεύθυνση email σε μια παραγγελία:
{{fields.email}}:"{{order.email}}"Αυτό είναι ένα παράδειγμα ερωτήματος για τη λήψη καταχωρήσεων μετα-αντικειμένου που ενημερώθηκαν την τελευταία ημέρα:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Η μεταβλητή updated_at είναι ένα φίλτρο που διατίθεται στο ερώτημα Μετα-αντικειμένων και μπορεί να χρησιμοποιηθεί πολλές φορές ή να συνδυαστεί με άλλες μεταβλητές. Η μεταβλητή Liquid scheduledAt είναι διαθέσιμη σε ροές εργασίας που χρησιμοποίησαν το Στοιχείο ενεργοποίησης προγραμματισμένου χρόνου. Η ετικέτα date_minus Liquid είναι μια ειδική ετικέτα του Flow που σας επιτρέπει να αφαιρείτε χρόνο από μια ημερομηνία.
Όταν υποβάλλετε ερωτήματα για δεδομένα, είναι χρήσιμο να γνωρίζετε τα εξής:
- Λίστα διαθέσιμων φίλτρων μετα-αντικειμένων
- Η υποβολή ερωτημάτων για μετα-αντικείμενα βάσει τιμής πεδίου απαιτεί να είναι ενεργοποιημένο το φιλτράρισμα για το μετα-αντικείμενο, το οποίο μπορεί να ενεργοποιηθεί στις επιλογές για προσαρμοσμένα δεδομένα στον Διαχειριστή Shopify.
- Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη
- Οι τιμές των πεδίων ερωτημάτων δεν είναι πάντα τεκμηριωμένες. Σε ορισμένες περιπτώσεις, οι τιμές μπορούν να βρεθούν στα έγγραφα του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές των πεδίων στα URL στον πίνακα διαχειριστή όταν εφαρμόζετε φίλτρα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτημάτων παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και, στη συνέχεια, ελέγξτε το URL.
- Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.
- Να είστε προσεκτικοί σχετικά με το τι συμβαίνει εάν το ερώτημά σας αποτύχει. Συχνά το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).
Επιστρεφόμενα δεδομένα
Όλες οι ενέργειες Λήψη δεδομένων επιστρέφουν μια λίστα από 0 έως 100 πόρους. Ανάλογα με την περίπτωση χρήσης σας, μπορεί να θέλετε να χρησιμοποιήσετε αυτά τα δεδομένα με διάφορους τρόπους:
- Αν χρειάζεται να διαχειριστείτε κάθε στοιχείο της λίστας ξεχωριστά, όπως για να προσθέσετε μια ετικέτα για το καθένα, τότε μπορείτε να χρησιμοποιήσετε την ενέργεια Για κάθε.
- Αν χρειάζεται να συγκεντρώσετε δεδομένα, όπως για να μετρήσετε πόσα αποτελέσματα επιστράφηκαν, τότε μπορείτε να χρησιμοποιήσετε τις ενέργειες Καταμέτρηση ή Άθροισμα.
- Αν χρειάζεται να εξαγάγετε τη λίστα, όπως για παράδειγμα να στείλετε ένα email με όλα τα κομμάτια, τότε μπορείτε να χρησιμοποιήσετε τα επιστρεφόμενα δεδομένα απευθείας σε επόμενες ενέργειες.
Για να αποκτήσετε πρόσβαση στα επιστρεφόμενα δεδομένα σε βήματα που ακολουθούν αυτήν την ενέργεια, χρησιμοποιήστε τη μεταβλητή με το όνομα Λήψη καταχωρήσεων μετα-αντικειμένου, η οποία είναι μια λίστα με καταχωρήσεις μετα-αντικειμένου. Μπορείτε να χρησιμοποιήσετε αυτήν τη μεταβλητή τόσο σε συνθήκες όσο και σε ενέργειες. Για παράδειγμα, μπορείτε να στείλετε τη λίστα των ζευγών κλειδιού-τιμής για τις καταχωρήσεις μετα-αντικειμένου σε μια ενέργεια Αποστολή εσωτερικού email ως εξής:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}Στοιχεία ενεργοποίησης
Μπορείτε να χρησιμοποιήσετε αυτήν την ενέργεια σε οποιαδήποτε ροή εργασίας, συμπεριλαμβανομένου του στοιχείου ενεργοποίησης Προγραμματισμένος χρόνος. Σε μια ροή εργασίας που χρησιμοποιεί το στοιχείο ενεργοποίησης Προγραμματισμένος χρόνος, η ροή εργασίας ξεκινά σε μια ώρα που έχετε καθορίσει, αντί ως αποτέλεσμα ενός συμβάντος. Επειδή δεν υπάρχει κάποιο συγκεκριμένο συμβάν στο κατάστημά σας ή από μια εφαρμογή που να ξεκινά τη ροή εργασίας, δεν περιλαμβάνονται αυτόματα δεδομένα.