Obter datos da colección
Nos fluxos de traballo que requiren datos da colección, podes usar a acción Obter datos da colección para recuperar información sobre as coleccións da túa tenda.
Configuración
Campos
A acción Obter datos da colección contén os seguintes campos.
| Campo | Descrición |
|---|---|
| Ordenar os datos por | Obrigatorio. Os parámetros mediante os que se ordenan os datos devoltos pola consulta de busca. |
| Número máximo de resultados | Obrigatorio. A cantidade máxima de resultados que pode devolver a consulta de busca que selecciones. Podes devolver ata 100 á vez. |
| Consulta | Obrigatorio. Escolle entre consultas habituais ou selecciona Avanzado para crear a túa propia. |
Cadea de consulta
Este é un exemplo de consulta para obter as coleccións que se actualizaron no último día:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'A variable updated_at é un filtro dispoñible na consulta de coleccións e pódese usar varias veces ou combinada con outras variables. A variable de Liquid scheduledAt está dispoñible nos fluxos de traballo que usaron o activador Hora programada. A etiqueta de Liquid date_minus é unha etiqueta especial de Flow que permite restar tempo dunha data.
Ao consultar datos, é útil saber:
- Lista de filtros de colección dispoñibles
- 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 da colección, que é unha lista de coleccións. Podes usar esta variable tanto nas condicións como nas accións. Por exemplo, podes enviar a lista de coleccións nunha acción Enviar correo electrónico interno parecida a esta:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}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 especificases, en vez de como resultado dun evento. Como non hai ningún evento específico na tenda nin desde unha aplicación que inicie o fluxo de traballo, non se inclúe ningún dato automaticamente.