De workflow-engine uitgelegd: validaties, taaktoekenning en goedkeuringsprocessen.
In het kort Met de workflow-engine automatiseer je het goedkeuringsproces voor inkomende facturen en declaraties. Je stelt validaties, taaktoekenningen en goedkeuringsstappen in. Beschikbaar als add-on bij een SLA-abonnement.
Met de workflow-engine van eConnect automatiseer je het goedkeuringsproces voor inkomende facturen, declaraties en andere documenten. Je stelt regels in die bepalen welke controles automatisch worden uitgevoerd en wie documenten moet goedkeuren. De workflow-functionaliteit is beschikbaar als add-on bij een SLA-abonnement (abonnement en/of inrichtingskosten). Functionaliteit staat onder Werkstromen in de klantomgeving; zonder contract of abonnement is deze niet aanwezig.
document.extra.receiverId).Een workflow heeft:
Methode (zonder Actor) gebruik je bijvoorbeeld bij inkoopfacturen om de download-datum te resetten. Daardoor gaat het document pas naar het softwarepakket nadat het is goedgekeurd en langs deze stap komt.
Bij de tab Volgende stappen kies je naar welke andere stappen het document mag. Routing is automatiseerbaar op condities, meestal bij de eerste stap of een stap zonder actor.
Een workflow bestaat uit een reeks stappen die een document doorloopt zodra het binnenkomt. Elke stap kan een automatische validatie zijn (het systeem controleert een voorwaarde) of een handmatige actie (een medewerker moet het document beoordelen).
De workflow-engine valideert op UBL-/XML-velden die het platform kent. Voorbeelden:
Op basis van de uitkomst worden taken toegekend of wordt het document automatisch doorgestuurd.
De veldpicker toont alleen platform-XML-velden. Ruwe UBL-extensies uit IDR staan daar niet in, tenzij via functions of XPath elders. Operators en functions zijn mogelijk, bijvoorbeeld lengte- of substringcontroles. Voor look-ups zonder workflow-aanpassing bij uitbreiding van een lijst gebruik je een datalijst-lookup (dl:getFirstResult).
Veelgebruikte conditiepatronen:
document.extra.isDuplicate == truedocument.DocumentCurrencyCode_ui6 != 'EUR'document.OrderReference_ui7 != null en binnen je bereiknoreply / no-replydocument.extra.receiverId == "<organisatie-id>"Als een document niet automatisch kan worden goedgekeurd, wordt een taak aangemaakt en toegewezen aan een gebruiker, groep of rol. De toewijzing kan gebaseerd zijn op het resultaat van de validatie, bijvoorbeeld: facturen boven €5.000 naar de financieel directeur, facturen onder €5.000 naar de boekhouder.
De medewerker die een taak ontvangt, kan het document:
Bij taken die aan meerdere personen zijn toegewezen, kun je instellen of alle personen moeten acteren of dat het voldoende is als één persoon goedkeurt.
De workflow is beschikbaar voor:
Een workflow kan automatisch starten bij binnenkomst van een document, of handmatig worden gestart vanuit het Postvak.
Pilot eerst: bouw en test de workflow altijd eerst in Pilot; zet daarna op in productie.
Een admin of beheerder kan ingrijpen op de workflow onder Administratie (Werkstroom admin).
Het menu-item Templates gebruik je voor het aanmaken van datalijsten. Datalijsten zet je in de workflow in voor automatische goedkeuring of afkeuring, routing en mapping (bijvoorbeeld EAN naar kostenplaats). Factuur-, conversietaak- en andere standaardtemplates kun je als klant niet aanpassen.
Datalijsten vul je via CSV-upload. Kolomnamen moeten exact overeenkomen met de datalist in het platform, de volgorde moet gelijk zijn, en er geldt een limiet van maximaal 5.000 rijen. Sla de CSV op zonder UTF-8-opmaak (ANSI/Windows-1252). Een downloadbaar template is beschikbaar via het tabblad "Upload gegevens".
De workflow stuurt automatisch e-mailnotificaties bij elke stap:
Menu: Ontwikkeling > E-mail templates. Je hebt rechten nodig om e-mailtemplates te ontwikkelen (doorgaans abonnement Professional of hoger). De lijst toont templates in het account en kan leeg zijn als er nog geen custom templates zijn. Tabs: Omgeving (accounttemplates) en Platform (platformtemplates van alle channels).
Workflow-notificaties en andere platformmails gebruiken e-mailsjablonen. Variabelen verschillen per context. Platformtemplates en eigen templates koppel je in workflow-notificatie- of e-mailverstuur-stappen.
Placeholders verschillen per context; niet elke placeholder is overal beschikbaar. Voorbeelden: [[params.INVOICEID]], [[params.SENDER]], [[params.RECEIVER]]. Beschikbare placeholders vind je vaak via Eigenschappen van de (platform)template.
Voor facturen ook XPath op XML, bijvoorbeeld:
[[document.xpath(//urn1:ID)]] = factuurnummer[[document.xpath(//urn2:AccountingSupplierParty/urn2:Party/urn2:Contact/urn1:ElectronicMail)]] = contactmail verzenderNa aanmaak of aanpassing koppel je e-mailverstuur-stappen in de workflow.
Elke stap in de workflow wordt vastgelegd in een volledige auditlog. Je kunt altijd terugzien wie wat heeft goedgekeurd, wanneer, en welke validaties zijn doorlopen. Dit is essentieel voor compliance en interne controle.
Voor het beheren van workflows is een speciale administratieve rol beschikbaar. Een gebruiker met deze rol kan taken herstarten, opnieuw toewijzen en stappen overrulen, zonder dat de reguliere workflow wordt doorbroken.
De Workflow Engine biedt inzicht via de Tijdlijn per document en het admin-overzicht:
Let op: de exportfunctie binnen de Workflow werkt momenteel niet. Validatieredenen en workflowstappen zijn niet exporteerbaar als CSV en niet als kolom toe te voegen aan de Takenbak-weergave. Gebruik als alternatief de Tijdlijn per document.
"The Workflow instance is already executing"
Deze foutmelding verschijnt wanneer een workflow-actie dubbel wordt geactiveerd, bijvoorbeeld door een dubbelklik op de goedkeurknop.
Oplossing als Workflow Admin:
Bij foutmeldingen in uitgaande werkstromen kun je als admin na correctie de taak hervatten via de resume-optie. Een gecancelde taak blijft op dezelfde status staan.
Dan verschijnt de foutmelding "The Workflow instance is already executing". Als Workflow Admin kun je de betreffende instantie opzoeken via "Alle instanties", de workflow opnieuw aanbieden en het document doorzetten naar de volgende stap.
Open de factuur en bekijk de Tijdlijn. Daar zie je alle uitgevoerde stappen, inclusief wie heeft geacteerd en wanneer. Als Workflow Admin kun je via de tab "All executed steps" een volledig overzicht bekijken.
Bij taken die aan meerdere personen zijn toegewezen, kun je instellen of alle personen moeten acteren of dat één goedkeuring voldoende is. Daarnaast kan een medewerker de taak delegeren naar een collega. Een gebruiker met de administratieve rol kan taken ook opnieuw toewijzen.
Wil je weten hoe taken werken in de praktijk? Lees Taken op het platform.
Stel een workflow in