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.

{
"@id":"https://stad.gent/id/mensgemaaktobject/dmg/530008250/2022-06-22T00:00:50.901Z",
"@type":"MensgemaaktObject"
}

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.

{
"@id":"https://data.passchendaele.be/begraving/id/530008250",
"@type":"Activiteit",
"heeftType":{
    "@type:"Type",
    "@value":"begraving"
    }
}

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.

{
"@id":"https://data.passchendaele.be/begraving/id/530008250",
"@type":"Activiteit",
"heeftType":[{
    "@type:"Type",
    "@value":"begraving"
    },
    {
    "@type":"Type",
    "@id":"cest:Term_geassocieerde_gebeurtenis"
    }]
}

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

{
"@id":"https://data.cagnet.be/item/530008250",
"@type":"MensgemaaktObject",
"isGeclassificeerdDoor":{
    "@type":"Classificatie",
    "heeftType":{
        "@type":"Type",
        "@id":"cest:Term_objectnaam"},
    "wijstToe":{
        "@type":"Type",
        "voorkeursterm":{
            "@value":"filmkopie",
            "@language":"nl"}
        }
    }
}

2. Namen

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

{
"@type":"ZelfstandigeExpressie",
"@id":"https://data.cagnet.be/item/F95043",
"@value":"Frischer Wind In Streudorf"
}

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.

{
"@type":"ZelfstandigeExpressie",
"@id":"https://data.cagnet.be/item/F95043",
"@value":"Frischer Wind In Streudorf",
"heeftNaam":[{
    	"@type":"Naam",
    	"@value":"Frischer Wind In Streudorf",
 	},
 	{
	"@type":"Naam",
    	"@value":"Een Frisse Wind In Strodorp"
 	}]
 }

Gebruik @language om de taal van namen te documenteren.

{
"@type":"ZelfstandigeExpressie",
"@id":"https://data.cagnet.be/item/F95043",
"@value":"Frischer Wind In Streudorf",
"heeftNaam":[{
    	"@type":"Naam",
    	"@value":"Frischer Wind In Streudorf",
  	"@language":"de"
 	},
 	{
	"@type":"Naam",
    	"@value":"Een Frisse Wind In Strodorp",
  	"@language":"nl", 
 	}]
 }

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

{
"@type":"ZelfstandigeExpressie",
"@id":"https://data.cagnet.be/item/F95043",
"heeftNaam":[{
    	"@type":"Naam",
    	"@value":"Frischer Wind In Streudorf",
  	"@language":"de",
	"heeftType":{
  		"@type":"Type",
  		"heeftVoorkeursterm":{
			"@type":"TaalString",
	    		"@value":"originele titel",
    			"@language":"nl"
    			}
  		} 
 	}
 }

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

{
"@type":"ZelfstandigeExpressie",
"@id":"https://data.cagnet.be/item/F95043",
"heeftNaam":{
    	"@type":"Naam",
    	"@value":"Frischer Wind In Streudorf",
  	"@language":"de",
	"heeftType":{
  		"@type":"Type",
  		"heeftVoorkeursterm":{
			"@type":"TaalString",
	    		"@value":"originele titel",
    			"@language":"nl"
    			}
  		},
        "isToegekendDoor":{
            "@type":"Toekenning",
	    "@value":"registrator x",
    			}
 	}
 }

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.
```
{ "@id":"https://stad.gent/id/mensgemaaktobject/dmg/530008250/2022-06-22T00:00:50.901Z"}
```
Het gebruik van @id is aanbevolen voor de Entiteiten die een eigenschap van de hoofdEntiteit karakteriseren.

{
"@id":"https://stad.gent/id/mensgemaaktobject/dmg/530008250/2022-06-22T00:00:50.901Z",
"@type":"MensgemaaktObject"
"heeftType":{
    "@type:"Type",
    "@id":"http://stad.gent/id/concept/300033618",
    "heeftVoorkeursterm":{
        "@value":"schilderij"
        }
    }
}

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.

{
"@id":"https://stad.gent/id/mensgemaaktobject/dmg/530008250/2022-06-22T00:00:50.901Z",
"@type":"MensgemaaktObject"
"heeftType":{
    "@type:"Type",
    "@id":"http://stad.gent/id/concept/300033618",
    "heeftVoorkeursterm":{
        "@value":"schilderij"
        },
    "heeftType":{
        "@type":"Type",
        "@id":"cest:Term_objectnaam"
        }
    }
}

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

{
"@id":"https://stad.gent/id/mensgemaaktobject/dmg/530008250/2022-06-22T00:00:50.901Z",
"@type":"MensgemaaktObject"
"wordtGeïdentificeerdDoor":{
    "@type:"Identificator",
    "@value":"530008250",
    "heeftType":{
        "@type":"Type",
        "@id":"cest:Waarde_objectnummer"
        },
    }
}

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

"@id":"https://stad.gent/id/mensgemaaktobject/dmg/530008250/2022-06-22T00:00:50.901Z",
"@type":"MensgemaaktObject"
"heeftType":{
    "@type:"Type",
    "@id":"http://vocab.getty.edu/aat/300033618",
    "heeftVoorkeursterm":{
        "@value":"schilderij",
        "@language":"nl"
        },
    "isHetzelfdeAls":{
        "@type:"Type",
        "@id":"http://vocab.getty.edu/aat/300033618",
        "heeftVoorkeursterm":{
            "@value":"painting (visual work) ",
            "@language":"en"
            },
    }
}

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)

"{
  "@type": "Persoon",
  "werd geboren": {
    "@type": "Geboorte",
      "had tijdsspanne": {
        "heeft naam": {
        "@type": "String",
        "@value": "geboortedatum",
        "@language": "nl"
      },
      "heeft begindatum": {
        "@type": "String",
        "@value": "9-11-1890"
      },
      "heeft einddatum": {
        "@type": "String",
        "@value": "9-11-1890"
      }
    }
  }
}"

Geboorteplaats (uitwerken)

"{
  "@type": "Persoon",
  "was aanwezig bij": {
    "@type": "Geboorte",
    "vond plaats op": {
      "@type": "Plaats",
      "heeft type": {
        "@type": "Concept",
        "heeft naam": {
          "@type": "String",
          "@value": "Bayswater, Middlesex, Engeland, Verenigd Koninkrijk",
          "@language": "en"
        }
      }
    }
  }
}"

Overlijdensdatum (uitwerken)

"{
  "@type": "Persoon",
  "stierf in": {
    "@type": "Overlijden",
      "had tijdsspanne": {
        "heeft naam": {
        "@type": "String",
        "@value": "sterfdatum",
        "@language": "nl"
      },
      "heeft begindatum": {
        "@type": "String",
        "@value": "6/11/1917"
      },
      "heeft einddatum": {
        "@type": "String",
        "@value": "6/11/1917"
      }
    }
  }
}"

Overlijdensplaats (uitwerken)

"{
  "@type": "Persoon",
  "stierf in": {
    "@type": "Overlijden",
    "vond plaats op": {
      "@type": "Plaats",
      "valt onder": {
        "@type": "Plaats",
        "heeft type": {
          "@type": "Concept",
          "heeft naam": {
            "@type": "String",
            "@value": "gemeente",
            "@language": "nl"
          }
        },
        "heeft naam": {
          "@type": "String",
          "@value": "Passendale, België",
          "@language": "nl"
        }
      }
    }
  }
}"

Familiebanden
Posities (ric:Position) (uitwerken)

"{
  "@type": "Persoon",
  "bezet": {
    "@type": "Positie",
    "heeft type":
      {
        "@type": "String",
        "@value": "Rang",
        "@language": "nl"
      }
  }
}"

Bezigheden (ric:Occupation) (uitwerken)

{
  "@type": "Persoon",
  "heeftBeroep": {
    "@type": "Beroep",
    "heeft naam": {
      "@type": "String",
      "@value": "Bakker",
      "@language": "nl"
    }
  }
}

7. Historische Plaatsen

Historische Toponiemen
Coordinaten

Coordinaten sterfteplaats (uitwerken)

"{
  "@type": "Persoon",
  "stierf in": {
    "@type": "Overlijden",
    "vond plaats op": {
      "@type": "Plaats",
      "valt onder": {
        "@type": "Plaats",
        "heeft type": {
          "@type": "Concept",
          "heeft naam": {
            "@type": "String",
            "@value": "gemeente",
            "@language": "nl"
          }
        },        
        "op een plaats binnen": {
        "@type": ""Space Primitive",
        "@value": ""5.089.979,302.133"
      }
      }
    }
  }
}"

Archeologische Contexten

Previous20221024-werkgroep3-notes NextTooling

Last updated 8 months ago