Hent kontantsporingsøktdata
I arbeidsflyter som krever data om kontantsporingsøkter, kan du bruke handlingen Hent kontantsporingsøktdata for å hente informasjon om kontantsporingsøkter fra POS Pro. Kontantsporingsøkter brukes til å spore kontanter i butikkens kasser.
På denne siden
Konfigurasjon
Felt
Handlingen Hent kontantsporingsøktdata inneholder følgende felt.
| Felt | Beskrivelse |
|---|---|
| Sorter data etter | Obligatorisk. Parameterne dataene som returneres av søket skal sorteres etter. |
| Maksimalt antall resultater | Obligatorisk. Maksimalt antall resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen. |
| Spørring | Obligatorisk. Velg fra vanlige spørringer eller velg Avansert for å lage din egen. |
Spørringsstreng
Dette er et eksempel på en spørring for å hente kontantsporingsøkter som ble lukket i løpet av det siste døgnet:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'Variabelen closing_time er et filter som er tilgjengelig i CashTrackingSessions-spørringen, og kan brukes flere ganger eller kombineres med andre variabler. scheduledAt Liquid-variabelen er tilgjengelig i arbeidsflyter som bruker Planlagt tidspunkt-utløseren. date_minus Liquid-taggen er en spesiell Flow-tagg som lar deg trekke tid fra en dato.
Når du henter data med spørringer, er det nyttig å vite følgende:
Spørringer må følge en bestemt syntaks
Feltverdier for spørringer er ikke alltid dokumentert. I noen tilfeller kan verdiene finnes ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen spørringsverdier for bestillinger, kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
Du kan kjøre eller teste en spørring i butikken din ved hjelp av Shopify GraphiQL-appen.
Vær oppmerksom på hva som skjer hvis spørringen mislykkes. API-et vil ofte returnere alle resultatene (i stedet for ingen).
Returnerte data
Alle Hent data-handlinger returnerer en liste med mellom 0 og 100 ressurser. Avhengig av bruksområdet ditt, kan det være du vil bruke disse dataene på ulike måter:
- Hvis du må håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hvert av dem, kan du bruke For hver-handlingen.
- Hvis du trenger å aggregere data, for eksempel telle hvor mange resultater som ble returnert, kan du bruke handlingene Antall eller Sum.
- Hvis du trenger å sende listen som utdata, for eksempel sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i etterfølgende handlinger.
For å få tilgang til de returnerte dataene i trinn som følger etter denne handlingen, bruker du variabelen med navnet Hent kontantsporingsøktdata, som er en liste over kontantsporingsøkter. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over kontantsporingsøkter i en Send intern e-post-handling slik som dette:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Utløsere
Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert Planlagt tidspunkt-utløseren. I en arbeidsflyt som bruker Planlagt tidspunkt-utløseren, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Fordi det ikke er noen bestemt hendelse i butikken eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.
API-referanse
Hvis du vil ha mer informasjon om API-et som brukes i denne handlingen, kan du se CashTrackingSessions-spørringen.