Loop

Loop herhaalt de stappen erin één keer per record. De drawer heeft de kop Loop en opent met één optie, Custom, beschreven als “Loops through a selection of records.” Deze kiezen leidt naar de objectlijst, en daarna naar het filterpaneel. Na het opslaan opent de Next step-picker voor de eerste stap binnen de loop.

​

Instellingen

• Select an object. Het recordtype om op te halen, met een Search-vak. Elke entry benoemt eronder zijn koppeling. Met Carerix gekoppeld bevat de lijst Candidates, Companies, Contacts, Emails, Lists, Matches, Meetings, Notes, Offices, Placements, Publications, Talent Pools, Tasks, Users en Vacancies. De eigen objecten van HireData worden niet aangeboden.
• Filter. Welke records er worden opgehaald, in dezelfde rijen en sets als een Filter-stap. De velden zijn de velden van het object, elk voorafgegaan door het icoon van de koppeling. Laat het leeg en de loop haalt elk record van het object op.
• Stop on first success. No of Yes, standaard No. Met Yes eindigt de loop na de eerste iteratie die wordt voltooid, dus de stappen erin draaien voor hoogstens één record.
• Output Variable. Een naam voor het huidige record, placeholder myLoopItem. De helptekst luidt “This variable will be used instead of the step’s id for clarity when filled in” en het voorbeeld erin wordt bijgewerkt terwijl je typt, dus candidate geeft candidate.index. Laat het leeg en de variabelen worden genoemd naar het id van de stap.

​

Op het canvas

De Loop tekent een box met een Loop-badge. Daarbinnen staat de recordkaart, met een regel zoals “Retrieve Candidates from Carerix”, de naam van de koppeling en het filter, gevolgd door de eigen stappen van de loop en een + om er meer toe te voegen.

​

Wat het oplevert

Voor elke iteratie, onder de output variable: Stappen binnen de loop lezen deze naast de velden van het event. Stappen na de loop niet: die zien de variabelen die vóór de loop bestonden. Elke iteratie is een sub-run. De runs-lijst toont een rij per sub-run, dus het aantal runs van een automatisering met een Loop is hoger dan het aantal events. De pagina van de bovenliggende run vouwt de iteraties samen in één diagram en de timeline ervan registreert “Waiting.” terwijl ze draaien.

​

Wat de run stopt

• Een loop zonder stap erin. De timeline registreert “Loop: Failed” met het bericht “Step not found.” en de run eindigt daar. De Loop-box zelf draagt geen statusregel.
• Records die niet kunnen worden opgehaald. De Loop toont Cancelled met het bericht “Data lookup failed.” Controleer de koppeling en de filtervelden.
• Een stap binnen de loop die stopt. Die stopt alleen de sub-run van die iteratie; de andere iteraties en de stappen na de loop gaan door.

Zie Redenen voor run-annuleringen.

​

Patronen

• Maak het filter smal. Filter op het record dat je bedoelt, zoals het id van de kandidaat uit het event, in plaats van elke kandidaat op te halen en binnen de loop te filteren.
• Alleen de eerste match. Zet Stop on first success op Yes en zet een Filter als eerste stap erin. De loop eindigt bij het eerste record dat slaagt.
• Geef de variabele een naam. Een output variable zoals vacancy leest beter dan een stap-id in een prompt of een e-mailtemplate, en blijft behouden wanneer de stap opnieuw wordt gebouwd.

​

Veelgemaakte fouten

• Geen filter. De loop haalt elk record van het object op en draait de binnenste stappen voor elk. Voeg een filter toe voordat je activeert.
• Loopvariabelen lezen na de loop. Ze bestaan alleen daarbinnen. Schrijf wat je nodig hebt naar een record met een Update-taak binnen de loop.
• Verwachten te loopen over tekst of een bereik. De drawer biedt alleen records uit een gekoppelde app. Om te herhalen over de regels van een tekstveld of een vast aantal, verdeel je het werk anders, zoals met een Prompt met een List-output.

​

Gerelateerd

• Find haalt één record op in plaats van meerdere.
• Split maakt ook sub-runs, één per branch in plaats van één per record.
• Filter documenteert de rijen, sets en operators die het filter van de loop deelt.