Λήψη δεδομένων καταλόγου

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

Σημείωση

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

Διαμόρφωση

Πεδία

Η ενέργεια Λήψη δεδομένων καταλόγου περιλαμβάνει τα ακόλουθα πεδία:

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

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

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

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

status:ACTIVE

Η μεταβλητή status είναι ένα φίλτρο διαθέσιμο στο Ερώτημα καταλόγων και μπορεί να χρησιμοποιηθεί πολλές φορές ή να συνδυαστεί με άλλες μεταβλητές.

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

• Λίστα διαθέσιμων φίλτρων καταλόγου

• Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη

• Οι τιμές των πεδίων ερωτημάτων δεν τεκμηριώνονται πάντα. Σε ορισμένες περιπτώσεις, μπορείτε να βρείτε τις τιμές ανατρέχοντας στα έγγραφα του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές πεδίων στα URL του πίνακα διαχειριστή κατά το φιλτράρισμα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτήματος παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και έπειτα ελέγξτε το URL.

• Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.

• Λάβετε υπόψη τι συμβαίνει εάν το ερώτημά σας αποτύχει. Συχνά, το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).

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

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

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

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Σημείωση

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

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

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

Αναφορά API

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