Imvertor / Imvertor-Maven

Mavenized version of Imvertor
http://www.imvertor.org
9 stars 12 forks source link

Begrippen links in respec documentatie #151

Open ThiesMesdag opened 3 years ago

ThiesMesdag commented 3 years ago

MIM metadata element Begrip zit niet in de respec documentatie. In het zorgeloos vastgoed model (ZVG) zijn de objecttype en andere elementen expliciet gebaseerd op een linked data begrip. De begrippen link is daarmee de documentatie van het objecttype/attribuutsoort/gegevensgroep.

Ik wil Begrip dus graag toegevoegd hebben aan de respec documentatie, voor of na de definitie.

Bijvoorbeeld:

Begrip https://mak.zorgeloosvastgoed.nl/doc/begrip/Voorwaarde
ArjanLoeffen commented 3 years ago

De begriuppen zijn opgenomen in de Kadaster Respec documentatie. Voorbeeld (relatiesoort):

image

kad-mesdat commented 3 years ago

Begrippen die met een url zijn aangeduid zouden als link moeten worden opgenomen, zodat ze klikbaar zijn vanuit de respec documentatie. Nu staat er gewoon "https://mak.zorgeloosvastgoed.nl/doc/concept/Voorwaarde" als tekst het is jammer dat dat niet klikbaar is.

image

ArjanLoeffen commented 3 years ago

We hebben nu de URL actief gemaakt.

Let op, we zien dat de weergave van de oorsprong van de begrippen (en andere waarden) in de catalogus nog worden voorzien van een (grijze) bron. Dat ziet er slecht uit, vind ik: in testomgeving:

image

Kunnen we daar niet een goed alternatief voor bedenken?

kad-mesdat commented 3 years ago

Ik vindt dat ook niet zo mooi. Op dit moment heb ik de volgende tekst in opgenomen

"Het informatiemodel IMKAD is gebaseerd op ons interne informatiemodel CDMKAD. Dit betekent dat de meeste documentatie uit het CDMKAD model is overgenomen. Daar waar dit het geval is wordt de prefix "cdmkad/CDMKAD/20190901" getoond. "

Maar ik heb het ook wel eens vervangen door een * of een - ofzo. Dan kan in de tekst worden opgenomen dat

".... Daar waar dit het geval is wordt de documentatie vooraf gegaan door een * "

Op zich is dit met zoek en vervang makkelijk te doen. Een alternatief zou een aangepaste opmaak zijn. Dan zou het handig zijn om een class in de html mee te genereren. Dan kunnen we bijvoorbeeld de achtergrond subtiel een andere kleur geven.

ArjanLoeffen commented 3 years ago

We zouden het volgende kunnen doen:

Nu is het:

<tr>
    <th>Herkomst definitie</th>
    <td> IMKAD BASISMODEL: HERKOMST DEFINITIE <span class="supplier">cdmkad/Bakstenen basismodel/20180101</span>CDMKAD BASISMODEL: HERKOMST DEFINITIE </td>
</tr>

Het word dan:

<tr>
    <th>Herkomst definitie</th>
    <td> IMKAD BASISMODEL: HERKOMST DEFINITIE <span class="supplied"><span class="supplier">cdmkad/Bakstenen basismodel/20180101</span>CDMKAD BASISMODEL: HERKOMST DEFINITIE</span></td>
</tr>

Aan de klasse supplied kun je een grijze stijl koppelen; aan de klasse supplier kun je display=none of * of whatever koppelen. We moeten ook een soortgelijke voorziening hebben voor meer uitgebreide alinea-strukturen die worden overgenomen uit de supplied. Wat mij betreft wordt dat dan een

<div supplied=>

Graag je mening.

kad-mesdat commented 3 years ago

Ik ben een beetje in de war. Ik zie in de IMKAD code

<th>Herkomst</th>
--
  | <td>
  | <span class="supplier">cdmkad/CDMKAD/20190901</span>BRK
  |  
  | </td>
  | </tr>

In jouw voorbeeld is er een extra laag. Is "IMKAD BASISMODEL: HERKOMST DEFINITIE " is dat de definitie van het eigen model? Dus Model definitie gevolgd door Supplier definitie?

Als schrijvend kom ik er achter dat de usecase is dat je wil kunnen schakelen tussen wat je ziet. Dus:

Dan heb je de mogelijkheid om de definities makkelijk te vergelijken, en kun je kiezen welke je wilt zien. Eventueel met een supplier referentie voor de supplier definitie. Dan zou je drie span's nodig hebben. Bijvoorbeeld:

<tr>
    <th>Herkomst definitie</th>
    <td> <span class="model">IMKAD BASISMODEL: HERKOMST DEFINITIE<span class="model"> <span class="supplied"><span class="supplier">cdmkad/Bakstenen basismodel/20180101</span>CDMKAD BASISMODEL: HERKOMST DEFINITIE</span></td>
</tr>