Usar campos de la API con argumentos en Shopify Flow para crear variables

Algunas variables requieren parámetros adicionales para funcionar de forma correcta en un flujo de trabajo de Shopify Flow. Estos parámetros son argumentos a los que debes declararles un valor antes de que la variable se considere completa y utilizable en el flujo de trabajo.

Por ejemplo, el campo product.inCollection determina si un producto está o no en una colección especificada y devuelve un resultado booleano true o false. Sin embargo, para este campo se debe incluir el argumento id de la colección, ya que, de lo contrario, la variable no sabrá qué colección específica debe buscar. Para utilizar el campo de forma correcta, debes incluir el argumento como parte del campo. Por ejemplo, al consultar product.inCollection(id: "gid://shopify/Collection/123456") de forma que Flow pueda determinar si el producto se encuentra o no en la colección con la identificación de 123456, para después devolver true o false como se espera. Al crear variables en Shopify Flow, no necesitas buscar valores como las identificaciones de productos o colecciones. Flow proporciona un selector de recursos para seleccionar el valor que deseas, y la identificación se completa automáticamente.

Para simplificar la experiencia de buscar campos con argumentos, puedes asignar un nuevo nombre a la variable que creas a partir del campo y el argumento en Shopify Flow. Por ejemplo, si el nombre de la colección con la identificación de 123456 es Summer Bestsellers, puedes asignar a la variable inCollection(id: "gid://shopify/Collection/123456") un nombre más sencillo: inSummerBestsellers. Luego, en todos los pasos siguientes del flujo de trabajo, puedes usar sencillamente la variable product.inSummerBestsellers.

Dado que los argumentos varían en función de los valores que se les asignen, puedes crear múltiples variables nuevas a partir de un solo campo que requiera argumentos. Por ejemplo, puedes crear tres variables exclusivas a partir del campo product.inCollection:

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

Campos de la GraphQL Admin API admitidos en Shopify Flow

Shopify Flow admite los siguientes campos de la GraphQL Admin API con argumentos requeridos:

• 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 de tipo translations, como collection.translations y product.translations

Campos de la GraphQL Admin API no admitidos en Shopify Flow

Shopify Flow no admite los siguientes campos:

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

Para usar datos de estos campos no admitidos en tu flujo de trabajo, debes usar una acción Enviar solicitud HTTP.

Crear una variable a partir de un campo con un argumento

Puedes crear una variable en Shopify Flow para cualquier campo admitido que requiera un argumento. Solo tienes que crear la variable una vez en un mismo flujo de trabajo, ya que la variable permanece disponible como opción en todos los pasos siguientes del flujo.

La variable que creas no se comparte con ningún otro flujo de trabajo, así que, para usarla en otro flujo de trabajo, debes agregarla de nuevo en dicho flujo.

Pasos:

1. En un flujo de trabajo de Shopify Flow, haz clic en Agregar una variable en una acción o condición.
2. Selecciona un campo que requiera un argumento. Estos campos muestran un botón +. Luego, haz clic en + Crear variable.
3. En el cuadro de diálogo Crear variable , sigue estos pasos:
   1. Según el campo que hayas seleccionado, establece un valor para el argumento requerido.
   2. Opcional: en el campo Nuevo nombre de variable, personaliza cómo quieres llamar a la nueva variable. Este nombre se aplica solo al flujo de trabajo actual.
   3. Haz clic en Agregar para actualizar el panel de selección de variables.

Una vez que agregues la nueva variable a un flujo de trabajo, esta permanece disponible como una opción de campo y puedes consultarla rápidamente en pasos posteriores. Si eliges Agregar una variable, se mostrará anidada debajo de la opción de campo original en la lista de campos.

Crear una variable desde un metacampo en Shopify Flow

Los metacampos son un tipo de variable con campos que requieren argumentos. Obtener datos de metacampos en un flujo de trabajo de Shopify Flow difiere ligeramente de obtener datos de campos estándar en otras variables porque creas y defines los valores de campo namespace y key del metacampo, por lo que siempre son exclusivos de tu tienda.

Por ejemplo, el campo product.inCollection siempre requiere el argumento id, independientemente de la tienda en la que trabajes. Sin embargo, dado que estableces el espacio de nombres y la clave para cada metacampo que creas en tu tienda, los argumentos requeridos son personalizados. Por lo tanto, una variable para un metacampo de producto que captura las instrucciones de cuidado de un artículo de ropa de verano podría ser product.careGuideSummer.value, o una variable para un metacampo de producto que registra la identificación de la edad para la que está destinado el artículo podría ser product.ageGroup.value_item.taxonomyReference.id. Tú determinas por completo los nombres de los campos y los argumentos.

Más información sobre los metacampos en Shopify Flow.