Configuratie
Om te zorgen dat de OpenWoo-website goed werkt, is het belangrijk dat de onderliggende (zaak)systemen op de juiste manier zijn geconfigureerd. Zo kan het zaaksysteem de informatie aanleveren die op de voorkant nodig is voor het opbouwen van de index. Daarbij is het belangrijk om te weten welke waarden waar worden gebruikt en wat het effect is van configuratiekeuzes.
- Gebruik variabelen
- Algemene inrichting zaaksysteem
- Categorieën
- Bijlagen
- Mapping ZGW
- Mapping vanuit zaaksysteem.nl search endpoint
Gebruik variabelen
Centraal in de Open WOO Website staat het publicatieobject, het publicatieobject vertegenwoordigt een Woo-publicatie, zijnde een verzoek, besluit, convenant of overige.
Zoekbalk
- Onder 'jaar' worden alleen de jaren weergegeven waarbinnen er een WOO-publicatie bestaat.
- Onder 'Categorie' worden de categorieën weergegeven waarvoor een WOO-publicatie bestaat.
Cards
In de cards worden de properties op de volgende plekken weergegeven.
Overzichtspagina
In de overzichtspagina worden de properties op de volgende plekken weergegeven.
Algemene inrichting
Voor het kunnen publiceren van zaken vanuit het zaaksysteem is het belangrijk dat het zaaksysteem beschikt over de juiste inrichting.
- OpenWoo.app kijkt alleen naar eigenschappen die vooraf worden gegaan door
woo_ - Er zijn algemene eigenschappen (geldend voor alle categorieën) en specifieke eigenschappen (alleen geldend voor bepaalde categorieën)
- Voor de gedefinieerde categorieën volgen we de informatiecategorieen-en-werkdefinities van koop
- Naast deze categorieën mag een organisatie ook eigen categorieën voeren (maatwerk).
Het is niet per definitie nodig om alle eigenschappen in het bronsysteem handmatig in te regelen en vullen, sommige eigenschappen kunnen worden overgenomen uit algemene metadata van een bron systeem.
Algemene eigenschappen
Een aantal zaakattributen zijn noodzakelijk voor het voor het goed werken van de OpenWoo.app, ze zijn dan ook altijd verplicht ongeacht de Woo categorie.
| Property | Verplicht | Gebruik | Toegestane waardes |
|---|---|---|---|
| woo_titel | Ja | De titel van de publicatie zoals online getoond | string, max 255 characters |
| woo_publicatiedatum | Ja | De datum vanaf wanneer de publicatie wordt gepubliceerd, bij leeg wordt de publicatie niet gepubliceerd. De datum wordt opgeslagen als UTC, hou hier rekening mee bij gebruik op de frontend. | string formatted as date-time (e.g., 2023-09-12 09:00) or string formatted as date (e.g., 2023-09-12) or NULL. If a date is presented instead of a date-time, the time will be automatically set to 00:00. |
| woo_categorien | Ja | De categorie van de WOO-publicatie | One of ("Wetten en algemeen verbindende voorschriften", "Overige besluiten van algemene strekking", "Ontwerpen van wet- en regelgeving met adviesaanvraag", "Organisatie en werkwijze", "Bij vertegenwoordigende organen ingekomen stukken", "Vergaderstukken decentrale overheden", "Agenda's en besluitenlijsten bestuurscolleges", "Adviezen", "Convenanten", "Jaarplannen en jaarverslagen", "Subsidieverplichtingen anders dan met beschikking", "Woo-verzoeken en -besluiten", "Onderzoeksrapporten", "Beschikkingen", "Klachtoordelen") |
| woo_thema | Nee | Een optionele titel van het thema waar de zaak onder valt | string, max 255 characters |
| woo_samenvatting | Nee | De KORTE samenvatting van de publicatie zoals online getoond | string, max 255 characters |
| woo_beschrijving | Nee | De UITGEBREIDE beschrijving van de publicatie zoals online getoond | string, max 2555 characters |
Specifieke eigenschappen
| Eigenschap | Verplicht | Gebruik | Toegestane waardes |
|---|---|---|---|
| woo_termijnoverschrijding | Nee | ||
| woo_datum_besluit | Nee | De datum waarop het besluit over de zaak genomen is | string formatted as date-time (e.g., 2023-09-12 09:00) or string formatted as date (e.g., 2023-09-12). If a date is presented instead of a date-time, the time will be automatically set to 00:00. |
| woo_datum_ontvangst | Nee | De datum waarop de zaak genomen is geregistreerd | string formatted as date-time (e.g., 2023-09-12 09:00) or string formatted as date (e.g., 2023-09-12). If a date is presented instead of a date-time, the time will be automatically set to 00:00. |
| woo_organisatieonderdeel | Nee | Vrije invulling tot op welk niveau 'organisatieonderdeel' wordt geïnterpreteerd. | string, max 2555 characters |
| woo_functiebenaming | Nee | string, max 255 characters | |
| woo_gedraging | Nee | string, max 2555 characters | |
| woo_bevindingen | Nee | string, max 2555 characters | |
| woo_oordeel | Nee | string, max 2555 characters | |
| woo_conclusies | Nee | string, max 2555 characters | |
| woo_opdrachtgever | Nee | Het bestuursorgaan of de externe partij die om het advies heeft gevraagd | string, max 2555 characters |
| woo_onderdeel_taak | Nee | Het organisatieonderdeel en de taak/bevoegdheid waarop het document betrekking heeft | string, max 2555 characters |
Eigenschappen naar categorie
| Categorie | Omschrijving | Eigenschappen | KOOP |
|---|---|---|---|
| 1a | Wetten en algemeen verbindende voorschriften | Valt buiten de OpenWoo.app | Valt buiten de OpenWoo.app |
| 1b | Overige besluiten van algemene strekking | Valt buiten de OpenWoo.app | Valt buiten de OpenWoo.app |
| 1c | Ontwerpen van wet- en regelgeving met adviesaanvraag | Valt buiten de OpenWoo.app | Valt buiten de OpenWoo.app |
| 1d | Organisatie en werkwijze | woo_onderdeel_taak | definitie |
| 1e | Bereikbaarheidsgegevens | Valt buiten de OpenWoo.app | |
| 2a | Bij vertegenwoordigende organen ingekomen stukken | Geen aanvullende eigenschappen | definitie |
| 2b | Vergaderstukken Staten-Generaal | Valt buiten de OpenWoo.app | Valt buiten de OpenWoo.app |
| 2c | Vergaderstukken decentrale overheden | Geen aanvullende eigenschappen | definitie |
| 2d | Agenda's en besluitenlijsten bestuurscolleges | Geen aanvullende eigenschappen | definitie |
| 2e | Adviezen | woo_opdrachtgever | definitie |
| 2f | Convenanten | Geen aanvullende eigenschappen | definitie |
| 2g | Jaarplannen en jaarverslagen | Geen aanvullende eigenschappen | definitie |
| 2h | Subsidieverplichtingen anders dan met beschikking | Geen aanvullende eigenschappen | definitie |
| 2i | Woo-verzoeken en -besluiten | woo_datum_besluit, woo_datum_ontvangst,woo_termijnoverschrijding | definitie |
| 2j | Onderzoeksrapporten | Geen aanvullende eigenschappen | definitie |
| 2k | Beschikkingen | Geen aanvullende eigenschappen | definitie |
| 2l | Klachtoordelen | woo_datum_ontvangst, woo_organisatieonderdeel, woo_functiebenaming, woo_gedraging, woo_bevindingen, woo_oordeel, woo_conclusies, woo_datum_besluit,woo_termijnoverschrijding | definitie |
Documenten/Bijlagen
Bijlagen nemen een bijzondere positie in binnen de OpenWoo.app, ze vormen de kern van de naar de bezoeker over te dragen informatie en zijn het centrale onderdeel van de Woo. De manier waarop deze worden getoond wordt beïnvloed door labels. Daarvoor gelden de volgende regels:
| Label | Effect van label |
|---|---|
| woo_publicatie | Alleen documenten met dit label worden weergegeven op de voorkant onder bijlage |
| woo_informatieverzoek | Documenten met dit label worden weergegeven onder de titel 'Informatieverzoek' in plaats van onder bijlagen |
| woo_inventarisatielijst | Documenten met dit label worden weergegeven onder de titel 'Inventarisatielijst' in plaats van onder bijlagen |
| woo_besluit | Documenten met dit label worden weergegeven onder de titel 'Besluit' in plaats van onder bijlagen |
| woo_convenant | Documenten met dit label worden weergegeven onder de titel 'Convenant' in plaats van onder bijlagen |
Spelregels omtrent labels
- De uniekheid van documenten wordt getoetst op basis van bestandsnaam.
Mappings
Mapping ZGW
Gebaseerd op: VNG ZGW Standaard
Mapping vanuit zaaksysteem.nl search endpoint
Gebaseerd op: xxllc-zaken mapping — historische 1.0-referentie naar de Common Gateway WooBundle. In de 2.0-architectuur wordt deze mapping via OpenRegister afgehandeld; de tabel hieronder beschrijft de mapping-logica los van het uitvoerend component.
| Eigenschap | Zaaksysteem.nl eigenschap |
|---|---|
| woo_titel | values.case.subject_external |
| woo_termijnoverschrijding | case.dateTarget - case.dateOfCompletion |
| woo_datum_ontvangst | values.case.date_of_registration |
| woo_id | object_id |
Note Voor de eigenschapen word verder gekeken naar values.attribute.[
eigenschap e.g. woo_beschrijving]