RDF/Turtle is missing for SerializationFormat in /serialization endpoint

[mhrimaz]

What happens?

Currently, RDF/Turtle format is not defined in the SerializationFormat enumeration list.

...

Why is this wrong?

Current /serialization does not support rdf/turtle even though the rdf serialization is part of the specification:

aas-specs-api/ConceptDescriptionServiceSpecification/V3.0_SSP-001.yaml

Lines 268 to 282 in a6956e5

	responses:
	'200':
	description: Requested serialization based on SerializationFormat
	content:
	application/asset-administration-shell-package+xml:
	schema:
	description: AASX package
	type: string
	format: binary
	application/json:
	schema:
	$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/Environment'
	application/xml:
	schema:
	$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/Environment'

Why in the Chapter 12 only JSON is the only value for serialization format? It should be possible to get any official serialization format and not only JSON. This enables a better integration. For example, Package Explorer works with XML format, so instead of copy-paste json and convert on the background to xml, it can be easily possible to directly import a submodel from a url, then package explorer can try to first get the xml. If the server support different serialization, then the response should be an official serialization, otherwise, the server should return an error. We can also define a specific error for this ("serliaziation format not supported").

How should it be fixed?

text/turtle MIME type should be added as the possible options.
Instead of unnecessary restriction that only application/json is allowed in official schema, all possible options should be there.

...

• I have signed the required Developer Certificate of Origin (DCO) already.

[mhrimaz]

Furthermore /serialization endpoint only makes sense for full profile and not for separate repositories. The fact that the schema output is an Environment emphasize it.

First if we have only a submodel repository, what should we do with other parameters? what does it even mean to include concept descriptions in the serialization?
Why concept description repository also don't accept ids?

https://industrialdigitaltwin.org/en/wp-content/uploads/sites/2/2023/04/IDTA-01002-3-0_SpecificationAssetAdministrationShell_Part2_API.pdf#page=152