Obtenir les données des commandes provisoires

Dans les flux de travail qui utilisent des données de commandes provisoires, vous pouvez utiliser l’action Obtenir les données des commandes provisoires pour récupérer les informations sur les commandes provisoires de votre boutique.

Remarque

Il s’agit d’une action de type Obtenir des données. Pour comprendre comment utiliser ce type d’action avec le déclencheur Heure programmée et les boucles Pour chaque, consultez la page Programmation, obtention de données et flux de travail en boucle dans Shopify Flow.

Configuration

Champs

L’action Obtenir les données des commandes provisoires contient les champs suivants, qui sont utilisés pour créer la requête :

Champs utilisés dans les actions Obtenir des données.

Champ	Description
Trier les données par	Obligatoire. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultats	Obligatoire. Le nombre maximum de résultats pouvant être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois.
Requête	Obligatoire. Choisissez parmi les requêtes courantes ou sélectionnez Avancé pour créer la vôtre.

Chaîne de requête

Voici un exemple de requête pour obtenir les commandes provisoires qui ont été mises à jour au cours du dernier jour :

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

La variable updated_at est un filtre disponible dans la requête de commandes provisoires et peut être utilisée plusieurs fois ou combinée avec d’autres variables. La variable Liquid scheduledAt est disponible dans les flux de travail qui utilisent le déclencheur Heure programmée. La balise Liquid date_minus est une balise Flow spéciale qui vous permet de soustraire du temps à une date.

Lorsque vous créez des requêtes, il est utile de savoir ce qui suit :

• Liste des filtres de commandes disponibles
• Les requêtes doivent respecter une certaine syntaxe
• Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, vous pouvez les trouver en consultant la documentation de l’API. Sinon, vous pouvez souvent trouver les valeurs des champs dans les URL de l’interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver des valeurs de requête de commande, filtrez la page Commandes dans l’interface administrateur, puis vérifiez l’URL.
• Vous pouvez exécuter ou tester une requête dans votre boutique à l’aide de l’application Shopify GraphiQL.
• Sachez ce qui se passe en cas d’échec de votre requête. Souvent, l’API renverra tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste de 0 à 100 ressources. Selon votre cas d’utilisation, vous pouvez utiliser ces données de différentes manières :

• Si vous devez traiter chaque élément de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chaque.
• Si vous devez agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Compter ou Sommer.
• Si vous devez utiliser la liste entière, par exemple pour envoyer un e-mail avec tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions qui suivent.

Pour accéder aux données renvoyées dans les étapes qui suivent cette action, utilisez la variable nommée Obtenir les données des commandes provisoires, qui est une liste de commandes provisoires. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des commandes provisoires dans une action Envoyer un e-mail interne comme ceci :

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

Remarque

Si une action Obtenir des données est utilisée plusieurs fois dans un même flux de travail, un numéro est ajouté au nom de la variable. Par exemple, dans un flux de travail qui utilise deux fois l’action Obtenir les données de la commande, la première variable pour les données renvoyées est getOrderData et la seconde est getOrderData1. Ce nom ne peut pas être personnalisé.

Déclencheurs

Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris avec le déclencheur Heure programmée. Dans un flux de travail qui utilise le déclencheur Heure programmée, le flux de travail démarre à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Comme aucun événement particulier dans votre boutique ou provenant d’une application ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.

Détails de l’API

• Ressource Commande provisoire
• Filtres de requête de commande provisoire

Modèles

Envoyer une notification quotidienne avec toutes les commandes provisoires ouvertes

Chaque jour, obtenez les commandes provisoires ouvertes, comptez-les et envoyez un message Slack. Utilise le déclencheur Heure programmée et les actions Obtenir les données des commandes provisoires et Compter. Afficher le modèle