Obtener datos de empresas
En los flujos de trabajo que usan datos de empresas, puedes usar la acción Obtener datos de empresas para recuperar información de empresas de la tienda.
En esta página
Configuración
Campos
La acción Obtener datos de empresas incluye los siguientes campos, que se usan para definir la consulta:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Parámetros según los cuales se ordenan los datos devueltos por la consulta de búsqueda. |
| Número máximo de resultados | Obligatorio. Cantidad máxima de resultados que puede devolver la consulta de búsqueda que selecciones. Puedes devolver hasta 100 a la vez. |
| Consulta | Obligatorio. Elige entre consultas comunes o selecciona Avanzado para crear una propia. |
Cadena de consulta
Este es un ejemplo de consulta para obtener empresas que se actualizaron en el último día:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable updated_at es un filtro disponible en la Companies query y se puede usar varias veces o combinar con otras variables. La variable de Liquid scheduledAt está disponible en los flujos de trabajo que usan el Scheduled time trigger. La etiqueta de Liquid date_minus es una etiqueta especial de Flow que permite restar tiempo a una fecha.
Cuando consultes datos, es útil saber lo siguiente:
- List of available company filters
- Las consultas deben seguir certain syntax
- Los valores de los campos de las consultas no siempre están documentados. En algunos casos, puedes consultarlos en la API docs. También suele ser posible ver los valores de los campos en las URL del panel de control cuando aplicas filtros. Por ejemplo, para encontrar algunos valores de consulta de pedidos, filtra la página Pedidos en el panel de control y revisa la URL.
- Puedes ejecutar o probar una consulta en la tienda con la Shopify GraphiQL app.
- Ten en cuenta lo que sucede si la consulta falla. A menudo, la API devuelve todos los resultados (en lugar de ninguno).
Datos devueltos
Todas las acciones de Obtener datos devuelven una lista de entre 0 y 100 recursos. Según el caso de uso, puedes usar estos datos de varias maneras:
- Si necesitas procesar cada elemento de la lista de forma individual, por ejemplo para agregar una etiqueta a cada uno, usa la acción Para cada.
- Si necesitas calcular datos agregados, como contar cuántos resultados se devolvieron, puedes usar las acciones Contar o Sumar.
- Si necesitas usar la lista, por ejemplo, para enviar un correo electrónico con todos los elementos, puedes usar los datos devueltos directamente en las acciones posteriores.
Para acceder a los datos devueltos en los pasos posteriores a esta acción, usa la variable llamada Obtener datos de la empresa, que es una lista de empresas. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de empresas con la acción Enviar correo electrónico interno de esta forma:
{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}Activadores
Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Hora programada. En un flujo de trabajo que usa el activador Hora programada, el flujo de trabajo se inicia a la hora que especificaste, en lugar de iniciarse por un evento. Como no hay un evento específico en la tienda ni en una app que inicie el flujo de trabajo, no se incluye ningún dato de forma automática.