Obtenir des données d’article

Dans les flux de travail nécessitant des données sur des articles de blog, vous pouvez utiliser l’action Obtenir des données d’article pour récupérer des informations sur les articles de votre boutique Shopify.

Remarque

Il s’agit d’un type d’action 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 Programmations, obtention de données et flux de travail en boucle dans Shopify Flow.

Configuration

Champs

L’action Obtenir des données d’article contient les champs suivants :

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

Champ	Description
Trier les données par	Obligatoire. Paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultats	Obligatoire. Nombre maximum de résultats pouvant être renvoyés par la requête de recherche que vous avez sélectionnée. Il est possible de renvoyer jusqu’à 100 résultats à 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 articles publiés au cours de la journée précédente :

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

La variable published_at est un filtre disponible pour la requête d’articles 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.

Lors de l’interrogation de données, il est utile de savoir que :

• Liste des filtres d'articles disponibles

• Les requêtes doivent suivre une certaine syntaxe

• Les valeurs de champ de requête ne sont pas toujours documentées. Dans certains cas, elles peuvent être trouvées en consultant la documentation de l’API. Vous pouvez également souvent trouver les valeurs des champs dans les URL de l'interface administrateur lorsque vous filtrez. Par exemple, pour trouver certaines 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 en utilisant l’application Shopify GraphiQL.

• Gardez à l’esprit ce qui se produit en cas d'échec de votre requête. Souvent, l’API renvoie tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste contenant entre 0 et 100 ressources. Selon votre cas d'utilisation, vous souhaiterez peut-être utiliser ces données de différentes manières :

• Si vous devez gérer 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 Somme.
• Si vous devez produire la liste, par exemple pour envoyer un e-mail avec tous les éléments, vous pouvez utiliser les données renvoyées directement dans les actions ultérieures.

Pour accéder aux données renvoyées lors des étapes qui suivent cette action, utilisez la variable nommée Obtenir des données d’article, qui est une liste d’articles. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des articles dans une action Envoyer un e-mail interne semblable à celle-ci :

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% 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 des données de commande, la première variable des données renvoyées est getOrderData et la deuxième variable 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 il n’y a pas d’événement spécifique dans votre boutique ou provenant d’une application qui lance le flux de travail, aucune donnée n’est automatiquement incluse.

Référence de l’API

Pour plus d’informations sur l’API utilisée dans cette action, consultez la requête d’articles.