¶ Introduction
The JOIN WOO Portal is the place where active and passive disclosure under the Open Government Act (WOO) comes together. The WOO Portal provides direct access to information from JOIN Case & Document, without the intervention of complex integration solutions. You only need 1 location where your public information is stored.
On this page you can read how to configure the WOO Portal.
¶ License
To be able to use the JOIN WOO Portal, you must have a valid license from the WOO Portal. You can contact your Decos or Doclogic Account Manager for this.
¶ Minimum System Requirements
In order to be able to use the JOIN WOO Portal, your JOIN Case & Document environment must meet the following requirements:
- the RestAPI of your environment must be publicly available. If you have any questions about this, please contact a Decos technical consultant
- Your JOIN Case & Document version must be 2024.8 or higher.
- You use Elastic as a search engine in JOIN Case & Document
You can use the WOO Portal in combination with both JOIN Case Types (the official case system of Decos) and your own setup based on file and document collections. If you use the DMS/RMA of JOIN Case & Document, this is no problem at all.
¶ IP-whitelist
We need to add below outbound IP-addresses from burgerberichten.nl in IP-whitelist in AKS or on-premise environment:
51.144.176.157
40.91.223.118
168.63.99.196
52.136.230.110
23.97.161.87
52.136.228.122
52.232.107.63
20.101.214.10
20.13.102.111
4.231.84.45
4.231.84.48
4.231.84.214
4.231.84.250
4.231.85.12
4.231.85.53
4.231.85.57
4.231.85.68
4.231.85.70
4.231.85.88
23.97.214.177
¶ JOIN Admin - System Configuration
On the side of JOIN Case & Document, you need to set up a number of configurations in the “Connectivity” section:
System
In the “Connectivity–>System” section, the WOO Portal is configured as an integration system. This configuration is done by a technical consultant from Decos.
The system configuration is necessary to be able to configure the correct connection in JOIN Citizen Messages.
Entities
It is possible to use entity definitions for the mapping of WOO attributes on the WOO Portal with the data from the item profiles of JOIN Case & Document. This functionality is used in combination with the “use connect mappings” setting that you need to activate on the Citizen Messages side.
¶ JOIN Admin - collections
In JOIN Admin (or in JOIN Case Types) you set up the collections that you want to make accessible to the JOIN WOO Portal.
Make sure that you set up the correct fields that can be used for:
- category: this is the name of the collection
- description: the description of the WOO File
- summary: the summary of the subject of the dossier in question
- publication date: the date on which the WOO file with underlying documents is publicly accessible (via the WOO POrtaal)
- decision date: if applicable, the date on which the decision was taken.
¶ Citizen Messages admin
The configuration of the WOO Portal is largely done in the management environment of JOIN Burgerberichten. You can access this environment via this URL citizen messages management environment.
If you do not yet have access to this environment, you can request access by means of a request to Decos Support. You can create a ticket with the support team via the following link: Create a ticket with Decos Support
¶ Settings
the following settings can be configured on the WOO portal:
| Setting | definition |
|---|---|
| WOO Endpoint URL | the URL of the RestAPI of the connected system (test and production) |
| System User | the system user authenticating to the API |
| API Client ID | the ClientID of the API |
| Password | the password used to authenticate to the API |
| Confidentiality folder | the level of confidentiality that determines the disclosure (file) |
| Confidentiality document | the level of confidentiality that determines the disclosure (document) |
| Header title | the title of the WOO Portal |
| Header subtitle | The subtitle of |
| Book keys | the keys to the collections that are searchable for the tenant’s WOO portal |
| Mark | the field in which the case or case reference is recorded |
| Confidentiality | the field in which the confidentiality of the file or case is recorded |
| Category | the field in which the category of the case or case is defined |
| Summary | field in which a summary of the case or case is presented |
| Publication date | the field in which the publication date of the file or case is recorded. Please note: only cases or files with a publication date in the past are shown on the WOO portal |
| Start date | the field in which the start date of the case or case is recorded |
| Decision date | the field in which the decision date of the case or case is recorded |
| Case Document Type | The field in which the document type/type is recorded. If it is empty, the book name is used |
| Case Document Confidentiality | the field in which the confidentiality of the document is determined |
| Case document Description | the field in which the description of the document is recorded |
| Data Provider | the connected system from which the WOO portal gets its data |
| Only show handled cases/folders | if this is checked, only completed files/cases will be shown on the WOO Portal |
| Only show handled documents | if this is checked, only completed documents will be shown on the WOO Portal |
| Search through document content | If this is checked, the content of documents can also be |
** if the URLs are not entered, the button for submitting a WOO request will not be displayed. If only 1 URL is entered, only 1 button will be shown with the label “Submit WOO Request”
