-
Notifications
You must be signed in to change notification settings - Fork 0
Home
[toc]
De sequence-diagrammen in dit document zijn gemaakt in Mermaid. Mermaid maakt het mogelijk om diagrammen in tekst te beschrijven, waarna deze dynamisch gerendered worden. Dit maakt het eenvoudig om de tekst en diagrammen vanuit één tool te wijzigen, namelijk met een tekst editor. De tekst en de diagrammen kunnen vervolgens in een browser worden bekeken, deze worden dan 'gerendered' en weergegeven.
Een browser ondersteund het renderen van mermaid niet standaard, hiervoor moet een extensie voor worden geïnstalleerd. In Chrome/Vivaldi kun je gebruik maken van bijvoorbeeld de extensie mermaid-diagrams.
Dit document beschrijft de berichtuitwisselingen tussen de Nationale Portalen en de decentrale overheden. De berichtuitwisselingen zijn uitgewerkt in sequence-diagrammen en vervolgens zijn de benodigde API's ontworpen op basis van het SDG informatiemodel.
Doelstelling van dit document is tweeledig:
- verifieren van het SDG informatiemodel. Bevindingen leiden tot aanpassing over en weer
- discussiedocument voor het afstemmen van de benodigde APIS's
1. Welke organisatie-rollen zijn relevant voor de decentrale overheden?
Het SDG informatiemodel kent de volgende organisatie-rollen:
- Organisatie voor ondersteuning
- Organisatie verantwoordelijk voor de decentrale informatie
- Bevoegd gezag verantwoordelijk voor de procedure
Voor zover nu bekend geldt voor een decentrale overheid dat deze alle 3 de rollen zelf vervult.
- Welk organisatietype gaan we gebruiken als identificatie van de DO?
- Welke organisatietypen gaan we retourneren in antwoorden?
2. Er is geen attribuut contactgegevens. Deze zijn impliciet onderdeel van de 3 organisatie-rollen
Het SDG informatiemodel is hier niet compleet. In de invoervoorziening is dit nu als volgt uitgewerkt:
- een organisatie heeft contactgegevens
- website
- telefoon
- en één of meerdere locaties
- bezoekadres
- openingstijden
Bij een product wordt aangegeven op welke locatie(s) deze beschikbaar is
De burger of ondernemer heeft via een search engine of YourEurope het product op een Nationaal Portaal (NP) gevonden. De burger of ondernemer kan van dit product vervolgens de specifieke teksten van een decentrale overheid opvragen. Het nationale portaal haalt deze gegevens op bij de SDG product API bij de invoorvoorziening (van de DO).
Alle gegevens zijn nu beschikbaar en het nationale portaal maakt de SDG productpagina op.
Een SDG productpagina bevat conform SDG verordening SDG tags waardoor de pagina vindbaar en herkenbaar is voor het YourEurope portaal.
sequenceDiagram %% diagram
autonumber
%% participant
participant B as Burger of <br>ondernemer
participant N as Nationale Portalen
participant A as SDG product API <br>(invoervoorziening)
B->>N: Raadplegen generieke productbeschrijving
activate N
N->>A: Opvragen status van specifieke teksten
activate A
A->>N: Per DO de status van de specifieke tekst
deactivate A
N->>N: toevoegen SDG tags
N->>B: Generieke productpagina
deactivate N
loop raadplegen één of meerdere DO
B->>N: Raadplegen specifieke product van DO
activate N
N->>N: Selecteer DO,<br> toon DO suggesties op basis van status
N->>A: ophalen specifieke tekst DO
activate A
A->>N: specifieke tekst en contactgegevens
deactivate A
N->>N: toevoegen SDG location tag
N->>B: Specifieke productpagina
deactivate N
end
Het ondernemersplein heeft aangegeven de specifieke teksten te willen cachen. De specifieke teksten in het cache worden periodiek geactualiseerd.
De SDG product API zal hiervoor specifieke bulk opvragingen ondersteunen
sequenceDiagram %% diagram
%% participant
participant B as Burger of <br>ondernemer
participant N as Nationale Portalen
participant A as Producten API <br>(invoervoorziening)
loop periodiek bijwerken cache
N->>A: geef gewijzigde specifieke teksten vanaf datum x
activate A
A->>N: per DO de gewijzigde specifieke teksten
deactivate A
end
B->>N: Raadplegen generieke productbeschrijving
activate N
N->>N: toevoegen per DO status specifieke teksten
N->>N: toevoegen SDG tags
N->>B: Generieke productpagina
deactivate N
loop raadplegen één of meerdere DO
B->>N: Raadplegen specifieke product van DO
activate N
N->>N: Selecteer DO,<br> toon DO suggesties op basis van status
N->>N: specifieke tekst en contactgegevens
N->>N: toevoegen SDG location tag
N->>B: Specifieke productpagina
deactivate N
end
Geef van het gevraagde product een lijst van de decentrale overheden en per DO of het product beschreven is.
- Request:
- UPN
- Reply
- UPN
- alle DO
- registratiestatus (wel/niet beschreven)
- registratiestatusToelichting
- Als status wel beschreven
- ProductAanwezig (ja/nee)
- ProductAanwezigToelichting
Geef de specifieke tekst van een organisatie in een bepaalde taal en voor een bepaalde doelgroep
- Request:
- Organisatie, UPN, Taal, Doelgroep
- Reply
- VerantwoordelijkeOrganisatie (of BevoegdeOrganisatie??)
- contactgegevens
- ProductAanwezig
- ProductAanwezigToelichting
- NPSpecifiekeLink
- locatie
- Alle Productvariant
- ProductTitelDecentraal
- SpecifiekeTekst
- VerwijzingLinks
- DatumWijziging
- Productvariant (specifiek procedure art 10)
- BeschikbareTalen
- ProcedureBeschrijving
- Vereisten
- Bewijs
- BezwaarEnBeroep
- KostenEnBetaalmethoden
- UitersteTermijn
- WTDBijGeenReactie
- DecentraleProcedureLink
- VerantwoordelijkeOrganisatie (of BevoegdeOrganisatie??)
Geef van alle organisaties de gewijzigde specifieke teksten waarvoor geldt DatumWijziging > DatumVanaf
- Request:
- DatumVanaf, Doelgroep
- Reply
- alle organisaties
- VerantwoordelijkeOrganisatie (of BevoegdeOrganisatie??)
- contactgegevens
- alle Product (specifiek informatie art 9)
- UPN_URI
- Doelgroep
- Alle talen
- Taal
- ProductAanwezig
- ProductAanwezigToelichting
- NPSpecifiekeLink
- locatie
- Alle Productvariant
- ProductTitelDecentraal
- SpecifiekeTekst
- VerwijzingLinks
- DatumWijziging
- Productvariant (specifiek procedure art 10)
- BeschikbareTalen
- ProcedureBeschrijving
- Vereisten
- Bewijs
- BezwaarEnBeroep
- KostenEnBetaalmethoden
- UitersteTermijn
- WTDBijGeenReactie
- DecentraleProcedureLink
- VerantwoordelijkeOrganisatie (of BevoegdeOrganisatie??)
- alle organisaties
De invoervoorziening vraagt de generieke teksten op om deze te tonen in de invoervoorziening. De generieke tekst wordt getoond aan de gemeente redactie bij het schrijven van een specifieke tekst.
sequenceDiagram %% diagram
autonumber
%% participant
participant R as Redactie
participant I as Invoervoorziening
participant A as Generieke tekst API <br>(Nationaal Portaal)
R->>I: Beheren specifieke tekst
activate I
I->>A: Opvragen generieke tekst
activate A
A->>I: generieke tekst
deactivate A
I->>I: invullen referentie tekstblokken
I->>I: invullen specifieke tekstblokken
I->>R: formulier specifieke tekst
deactivate I
sequenceDiagram %% diagram
autonumber
%% participant
participant R as Redactie
participant I as Invoervoorziening
participant A as Generieke tekst API <br>(Nationaal Portaal)
loop periodiek bijwerken cache
I->>A: geef gewijzigde generieke teksten vanaf datum x
activate A
A->>I: gewijzigde generieke teksten
deactivate A
end
R->>I: Beheren specifieke tekst
activate I
I->>I: invullen generieke tekst
I->>I: invullen referentie tekstblokken
I->>I: invullen specifieke tekstblokken
I->>R: formulier specifieke tekst
deactivate I
Geef de generieke tekst van een product
- Request:
- UPN_URI
- Reply
- VerantwoordelijkeOrganisatie
- Product (generiek)
- Alle talen
- Taal
- ProductTitel
- GeneriekeTekst
- KorteOmschrijving
- VerwijzingLinks
- NationaleLink
- DatumCheck
- Alle talen
Geef de gewijzigde generieke teksten waarvoor geldt DatumCheck > DatumVanaf
- Request:
- DatumVanaf
- Reply
- VerantwoordelijkeOrganisatie
- Alle producten
- Product (generiek)
- UPN_URI
- Alle talen
- Taal
- ProductTitel
- GeneriekeTekst
- KorteOmschrijving
- VerwijzingLinks
- NationaleLink
- DatumCheck
- Product (generiek)