Utilizați Iterator

Documentation Index

Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt

Use this file to discover all available pages before exploring further.

​

Când să folosiți Iterator

​

Înțelegerea Iteratorului

1. Preia primul element din array
2. Rulează toate acțiunile din interiorul Iteratorului cu acel element
3. Trece la următorul element
4. Repetă până când toate elementele sunt procesate

​

Configurare de bază

​

Exemplu: Trimiteți e-mail tuturor din rezultatele căutării

​

Pasul 1: Căutați înregistrări

1. Adăugați acțiunea Search Records
2. Obiect: Persoane
3. Filtru: Compania este egală cu “Acme Inc”
4. Aceasta returnează un array de persoane

​

Pasul 2: Verificați dacă există rezultate

1. Adăugați acțiunea Filter
2. Condiție: {{searchRecords.length}} este mai mare decât 0
3. Aceasta previne erorile Iteratorului când rezultatele sunt goale

​

Pasul 3: Adăugați un Iterator

1. Adăugați acțiunea Iterator
2. Intrare pentru array: selectați {{searchRecords}}
3. Aceasta creează o buclă

​

Pasul 4: Adăugați acțiuni în interiorul Iteratorului

1. Adăugați acțiunea Send Email (în interiorul Iteratorului)
2. Către: {{iterator.currentItem.email}}
3. Subiect: Salut {{iterator.currentItem.firstName}}!
4. Conținut: Mesaj personalizat folosind câmpurile elementului curent

​

Rezultat

• Trimite e-mail persoanei 1
• Trimite e-mail persoanei 2
• … continuă pentru toate cele 5

​

Accesarea datelor elementului curent

​

Tipare comune

​

Actualizați mai multe înregistrări

1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
   └── Update Record
       - Object: Tasks
       - Record: {{iterator.currentItem.id}}
       - Status: Late

​

Creați înregistrări dintr-un array

1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
   └── Create Record
       - Object: Order Items
       - Name: {{iterator.currentItem.name}}
       - Quantity: {{iterator.currentItem.qty}}
       - Related Order: {{trigger.body.orderId}}

​

Procesare condițională în interiorul buclei

1. Search Records (People)
2. Iterator (searchRecords)
   └── Filter (currentItem.email is not empty)
       └── Send Email
           - To: {{iterator.currentItem.email}}

​

Depanare

​

”Iterator expects an array”

✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}

​

Iteratorul nu rulează

Filter: {{searchRecords.length}} > 0

​

Acțiunile rulează de prea multe ori

• Adăugați filtre mai specifice în Search Records
• Setați o limită în Search Records (maxim 200)
• Adăugați un Filter în interiorul Iteratorului pentru condiții suplimentare

​

Considerații de performanță

• Utilizarea creditelor: Fiecare iterație consumă credite pentru acțiunile sale
• Timp: Array-urile mari necesită mai mult timp pentru a fi procesate
• Limite: Luați în considerare procesarea în loturi a operațiunilor foarte mari
• Limite de rată: Apelurile către API-uri externe pot atinge limitele de rată la multe iterații

​

Cele mai bune practici

1. Verificați întotdeauna lungimea array-ului înainte de Iterator pentru a evita erorile
2. Adăugați filtre în interiorul buclelor când nu toate elementele trebuie procesate
3. Redenumiți pasul Iterator pentru a descrie prin ce iterează
4. Testați cu array-uri mici înainte de a procesa seturi mari de date
5. Monitorizați rulările fluxurilor de lucru pentru a vă asigura că iterațiile se finalizează conform așteptărilor

​

Conexe

• Acțiuni ale fluxurilor de lucru
• Cum să utilizați ramurile
• Întrebări frecvente despre fluxurile de lucru