Obter datos de localización

Nos fluxos de traballo que precisen datos das localizacións, podes usar a acción de Obter datos de localización para recuperar a información da localización na túa tenda de Shopify. As Localizacións son calquera lugar onde se garde inventario, se vendan produtos ou se envíen ou preparen pedidos.

Nota

Esta é un tipo de acción de Obter datos. Para entender como usar este tipo de acción co activador de Hora programada e os bucles de Para cada, consulta os horarios, as accións para obter datos e os fluxos de traballo en bucle en Shopify Flow.

Configuración

Campos

A acción Obter datos de localización contén os seguintes campos.

Campos utilizados nas accións para obter datos.

Campo	Descrición
Ordenar datos por	Obrigatorio. Os parámetros para ordenar 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 as consultas máis comúns ou selecciona Avanzado para crear a túa.

Cadea da consulta

Este é un exemplo dunha consulta para obter as localizacións que teñen a recollida na tenda activada:

pickup_in_store:enabled

A variable pickup_in_store é un filtro dispoñible na consulta de Localizacións e pode usarse varias veces ou combinada con outras variables.

Cando se consulten datos, convén saber que:

• Lista dos filtros de localización dispoñibles

• As consultas deben seguir certa sintaxe

• Os valores dos campos da consulta non sempre están documentados. Nalgúns casos, pódense atopar os valores botando unha ollada nos documentos da API. Se non, moitas veces podes atopar os valores dos campos nos URL do administrador ao filtrar. Por exemplo, para buscar algúns dos valores da consulta de Pedidos, filtra a páxina Pedidos no administrador e logo comproba o URL.

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

• Ten coidado co que poida pasar se falla a túa consulta. Adoita pasar que a API devolve todos os resultados (en lugar de ningún).

Datos devoltos

Todas as accións de Obter datos devolven unha lista de entre 0 e 100 recursos. Dependendo do caso de uso, pode que queiras usar estes datos de distintas maneiras:

• Se precisas xestionar cada artigo da lista de forma individual, como por exemplo para engadirlle unha etiqueta a cada un, podes usar a acción Para cada.
• Se necesitas agregar datos, por exemplo para contar os resultados devoltos, podes usar as accións Contar ou Sumar.
• Se precisas mostrar a lista, como 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 de localización, que é unha lista de localizacións. Podes usar esta variable tanto en condicións coma en accións. Por exemplo, podes enviar a lista de localizacións nunha acción de Enviar correo electrónico interno parecida a esta:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Nota

Se se utiliza 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 use a acción Obter datos do pedido dúas veces, a primeira variable dos datos devoltos é getOrderData e a segunda é getOrderData1. Este nome non se pode personalizar.

Activadores

Podes usar esta acción en calquera fluxo de traballo, ata co activador de Hora programada. Nun fluxo de traballo que usa o activador de Hora programada, o fluxo de traballo iníciase á hora especificada por ti, en vez de arrincar por un 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úen datos automaticamente.

Referencia da API

Para obter máis información sobre a API usada nesta acción, consulta a consulta de localizacións.