Bewerken: Scheduled Workflows

Sectie: Opzet van de workflow

Reden:

### Opzet van de workflow

**WorkflowType:** `Scheduled`  
**AllowUserInteraction:** `False` — scheduled workflows draaien zonder UI; dialogen zijn niet mogelijk.

#### Properties

| Naam | Type | Accessor | Direction | Beschrijving |
|------|------|----------|-----------|-------------|
| `LastCheck` | `DateTime` | `Optional` | `In` | Verplicht voor scheduled workflows |
| `to` | `UltimoString` | `Required` | `In` | E-mailadres ontvanger — via Scheduler in te vullen |

#### Stap 1: GetList — afgeronde jobs ophalen

Haal alle jobs op die in de afgelopen 7 dagen zijn afgerond:

```xml
<Transaction>
    <GetList Name="Haal afgeronde jobs op" Type="Job" OutputProperty="${jobs}">
        <Filter Property="FinishedDate"
                Operator="GreaterThanOrEqual"
                Value="=#startofday(#adddays(#{Environment.CurrentDate}, -7))" />
        <Filter Property="FinishedDate"
                Operator="SmallerThan"
                Value="=#startofday(#{Environment.CurrentDate})" />
    </GetList>
</Transaction>
```

> **Datumpatroon:** `#startofday(#adddays(now(), -2))` geeft het begin van de dag van 2 dagen geleden. Gebruik dit voor bereikfilters (BETWEEN) door twee filters te combineren: GreaterThanOrEqual voor de startdatum en SmallerThan voor de einddatum.

#### Stap 2: TextTemplate — conditionele e-mailtekst

Gebruik een TextTemplate met conditionele logica op basis van het aantal gevonden jobs:

```
#if(${jobs.Count} > 0)
    In de afgelopen week zijn ${jobs.Count} jobs afgerond:

#foreach(${job} in ${jobs})
    - ${job.Id}: ${job.Description} (afgerond: ${job.FinishedDate})
    #end
#else
    Er zijn geen jobs afgerond in de afgelopen week.
#end
```

- `${jobs.Count}` geeft het aantal elementen in de lijst
- De `#foreach` iteratie toont per job het ID, de omschrijving en de afmelddatum
- De `#else` tak toont een alternatieve tekst als de lijst leeg is

#### Stap 3: Email versturen

```xml
<Email Name="Stuur weekrapport"
       From="#{Settings.EmailSender}"
       To="${to}"
       SubjectTemplateCode="WEEKRAPPORT_SUBJECT"
       BodyTemplateCode="WEEKRAPPORT_BODY" />
```

- `From`: gebruik `#{Settings.EmailSender}` om het geconfigureerde afzenderadres te gebruiken
- `To`: gebruik de `${to}` property (Required In), zodat het e-mailadres per scheduler-instantie instelbaar is

#### Stap 4: Scheduler instellen

1. Ga naar `UCT > Business Rules > Workflow Scheduler`
2. Voeg de workflow toe
3. Stel het schema in: **Recurrence pattern > Weekly > Maandag > 07:00**
4. Vul bij Properties het veld `to` in met het e-mailadres van de maintenance manager
5. Activeer de workflow

#### Testen zonder te wachten

Gebruik de **Test Run** knop (of **Run** in de Scheduler-lijst) om de workflow direct uit te voeren zonder te wachten op het geplande tijdstip. Controleer daarna de **Message**-kolom en het **Event Log** op eventuele fouten.

> **Valkuil:** Als `AllowUserInteraction` per ongeluk op `True` staat, zal de scheduler de workflow niet uitvoeren. Zet dit altijd op `False` voor scheduled workflows.

---