Klantmail TC-5823

Onderwerp: Maatwerk gereed, extra tekst bij INSBOU onderhoudsbericht

---

Beste [naam],

Naar aanleiding van het verzoek om extra informatie mee te sturen bij automatische onderhoudstatusberichten naar de woningcorporatie hebben wij de aanpassing gerealiseerd in de testomgeving.

Wat is er aangepast?

Wanneer een logmoment wordt aangemaakt op een INSBOU-serviceorder, wordt nu automatisch de datum en de omschrijving van het logmoment meegestuurd in het onderhoudsbericht. De woningcorporatie ontvangt dit als extra tekst bij de onderhoudsstatuscode.

Voorbeeld: bij het logmoment "2e belpoging" ziet het bericht er nu als volgt uit:

[screenshot invoegen]

Wat moet u doen?

Er is geen aanvullende handeling nodig. De aanpassing werkt automatisch bij het aanmaken van logmomenten op INSBOU-serviceorders.

Kunt u dit testen in de testomgeving en laten weten of het naar wens werkt? Dan zetten wij het door naar productie.

Met vriendelijke groet, [naam]

Technisch Oplossingsontwerp TC-5823

Samenvatting

Extra tekst (<FreeText>) meesturen bij automatische INSBOU onderhoudstatusberichten, bestaande uit de datum en logmomentomschrijving.

Aanleiding

QBuild gebruikt dezelfde onderhoudsstatuscode (bijv. "AFH" = Afspraak huurder) voor meerdere logmomenten. De woningcorporatie ontvangt daardoor meerdere identieke statuscodes zonder context. Door de logmomentomschrijving en datum als FreeText mee te sturen, wordt duidelijk waarom de statuscode is verstuurd.

Oplossingsrichting

Zelfde aanpak als TC-1119 (Bouwmeester): bij het aanmaken van een Document Reference Point de Service Order Status Text vullen. Het INSBOU-systeem pakt deze tekst op als <FreeText> bij het versturen van het onderhoudsbericht.

Extra t.o.v. Bouwmeester: ook de datum meesturen (conform FO v1.1).

Technische details

Nieuw object

Object	ID	Naam
Codeunit	73904	Events QB

Logica

1. Trigger: OnAfterInsertEvent op table Document Reference Point
2. Guard clauses:
   • Serviceorder moet bestaan en origin moet INSBOU Maint. Instr. zijn
   • Er moet een geldige INSBOU Maint. Status Setup bestaan voor het logmoment
3. Actie:
   • Bestaande Service Order Status Text regels voor deze serviceorder verwijderen
   • Nieuwe regel aanmaken met:
     • Maintenance Status Code = de gevonden onderhoudsstatuscode
     • Comment = <datum yyyy-MM-dd>: <logmoment omschrijving>

Voorbeeld output

<FreeText>2026-03-25: 2e belpoging</FreeText>

Impact

• Geen UI-wijzigingen
• Geen database-wijzigingen (gebruikt bestaande tabel Service Order Status Text)
• Performance impact nihil (1 extra insert per logmoment)

Teststappen

1. Open een INSBOU-serviceorder in de testomgeving
2. Maak een logmoment aan (bijv. logmoment 210 = 2e belpoging)
3. Controleer:
   • Service Order Status Text is gevuld met datum en omschrijving
   • De Maintenance Status Code in de status text klopt met de INSBOU-instelling
   • Het verzonden onderhoudsbericht bevat <FreeText> met de juiste tekst
4. Herhaal met een ander logmoment om te controleren dat de oude status text wordt vervangen

Testresultaten

[ruimte voor screenshots en bevindingen]

Referentie

• TC-1119 (Bouwmeester): Cod63000.EventsBM.al regels 129-159
• FO: "Functional Design Add text INSBOU Maintenance Message v 1.1.pdf"