Skip to Content
Last modified by Artur on 2025/09/10 11:19
From version 1.4
edited by Helena
on 2025/06/16 15:40
Change comment: There is no comment for this version
To version 1.3
edited by Helena
on 2025/06/16 15:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -40,24 +40,121 @@
40 40  1.0.0-prerelease.11 < 1.0.0-rc.1 < 1.0.0.
41 41  
42 42  * The reasons for version changes MAY be documented in brief form in an artefact's annotation of type "CHANGELOG".
43 +*1. Backus–Naur Form Grammar for Valid SDMX 3.0(.0) Semantic Versions
43 43  
44 -== 14.3 Backus–Naur Form Grammar for Valid SDMX 3.0(.0) Semantic Versions ==
45 +|(((
46 +**<valid semver> ::= <version core>**
45 45  
46 -[[image:1750077413040-228.png]]
48 +**~ | <version core> "-" <extension>**
47 47  
48 -[[image:1750077431756-519.png]]
50 +**<version core> ::= <major> "." <minor> "." <patch>**
49 49  
50 -== 14.4 Dependency Management in SDMX 3.0(.0): ==
52 +**~ **
51 51  
54 +**<major> ::= <numeric identifier>**
55 +
56 +**~ **
57 +
58 +**<minor> ::= <numeric identifier>**
59 +
60 +**~ **
61 +
62 +**<patch> ::= <numeric identifier>**
63 +
64 +**~ **
65 +
66 +**<extension> ::= <dot-separated extension identifiers>**
67 +
68 +**~ **
69 +
70 +**<dot-separated extension identifiers> ::= <extension identifier>**
71 +
72 +**~ | <extension identifier> "." <dotseparated extension identifiers>**
73 +
74 +**~ **
75 +
76 +**<extension identifier> ::= <alphanumeric identifier>**
77 +
78 +**~ | <numeric identifier>**
79 +
80 +**~ **
81 +
82 +**<alphanumeric identifier> ::= <non-digit>**
83 +
84 +**~ | <non-digit> <identifier characters>**
85 +
86 +**~ | <identifier characters> <non-digit>**
87 +
88 +**~ | <identifier characters> <non-digit> <identifier characters>**
89 +
90 +**~ **
91 +
92 +**<numeric identifier> ::= "0"**
93 +
94 +**~ | <positive digit>**
95 +
96 +**~ | <positive digit> <digits>**
97 +
98 +**~ **
99 +
100 +**<identifier characters> ::= <identifier character>**
101 +
102 +**~ | <identifier character> <identifier characters>**
103 +)))
104 +
105 +**<identifier character> ::= <digit>**
106 +
107 +**~ | <non-digit>**
108 +
109 +**~ **
110 +
111 +**<non-digit> ::= <letter>**
112 +
113 +**~ | "-"**
114 +
115 +**~ **
116 +
117 +**<digits> ::= <digit>**
118 +
119 +**~ | <digit> <digits>**
120 +
121 +**~ **
122 +
123 +**<digit> ::= "0"**
124 +
125 +**~ | <positive digit>**
126 +
127 +**~ **
128 +
129 +**<positive digit> ::= "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"**
130 +
131 +**<letter> ::= "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "J"**
132 +
133 +**~ | "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" | "S" | "T"**
134 +
135 +**~ | "U" | "V" | "W" | "X" | "Y" | "Z" | "a" | "b" | "c" | "d"**
136 +
137 +**~ | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n"**
138 +
139 +**~ | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x"**
140 +
141 +**~ | "y" | "z"**
142 +
143 +1.
144 +11. Dependency Management in SDMX 3.0(.0):
145 +
52 52  MAJOR, MINOR or PATCH version parts in SDMX 3.0 artefact references CAN be wildcarded using "+" as extension:
53 53  
54 -* X+.Y.Z means the currently latest available version >= X.Y.Z
55 -** Example: "2+.3.1" means the currently latest available version >="2.3.1" (even if not backwards compatible)
56 -** Typical use case: references in SDMX Categorisations
57 -* X.Y+.Z means the currently latest available backwards compatible version >=X.Y.Z
58 -** Example: "2.3+.1" means the currently latest available version >= "2.3.1" and < "3.0.0" (all backwards compatible versions >="2.3.1")
59 -** Typical use case: references in SDMX DSD
148 +* X+.Y.Z means the currently latest available version >= X.Y.Z o Example: "2+.3.1" means the currently latest available version >=
60 60  
150 +"2.3.1" (even if not backwards compatible) o Typical use case: references in SDMX Categorisations
151 +
152 +* X.Y+.Z means the currently latest available backwards compatible version >=
153 +
154 +X.Y.Z o Example: "2.3+.1" means the currently latest available version >= "2.3.1" and < "3.0.0" (all backwards compatible versions >=
155 +
156 +"2.3.1") o Typical use case: references in SDMX DSD
157 +
61 61  * X.Y.Z+ means the currently latest available forwards and backwards compatible version >= X.Y.Z o Example: "2.3.1+" means the currently latest available version >= "2.3.1" and < "2.4.0" (all forwards and backwards compatible versions >= "2.3.1")
62 62  * Non-versioned and 2-digit version SDMX structural artefacts CAN reference any other non-versioned or versioned (whether SemVer or not) SDMX structural artefacts.
63 63  * Semantically versioned artefacts MUST only reference other semantically versioned artefacts.
... ... @@ -74,7 +74,8 @@
74 74  
75 75  ~* means all available versions
76 76  
77 -== 14.5 Upgrade and conversions of artefacts defined with previous SDMX standard versions to Semantic Versioning ==
174 +1.
175 +11. Upgrade and conversions of artefacts defined with previous SDMX standard versions to Semantic Versioning
78 78  
79 79  Because SDMX standardises the interactions between statistical systems, which cannot all be upgraded at the same time, the new versioning rules cannot be applied to existing artefacts in EDIFACT, SDMX 1.0, 2.0 or 2.1. SemVer can only be applied to structural artefacts that are newly modelled with the SDMX 3.0 Information Model. Migrating to SemVer means migrating to the SDMX 3.0 Information Model, to its new API version and new versions of its exchange message formats.
80 80  
... ... @@ -96,7 +96,7 @@
96 96  
97 97  Note: Like for other not fully backwards compatible SDMX 3.0 features, also some cases of semantically versioned SDMX 3.0 artefacts cannot be converted back to earlier SDMX versions. This is the case when one or more extensions have been created in parallel to the corresponding stable version. In this case, only the stable version SHOULD be converted to a final version (e.g., 3.2.1 becomes 3.2.1 final, and 3.2.1-draft cannot be converted back).
98 98  
99 -1.
197 +1.
100 100  11. FAQ for Semantic Versioning
101 101  
102 102  **My organisation is new to SDMX and starts to implement 3.0 or starts to implement a new process fully based on SDMX 3.0. Which versioning scheme should be used?**
1750077413040-228.png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -70.3 KB
Content
1750077431756-519.png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -33.3 KB
Content