Recupera dati del contratto di abbonamento

Nei flussi di lavoro che utilizzano i dati del contratto di abbonamento, puoi utilizzare l'azione Recupera dati del contratto di abbonamento per recuperare le informazioni sul contratto di abbonamento dal tuo negozio.

In questa pagina

Configurazione

Campi

L'azione Recupera dati del contratto di abbonamento contiene i seguenti campi, che vengono utilizzati per creare la query:

Campi utilizzati nelle azioni Recupera dati.
Campo	Descrizione
Ordina dati per	Obbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca.
Numero massimo di risultati	Obbligatorio. La quantità massima di risultati che possono essere restituiti dalla query di ricerca selezionata. Puoi restituirne fino a 100 alla volta.
Query	Obbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata.

Stringa di query

Questo è un esempio di query per ottenere i contratti di abbonamento con stato ACTIVE:

status: ACTIVE

La variabile status è un filtro disponibile nella query sui contratti di abbonamento e può essere utilizzata più volte.

Quando si esegue una query sui dati, è utile sapere quanto segue:

Elenco dei filtri disponibili
Le query devono seguire una sintassi specifica
I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori possono essere individuati consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL del pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori di query per gli ordini, filtra la pagina Ordini nel pannello di controllo e controlla l'URL.
Puoi eseguire o testare una query nel tuo negozio utilizzando l’app Shopify GraphiQL.
Tieni presente cosa succede se la query non riesce. Spesso, l'API restituirà tutti i risultati (invece di nessuno).

Dati restituiti

Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del tuo caso d'uso, puoi utilizzare questi dati in vari modi:

Se devi gestire ogni articolo dell'elenco singolarmente, ad esempio per aggiungere un tag a ciascuno, puoi utilizzare l'azione Per ogni.
Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
Se devi restituire l'elenco come output, ad esempio per inviare un'email con tutti gli articoli, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi successivi a questa azione, utilizza la variabile denominata Recupera dati del contratto di abbonamento, che è un elenco di contratti di abbonamento. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco degli ordini in un'azione Invia email interna in questo modo:

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

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Orario pianificato. In un flusso di lavoro che utilizza il trigger Orario pianificato, il flusso di lavoro si avvia all'orario specificato, anziché in seguito a un evento. Poiché il flusso di lavoro non viene avviato da un evento specifico nel negozio o da un'app, non vengono inclusi dati automaticamente.