Anteprima dei dati API utilizzati in Shopify Flow
La maggior parte dei flussi di lavoro accede ai dati del negozio, in modo da poterli utilizzare in condizioni e azioni. Shopify Flow accede ai dati del negozio chiamando la GraphQL Admin API, dandoti accesso a quasi tutti i campi dell'API.
Durante la creazione di un flusso di lavoro, spesso incontrerai nomi di campi e descrizioni basati sull'API, ma potresti aver bisogno di conoscere i valori di tali dati. Ad esempio, potresti voler conoscere il nome dell'app per un ordine creato da una bozza di ordine. Inoltre, potresti voler verificare che il flusso di lavoro restituisca i dati previsti o nel formato previsto.
Per esaminare i valori dei dati, hai a disposizione diverse opzioni in Shopify Flow.
In questa pagina
Trova un campo nel pannello di controllo Shopify
Nella maggior parte dei casi, puoi trovare i dati nel pannello di controllo Shopify. Ad esempio, product.title è riportato sulla pagina Prodotto.
Ottieni dati di esempio
Durante la creazione di un flusso di lavoro, puoi ottenere dati di esempio direttamente nell'editor di Flow. Poiché i dati di Flow provengono da eventi, per ottenere dati di esempio accurati devi iniziare scegliendo un evento pertinente:
- Nell'editor di Flow, apri un'azione in cui desideri utilizzare i dati e clicca su Aggiungi una variabile. In alternativa, in una condizione, clicca su Aggiungi criteri.
- Clicca su Configura dati di esempio.
- Flow mostra gli eventi precedenti in base al trigger del flusso di lavoro. Clicca su Aggiorna eventi per recuperare gli eventi da esecuzioni recenti oppure clicca su Inizia ad ascoltare gli eventi dal vivo, quindi attiva manualmente l'evento nel pannello di controllo o nell'app pertinente (per i trigger basati sulle app).
- Una volta che l'evento si verifica, Flow mostrerà i dettagli relativi all'evento. Scegli l'evento che desideri utilizzare per ottenere i dati di esempio. Clicca su Usa questo evento trigger.
- Ora, mentre esplori gli eventi, i dati di esempio dovrebbero essere visualizzati per ogni variabile.
Limitazioni:
- A causa dei limiti di spazio, per i dati in un elenco, Flow visualizzerà solo i dati del primo articolo dell'elenco.
- Flow archivierà fino a 5 eventi alla volta per ogni flusso di lavoro.
- Flow non può recuperare eventi da esecuzioni recenti per alcuni trigger, come Orario programmato, Voce di metaobject creata, Cliente aggiunto al segmento o Cliente rimosso dal segmento.
Usa il campo in un flusso di lavoro attivo
Puoi utilizzare i campi in modo sicuro in un flusso di lavoro servendoti dell'azione Registra output. Quando esegui un flusso di lavoro, l'azione Registra output stamperà l'output di qualsiasi variabile e testo nella pagina Cronologia esecuzioni. Puoi anche utilizzare azioni di notifica come Invia email interna.
Passaggi per utilizzare Registra output:
- Scegli un trigger che può essere attivato manualmente.
- Aggiungi un'azione Registra output al flusso di lavoro e collegala al trigger.
- Nella configurazione di Registra output, clicca su Aggiungi una variabile per aggiungere le variabili che desideri esaminare alla sezione Output.
- Al termine, clicca su Attiva flusso di lavoro.
- Attiva il flusso di lavoro eseguendolo manualmente o facendo scattare il trigger. Ad esempio, se utilizzi il trigger Ordine creato, crea un ordine di prova.
- Dopo l'esecuzione del flusso di lavoro, controlla il registro delle attività per le variabili.
Consulta la pagina JSON della risorsa
La maggior parte delle pagine delle risorse nel pannello di controllo Shopify, come le pagine Ordine, Prodotto o Cliente, consente di visualizzare i dati che le alimentano. La denominazione e il formato di questi dati non sono esattamente gli stessi utilizzati da Shopify Flow, ma i valori corrispondono a quelli presenti nella GraphQL Admin API. Per esaminare i dati, aggiungi .json all'URL.
Ad esempio, vai a un ordine accedendo nel pannello di controllo Shopify alla pagina Ordini e cliccando su un ordine. Nella barra degli indirizzi del browser, modifica l'indirizzo della pagina da:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234
A questo:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json
Usa GraphiQL o uno strumento API di terze parti
Puoi eseguire query direttamente sull'API utilizzando uno strumento API di terze parti come Postman o lo strumento gratuito fornito da Shopify, GraphiQL. Questa opzione fornisce i risultati più accurati, ma richiede una certa familiarità con la creazione di query GraphQL.
Per GraphiQL, Shopify offre sia un explorer GraphiQL basato sul web con dati generici, sia l'app GraphiQL. Con GraphiQL puoi creare una query GraphQL che corrisponda esattamente ai nomi dei campi in Shopify Flow. I valori corrisponderanno esattamente anche al tuo negozio se utilizzi l'app.
Utilizzando questo strumento, puoi determinare esattamente quali dati utilizza Shopify Flow, con i dati reali del tuo negozio. Ad esempio, crei la seguente query:
{
orders(first:5, reverse:true) {
nodes {
createdAt
app {
name
}
channelInformation {
app {
title
}
}
}
}
}Nei risultati seguenti, la variabile order / app / name mostra il nome dell'app per l'ordine. In questo caso, l'ordine è stato creato dall'app per le bozze di ordini, quindi il valore è Draft Orders. Le informazioni sul canale sono disponibili solo per l'app Point of Sale.
{
"data": {
"orders": {
"nodes": [
{
"createdAt": "2023-04-10T12:32:41Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-04-10T12:29:12Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:23:10Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:20:53Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T15:45:15Z",
"app": {
"name": "Point of Sale"
},
"channelInformation": {
"app": {
"title": "Point of Sale"
}
}
}
]
}
}