De OpenWoo Service versterkt de toegankelijkheid van overheidspublicaties volgens de Wet open overheid (Woo) door organisatiebronnen naadloos te synchroniseren met Open Index. Deze kernservice ondersteunt efficiënte zoekacties binnen Woo-categorieën en bevordert data-uitwisseling via het Common Ground OpenServices framework. Het faciliteert integratie met lokale en landelijke publicatieplatformen, inclusief koppelingen met het Kennis- en Exploitatiecentrum Officiële Publicaties (KOOP). OpenWoo.app is ontworpen voor zowel open source als proprietary platforms, waardoor het een centrale oplossing biedt voor het beheer en de zoekbaarheid van overheidsinformatie..
- Automatische Synchronisatie: Naadloze integratie met Open Index om overheidspublicaties automatisch bij te werken en te synchroniseren.
- Efficiënt Zoeken: Maakt geavanceerde zoekopdrachten mogelijk binnen Woo-categorieën door de data-uitwisseling met Open Index.
- Veelzijdige Ondersteuning: Geschikt voor zowel lokale als landelijke publicatieplatformen, waaronder een verbinding met het Kennis- en Exploitatiecentrum Officiële Publicaties (KOOP).
- Federale Zoekopdrachten: Ondersteunt federale zoekopdrachten via koophulpje.nl, waardoor een breder bereik en toegankelijkheid van overheidspublicaties wordt gegarandeerd.
- OpenServices Framework: Geïntegreerd met het Common Ground OpenServices framework voor gestandaardiseerde data-uitwisseling en interoperabiliteit.
- PHP 7.4 of hoger
- Symfony 5 of hoger
- Docker (voor containerisatie en lokale ontwikkeling)
- Clone het OpenWoo repository:
git clone https://github.com/OpenWoo/OpenWooService.git - Installeer afhankelijkheden met Composer:
composer install - Pas de
.envbestanden aan met uw specifieke configuraties voor de database en andere diensten. - Start de OpenWoo Service met Docker:
docker-compose up -d
Er is ook een docker-compose.yml beschikbaar voor de OpenWoo service om bovenstaande snel op te bouwen. Deze file is beschikbaar in de root folder van deze repository. Om deze te draaien is docker benodigd en zet u de volgende stappen:
- Open een terminalvenster waarmee Docker kan worden gedraaid
- Navigeer naar de map waarin u de repository heeft gecloned
- Draai het commando
docker compose up- Indien de image nog niet in docker beschikbaar is, zal de image opnieuw worden opgebouwd op basis van de latest versie van de common gateway images.
- Daarna worden de containers gestart (als de image wel beschikbaar is zal dit direct gebeuren)
- De admin omgeving komt beschikbaar op https://localhost:8000, de frontend op https://localhost:8080
Op de admin omgeving kan worden ingelogd met de default credentials username: [email protected], password: !ChangeMe!. Daarmee kan dan de configuratie van de omgeving worden beïnvloed.
Wijzigingen die in de code van deze repository (de map src) worden gedaan worden lokaal direct overgenomen. Changes in de configuratiebestanden in deze repository (Installation-folder) worden eveneens overgenomen, maar moeten om actief te worden in de lokale omgeving nog worden ingeladen met het commando docker compose exec php bin/console commongateway:initialize
Na de installatie kunt u de OpenWoo Service configureren om te beginnen met de automatische synchronisatie van uw organisatiebronnen naar Open Index.
De synchronisaties werken aan de hand van een action in combinatie met een source. Hieronder wordt uitgelegd hoe deze ingevuld moeten worden, er zijn ook genoeg voorbeelden in de /Installation/Action en /Installation/Source folders.
Er kan vanuit de volgende brontypen gesynchroniseerd worden:
- Zaaksysteem
- OpenWoo (en OpenConvenant)
Voor elk brontypen verschilt de configuratie voor de source en action die ingevuld moet worden.
Een source heeft standaard een reference en een name nodig. De reference moet uniek zijn als bijvoorbeeld https://commongateway.woo.nl/source/example.zaaksysteem.source.json.
Voor een source voor een zaaksysteem moeten de location ingevoerd worden. Dat is de volledige url van het zaaksysteem url, dus inclusief https:// aan het begin en /api aan het eind.
Ook moeten er headers geset worden met auth gegevens om te kunnen autoriseren voor het ophalen van documenten, hier een voorbeeld:
"headers": { "Accept": "*/*", "API-Interface-ID": "{apiInterfaceId}", "API-KEY": "{apiKey}", "Content-Type": "application/json" }
Als je al de velden van je source goed ingevuld heb kan je hem aanzetten door isEnabled op true te zetten.
De volledige POST van een goed ingevulde source voor het zaaksysteem ziet er als volgt uit:
{ "reference": "https://commongateway.woo.nl/source/example.zaaksysteem.source.json" "name": "Jouw zaaksysteem", "location": "https://{zaaksysteemUrl}/api", "isEnabled": true, "headers": { "Accept": "*/*", "API-Interface-ID": "{apiInterfaceId}", "API-KEY": "{apiKey}", "Content-Type": "application/json" } }
Voor een source voor OpenWoo of OpenConvenant hoeft alleen de location geset te worden, inclusief https:// aan het begin en /wp-json aan het eind (bijv: https://{openWooUrl}/wp-json).
Als je wilt dat je source en dus synchronisatie aanstaat moet isEnabled op true staan.
De volledige POST van een goed ingevulde source voor het OpenWoo of OpenConvenant ziet er als volgt uit:
{ "reference": "https://commongateway.woo.nl/source/example.openwoo.source.json" "name": "Jouw OpenWoo", "location": "https://{openWooUrl}/wp-json", "isEnabled": true }
Voor een voorbeeld van een action voor het zaaksysteem kan je kijken naar SyncEpeAction en als voor OpenWoo naar SyncBurenOpenWooAction. Voor OpenConvenant kan er gekeken worden naar SyncBurenOpenConvenantAction.
Een action heeft standaard een reference en een name nodig. De reference moet uniek zijn als bijvoorbeeld https://commongateway.nl/woo.SyncExampleAction.action.json.
Een action heeft ook een listens veld. Deze is in deze context meestal gelijk aan de throws van de algemene cronjob: woo.default.listens. Dit zorgt ervoor dat de action (synchronisatie) elke x minuten afgaat als in de cronjob ingesteld staat (standaard 10 minuten).
Het conditions veld. Dit zijn extra regels waneer een action af mag gaan. In dit geval gaan de actions standaard op de throws van de cronjob af, ingesteld via het listens van de action, dus mag hier de conditions standaard op {"==": [1,1]}. Deze json logic betekend dat hij altijd afgaat (op het listens event).
Het class veld. Dit geeft aan welke code uitgevoerd gaat worden voor deze action. Voor verschillende bronnen kan dit anders zijn:
- zaaksysteem:
CommonGateway\\WOOBundle\\ActionHandler\\SyncXxllncCasesHandler. - OpenWoo en OpenConvenant:
CommonGateway\\WOOBundle\\ActionHandler\\SyncOpenWooHandler.
De action heeft in de configuratie array een aantal velden wat geconfigureerd moet worden, sommige velden zijn verplicht en andere niet. Het verschilt ook vanuit wat voor type source (zaaksysteem, OpenWoo of OpenConvenant) gesynchroniseerd wordt:
- oin (required): oin vanuit het oin register van Logius. Deze waarde wordt gebruikt zodat er later op gefiltered kan worden
?organsiatie.oin=value. - portalUrl (required): Wordt gebruikt om de link naar de frontend mee te genereren.
- source (required): De reference van de source, die je meegeeft aan je source bij het aanmaken daarvan (bijv:
https://commongateway.woo.nl/source/example.zaaksysteem.source.json). - schema (required): Meestal de reference van het publicatie schema, voor bijna alle Woo synchronisaties wil je naar het publicatie schema mappen:
https://commongateway.nl/woo.publicatie.schema.json - mapping (required): De mapping die gebruikt wordt om het van source object naar publicatie object te krijgen. Voor het zaaksysteem is dit
https://commongateway.nl/mapping/woo.xxllncCaseToWoo.mapping.jsonen voor OpenWoo is dithttps://commongateway.nl/mapping/woo.openWooToWoo.mapping.json, voor OpenConvenant is hethttps://commongateway.nl/mapping/woo.openConvenantToWoo.mapping.json. - organisatie (required): Textueele representatie van de organisatie waar de publicaties van zijn, meestal de gemeente naam in het geval van een gemeente.
- zaaksysteemSearchEndpoint (required in geval zaaksysteem): Het endpoint wat gebruikt wordt om de publicaties op te halen in het zaaksysteem.
- sourceEndpoint (required in geval OpenWoo of OpenConvenant): Endpoint waar publicaties vandaan gehaald worden.
- fileEndpointReference (required in geval zaaksysteem): De reference naar het view-file endpoint voor de gesynchroniseerde documenten. Zorgt ervoor dat binnengehaalde documenten een endpoint hebben en bekeken kunnen worden. Standaard:
https://commongateway.nl/woo.ViewFile.endpoint.jsoninvoeren. - sourceType (required in geval OpenWoo, OpenConvenant of Notubiz): Niet verplicht in geval zaaksysteem, staat default op zaaksysteem. Anders voor OpenWoo of OpenCovenant 'openWoo' invoeren en voor Notubiz 'notubiz' invoeren.
- autoPublish: Niet verplicht, standaard op true. Als de wens is dat gesynchroniseerde publicaties niet meteen op te halen zijn, dan moet dit veld op false staan.
- allowPDFOnly: Niet verplicht. Op true zetten als de wens is om alleen pdf documenten te synchroniseren en geen andere bestandstypen.
Check altijd ook of de action aan staat met het isEnabled veld. Deze moet op true staan als er gesynchroniseerd moet worden.
De POST van een action voor het zaaksysteem ziet er als volgt uit:
{ "reference": "https://commongateway.nl/woo.SyncExampleAction.action.json", "name": "SyncExampleCasesAction", "listens": [ "woo.default.listens" ], "conditions": { "==": [ 1, 1 ] }, "class": "CommonGateway\\WOOBundle\\ActionHandler\\SyncXxllncCasesHandler", "configuration": { "oin": "{oinNummer}", "portalUrl": "https://conductionnl.github.io/woo-website-example", "source": "https://commongateway.woo.nl/source/example.zaaksysteem.source.json", "schema": "https://commongateway.nl/woo.publicatie.schema.json", "mapping": "https://commongateway.nl/mapping/woo.xxllncCaseToWoo.mapping.json", "organisatie": "Example", "zaaksysteemSearchEndpoint": "{zaaksysteemZoekEndpoint}", "fileEndpointReference": "https://commongateway.nl/woo.ViewFile.endpoint.json" }, "isEnabled": true }
De POST van een action voor het OpenWoo of OpenConvenant ziet er als volgt uit:
{ "reference": "https://commongateway.nl/woo.SyncExampleOpenConvenantAction.action.json", "name": "SyncExampleOpenConvenantAction", "listens": [ "woo.default.listens" ], "conditions": { "==": [ 1, 1 ] }, "class": "CommonGateway\\WOOBundle\\ActionHandler\\SyncOpenWooHandler", "configuration": { "oin": "{oinNummer}", "portalUrl": "https://conductionnl.github.io/woo-website-example", "source": "https://commongateway.woo.nl/source/example.openwoo.source.json", "schema": "https://commongateway.nl/woo.publicatie.schema.json", "mapping": "https://commongateway.nl/mapping/woo.openConvenantToWoo.mapping.json", "sourceType": "openWoo", "organisatie": "Exanoke", "sourceEndpoint": "{sourceEndpoint}" }, "isEnabled": true }
Als de action en source aangemaakt/ingeregeld zijn en isEnabled staat op true. Zou de cronjob elke x minuten deze action afvuren en de synchrosatie aftrappen. Check de logs of om te kijken of deze de 1e keer goed gaat.
Wij verwelkomen bijdragen aan de OpenWoo Service, of het nu gaat om bugrapporten, feature suggesties, of codebijdragen. Zie onze CONTRIBUTING.md voor meer informatie over hoe u kunt bijdragen.
De OpenWoo Service is uitgegeven onder de EUPL 1.2 licentie. Voor meer details, zie het LICENSE.md bestand in onze GitHub repository.
Voor meer informatie over de OpenWoo Service en hoe deze in uw organisatie geïmplementeerd kan worden, kunt u contact met ons opnemen via [email protected].