Obtenir les données de la page

Dans les flux de travail qui nécessitent des données de page, vous pouvez utiliser l’action Obtenir les données de la page pour récupérer les informations de la page de votre boutique. Les pages sont les pages web de votre boutique en ligne qui contiennent des informations qui changent rarement, telles qu’une page À propos de nous ou une page Contact.

Remarque

Il s’agit d’un type d’action Obtenir des données. Pour savoir comment utiliser ce type d’action avec le déclencheur Heure prévue et les boucles Pour chaque, consultez l’article Programmations, obtention de données et flux de travail en boucle dans Shopify Flow.

Configuration

Champs

L’action Obtenir les données de la page contient les champs suivants :

Champs utilisés dans les actions d’obtention de données.

Champ	Description
Trier les données par	Requis. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximal de résultats	Requis. Le nombre maximal de résultats pouvant être renvoyés par la requête de recherche que vous avez sélectionnée. Vous pouvez obtenir jusqu’à 100 résultats à la fois.
Requête	Requis. 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 pages publiées :

published_status:published

La variable published_status est un filtre disponible pour la requête de pages. Elle peut être utilisée plusieurs fois ou combinée avec d’autres variables.

Lors de l’interrogation de données, il est utile de savoir ce qui suit :

• Liste des filtres de pages disponibles

• Les requêtes doivent respecter une syntaxe précise

• Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, il est possible de trouver ces valeurs en consultant la documentation de l’API. Par ailleurs, 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êtes associées aux commandes, filtrez la page Commandes de 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.

• Tenez compte de ce qui se passe si votre requête échoue. L’API renvoie souvent 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 souhaiterez peut-être employer ces données de plusieurs façons :

• Si vous devez gérer chaque élément de la liste individuellement, par exemple pour ajouter une balise à chacun d’eux, 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 Additionner.
• Si vous avez besoin de générer la liste, par exemple pour envoyer un e-mail contenant tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Remarque

Si une action Obtenir des données est utilisée plusieurs fois dans un même flux de travail, un chiffre est ajouté au nom de la variable. Par exemple, dans un flux de travail qui utilise l’action Obtenir les données de la commande à deux reprises, la première variable des données renvoyées est getOrderData et la deuxième 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 le déclencheur Heure prévue. Dans un flux de travail qui l’utilise, le flux de travail commence à l’heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Étant donné qu’aucun événement spécifique dans votre boutique ou provenant d’une application ne lance le flux de travail, aucune donnée n’est incluse automatiquement.

Référence de l’API

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