Fix formatting, update Endpoint-Description XSD schema to include missing FCS layer attributes

Querela · Querela · commit fbf1bd6e0796 · 2025-11-17T14:25:43.000+01:00
diff --git a/fcs-core-2.0/attachments/Endpoint-Description.xsd b/fcs-core-2.0/attachments/Endpoint-Description.xsd
@@ -182,6 +182,41 @@
                                                     </xs:documentation>
                                                 </xs:annotation>
                                             </xs:attribute>
+                                            <xs:attribute name="qualifier" use="optional">
+                                                <xs:annotation>
+                                                    <xs:documentation>
+                                                        <h:p>
+                                                            An optional attribute that is used as a qualifier in a FCS-QL
+                                                            search term in to address this specific layer.
+                                                        </h:p>
+                                                    </xs:documentation>
+                                                </xs:annotation>
+                                                <xs:simpleType>
+                                                    <xs:restriction base="xs:string">
+                                                        <xs:pattern value="[a-zA-Z0-9-]+" />
+                                                    </xs:restriction>
+                                                </xs:simpleType>
+                                            </xs:attribute>
+                                            <xs:attribute name="alt-value-info" type="xs:string" use="optional">
+                                                <xs:annotation>
+                                                    <xs:documentation>
+                                                        <h:p>
+                                                            An optional short description about the layer, e.g. the original tag set used.
+                                                        </h:p>
+                                                    </xs:documentation>
+                                                </xs:annotation>
+                                            </xs:attribute>
+                                            <xs:attribute name="alt-value-info-uri" type="xs:anyURI" use="optional">
+                                                <xs:annotation>
+                                                    <xs:documentation>
+                                                        <h:p>
+                                                            An optional well-formed URI that should point to a web site with further information,
+                                                            e.g. about the original tag set and how the translation to FCS is done.
+                                                            Clients can display this information together with the search result.
+                                                        </h:p>
+                                                    </xs:documentation>
+                                                </xs:annotation>
+                                            </xs:attribute>
                                             <xs:attribute name="type" use="optional" default="value">
                                                 <xs:annotation>
                                                     <xs:documentation>
diff --git a/fcs-core-2.0/interface-specification.adoc b/fcs-core-2.0/interface-specification.adoc
@@ -62,7 +62,7 @@ The value of the `@id` attribute `MUST NOT` contain the characters `,` (comma) o
 
 * one `<ed:SupportedLayers>` element (`REQUIRED` if Endpoint supports _Advanced Search_ capability)
 +
-A list of Layers that are generally supported by this Endpoint. This list is composed of one or more `<ed:SupportedLayer>` elements. The content of a `<ed:SupportedLayer>` `MUST` be the identifier of a Layer (see section <<Layers>>), e.g. orth. Each `<ed:SupportedLayer>` element `MUST` carry an `@id` and a @result-id attribute. The value of the `@id` attribute is later used in the <ed:Resource> element to indicate, which Layer is supported by a resource (see below). The `@result-id` attribute is used in the Advanced Data View (see section <<Advanced (ADV), Advanced Data View>>). Each `<ed:SupportedLayer>` element `MAY` carry an optional `@qualifier` attribute. It is used as a qualifier in a FCS-QL search term in to address this specific layer.
+A list of Layers that are generally supported by this Endpoint. This list is composed of one or more `<ed:SupportedLayer>` elements. The content of a `<ed:SupportedLayer>` `MUST` be the identifier of a Layer (see section <<Layers>>), e.g. orth. Each `<ed:SupportedLayer>` element `MUST` carry an `@id` and a `@result-id` attribute. The value of the `@id` attribute is later used in the `<ed:Resource>` element to indicate, which Layer is supported by a resource (see below). The `@result-id` attribute is used in the Advanced Data View (see section <<Advanced (ADV), Advanced Data View>>). Each `<ed:SupportedLayer>` element `MAY` carry an optional `@qualifier` attribute. It is used as a qualifier in a FCS-QL search term in to address this specific layer.
 +
 This list `MUST NOT` include duplicate entries, i.e. no Layer with the same `@result-id` MIME type must appear more than once.
 +

Original file line number	Diff line number	Diff line change
@@ -62,7 +62,7 @@ The value of the `@id` attribute `MUST NOT` contain the characters `,` (comma) o
`62`	`62`
`63`	`63`	* one `<ed:SupportedLayers>` element (`REQUIRED` if Endpoint supports _Advanced Search_ capability)
`64`	`64`	`+`
`65`		-A list of Layers that are generally supported by this Endpoint. This list is composed of one or more `<ed:SupportedLayer>` elements. The content of a `<ed:SupportedLayer>` `MUST` be the identifier of a Layer (see section <<Layers>>), e.g. orth. Each `<ed:SupportedLayer>` element `MUST` carry an `@id` and a @result-id attribute. The value of the `@id` attribute is later used in the <ed:Resource> element to indicate, which Layer is supported by a resource (see below). The `@result-id` attribute is used in the Advanced Data View (see section <<Advanced (ADV), Advanced Data View>>). Each `<ed:SupportedLayer>` element `MAY` carry an optional `@qualifier` attribute. It is used as a qualifier in a FCS-QL search term in to address this specific layer.
	`65`	+A list of Layers that are generally supported by this Endpoint. This list is composed of one or more `<ed:SupportedLayer>` elements. The content of a `<ed:SupportedLayer>` `MUST` be the identifier of a Layer (see section <<Layers>>), e.g. orth. Each `<ed:SupportedLayer>` element `MUST` carry an `@id` and a `@result-id` attribute. The value of the `@id` attribute is later used in the `<ed:Resource>` element to indicate, which Layer is supported by a resource (see below). The `@result-id` attribute is used in the Advanced Data View (see section <<Advanced (ADV), Advanced Data View>>). Each `<ed:SupportedLayer>` element `MAY` carry an optional `@qualifier` attribute. It is used as a qualifier in a FCS-QL search term in to address this specific layer.
`66`	`66`	`+`
`67`	`67`	This list `MUST NOT` include duplicate entries, i.e. no Layer with the same `@result-id` MIME type must appear more than once.
`68`	`68`	`+`