Récupérer les données de contrat d’abonnement

Dans les flux de travail qui utilisent des données de contrat d’abonnement, vous pouvez utiliser l’action Récupérer les données de contrat d’abonnement pour récupérer les informations sur les contrats d’abonnement de votre boutique.

Sur cette page

Configuration

Champs

L’action Récupérer les données de contrat d’abonnement contient les champs suivants, qui sont utilisés pour créer la requête :

Champs utilisés dans les actions Récupérer les 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 maximum de résultats	Requis. Le nombre maximum de résultats qui peuvent être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à 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 contrats d’abonnement dont le statut est ACTIVE :

status: ACTIVE

La variable status est un filtre disponible sur la requête de contrats d’abonnement et peut être utilisée plusieurs fois.

Lorsque vous interrogez des données, il est utile de connaître les éléments suivants :

Liste des filtres 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 trouver les valeurs en consultant la documentation de l’API. Autrement, vous pouvez souvent trouver les valeurs des champs dans les URL de l’interface administrateur lorsque vous appliquez un filtre. 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 à l’aide de l’application Shopify GraphiQL.
Faites attention à ce qui se passe si votre requête échoue. Souvent, l’API renvoie tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Récupérer les données renvoient une liste de 0 à 100 ressources. En fonction de votre cas d’utilisation, vous pouvez utiliser ces données de plusieurs manières :

Si vous devez traiter chaque article 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 utiliser la liste en sortie, par exemple pour envoyer un e-mail contenant tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions ultérieures.

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

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Déclencheurs

Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris avec le déclencheur Heure planifiée. Dans un flux de travail qui utilise le déclencheur Heure planifiée, le flux de travail démarre à une 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 démarre le flux de travail, aucune donnée n’est automatiquement incluse.