Usar campos de API com argumentos no Shopify Flow para criar variáveis

Algumas variáveis exigem parâmetros adicionais para funcionarem corretamente em um fluxo de trabalho do Shopify Flow. Esses parâmetros são argumentos que precisam ter os valores declarados antes que a variável seja considerada completa e utilizável pelo fluxo de trabalho.

Por exemplo, o campo product.inCollection determina se um produto está ou não em uma coleção especificada e retorna um resultado booleano (true ou false). No entanto, o argumento id da coleção deve ser incluído para esse campo; caso contrário, a variável não saberá qual coleção específica verificar. Para usar o campo corretamente, inclua o argumento como parte dele. Por exemplo, a consulta product.inCollection(id: "gid://shopify/Collection/123456") permite que o Flow determine se o produto está ou não na coleção com o ID 123456 e, em seguida, retorne true ou false como esperado. Ao criar variáveis no Shopify Flow, não é necessário pesquisar valores como IDs de produtos ou coleções. O Flow fornece um seletor de recursos para escolher o valor desejado, e o sistema preenche o ID automaticamente.

Para simplificar a experiência de consultar campos com argumentos, é possível atribuir um novo nome à variável criada com base no campo e no argumento no Shopify Flow. Por exemplo, se o nome da coleção com o ID 123456 for Mais vendidos de verão, você poderá atribuir à variável inCollection(id: "gid://shopify/Collection/123456") o nome mais simples de inSummerBestsellers. Depois, em todas as etapas seguintes do fluxo de trabalho, basta usar a variável product.inSummerBestsellers.

Como os argumentos diferem dependendo dos valores atribuídos a eles, é possível criar várias novas variáveis com base em um único campo que exija argumentos. Por exemplo, você poderia criar três variáveis exclusivas usando apenas o campo product.inCollection:

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

Campos da GraphQL Admin API compatíveis no Shopify Flow

O Shopify Flow é compatível com os seguintes campos da GraphQL Admin API com argumentos obrigatórios:

• 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 campos do tipo translations, como collection.translations e product.translations

Campos da GraphQL Admin API não compatíveis no Shopify Flow

O Shopify Flow não é compatível com os seguintes campos:

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

Para usar dados desses campos não compatíveis em seu fluxo de trabalho, é necessário usar a ação Enviar solicitação HTTP.

Criar uma variável com base em um campo com argumento

No Shopify Flow, é possível criar uma variável para qualquer campo compatível que exija um argumento. Basta criar a variável uma única vez em um fluxo de trabalho, pois ela permanece disponível como opção em todas as etapas seguintes desse mesmo fluxo.

A variável criada não é compartilhada com nenhum outro fluxo de trabalho. Portanto, para usá-la em outro fluxo, é preciso adicioná-la novamente nele.

Passos:

1. Em um fluxo de trabalho do Shopify Flow, clique em Adicionar variável em uma ação ou condição.
2. Selecione um campo que exija um argumento. Esses campos exibem o botão +. Em seguida, clique em + Criar variável.
3. Na caixa de diálogo Criar variável , siga estes passos:
   1. Com base no campo selecionado, defina um valor para o argumento exigido.
   2. Opcional: no campo Nome da nova variável, personalize como deseja chamar a nova variável. Esse nome se aplica apenas ao fluxo de trabalho atual.
   3. Clique em Adicionar para atualizar o painel de seleção de variáveis.

Após adicionar a nova variável a um fluxo de trabalho, ela continua disponível como opção de campo e pode ser rapidamente referenciada em passos seguintes. Ao escolher Adicionar variável, ela é exibida aninhada abaixo da opção de campo original na lista.

Criar uma variável de um metacampo no Shopify Flow

Os metacampos são um tipo de variável com campos que exigem argumentos. A obtenção de dados de metacampos em um fluxo de trabalho do Shopify Flow difere um pouco da obtenção de dados de campos padrão em outras variáveis porque você cria e define os valores dos campos namespace e key do metacampo, de modo que eles sejam sempre exclusivos da loja.

Por exemplo, o campo product.inCollection sempre exige o argumento id, independentemente da loja em que você esteja trabalhando. No entanto, como você define o namespace e a chave (key) para cada metacampo criado em sua loja, os argumentos exigidos são personalizados. Portanto, uma variável para um metacampo de produto que captura as instruções de cuidado para um produto de vestuário de verão pode ser product.careGuideSummer.value, ou uma variável de metacampo de produto que registra o ID da idade a qual o produto se destina pode ser product.ageGroup.value_item.taxonomyReference.id. Os nomes dos campos e os argumentos são determinados inteiramente por você.

Saiba mais sobre os metacampos no Shopify Flow.