Recupera dati azienda

Nei flussi di lavoro che utilizzano i dati dell'azienda, puoi utilizzare l'azione Recupera dati azienda per recuperare le informazioni sull'azienda dal tuo negozio.

Configurazione

Campi

L'azione Recupera dati azienda contiene i seguenti campi, che vengono utilizzati per creare la query:

Campi utilizzati nelle azioni Recupera dati.
CampoDescrizione
Ordina dati perObbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca.
Numero massimo di risultatiObbligatorio. La quantità massima di risultati che può essere restituita dalla query di ricerca che selezioni. Puoi restituirne fino a 100 alla volta.
QueryObbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata.

Stringa di query

Questo è un esempio di query per ottenere le aziende aggiornate nell'ultimo giorno:

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

La variabile updated_at è un filtro disponibile nella query Companies e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che hanno utilizzato il trigger Orario programmato. Il tag Liquid date_minus è un tag speciale di Flow che ti consente di sottrarre del tempo da una data.

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

  • Elenco dei filtri azienda disponibili
  • Le query devono seguire una certa sintassi
  • I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori si possono trovare consultando la documentazione API. In alternativa, puoi trovare spesso i valori dei campi negli URL del pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori della query Order, filtra la pagina Orders nel pannello di controllo, quindi controlla l'URL.
  • Puoi eseguire o testare una query nel tuo negozio usando 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 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 per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
  • Se devi utilizzare l'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 Ottieni dati azienda, che è un elenco di aziende. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco di aziende in un'azione Invia email interna in questo modo:

{% for single_company in GetCompanyData %}
* {{ 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 all'orario da te specificato, anziché in seguito a un evento. Poiché non vi è alcun evento specifico nel tuo negozio o da un'app che avvia il flusso di lavoro, non vengono inclusi dati automaticamente.

Riferimento API