Skip to content
RaspConfiguration-update-UBL-2.1.adoc 2.48 KiB
Newer Older
include::_common-settings.adoc[]

== RaspConfiguration.xml (OIOUBL 2.1)
From 15.05.2022 OIOUBL 2.1 will be an option in Danish Nemhandel, allowing new XML classes..... *SKRIV MERE HER*) - see public notification: https://www.digitaliser.dk/news/6512425

It is then possible to base an OIOUBL document 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 a `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.

.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