How can I see the complete SHACL for an FDP resource?

[dennisvang]

The FDP defines metadata schemas as building blocks for resources, and adds some dynamic properties as well.
As a result, it is not so easy to get an overview of the complete metadata schema for a resource.

Is there some way to see the complete metadata schema for an FDP resource?

[dennisvang]

One way is via the conformsTo property:

This points to a profile:

which has a hasArtifact predicate pointing to the uri of the complete schema.

To view this schema in a browser, we need to copy that uri and append ?format=ttl, for example, from the above:

https://app.fairdatapoint.org/metadata-schemas/a92958ab-a414-47e6-8e17-68ba96ba3a2b?format=ttl

how that works

We can see from the ProfileService that this uri points to the metadataschema as stored in the repository:

FAIRDataPoint/src/main/java/org/fairdatapoint/service/profile/ProfileService.java

Lines 91 to 92 in 8ad9994

	modelBuilder.add(i(format("%shasArtifact", PROFILE_PREFIX)), i(format("%s/metadata-schemas/%s",
	persistentUrl, schema.getUuid())));

where schemas come from the resource definition:

FAIRDataPoint/src/main/java/org/fairdatapoint/service/profile/ProfileService.java

Lines 70 to 77 in 8ad9994

	resourceDefinition
	.getMetadataSchemaUsages()
	.forEach(usage -> {
	metadataSchemaRepository
	.getLatestBySchemaUuid(usage.getUsedMetadataSchema().getUuid()).ifPresent(schema -> {
	addSchemaToProfile(uri, profile, schema);
	});
	});

Note that the metadata schema repository contains the metadata schemas of the individual components making up the resource.

However, if we request an RDF format from the metadata-schemas API endpoint, these are merged into one:

FAIRDataPoint/src/main/java/org/fairdatapoint/api/controller/schema/MetadataSchemaController.java

Lines 95 to 107 in 8ad9994

	@GetMapping(path = "/{uuid}", produces = {
	"text/turtle",
	"application/x-turtle",
	"text/n3",
	"text/rdf+n3",
	"application/ld+json",
	"application/rdf+xml",
	"application/xml",
	"text/xml"
	})
	public ResponseEntity<Model> getSchemaContent(@PathVariable final UUID uuid)
	throws ResourceNotFoundException {
	final Optional<Model> oDto = metadataSchemaService.getSchemaContentByUuid(uuid);

The actual merge takes place in the call to getSchemaContentByUuid():

FAIRDataPoint/src/main/java/org/fairdatapoint/service/schema/MetadataSchemaService.java

Lines 384 to 393 in 8ad9994

	public Optional<Model> getSchemaContentByUuid(UUID uuid) {
	// TODO: cache (?)
	final Optional<MetadataSchemaVersion> oSchema = versionRepository.getLatestBySchemaUuid(uuid);
	if (oSchema.isEmpty()) {
	return empty();
	}
	final MetadataSchemaVersion schema = oSchema.get();
	final List<MetadataSchemaVersion> schemas = resolveExtends(schema);
	return of(mergeSchemaDefinitions(schemas));
	}

[dennisvang]

A better solution is to use the */spec endpoints:

• /spec
• /catalog/{uuid}/spec
• /dataset/{uuid}/spec
• ...