Uso dei campi API con argomenti in Shopify Flow per creare variabili

Alcune variabili richiedono parametri aggiuntivi per funzionare correttamente in un flusso di lavoro di Shopify Flow. Questi parametri sono argomenti che devono avere dei valori da te dichiarati prima che la variabile venga considerata completa e utilizzabile dal flusso di lavoro.

Ad esempio, il campo product.inCollection determina se un prodotto si trova o meno in una determinata collezione e restituisce un risultato booleano (true o false). Tuttavia, in questo campo occorre includere l’argomento id della collezione, perché altrimenti la variabile non saprà quale collezione specifica controllare. Per utilizzare correttamente il campo, devi inserire l’argomento al suo interno. Ad esempio, eseguendo la query product.inCollection(id: "gid://shopify/Collection/123456") in modo che Flow possa stabilire se il prodotto è presente nella collezione con ID 123456 e poi restituire true o false come previsto. Quando crei variabili in Shopify Flow, non devi cercare valori come gli ID di prodotti o collezioni. Flow fornisce un selettore di risorse da cui selezionare il valore desiderato e l’ID viene inserito automaticamente.

Per semplificare l’interrogazione dei campi con argomenti, puoi assegnare un nuovo nome alla variabile creata in base al campo e all’argomento in Shopify Flow. Ad esempio, se la collezione con ID 123456 si chiama Summer Bestsellers, potresti assegnare alla variabile inCollection(id: "gid://shopify/Collection/123456") il nome più semplice inSummerBestsellers. Dopodiché, in tutti i passaggi successivi del flusso di lavoro, potrai semplicemente utilizzare la variabile product.inSummerBestsellers.

Poiché gli argomenti differiscono a seconda dei valori a essi assegnati, puoi creare diverse nuove variabili da un singolo campo che richiede argomenti. Ad esempio, potresti creare 3 variabili uniche soltanto dal campo product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") potrebbe diventare product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") potrebbe diventare product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") potrebbe diventare product.inBeachAccessories.

Campi di GraphQL Admin API supportati in Shopify Flow

Shopify Flow supporta i seguenti campi di GraphQL Admin API con i relativi argomenti richiesti:

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 campi di tipo translations, come collection.translations e product.translations

Campi di GraphQL Admin API non supportati in Shopify Flow

Shopify Flow non supporta i seguenti campi:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Per utilizzare i dati provenienti da questi campi non supportati nel flusso di lavoro, devi usare un’azione di Invio richiesta HTTP.

Creazione di una variabile da un campo con argomento

In Shopify Flow puoi creare una variabile per qualsiasi campo supportato che richieda un argomento. Basta creare la variabile una sola volta all’interno di un flusso di lavoro, poiché quest’ultima resterà disponibile come opzione in tutti i passaggi successivi del flusso.

La variabile che crei non è condivisa con altri flussi di lavoro, quindi per utilizzarla in un altro flusso di lavoro devi aggiungerla di nuovo.

Passaggi:

1. In un flusso di lavoro di Shopify Flow, clicca su Aggiungi una variabile in un'azione o condizione.
2. Seleziona un campo che richiede un argomento. Questi campi mostrano un pulsante +. Quindi, clicca su + Crea variabile.
3. Nella finestra di dialogo Crea variabile , segui questi passaggi:
   1. In base al campo selezionato, imposta un valore per l'argomento richiesto.
   2. Facoltativo: nel campo Nuovo nome variabile, personalizza il nome da assegnare alla nuova variabile. Questo nome si applica solo al flusso di lavoro corrente.
   3. Clicca su Aggiungi per aggiornare il pannello di selezione delle variabili.

Dopo aver aggiunto la nuova variabile a un flusso di lavoro, questa rimane disponibile come opzione di campo ed è possibile farvi riferimento rapidamente nei passaggi successivi. Quando scegli Aggiungi una variabile, la variabile viene visualizzata nidificata sotto l'opzione di campo originale nell'elenco dei campi.

Creazione di una variabile da un metafield in Shopify Flow

I metafield sono un tipo di variabile con campi che richiedono argomenti. Ottenere i dati di un metafield in un flusso di lavoro di Shopify Flow è leggermente diverso da ottenere i dati di un campo standard in altre variabili, in quanto sei tu a creare e definire i valori dei campi namespace e key del metafield, in modo che siano sempre univoci per il tuo negozio.

Ad esempio, il campo product.inCollection richiede sempre l'argomento id, a prescindere dal negozio in cui operi. Tuttavia, poiché imposti il campo namespace e key per ogni metafield che crei nel tuo negozio, gli argomenti richiesti sono personalizzati. Quindi, una variabile per il metafield di un prodotto che acquisisce le istruzioni per la cura di un capo di abbigliamento estivo potrebbe essere product.careGuideSummer.value, o una variabile per il metafield di un prodotto che registra l'ID relativo all'età a cui è destinato il prodotto potrebbe essere product.ageGroup.value_item.taxonomyReference.id. I nomi e gli argomenti dei campi sono interamente stabiliti da te.

Maggiori informazioni sui metafield in Shopify Flow.