OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

ubl-dev message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [ubl-dev] Free UBL NDR 2.1 schema generator

The tutorial is great Ken, (and thanks for the credit!)
I notice the short sentence towards the end looks a bit too short - it kind of
alludes to custom document creation but perhaps it meant to say a little more
"The custom documents DocumentExt.xml and DocumentExtBad.xml are short
and contain both common and foreign constructs:" followed by a document
schema but no more explanation than that, it seems. I like the tantalizing
hint that more is possible, leaving the reader to think about it some more, but
maybe a bit more of a hint would make more sense.
But yes, I think the tutorial is great.

Best regards

Stephen D Green

On 12 November 2011 19:39, G. Ken Holman <gkholman@cranesoftwrights.com> wrote:
At 2011-10-25 14:02 +0100, Stephen D Green wrote:
That all sounds wonderful, Ken.

I can't think of any more that would be needed (maybe others can).

I would think there might be a need to stick to just the extension
of the tutorial to keep it simple but maybe something at the end
about any extra steps which might be needed to create a new
document using the common library.


I have just posted to the UBL TC list a pointer to the revised environment used to create schema fragments:


The readme-Crane-gc2ublndr.html file documents the invocation details of the spreadsheet that creates the outputs from the inputs.

The CreatingExtensionsWithUBLNDR.html file is the first cut at the tutorial you requested, directing users in how to use the package to create both document extensions and additional documents for any project that uses the upcoming UBL NDR 2.1.

I will be rewriting the second day of my two-day UBL training class to include hands-on sessions that create such user-defined additions to UBL.  The handouts with those changes will end up in the book.

I am hoping to get feedback from anyone who uses the package.  I want to make this easy for people to create extensions for UBL, and easy for non-UBL projects to use off-the-shelf to create their schemas from the UBL NDR 2.1 models.

Thanks, Steve, for the impetus to augment this free package of software.

. . . . . . . . . . . Ken

Very good.

Cheers Ken

Stephen D Green

On 25 October 2011 11:56, G. Ken Holman <<mailto:gkholman@cranesoftwrights.com>gkholman@cranesoftwrights.com> wrote:
At 2011-10-24 14:15 +0100, Stephen D Green wrote:
such as the
use case where they need to create a small extension schema for
a UBL invoice.

This is an excellent idea, Stephen!

It shouldn't be too hard to find a specific example (but
I might be out-of-date with my knowledge of what isn't already covered
by the 2.1 UBL invoice).

There *is* a specific example:  the UBL 2.1 standardized signature extension!  I will adapt this environment to accept a standalone genericode _expression_ of the BIEs of the signature extension and I should then be able to synthesize the fragment that will be included in the UBL 2.1 delivery.

Then anyone will be able to follow what I did for the signature extension to create their own custom extension for UBL documents.

In the past a utility invoice extension or one
for billing hours worked (by consultant or contractor, say) would have
been good ones and maybe one or other would still be appropriate.

And ..... what about someone wanting to create their own non-UBL document that uses the UBL common library?  Two use cases:  an independent who needs something that isn't already in UBL, and a group who wants to propose new documents to go into a future UBL.

I will adapt this environment to accept a standalone genericode _expression_ of the BIEs in a suite of non-UBL documents using the UBL common library.  A group can then model their set of documents, express the contents in genericode, run it through this environment and get a set of schemas that work in unison with the UBL common library.  Having done so, their non-UBL ABIEs and BBIEs will be suitably structured for the UBL TC to consider simply plugging in to the common library in a future version.

I already have pencilled in the necessary changes to the configuration file and invocations in order to effect both of the above features.  I should be able to get a new version of this environment out by late next week (possibly earlier if I can juggle priorities) that will support them.

Then the environment is useful not only to any project following UBL NDR 2.1, but also any project group with constituents wanting to create custom extensions and additional documents for use with that project's artefacts.

If you (or anyone else) can think of any other features that would help in this schema-generating environment, please let me know ASAP so I can consider them for this next revision.

Thanks, again, Stephen!

. . . . . . . . . . Ken

Contact us for world-wide XML consulting and instructor-led training
Free 5-hour video lecture: XSLT/XPath 1.0 & 2.0 http://ude.my/t37DVX

Crane Softwrights Ltd.            http://www.CraneSoftwrights.com/u/
G. Ken Holman                   mailto:gkholman@CraneSoftwrights.com
Google+ profile: https://plus.google.com/116832879756988317389/about
Legal business disclaimers:    http://www.CraneSoftwrights.com/legal

To unsubscribe, e-mail: ubl-dev-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: ubl-dev-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]