Create V2 for Search

docs/rst/knora-api-server/api_v1/create-a-mapping.rst

@@ -59,13 +59,16 @@ Basically, a mapping expresses the relations between XML elements and attributes
 The relations expressed in a mapping are one-to-one relations, so the XML can be recreated from the data in RDF. However, since HTML offers a very limited set of elements, Knora mappings support the combination of element names
 and classes. In this way, the same element can be used several times in combination with another classname (please note that ``<a>`` without a class is a mere hyperlink whereas ``<a class="salsah-link">`` is an internal link/standoff link).
 
+With a mapping, a default XSL transformation may be provided to transform the XML to HTML before sending it back to the client. This is useful when the client is a web-browser expecting HTML (instead of XML).
+
 ----------------------------
 Basic Structure of a Mapping
 ----------------------------
 
 The mapping is written in XML itself (for a formal description, see ``webapi/src/resources/mappingXMLToStandoff.xsd``). It has the following structure (the indentation corresponds to the nesting in XML):
 
 - ``<mapping>``: the root element
+    - ``<defaultXSLTransformation> (optional)``: the Iri of the default XSL transformation to be applied to the XML when reading it back from Knora. The XSL transformation is expected to produce HTML. If given, the Iri has to refer to a resource of type ``knora-base:XSLTransformation``.
     - ``<mappingElement>``: an element of the mapping (at least one)
        - ``<tag>``: information about the XML element that is mapped to a standoff class
            - ``<name>``: name of the XML element
@@ -86,6 +89,7 @@ The mapping is written in XML itself (for a formal description, see ``webapi/src
 XML structure of a mapping::
 
     <mapping>
+        <defaultXSLTransformation>Iri of a knora-base:XSLTransformation</defaultXSLTransformation>
         <mappingElement>
             <tag>
                 <name>XML element name</name>

docs/rst/knora-ontologies/knora-base.rst

@@ -1216,7 +1216,7 @@ has permission to see the source and target resources.
 Internal Links in a TextValue
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Internal links in a ``TextValue`` can be using the data type standoff class ``StandoffInternalReferenceTag`` or a subclass of it.
+Internal links in a ``TextValue`` can be represented using the data type standoff class ``StandoffInternalReferenceTag`` or a subclass of it.
 It has the following property:
 
 ``standoffTagHasInternalReference`` (1)

knora-ontologies/knora-admin.ttl

@@ -150,6 +150,43 @@
 
 
 
+:isInMap rdf:type owl:ObjectProperty ;
+
+    rdfs:subPropertyOf :objectCannotBeMarkedAsDeleted ;
+
+    :subjectClassConstraint :MapEntry;
+
+    :objectClassConstraint :Map ;
+
+    rdfs:comment "Associates a MapEntry with a Map"@en .
+
+
+
+:mapEntryKey rdf:type owl:DatatypeProperty ;
+
+    rdfs:subPropertyOf :objectCannotBeMarkedAsDeleted ;
+
+    :subjectClassConstraint :MapEntry;
+
+    :objectDatatypeConstraint xsd:string ;
+
+    rdfs:comment "Represents the key of a MapEntry"@en .
+
+
+
+:mapEntryValue rdf:type owl:DatatypeProperty ;
+
+    rdfs:subPropertyOf :objectCannotBeMarkedAsDeleted ;
+
+    :subjectClassConstraint :MapEntry;
+
+    :objectDatatypeConstraint xsd:string ;
+
+    rdfs:comment "Represents the value of a MapEntry"@en .
+
+
+
+
 #################################################################
 #
 #    Datatype properties
@@ -597,6 +634,41 @@
 
 
 
+:Map rdf:type owl:Class ;
+
+    rdfs:subClassOf [ rdf:type owl:Restriction ;
+                      owl:onProperty :lastModificationDate ;
+                      owl:maxCardinality "1"^^xsd:nonNegativeInteger
+                    ] ;
+
+    rdfs:comment "Represents a simple map of key-value pairs"@en .
+
+
+
+:MapEntry rdf:type owl:Class ;
+
+    rdfs:subClassOf [ rdf:type owl:Restriction ;
+                      owl:onProperty :isInMap ;
+                      owl:cardinality "1"^^xsd:nonNegativeInteger
+                    ],
+                    [ rdf:type owl:Restriction ;
+                      owl:onProperty :mapEntryKey ;
+                      owl:cardinality "1"^^xsd:nonNegativeInteger
+                    ],
+                    [ rdf:type owl:Restriction ;
+                      owl:onProperty :mapEntryValue ;
+                      owl:cardinality "1"^^xsd:nonNegativeInteger
+                    ],
+                    [ rdf:type owl:Restriction ;
+                      owl:onProperty :lastModificationDate ;
+                      owl:cardinality "1"^^xsd:nonNegativeInteger
+                    ];
+
+    rdfs:comment "Represents a key-value pair in a Map"@en .
+
+
+
+
 #################################################################
 #
 #    Individuals