Βοήθεια
Σύνδεση

Ανάκτηση δεδομένων εταιρείας

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

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

Διαμόρφωση

Πεδία

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

Πεδία που χρησιμοποιούνται στις ενέργειες Ανάκτησης δεδομένων.
ΠεδίοΠεριγραφή
Ταξινόμηση δεδομένων κατάΑπαιτείται. Οι παράμετροι με βάση τις οποίες ταξινομούνται τα δεδομένα που επιστρέφονται από το ερώτημα αναζήτησης.
Μέγιστος αριθμός αποτελεσμάτωνΑπαιτείται. Ο μέγιστος αριθμός αποτελεσμάτων που μπορούν να επιστραφούν από το ερώτημα αναζήτησης που επιλέγετε. Μπορείτε να επιστρέψετε έως και 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_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

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

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

Αναφορά API