Obter datos da páxina

Nos fluxos de traballo que requiren datos das páxinas, podes usar a acción Obter datos da páxina para recuperar información das páxinas da túa tenda. As Páxinas son as páxinas web da túa tenda en liña que conteñen información que rara vez cambia, como unha páxina Sobre nós ou de contacto.

Nota

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

Configuración

Campos

A acción Obter datos da páxina contén os seguintes campos:

Campos usados nas accións Obter datos.

Campo	Descrición
Ordenar os datos por	Obrigatorio. Os parámetros cos cales 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 que selecciones. Podes devolver ata un máximo de 100 resultados á vez.
Consulta	Obrigatorio. Escolle entre as consultas habituais ou selecciona Avanzada para crear unha propia.

Cadea da consulta

Este é un exemplo de consulta para obter as páxinas publicadas:

published_status:published

A variable published_status é un filtro dispoñible na Consulta de páxinas e pódese usar varias veces ou combinarse con outras variables.

Ao consultar datos, é útil saber o seguinte:

• Lista dos filtros de páxina dispoñibles

• As consultas deben seguir unha determinada sintaxe

• Os valores dos campos da consulta non sempre están documentados. Nalgúns casos, os valores pódense atopar consultando a documentación da API. Como alternativa, adoita ser posible atopar os valores dos campos nos URL do panel de administración ao aplicar filtros. 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 Shopify GraphiQL.

• Ten en conta o que ocorre se a túa consulta falla. A miúdo, a API devolverá todos os resultados (en vez de ningún).

Datos devoltos

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

• Se precisas xestionar cada artigo da lista individualmente, por exemplo, para engadirlle unha etiqueta a cada un, podes usar a acción Para cada.
• Se precisas agregar datos, por exemplo, para contar cantos resultados se devolveron, podes usar as accións Reconto ou Suma.
• Se precisas mostrar a lista, por exemplo, para enviar un correo electrónico con todos os artigos, podes usar os datos devoltos directamente nas accións posteriores.

Para acceder aos datos devoltos nos pasos que seguen a esta acción, usa a variable chamada Obter datos da páxina, que é unha lista de páxinas. Podes usar esta variable tanto en condicións como en accións. Por exemplo, podes enviar a lista de páxinas nunha acción Enviar correo electrónico interno semellante a esta:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Nota

Se se usa unha acción 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 use a acción Obter datos do pedido dúas veces, 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 co activador Hora programada. Nun fluxo de traballo que usa o activador Hora programada, este iníciase nunha hora que ti especificases, en lugar de facelo como resultado dun evento. Como non hai ningún evento específico na túa tenda ou nunha aplicación que inicie o fluxo de traballo, non se inclúe ningún dato automaticamente.

Referencia da API

Para obter máis información sobre a API usada nesta acción, consulta a Consulta de páxinas.