Concept
Een Skryv applicatie is configureerbaar via low-code artefacten zoals workflows, beslissingstabellen, formulieren en communicatietemplates. Deze kennen een grote mate van flexibiliteit dankzij het gebruik van expressies & scripts, services en connectoren. Toch zijn er altijd zaken die je op maat wil ontwikkelen. Maatwerk kan op twee plaatsen: in de applicatie zelf, via extensies en customizaties, of ernaast, via de API’s die de applicatie aanbiedt.
In de Skryv applicatie zelf
|
Mogelijkheid |
Uitleg |
Voorbeeld |
|---|---|---|
|
Je wil binnen je Skryv app bijkomende functionaliteit voorzien die niet standaard, out-of-the-box met de Skryv platform code afgeleverd wordt. Je vindt ze vooral in de back-end, zoals een eigen service, connector of geplande taak, maar ook in de frontends, zoals een nieuwe pagina of een eigen formuliercomponent. |
|
|
|
Je wil een bestaande functionaliteit die meegeleverd wordt met de Skryv platform code overschrijven met een custom component. Customizaties tref je vooral aan in de frontend (frontoffice of backoffice), maar evengoed ook in de back-end. |
|
De lichtste vorm van maatwerk is configureren in code: je past thema, vertalingen of zoekvelden aan via de API van het platform, zonder iets te vervangen.
Extern via API’s aangeboden door de Skryv applicatie
|
Mogelijkheid |
Uitleg |
Voorbeeld |
|---|---|---|
|
Je hebt iets buiten de Skryv app gebouwd en je wil het laten interageren met de Skryv app. |
Doorsluizen van specifieke dossiergegevens. |
|
|
Je wil custom rapporten en dashboards bouwen op basis van dossiergegevens in je Skryv app. |
Taartdiagram met verhouding dossiers goedgekeurd tegenover afgekeurd. |
Impact bij platformupgrades
Wie binnen de out-of-the-box configuratiemogelijkheden van een Skryv app blijft, hoeft zich in principe geen zorgen te maken bij upgrades naar een hogere platformversie. Vandaar de vuistregel: probeer in de eerste plaats functionaliteit uit te werken via configuratie.
Toch is dit niet altijd mogelijk of zelfs wenselijk (zie best practice pagina BPMN versus Code). Op dat moment schakel je over naar maatwerk onder de vorm van een extensie of customizatie. Dit heeft echter als gevolg dat elke platformupgrade potentieel breaking changes voor jouw applicatie met zich meebrengt. Denk bijvoorbeeld aan de upgrade van een onderliggende component zoals de toegepaste Java-versie. Uiteraard detecteert het Skryv platform team breaking changes zo veel mogelijk op voorhand en signaleert het deze via de release notes.
Hoe dieper je ingrijpt, hoe groter het risico. Vervang je een standaardcomponent, dan neem je de verantwoordelijkheid over voor alles wat dat component deed, ook wanneer het platform het bij een upgrade wijzigt.
Anatomie van een Skryv app
Vooraleer je start met extensies & customizaties, moet je weten hoe een typische Skryv app technisch in elkaar zit. Je leest alles hier over op de pagina Opbouw van een Skryv applicatie.