Re: [dss-x] Sample files regarding 'structure models'

[Andreas Kuehne <kuehne@trustable.de>]

Hi Pim,

thanks for the hint! I'm always afraid to re-invent some kind of wheel
... especially when the problem isn't that specific! I'll check the UBL
approach.

Greetings,

Andreas
>
> Hi Andreas,
>
> I've not been tracking this work as actively as I wanted,  so
> apologies this has already been discussed.   Regarding managing XSD
> and JSON schema representations,   I'm wondering if you thought of an
> approach to generate them both from a single source format.   The UBL
> TC has been doing this
> (http://docs.oasis-open.org/ubl/UBL-2.1-JSON/v1.0/cnd02/UBL-2.1-JSON-v1.0-cnd02.html#json-schema),
> using UN/CEFACT BIEs (Business Information Entities) as source for
> both XSD and JSON schema, and so have other groups.
>
> Kind Regards,
>
> Pim
>
>
>
> On 25-07-17 08:23, Andreas Kuehne wrote:
>> Hi all,
>>
>> in the attached core document draft you can see the JSON schema and
>> element mapping sections filled properly. Comments regarding section 3
>> are wellcome!
>>
>> My next step is the introduction of some comment areas for the elements
>> that will be preserved between generator runs. This will avoid the need
>> to manage comments in the schema file. Another topic is  JSON schema
>> itself. It needs some improvement but there is a mismatch in the XML and
>> JSON schema approaches so it's tricky to derive one from the other.
>>
>> Greetings,
>>
>> Andreas
>>> Hi Detlef,
>>>> the idea and approach is great. How much work is necessary to
>>>> finish the approach for JSON?
>>> my current approach to generate the JSON scheme is based on JAXB. This
>>> introduces some restrictions but ensures a usable server and client
>>> implementation for both XML and JSON. The downside is the lack of
>>> alignment between the XML schema elements and the JSON schema
>>> artefacts.
>>> And the JAXB output doesn't align with usual JSON schema guidelines. A
>>> very nasty aspect is the attribute name mapping buried in an XML
>>> file in
>>> such a tricky way that see no chance to reuse it.
>>> Other approaches for XML -> JSON have their specific problems, e.g. the
>>> jsonix (http://www.jsonix.org/) project fails to build :-(
>>> Building a XML->JSON mapping stylesheet isn't trivial but could be the
>>> last resort.
>>> I'll have to dig into the detail and like to come up with a solution
>>> next week.
>>>> What else is necessary in order to make this usable together with
>>>> DocBook?
>>> Havn't worked with DocBook yet. But as a XML-based format it should be
>>> possible to support.
>>>
>>> Greetings,
>>>
>>> Andreas
>>>>  
>>>> BR,
>>>>
>>>> Detlef
>>>>
>>>>  
>>>>  
>>>> Von: dss-x@lists.oasis-open.org [mailto:dss-x@lists.oasis-open.org]
>>>> Im Auftrag von Andreas Kuehne
>>>> Gesendet: Freitag, 21. Juli 2017 12:41
>>>> An: dss-x <dss-x@lists.oasis-open.org>
>>>> Betreff: [dss-x] Sample files regarding 'structure models'
>>>>
>>>>  
>>>> Hi all,
>>>>
>>>>  
>>>> as agreed in the last call see attached files related to the
>>>> automated generation of the core's specification 'structure models'
>>>> section. Theattac hed zip contains the following files:
>>>>
>>>>  
>>>> *    Consistent schema and specification approach.odp : An overview
>>>> about the generation process.
>>>> *    oasis-dss-core-schema-v1.0-os.xsd :  The current version of
>>>> the dss core schema.
>>>> *    insertContent.xsl :  The stylesheet creating the 'structure
>>>> models' section.
>>>> *    dss-core-v2.0-1500632109391.docx : The created core
>>>> specification.
>>>>
>>>> The 'Semantics' and the 'XML syntax' sections are generated from
>>>> the given schema. In section 3.6 Base64DataType you can see
>>>> comments inserted that are defined within the schema using the
>>>> annotation/documentation tags.
>>>>
>>>> The JSON schema section needs some work as some of the relevant
>>>> information are not included in the schema (currently). Take it as
>>>> a placeholder for now.
>>>>
>>>>  
>>>> Greetings,
>>>>
>>>>  
>>>> Andreas
>>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe from this mail list, you must leave the OASIS TC that
>> generates this mail.  Follow this link to all your TCs in OASIS at:
>> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>
>

-- 
Andreas Kühne 
phone: +49 177 293 24 97 
mailto: kuehne@trustable.de

Trustable Ltd. Niederlassung Deutschland Gartenheimstr. 39C - 30659 Hannover Amtsgericht Hannover HRB 212612

Director Andreas Kühne

Company UK Company No: 5218868 Registered in England and Wales