Werkzaamheden zonder trefwoorden

Organisaties Data en Services Omgevingsloket
#1

De service om werkzaamheden te bekijken lijkt sinds kort nieuwe werkzaamheden te bevatten, die geen trefwoorden bevat, zie namelijk deze of deze werkzaamheid.

Uit de documentatie lijkt het alsof werkzaamheden altijd een ‘trefwoorden’ property horen te hebben. Dat zou deze werkzaamheden – die overigens duidelijk ter behoeve van een oefening zijn – ongeldig maken. Kan daar iets aan gedaan worden? Of op z’n minst duidelijk aangeven welke properties vereist zijn voordat een oefen-werkzaamheid kan worden toegevoegd.

#2

De inhoud van de StelselCatalogus en bijbehorende service wordt opgehaald uit andere systemen.
Werkzaamheden worden op dit moment opgehaald uit de PRE omgeving van toepasbare regels.

Dit is de reden dat er werkzaamheden aanwezig zijn welke de tekst oefen bevatten en ook de reden dat ze geen trefwoorden bevatten.

#3

Oke. Het is lastig om een implementatie te schrijven op een service die onduidelijk gedocumenteerd is, of zoals nu, waar een property overal beschikbaar is, en ineens niet meer. Dus laat ik mijn vraag beter stellen:

Ongeacht de omgeving (pre of productie), welke eigenschappen van een werkzaamheid zijn verplicht bij het beheren/wijzigen/toevoegen van een werkzaamheid?

#4

Ik snap je vraag nu beter, maar kan hem helaas niet voor je beantwoorden. De Catalogus publiceert enkel vanuit andere bronnen, ik ben onvoldoende bekend met het model rondom werkzaamheden. Ik ga intern even wat navraag doen en zorg dat er iemand op terug komt die je vraag wel kan beantwoorden.

#5

Trefwoorden bij een Werkzaamheid zijn optioneel, een Werkzaamheid kan 0 of meer trefwoord bevatten.
Meer informatie over het model rondom werkzaamheden kun je vinden in het STTR en IMTR.

#6

Ik kan niet precies vinden waar de werkzaamheden dan precies aan moeten voldoen, maar dank hiervoor in ieder geval.

Er is natuurlijk nog wel een verschil of een werkzaamheid wel de eigenschap trefwoorden heeft (die vervolgens een lege lijst bevat: []) of dat die eigenschap helemaal niet bestaat. Kun je daar toevallig nog meer over zeggen? Vanuit een API design is dat nog wel een verschil namelijk :slightly_smiling_face:

#7

Dankzij een oplettende collega zie ik nu trouwens pas dat je in je eerste bericht refereert naar de API van RTR en niet naar de opvragen API van de Catalogus.
Neemt trouwens niet weg dat je laatste vraag voor beide API’s van toepassing is en voor verbetering vatbaar.

Dit is de API voor de StelselCatalogus, waar je ook de werkzaamheden kunt vinden:
https://omgevingswet.overheid.nl/knooppunt/apistore/api-docs/Kadaster/Catalogus-Opvragen/v3

Alle werkzaamheden kun je middels deze call vinden:
https://service.omgevingswet.overheid.nl/publiek/catalogus/api/opvragen/v3/conceptschemas?uri=http://toepasbare-regels.omgevingswet.overheid.nl/id/conceptscheme/Werkzaamheden&_expandScope=concepten