Voer een trigger uit voor records die u al hebt
Voer een Shopify Flow-trigger eenmalig uit voor bestaande producten, bestellingen, klanten, conceptbestellingen en collecties, of voor één record.
Een trigger wordt geactiveerd wanneer er iets verandert. Een Workflow die u vandaag opstelt, houdt daarom nooit rekening met de bestellingen, producten en klanten die al in uw winkel aanwezig waren, tenzij er toevallig een wijziging in deze gegevens plaatsvindt. Met Workflow Trigger Extensions beschikt u over twee manieren om een trigger te starten zonder op een wijziging te hoeven wachten:
- De pagina Uitvoeren voor bestaande records verstuurt één gebeurtenis voor elk record dat u al hebt, of alleen voor de records die bij een zoekopdracht worden gevonden. Gebruik deze pagina om een nieuwe workflow uit te voeren op oude bestellingen, elk bestaand product te taggen of alle klanten eenmalig te synchroniseren.
- Bij een afzonderlijk record bevat het blok van de app op de pagina van dat record in de Shopify-beheeromgeving een knop met de naam Trigger nu activeren.
Beide sturen een daadwerkelijke gebeurtenis naar Shopify Flow: elke actieve workflow die met de trigger begint, wordt één keer per record uitgevoerd, en elke gebeurtenis telt voor uw abonnement mee als een daadwerkelijke wijziging.
Welke triggers kunnen dit bewerkstelligen?
Op deze manier kunnen vijf triggers worden uitgevoerd. Elk daarvan verzendt één gebeurtenis voor elk record van het betreffende type:
| Trigger | Recordtype |
|---|---|
| Productupdate | Producten |
| Update betreffende uw bestelling | Bestellingen |
| Klantupdate | Klanten |
| Update inzake het conceptbesluit | Conceptbestellingen |
| Update van de collectie | Collecties |
Deze vijf triggers sturen het record zelf naar Shopify Flow, zodat er op elk moment voor elk record een gebeurtenis kan worden aangemaakt. Andere triggers, zoals ‘Producttags toegevoegd’ of ‘Opmerking bij bestelling gewijzigd’, beschrijven een wijziging met een waarde vóór en een waarde na de wijziging. Een record dat niet is gewijzigd, heeft geen van beide, waardoor deze triggers op deze manier niet kunnen worden geactiveerd.
Zoek naar bestaande records
- Open de pagina Triggers in de app en klik op de knop Uitvoeren voor bestaande records.
- Klik op de knop Nieuwe run.
- Selecteer in het veld Trigger de trigger die u wilt uitvoeren. De trigger moet zijn ingeschakeld. Als een trigger is uitgeschakeld, wordt u in het dialoogvenster gevraagd deze eerst in te schakelen.
- U kunt desgewenst het veld Alleen records die overeenkomen invullen. Hierin wordt dezelfde zoektekst gebruikt die u in de Shopify-beheeromgeving invoert. Twee voorbeelden:
tag:vip,created_at:>2026-01-01. Laat het veld leeg om alle records mee te nemen. - Klik op de knop Records tellen. De app geeft weer hoeveel records overeenkomen, hoeveel gebeurtenissen de run verstuurt en hoeveel gebeurtenissen er nog over zijn in uw abonnement voor de huidige periode van 30 dagen.
- Klik op de knop Start run.
De uitvoering verschijnt in de lijst Recente uitvoeringen met de trigger, de zoekopdracht, het aantal tot nu toe verwerkte records en de status. De status verandert van In afwachting naar Bezig en vervolgens naar Voltooid. De lijst wordt automatisch bijgewerkt terwijl een uitvoering aan de gang is. U kunt de pagina verlaten; de uitvoering gaat gewoon door.
Een aanval stoppen
Klik op de knop Stop naast een uitvoering die in de wachtrij staat of momenteel wordt uitgevoerd. De uitvoering wordt beëindigd nadat de batch van maximaal 100 records waar deze mee bezig is, is verwerkt; er kunnen dus nog enkele gebeurtenissen worden verzonden. Gebeurtenissen die al zijn verzonden, blijven verzonden: uw workflows zijn hiervoor uitgevoerd en ze zijn meegeteld.
Een run kan ook vanzelf stoppen. De status geeft dan aan waarom:
| Status | Wat is er gebeurd? |
|---|---|
| Gestopt: limiet van het abonnement bereikt | Andere gebeurtenissen hebben uw abonnement opgebruikt terwijl de run nog aan de gang was |
| Gestopt: toestemming ontbreekt | De toestemming voor deze gegevens werd niet langer verleend |
| Gestopt: kon niet worden voltooid | Er is een fout opgetreden tijdens de uitvoering. In de voortgangskolom kunt u zien hoever de uitvoering is gekomen |
| Gestopt | U hebt de aanval gestopt |
Beperkingen
- Eén run per winkel. Wacht tot een run is voltooid, of stop deze, voordat u de volgende start.
- Maximaal 50.000 records per zoekopdracht. Indien er meer records overeenkomen, kunt u de zoekopdracht verfijnen en deze in delen uitvoeren, bijvoorbeeld per jaar.
- De zoektekst mag maximaal 500 tekens lang zijn.
- Een run wordt handmatig gestart in de app. Deze kan niet worden gepland of gestart via de Developer API.
Een trigger voor één record starten
Het blok Flow-triggergebeurtenissen op de pagina van een record in de Shopify-beheeromgeving bevat een knop met de naam Trigger nu activeren. Deze knop is aanwezig op de pagina’s voor producten, bestellingen, klanten, conceptbestellingen en collecties. Op de pagina’s voor varianten, bedrijven en bedrijfslocaties beschikt het blok niet over een dergelijke knop, aangezien deze records geen van de vijf bovengenoemde triggers bevatten.
- Open het record in uw Shopify-beheerdersgedeelte en zoek het blok Flow-triggergebeurtenissen. Als u het blok nog niet hebt toegevoegd, raadpleeg dan Triggergebeurtenissen op de beheerpagina van een record.
- Klik op de knop Trigger nu activeren. Het blok geeft de trigger een naam en vraagt om bevestiging. Het wijst u er tevens op dat elke actieve workflow die met deze trigger begint, één keer wordt uitgevoerd en dat dit als één gebeurtenis wordt geteld.
- Het blok bevat nu twee knoppen. De eerste knop bevestigt en start de trigger. De tweede knop annuleert.
Twee klikken met opzet: een knop die workflows in gang zet, mag niet per ongeluk worden triggerd. Even later verschijnt de gebeurtenis in de lijst van het blok, net als elke andere gebeurtenis van dat record.
Als de trigger niet kan worden gestart, geeft het blok aan waarom: de trigger is uitgeschakeld, er ontbreekt een machtiging of de limiet van uw abonnement is bereikt. Na veel klikken in korte tijd vraagt het blok u om het over een minuut opnieuw te proberen.
Wat uw workflow ontvangt
De gebeurtenis is dezelfde als die welke bij een daadwerkelijke update wordt verzonden, met het record zoals het er nu uitziet. Er zijn drie verschillen, omdat er niets is veranderd:
- Er zijn geen oude en nieuwe waarden. Zelfs wanneer de instelling Oude en nieuwe waarden verzenden is ingeschakeld, is de lijst met wijzigingen in de gebeurtenis leeg.
- De veldselectie van de trigger wordt niet toegepast. De instelling met de naam Welke wijzigingen activeren dit bepaalt welke daadwerkelijke updates de trigger activeren. Een handmatig gestarte uitvoering heeft betrekking op elk record dat wordt aangetroffen.
- Aangepaste triggers worden niet uitgevoerd. Een uitvoering is bedoeld voor de workflows van één ingebouwde trigger. Uw eigen aangepaste triggers die op dezelfde gebeurtenis reageren, worden voor deze gebeurtenissen niet uitgevoerd. Zie Aangepaste triggers.
In de geschiedenis van het evenement
In de gebeurtenisgeschiedenis worden deze gebeurtenissen weergegeven met als bron Handmatige uitvoering. Dit geldt zowel voor gebeurtenissen uit een uitvoering als voor gebeurtenissen die voortkomen uit de knop Trigger nu activeren. Zo kunt u ze onderscheiden van de gebeurtenissen die door Shopify zijn verzonden. Om alleen deze gebeurtenissen te bekijken, selecteert u Handmatige uitvoering in het filter Bron.
Een handmatige uitvoering is geen test. Een test is gratis en heeft de bron Test. Een handmatige uitvoering is een daadwerkelijke gebeurtenis: deze zet uw workflows in gang en telt mee voor uw abonnement.
Wat gebeurt er als ik dezelfde run twee keer start?
Bij de tweede uitvoering wordt opnieuw voor elk overeenkomend record een gebeurtenis verzonden, en elke gebeurtenis telt opnieuw mee. Controleer de lijst Recente uitvoeringen voordat u een uitvoering herhaalt.
Hoe lang duurt een hardloopsessie?
Een verwerkingsrun doorloopt de records in batches, dus een grote run duurt even. In de voortgangskolom kunt u zien hoever de run is gevorderd. Uw workflows starten zodra de gebeurtenissen binnenkomen in Shopify Flow.
In het dialoogvenster staat dat de trigger is uitgeschakeld, of dat de uitvoering is geweigerd. Waarom?
De trigger is uitgeschakeld, of de toestemming voor die gegevens is niet verleend. Schakel de trigger in en verleen de toestemming, en start de uitvoering vervolgens opnieuw. Zie De pagina ‘Triggers’ (voorheen ‘Instellingen’) en Toestemmingen en toegang tot gegevens.
Volgende stappen
- Abonnementen en gebruik - wat wordt als een gebeurtenis beschouwd en wat gebeurt wanneer de limiet wordt bereikt.
- Triggergebeurtenissen op de beheerpagina van een record - het blok met de knop voor één record.
- Gebeurtenisgeschiedenis en probleemoplossing - de gebeurtenissen van een uitvoering opzoeken.
- De pagina ‘Triggers’ (voorheen ‘Instellingen’) - schakel een trigger in voordat u deze uitvoert.