Edit

Richtlijnen

Algemene implementatie richtlijnen voor OSLO voor Erfgoed

Principes Naamgeving

1. Entiteiten worden zowel in de Specificatie als de Context in Upper Camel Case geschreven. bvb. "MensgemaaktObject", niet: "Mensgemaakt Object", "Mensgemaakt object"

2. Eigenschappen worden zowel in de Specificatie als in de Context in Lower Camel Case geschreven: bvb "heeftTitel", niet "heeft titel", "heeft-titel"

3. Namen in de Specificatie zijn identiek aan namen in de Context. bvb. "heeftTitel" in de specificatie, wordt in de @context gedefinieerd als: 

"heeftTitel": {
      "@id": "http://www.cidoc-crm.org/cidoc-crm/P102_has_title",
      "@type": "http://www.w3.org/1999/02/22-rdf-syntax-ns#langString",
      "@container": "@set"
      }

niet:

"MensgemaaktObject.Titel": {
      "@id": "http://www.cidoc-crm.org/cidoc-crm/P102_has_title",
      "@type": "http://www.w3.org/1999/02/22-rdf-syntax-ns#langString",
      "@container": "@set"
      }

4. Namen van eigenschappen vormen een actieve of passieve zinsconstructie. bvb "heeftTitel", "isTitelVan", niet "titel"

5. Namen van eigenschappen zijn een zo nauwkeurig mogelijke vertaling van de broneigenschap uit CIDOC-CRM, LRM of RIC. bvb CIDOC CRM: "P1 is identified by (identifies)" wordt OSLO: :wordtGeïdentificeerdDoor (Let op: @context mapt op in dit geval naar ""http://www.w3.org/ns/adms#identifier".

Basispatronen

1. Types

  • Gebruik @type om de Entiteit te identificeren waarop het JSON-object betrekking heeft.

  • Gebruik "heeftType" / CIDOC-CRM P2: has type / is type als OSLO geen nauwkeurig matchende Entiteit beschikbaar heeft en je de Entiteit zelf nader wil karakteriseren.

  • Gebruik "heeftType" / CIDOC-CRM P2: has type / is type ook om een Entiteit te mappen met een 'veld' uit het Invulboek dat beschrijvingsregels bevat voor de inhoud van het JSON-object.​

  • Gebruik "isGeclassificeerdDoor" en een "Classificatie" om de "objectnaam" (i.e. het type erfgoedobject) of anderen trefwoorden voor de Entiteit te documenteren.

2. Namen

  • Gebruik @value om Entiteiten van een mensleesbaar label te voorzien.

  • Wanneer je een Entiteit van meerdere namen wil voorzien, of informatie over de toekenning van de naam wil documenteren, gebruik de eigenschap "heeftNaam" en "Naam" (cf. CRM E35 Title) om vervolgens eigenschappen van de naam te documenteren.

  • Gebruik @language om de taal van namen te documenteren.

  • Gebruik de eigenschap "heeftType" om het soort naam te karakteriseren.

  • Gebruik de eigenschap "isToegekendDoor" en "Toekenning" om uit te drukken wie en wanneer een naam werd toegekend.

3. Identificatienummers

  • Gebruik @id om de persistente URI te documenteren voor de Entiteit waarop het JSON-object betrekking heeft.

  • Het gebruik van @id is verplicht voor de (hoofd-)Entiteit waarop de root van het JSON-document betrekking heeft.

  • Het gebruik van @id is aanbevolen voor de Entiteiten die een eigenschap van de hoofdEntiteit karakteriseren.

  • Het gebruik van @id is verplicht wanneer je een Entiteiten wil mappen naar een Veld in het Invulboek Objecten waar zich de beschrijvingsregels bevinden voor de inhoud van het JSON-object.

  • Gebruik de eigenschap "wordtGeïdentificeerdDoor" en "Identificator" om lokale objectnummers en andere interne identificatienummers te documenteren.

  • Gebruik de eigenschap "isHetzelfdeAls" om je Entiteit te mappen met een equivalente Entiteit in een anderen bron

4. Toekenningen

  • Classificaties

  • Metingen

  • Conditiebeoordelingen

  • (andere activiteiten)

5. Werken, Expressies en Dingen

  • Typische eigenschappen voor Werken

  • Typische eigenschappen voor Expressies

  • Typische eigenschappen voor Dingen

6. Historische Actoren

  • Geboorte en dood

Geboortedatum (uitwerken)

Geboorteplaats (uitwerken)

Overlijdensdatum (uitwerken)

Overlijdensplaats (uitwerken)

  • Familiebanden

  • Posities (ric:Position) (uitwerken)

  • Bezigheden (ric:Occupation) (uitwerken)

7. Historische Plaatsen

  • Historische Toponiemen

  • Coordinaten

Coordinaten sterfteplaats (uitwerken)

  • Archeologische Contexten

Previous20221024-werkgroep3-notesNextTooling

Last updated

Was this helpful?