Bewerken: Package Manager

Sectie: Workflow hash-attribuut

Reden:

### Workflow hash-attribuut

Elke `.wfl` in een package moet op de `<Workflow>`-root een `Hash="..."`-attribuut bevatten met een SHA1 over de eigen content. Klopt dit niet, dan weigert Ultimo het bestand zowel bij import als bij openen in de Workflow Designer met:

> `WorkflowException (0x10005013): Workflow_RunDesigner ... Workflow '<naam>' was edited with an unauthorized tool`

**Algoritme** (reverse-engineered, round-trip geverifieerd op 2026-05-19):

- **SHA1** van de UTF-8 bytes van het `.wfl`-bestand
- **zonder BOM** — de eerste drie bytes (`EF BB BF`) overslaan vóór hashen
- **zonder het `Hash="..."`-attribuut** zelf — patroon `Hash="[^"]*"\s+` één keer verwijderen vóór hashen (inclusief de spatie erna)
- Resultaat: 40-character hex, **uppercase**

**PowerShell-implementatie:**

```powershell
function Get-WorkflowHash {
    param([string]$Path)
    $bytes = [System.IO.File]::ReadAllBytes($Path)
    if ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF) {
        $bytes = $bytes[3..($bytes.Length - 1)]
    }
    $content        = [System.Text.Encoding]::UTF8.GetString($bytes)
    $contentNoHash  = [regex]::Replace($content, 'Hash="[^"]*"\s+', '', 1)
    $sha1           = [System.Security.Cryptography.SHA1]::Create()
    $hashBytes      = $sha1.ComputeHash([System.Text.Encoding]::UTF8.GetBytes($contentNoHash))
    return ($hashBytes | ForEach-Object { $_.ToString("X2") }) -join ""
}
```

**Werkwijze voor een nieuwe of buiten-Ultimo bewerkte `.wfl`:**

1. Schrijf het bestand met `<Workflow Hash="" Version="..." ...>` (lege placeholder; spatie erna behouden zodat de regex blijft kloppen na injectie).
2. Bereken de hash met de functie hierboven.
3. Vervang `Hash=""` door `Hash="<computed>"`.
4. Schrijf terug met UTF-8 BOM en CRLF line-endings (consistent met de Workflow Designer-output).
5. Round-trip-test: hash opnieuw berekenen → moet exact gelijk zijn aan het opgeslagen `Hash`-attribuut. Slaagt deze niet, dan staat de spatie na het Hash-attribuut waarschijnlijk verkeerd, of zit er een BOM-byte mee in de hash-input.

> **Wanneer is dit nodig?** Workflows die je via de Workflow Designer in UCT publiceert krijgen automatisch een geldige hash — daar hoef je niets te doen. Het algoritme hierboven is alleen relevant wanneer je workflow-XML buiten Ultimo om aanmaakt of bewerkt (bv. via scripting, templating of het samenstellen van een `.up`-package zonder UCT in de loop).

---