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


Help: OASIS Mailing Lists Help | MarkMail Help

obix message

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

Subject: Artifacts and the OASIS Process



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.




The prose specification can be found, in html, at



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

blog: http://www.NewDaedalus.com


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