Recupera dati sede aziendale
Nei flussi di lavoro che utilizzano i dati della sede aziendale, puoi utilizzare l'azione Recupera dati sede aziendale per recuperare le informazioni sulla sede aziendale dal negozio.
In questa pagina
Configurazione
Campi
L'azione Recupera dati sede aziendale contiene i seguenti campi, che vengono utilizzati per creare la query:
| 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. Il numero massimo 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
Di seguito è riportato un esempio di query per recuperare le sedi aziendali aggiornate nell'ultimo giorno:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variabile updated_at è un filtro disponibile nella query delle sedi aziendali e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che utilizzano il trigger Orario programmato. Il tag Liquid date_minus è uno speciale tag di Flow che ti permette di sottrarre tempo da una data.
Quando esegui una query sui dati, è utile conoscere quanto segue:
- Elenco dei filtri disponibili per le sedi aziendali
- Le query devono seguire una determinata sintassi
- I valori dei campi della query non sono sempre documentati. In alcuni casi, i valori si possono trovare consultando la documentazione API. In alternativa, puoi spesso trovare i valori dei campi negli URL nel pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori della query Ordine, filtra la pagina Ordini nel pannello di controllo, quindi controlla l’URL.
- Puoi eseguire o testare una query nel tuo negozio utilizzando l’app Shopify GraphiQL.
- Fai attenzione a cosa succede se la query non riesce. Spesso l’API restituirà tutti i risultati (anziché nessuno).
Dati restituiti
Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del tuo caso d’uso, potresti voler 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 contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
- Se devi generare un output dell’elenco, 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 che seguono questa azione, utilizza la variabile denominata Recupera dati sede aziendale, che è un elenco di sedi aziendali. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco delle sedi in un'azione Invia email interna in questo modo:
{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}Trigger
Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Orario programmato. In un flusso di lavoro che utilizza il trigger Orario programmato, il flusso di lavoro si avvia a un orario specificato, anziché in seguito a un evento. Poiché non c’è un evento specifico nel tuo negozio o da un’app che avvia il flusso di lavoro, non vengono inclusi dati automaticamente.