Artifacts and the OASIS Process

Markus

As discussed during last Thursday’s meeting, machine readable artifacts are an important part of the OASIS process.

When a specification includes both prose and artifacts covering the same material, the artifacts are considered normative. This means that if the prose says “foo” and the artifact says “fie”, The specification is considered to specify “fie”. Typical artifacts are XSD and WSDL.

I recently completed work on the Energy Interoperation specification which specifies interactions between an energy provider and an energy consumer. I am using this an example because it contains Prose, WSDL, and XSD.

https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=energyinterop

The prose specification can be found, in html, at

http://docs.oasis-open.org/energyinterop/ei/v1.0/energyinterop-v1.0.html

If you note, one of the first parts is the “Additional Artifacts” section

Additional artifacts:

This prose specification is one component of a Work Product, which also includes:

. XML schemas: http://docs.oasis-open.org/energyinterop/ei/v1.0/cs02/xsd/

. EIClasses.xsd

. EiEnrollment.xsd

. EiPayloads.xsd

. iCalendar-streams-extensions.xsd

. wsdl files: http://docs.oasis-open.org/energyinterop/ei/v1.0/cs02/wsdl/

. EnergyInterop-Avail.wsdl

. EnergyInterop-Delivery.wsdl

. EnergyInterop-Enroll.wsdl

. EnergyInterop-Event.wsdl

. EnergyInterop-MarketContext.wsdl

. EnergyInterop-Opt.wsdl

. EnergyInterop-PartyRegistration.wsdl

. EnergyInterop-Quote.wsdl

. EnergyInterop-Report.wsdl

. EnergyInterop-Tender.wsdl

. EnergyInterop-Transaction.wsdl

You can use these as examples of what the finished artifacts for oBIX might look like.

If you have examples that you would like to submit as the initial version for this work, please start by uploading them to the “Contributions” folder in the OASIS OBIX Document Repository. This grants the TC the right to use this submission as the basis for further work.

I will prepare another note on contributions in a bit

“It is the theory that decides what can be observed." -- Albert Einstein

Toby Considine
TC9, Inc

OASIS TC Chair: oBIX & WS-Calendar

OASIS TC Editor: EMIX, Energy Interoperation

SGIP Smart Grid Architecture Committee

Email: Toby.Considine@gmail.com
Phone: (919)619-2104

http://www.tcnine.com
blog: http://www.NewDaedalus.com

obix message