Obter datos de catálogos

Nos fluxos de traballo que requiren datos de catálogos, podes usar a acción Obter datos de catálogos para recuperar información do catálogo B2B da túa tenda. Os catálogos son grupos de produtos con prezos personalizados para determinados clientes B2B ou localizacións da empresa.

Nota

Este é un tipo de acción Obter datos. Para entender como usar este tipo de acción co activador Hora programada e cos bucles Para cada, consulta Programacións, obtención de datos e fluxos de traballo en bucle en Shopify Flow.

Configuración

Campos

A acción Obter datos de catálogos contén os seguintes campos:

Campos usados nas accións Obter datos.

Campo	Descrición
Ordenar datos por	Obrigatorio. Os parámetros polos que se ordenan os datos que devolve a consulta de busca.
Número máximo de resultados	Obrigatorio. A cantidade máxima de resultados que pode devolver a consulta de busca seleccionada. Pódense devolver ata 100 de cada vez.
Consulta	Obrigatorio. Escolle entre as consultas habituais ou selecciona Avanzado para crear a túa propia.

Cadea de consulta

Este é un exemplo de consulta para obter todos os catálogos activos:

status:ACTIVE

A variable status é un filtro dispoñible na consulta de Catalogs e pódese usar varias veces ou combinala con outras variables.

Cando se consultan datos, é útil saber:

• Lista dos filtros dispoñibles de catálogos

• As consultas deben seguir unha sintaxe concreta

• Os valores dos campos de consulta non sempre están documentados. Nalgúns casos, os valores pódense atopar na documentación da API. Tamén podes atopar os valores dos campos nos URL do panel de administración ao filtrar. Por exemplo, para atopar algúns valores de consulta de pedidos, filtra a páxina Pedidos no panel de administración e logo comproba o URL.

• Podes executar ou probar unha consulta na túa tenda usando a aplicación de Shopify GraphiQL.

• Ten coidado co que pasa se a túa consulta falla. A miúdo, a API devolverá todos os resultados (no canto de ningún).

Datos devoltos

Todas as accións de Obter datos devolven unha lista de entre 0 e 100 recursos. Dependendo do teu caso de uso, se cadra queres usar estes datos de varias formas:

• Se necesitas xestionar cada elemento da lista de forma individual, por exemplo, para engadir unha etiqueta a cada un, podes usar a acción Para cada.
• Se necesitas agregar datos, por exemplo, contar cantos resultados se devolveron, podes usar as accións Contar ou Sumar.
• Se necesitas enviar a lista, por exemplo, enviar un correo electrónico con todos os elementos, podes usar os datos devoltos directamente nas accións posteriores.

Para acceder aos datos devoltos nos pasos seguintes a esta acción, usa a variable chamada Obter datos do catálogo, que é unha lista de catálogos. Podes usar esta variable tanto nas condicións como nas accións. Por exemplo, podes enviar a lista de catálogos nunha acción Enviar correo electrónico interno parecida a esta:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Nota

Se se usa unha acción de Obter datos varias veces nun mesmo fluxo de traballo, engádese un número ao nome da variable. Por exemplo, nun fluxo de traballo que usa dúas veces a acción Obter datos do pedido, a primeira variable para os datos devoltos é getOrderData e a segunda é getOrderData1. Este nome non se pode personalizar.

Activadores

Podes usar esta acción en calquera fluxo de traballo, incluído o activador Hora programada. Nun fluxo de traballo que usa o activador Hora programada, o fluxo de traballo comeza nunha hora que especificaches, en vez de facelo como resultado dun evento. Como non hai ningún evento específico na túa tenda nin nunha aplicación que inicie o fluxo de traballo, non se inclúe ningún dato de xeito automático.

Referencia da API

Para obter máis información sobre a API que se usa nesta acción, consulta a consulta de catálogos.