View Issue Details

IDProjectCategoryView StatusLast Update
0004609UA SpecificationSpecpublic2019-09-02 12:43
ReporterWolfgang Mahnke Assigned ToKarl Deiretsbacher  
PrioritynormalSeverityminorReproducibilityhave not tried
Status closedResolutionfixed 
Fixed in Version1.01 
Summary0004609: Reference to versions of the specification
Description

Currently our base specifications do not reference versions of the spec, but only the parts. Same is true for the template and many released companion specifications.

In the beginning of the references is stated
"The following referenced documents are indispensable for the application of this specification. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies."

BTW: For example Part 3 and 4 have different text, I have not checked all parts. I think the text should be the same in all parts.

Those references work in a way that if I use the latest version of OPC UA with a companion spec it shall work with the companion spec as we are supposed not to do breaking changes.

What we loose with that kind of references is the knowlegde, which older version of OPC UA would be enough to support the companion specification. I do not think that we have Profiles on a level that it would help for this purpose. For example, for Ammendments 1-3 we have no additional profiles defined (should we do this in the future?).
The NodeSet-Files of the companion specs do reference versions of the NodeSet-File of the base specification. Is this enough information? And if yes, should we at least point out in the companion specifications that this is the intended way. Do we provide information to figure out from the base specification NodeSet-File which version of the spec including Ammendments are included? If not, should we provide this (e.g. as comment in the NodeSet-File)?

TagsNo tags attached.
Commit Version
Fix Due Date

Activities

Jim Luth

2019-06-25 16:08

administrator   ~0010406

Agreed to update the base specs to use the same wording for referencing other parts. Also agreed to update the companion spec template to show how to reference the minimum required version of the base specs.

We have already agreed on a mechanism to use the full Errata version e.g. 1.04.xx as the way to tie Errata, amendments and NodeSet changes together into consistent version.

Karl Deiretsbacher

2019-09-02 12:42

developer   ~0010893

Fixed in Version 1.01 of the template. It is located in "OPC-Harmonization -> working documents -> templates".

Karl Deiretsbacher

2019-09-02 12:43

developer   ~0010894

see last note.

Issue History

Date Modified Username Field Change
2019-02-06 09:47 Wolfgang Mahnke New Issue
2019-06-25 16:08 Jim Luth Note Added: 0010406
2019-06-25 16:08 Jim Luth Assigned To => Karl Deiretsbacher
2019-06-25 16:08 Jim Luth Status new => assigned
2019-09-02 12:42 Karl Deiretsbacher Status assigned => resolved
2019-09-02 12:42 Karl Deiretsbacher Resolution open => fixed
2019-09-02 12:42 Karl Deiretsbacher Fixed in Version => 1.01
2019-09-02 12:42 Karl Deiretsbacher Note Added: 0010893
2019-09-02 12:43 Karl Deiretsbacher Status resolved => closed
2019-09-02 12:43 Karl Deiretsbacher Note Added: 0010894