Λήψη δεδομένων στοιχείου αποθέματος

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

Διαμόρφωση

Πεδία

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

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

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

tracked:true

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

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

• Λίστα διαθέσιμων φίλτρων στοιχείων αποθέματος

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

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

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

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

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

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

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

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

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

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

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

Αναφορά API

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