Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -33,13 +33,21 @@
33	33	To simplify the human-readability for all openMINDS users, technical properties specifically required for the JSON-LD syntax are, on purpose, not defined in the openMINDS schema templates. Instead, these technical properties are first added to the required property list of all openMINDS schemas after their template is transformed into an established, full-blown metadata schema format, such as JSON-Schema (cf. [[Technical details>>Technical details||target="_blank"]]). Let us explain why these technical JSON-LD properties are needed and how they are correctly provided for an openMINDS instance.
34	34
35	35	(% style="text-align: justify;" %)
36		-The JSON-LD property **##"@type"##** expects an entry (value) of type string that defines which schema is used to validate the particular JSON-LD. Within openMINDS each schema can be identified through its namespace (type) with the following naming convention:
37		-**##"@type": "https:~/~/openminds.ebrains.eu/XXX/YYY"##**,
	36	+The JSON-LD property **##"@type"##** expects an entry (value) of type string with the format of an IRI. Generally speaking, the **##"@type"##** defines which schema shouldbe used to validate the particular JSON-LD. Within openMINDS, each schema can be identified through its namespace (type) with the following naming convention:
	37	+
	38	+(% style="text-align: center;" %)
	39	+**##"@type": "https:~/~/openminds.ebrains.eu/XXX/YYY"##**
	40	+
	41	+(% style="text-align: justify;" %)
38	38	where **##XXX##** and **##YYY##** should be replaced with the openMINDS sub-module (e.g., **##core##**) and corresponding schema (e.g., **##ContactInformation##**), respectively.
39	39
40	40	(% style="text-align: justify;" %)
41		-The JSON-LD property **##"@id"##** expects an entry (value) of type string that provides a unique identifier for the created metadata instance. On your local machine, you should use the following naming convention for this identifier:
42		-**##"@id": "http:~/~/localhost/YYY/ZZZ"##**,
	45	+The JSON-LD property **##"@id"##** expects an entry (value) of type string that provides a unique identifier for the created metadata instance. On your local machine, you should use the following naming convention for this identifier:
	46	+
	47	+(% style="text-align: center;" %)
	48	+**##"@id": "http:~/~/localhost/YYY/ZZZ"##**
	49	+
	50	+(% style="text-align: justify;" %)
43	43	where **##YYY##** and **##ZZZ##** should be replaced with the openMINDS schema (e.g., **##ContactInformation##**) and your own collection-unique identifier (e.g. **##email_openMINDS##**), respectively. Within the EBRAINS Knowledge Graph (KG) this identifier has to be a universally unique identifier (UUID). Assuming you locally generated a openMINDS metadata collection, your user-defined **##"@id"##** will be automatically replaced with a UUID in all your JSON-LDs if they are uploaded to the KG.
44	44
45	45	(% style="text-align: justify;" %)