include::_common-settings.adoc[]

== RaspConfiguration.xml (OIOUBL 2.1)
From 15.05.2022 OIOUBL 2.1 will be an option in Nemhandel, allowing new XML classes based on the UBL 2.1 standard 
- please see public notification: https://www.digitaliser.dk/news/6512425

It is then possible to create an OIOUBL document based on the UBL 2.1 standard. This requires an update to the RaspConfiguration.xml file.

The update is required for all receivers (because you don't know what the sending party might send you), and it is required for sendes when they update their document generation to UBL 2.1 syntax.


=== Changes

==== Path to schema XSD
UBL schema 2.1 is backwards compatible with UBL 2.0, so it is highly recommended that XSD references are updated to the UBL 2.1 files.

For each <DocumentTypeConfig> having a <SchemaPath> with the `UBL_v2.0` value, it could be updated to a path holding the UBL 2.1 files - also changing the file name version to 2.1. One exception to this, is the XSD for UtilityStatement that still requires the special OIOUBL 2.1 schema (which is why the search below does not match this).


.Search and replace
|===
|Search for | Replace with

|Schemas/UBL_v2.0/
|Schemas/UBL_v2.1/

|-2.0.xsd</SchemaPath>
|-2.1.xsd</SchemaPath>
|===



==== XPath version matcher
Each <DocumentTypeConfig> for OIOUBL documents should be able to match OIOUBL version 2.01, 2.02 and 2.1.

For each <DocumentTypeConfig> having a <XPathExpectedResult> starting with a `OIOUBL` value, it could be updated to a xpath matching all 3 options.

.Search and replace
|===
|Search for | Replace with

|<XPathExpectedResult>OIOUBL-2.0(1\|2)</XPathExpectedResult>
|<XPathExpectedResult>OIOUBL-2.(01\|02\|1)</XPathExpectedResult>
|===



==== Example

.DocumentTypeConfig (updated example)
[source, xml]
<DocumentTypeConfig>
    <Id>40c9fbee-ad39-48ed-9e04-c28cbbf8a38c</Id>
    <FriendlyName>Applikationsmeddelse</FriendlyName>
    <RootNamespace>urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2</RootNamespace>
    <RootName>ApplicationResponse</RootName>
    <IdentifierDiscriminators>
        <XPathDiscriminatorConfig>
            <XPathExpression>/root:ApplicationResponse/cbc:CustomizationID</XPathExpression>
            <XPathExpectedResult>OIOUBL-2.(01|02|1)</XPathExpectedResult>
        </XPathDiscriminatorConfig>
    </IdentifierDiscriminators>
    <ServiceContractTModel>uddi:42F92342-C3ED-46ff-8A8A-6518F55D5CD5</ServiceContractTModel>
    <SchemaPath>Resources/Schemas/UBL_v2.1/maindoc/UBL-ApplicationResponse-2.1.xsd</SchemaPath>


=== Resources
The XSD files for UBL 2.1 can be downloaded from https://rep.erst.dk/git/openebusiness/common/-/tree/master/resources/Schemas/UBL_v2.1/maindoc
