Hämta data för faktureringsförsök för prenumeration
I arbetsflöden som kräver data om faktureringsförsök för prenumerationer kan du använda åtgärden Hämta data för faktureringsförsök för prenumeration för att hämta orderinformation från din butik.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta data för faktureringsförsök för prenumeration innehåller följande fält, som används för att skapa sökfrågan:
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. De parametrar som styr sorteringen av de data som sökfrågan returnerar. |
| Maximalt antal resultat | Obligatoriskt. Det maximala antalet resultat som kan returneras av den sökfråga du väljer. Du kan returnera upp till 100 åt gången. |
| Sökfråga | Obligatoriskt. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen. |
Sökfrågesträng
Det här är ett exempel på en sökfråga för att hämta faktureringsförsök för prenumerationer som har skapats under de senaste tre dagarna:
created_at:>'{{ createdAt | date_minus: "3 day" }}'Variabeln created_at är ett filter som är tillgängligt för sökfrågan för faktureringsförsök för prenumeration och kan användas för att välja specifika felmeddelanden för faktureringsförsök för prenumerationer.
När du gör sökfrågor för data är det bra att känna till:
- Lista över tillgängliga filter för faktureringsförsök för prenumerationer
- Frågor måste följa en viss syntax
- Fältvärden för frågor är inte alltid dokumenterade. I vissa fall kan värdena hittas i API-dokumenten. Alternativt kan du ofta hitta fältvärdena i URL:erna i adminpanelen när du filtrerar. Om du till exempel vill hitta några frågevärden för Order, filtrerar du sidan Ordrar i adminpanelen och kontrollerar sedan URL:en.
- Du kan köra eller testa en fråga i din butik med hjälp av Shopify GraphiQL-appen.
- Tänk på vad som händer om din fråga misslyckas. Ofta returnerar API:et alla resultat (i stället för inga).
Returnerade data
Alla Hämta data-åtgärder returnerar en lista med 0 till 100 resurser. Beroende på ditt användningsfall kan du använda dessa data på olika sätt:
- Om du behöver hantera varje artikel i listan individuellt, till exempel för att lägga till en tagg för varje, kan du använda åtgärden För varje.
- Om du behöver aggregera data, till exempel för att räkna hur många resultat som returnerades, kan du använda åtgärderna Räkna eller Summera.
- Om du behöver mata ut listan, till exempel skicka ett e-postmeddelande med alla artiklar, kan du använda returnerade data direkt i efterföljande åtgärder.
För att komma åt returnerade data i steg som följer efter den här åtgärden använder du variabeln Hämta data för faktureringsförsök för prenumerationer, som är en lista över faktureringsförsök för prenumerationer. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan med faktureringsförsök för prenumerationer i en Skicka internt e-postmeddelande-åtgärd så här:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Exempel
Till exempel schemaläggs ett arbetsflöde att köras varje söndag kl. 09.00. Åtgärden Hämta data för faktureringsförsök för prenumerationer används för att samla in data för faktureringsförsök för prenumerationer som skapats under den senaste veckan. Om de har ett felmeddelande, skicka e-postmeddelande om faktureringsförsöken.