SPECRM-90 Add new DV_OPENEHR_URI type

docs/UML/class_index.adoc

@@ -155,6 +155,8 @@
 [.xcode]
 * link:/releases/RM/{rm_release}/data_types.html#_dv_multimedia_class[DV_MULTIMEDIA^]
 [.xcode]
+* link:/releases/RM/{rm_release}/data_types.html#_dv_openehr_uri_class[DV_OPENEHR_URI^]
+[.xcode]
 * link:/releases/RM/{rm_release}/data_types.html#_dv_ordered_class[DV_ORDERED^]
 [.xcode]
 * link:/releases/RM/{rm_release}/data_types.html#_dv_ordinal_class[DV_ORDINAL^]

docs/UML/classes/org.openehr.rm.common.attestation.adoc

@@ -29,7 +29,7 @@ a|Proof of attestation.
 
 h|*0..1*
 |*items*: `link:/releases/BASE/{base_release}/foundation_types.html#_list_class[List^]<link:/releases/RM/{rm_release}/data_types.html#_dv_ehr_uri_class[DV_EHR_URI^]>`
-a|Items attested, expressed as fully qualified runtime paths to the items in question. Although not recommended, these may include fine-grained items which have been attested in some other system. Otherwise it is assumed to be for the entire VERSION with which it is associated.
+a|Items attested, expressed as fully qualified runtime paths to the items in question. Although not recommended, these may include fine-grained items which have been attested in some other system. Otherwise it is assumed to be for the entire `VERSION` with which it is associated.
 
 h|*1..1*
 |*reason*: `link:/releases/RM/{rm_release}/data_types.html#_dv_text_class[DV_TEXT^]`

docs/UML/classes/org.openehr.rm.common.link.adoc

@@ -25,6 +25,6 @@ h|*1..1*
 a|The type attribute is used to indicate a clinical or domain-level meaning for the kind of link, for example  problem  or  issue . If type values are designed appropriately, they can be used by the requestor of EHR extracts to categorise links which must be followed and which can be broken when the extract is created.
 
 h|*1..1*
-|*target*: `link:/releases/RM/{rm_release}/data_types.html#_dv_ehr_uri_class[DV_EHR_URI^]`
-a|The logical  to  object in the link relation, as per the linguistic sense of the meaning attribute.
+|*target*: `link:/releases/RM/{rm_release}/data_types.html#_dv_openehr_uri_class[DV_OPENEHR_URI^]`
+a|The logical target object in the link relation, as per the linguistic sense of the meaning attribute. May be any openEHR data artefact, including in an EHR, PARTY etc.
 |===

docs/UML/classes/org.openehr.rm.data_types.dv_ehr_uri.adoc

@@ -11,7 +11,7 @@ h|*Description*
 Used to reference items in an EHR, which may be the same as the current EHR (containing this link), or another.
 
 h|*Inherit*
-2+|`<<_dv_uri_class,DV_URI>>`
+2+|`<<_dv_openehr_uri_class,DV_OPENEHR_URI>>`
 
 
 h|*Invariants*

docs/UML/classes/org.openehr.rm.data_types.dv_openehr_uri.adoc

@@ -0,0 +1,21 @@
+=== DV_OPENEHR_URI Class
+
+[cols="^1,3,5"]
+|===
+h|*Class*
+2+^h|*DV_OPENEHR_URI*
+
+h|*Description*
+2+a|
+
+h|*Inherit*
+2+|`<<_dv_uri_class,DV_URI>>`
+
+h|*Functions*
+^h|*Signature*
+^h|*Meaning*
+
+h|*1..1*
+|*as_urn* (): `link:/releases/BASE/{base_release}/foundation_types.html#_string_class[String^]`
+a|Generate URN form of this URI.
+|===

docs/UML/classes/org.openehr.rm.demographic.party.adoc

@@ -30,10 +30,6 @@ h|*0..1*
 |*details*: `link:/releases/RM/{rm_release}/data_structures.html#_item_structure_class[ITEM_STRUCTURE^]`
 a|All other details for this Party.
 
-h|*0..1*
-|*reverse_relationships*: `link:/releases/BASE/{base_release}/foundation_types.html#_list_class[List^]<link:/releases/BASE/{base_release}/base_types.html#_locatable_ref_class[LOCATABLE_REF^]>`
-a|References to relationships in which this Party takes part as target.
-
 h|*0..1*
 |*relationships*: `link:/releases/BASE/{base_release}/foundation_types.html#_list_class[List^]<<<_party_relationship_class,PARTY_RELATIONSHIP>>>`
 a|Relationships in which this Party takes part as source.

docs/common.html

@@ -10,6 +10,7 @@
 <title>Common Information Model</title>
 <link rel="stylesheet" href="https://specifications.openehr.org/styles/openehr.css">
 <link rel="stylesheet" href="https://specifications.openehr.org/styles/pygments-default.css">
+<link rel="stylesheet" href="https://specifications.openehr.org/styles/asciidoctor-tabs.css">
 </head>
 <body class="book toc2 toc-left">
 <div id="header">
@@ -266,7 +267,7 @@ <h1 id="_common_information_model" class="sect0"><a class="anchor" href="#_commo
 </colgroup>
 <thead>
 <tr>
-<th class="tableblock halign-center valign-top" colspan="2">&#169; 2003 - 2023 The openEHR Foundation</th>
+<th class="tableblock halign-center valign-top" colspan="2">&#169; 2003 - 2024 The openEHR Foundation</th>
 </tr>
 </thead>
 <tbody>
@@ -307,14 +308,26 @@ <h2 id="_amendment_record"><a class="anchor" href="#_amendment_record"></a>Amend
 <tbody>
 <tr>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
-<p><a id="latest_issue"></a>2.1.5</p>
+<p><a id="latest_issue"></a>2.2.0</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://specifications.openehr.org/tickets/SPECRM-90" target="_blank" rel="noopener">SPECRM-90</a>: Add new <code>DV_OPENEHR_URI</code> type; change <code>LINK.<em>target</em></code> to this type.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">S Iancu,<br>
+E Sundvall,<br>
+M Polajnar</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
+<p><a id="latest_issue_date"></a>01 Nov 2024</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
+<p>2.1.5</p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://specifications.openehr.org/tickets/SPECRM-87" target="_blank" rel="noopener">SPECRM-87</a>: Support tags: added <a href="#tags">Tags Package</a> (Addresses <a href="https://specifications.openehr.org/tickets/SPECPR-265" target="_blank" rel="noopener">SPECPR-265</a>).</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">S Iancu,<br>
 B Næss,<br>
 M Polajnar</p></td>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
-<p><a id="latest_issue_date"></a>17 Nov 2022</p>
+<p>17 Nov 2022</p>
 </div></div></td>
 </tr>
 <tr>
@@ -1911,9 +1924,9 @@ <h4 id="_link_class"><a class="anchor" href="#_link_class"></a>3.2.4. LINK Class
 </tr>
 <tr>
 <th class="tableblock halign-center valign-top"><p class="tableblock"><strong>1..1</strong></p></th>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>target</strong>: <code><a href="/releases/RM/latest/data_types.html#_dv_ehr_uri_class" target="_blank" rel="noopener">DV_EHR_URI</a></code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>target</strong>: <code><a href="/releases/RM/latest/data_types.html#_dv_openehr_uri_class" target="_blank" rel="noopener">DV_OPENEHR_URI</a></code></p></td>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
-<p>The logical  to  object in the link relation, as per the linguistic sense of the meaning attribute.</p>
+<p>The logical target object in the link relation, as per the linguistic sense of the meaning attribute. May be any openEHR data artefact, including in an EHR, PARTY etc.</p>
 </div></div></td>
 </tr>
 </tbody>
@@ -2608,7 +2621,7 @@ <h4 id="_attestation_class"><a class="anchor" href="#_attestation_class"></a>4.3
 <th class="tableblock halign-center valign-top"><p class="tableblock"><strong>0..1</strong></p></th>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>items</strong>: <code><a href="/releases/BASE/latest/foundation_types.html#_list_class">List<sup></a>&lt;<a href="/releases/RM/latest/data_types.html#_dv_ehr_uri_class">DV_EHR_URI</sup></a>&gt;</code></p></td>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
-<p>Items attested, expressed as fully qualified runtime paths to the items in question. Although not recommended, these may include fine-grained items which have been attested in some other system. Otherwise it is assumed to be for the entire VERSION with which it is associated.</p>
+<p>Items attested, expressed as fully qualified runtime paths to the items in question. Although not recommended, these may include fine-grained items which have been attested in some other system. Otherwise it is assumed to be for the entire <code>VERSION</code> with which it is associated.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -4738,5 +4751,6 @@ <h2 id="_references"><a class="anchor" href="#_references"></a>References</h2>
 Last updated 2022-11-17 15:56:53 UTC
 </div>
 </div>
+<script src="https://specifications.openehr.org/js/asciidoctor-tabs.js"></script>
 </body>
 </html>

docs/common/master00-amendment_record.adoc

@@ -4,13 +4,19 @@
 |===
 |Issue|Details|Raiser|Completed
 
+|[[latest_issue]]2.2.0
+|{spec_tickets}/SPECRM-90[SPECRM-90^]: Add new `DV_OPENEHR_URI` type; change `LINK._target_` to this type.
+|S Iancu, +
+E Sundvall, +
+M Polajnar
+|[[latest_issue_date]]01 Nov 2024
 
-|[[latest_issue]]2.1.5
+|2.1.5
 |{spec_tickets}/SPECRM-87[SPECRM-87^]: Support tags: added <<tags, Tags Package>> (Addresses {spec_tickets}/SPECPR-265[SPECPR-265^]).
 |S Iancu, +
 B Næss, +
 M Polajnar
-|[[latest_issue_date]]17 Nov 2022
+|17 Nov 2022
 
 |
 |{spec_tickets}/SPECRM-107[SPECRM-107^]: Add `inactive` and `abandoned` states to Version lifecycle (fixes {spec_tickets}/SPECPR-383[SPECPR-383^]).

docs/data_types.html

@@ -10,6 +10,7 @@
 <title>Data Types Information Model</title>
 <link rel="stylesheet" href="https://specifications.openehr.org/styles/openehr.css">
 <link rel="stylesheet" href="https://specifications.openehr.org/styles/pygments-default.css">
+<link rel="stylesheet" href="https://specifications.openehr.org/styles/asciidoctor-tabs.css">
 </head>
 <body class="book toc2 toc-left">
 <div id="header">
@@ -259,12 +260,14 @@
 <li><a href="#_class_descriptions_7">10.3. Class Descriptions</a>
 <ul class="sectlevel3">
 <li><a href="#_dv_uri_class">10.3.1. DV_URI Class</a></li>
-<li><a href="#_dv_ehr_uri_class">10.3.2. DV_EHR_URI Class</a></li>
+<li><a href="#_dv_openehr_uri_class">10.3.2. DV_OPENEHR_URI Class</a></li>
+<li><a href="#_dv_ehr_uri_class">10.3.3. DV_EHR_URI Class</a></li>
 </ul>
 </li>
 <li><a href="#_syntaxes_3">10.4. Syntaxes</a>
 <ul class="sectlevel3">
-<li><a href="#_dv_ehr_uri_syntax">10.4.1. DV_EHR_URI Syntax</a></li>
+<li><a href="#_dv_openehr_uri_syntax">10.4.1. DV_OPENEHR_URI Syntax</a></li>
+<li><a href="#_dv_ehr_uri_syntax">10.4.2. DV_EHR_URI Syntax</a></li>
 </ul>
 </li>
 </ul>
@@ -350,7 +353,7 @@ <h1 id="_data_types_information_model" class="sect0"><a class="anchor" href="#_d
 </colgroup>
 <thead>
 <tr>
-<th class="tableblock halign-center valign-top" colspan="2">&#169; 2003 - 2023 The openEHR Foundation</th>
+<th class="tableblock halign-center valign-top" colspan="2">&#169; 2003 - 2024 The openEHR Foundation</th>
 </tr>
 </thead>
 <tbody>
@@ -390,11 +393,19 @@ <h2 id="_amendment_record"><a class="anchor" href="#_amendment_record"></a>Amend
 </thead>
 <tbody>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="latest_issue"></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="latest_issue"></a>2.2.0</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://specifications.openehr.org/tickets/SPECRM-90" target="_blank" rel="noopener">SPECRM-90</a>: Add new <code>DV_OPENEHR_URI</code> type as descendant of <code>DV_URI</code>.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">S Iancu,<br>
+E Sundvall,<br>
+M Polajnar</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="latest_issue_date"></a>01 Nov 2024</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://specifications.openehr.org/tickets/SPECRM-101" target="_blank" rel="noopener">SPECRM-101</a>: Correct error in <code><em>less_than()</em></code> description in various <code>DV_ORDERED</code> descendants: <code>DV_QUANTIFIED</code>, <code>DV_COUNT</code>, <code>DV_QUANTITY</code>, and the DV date/time types to indicate that the result is 'this object &lt; other'.</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">B Verhees,<br>
  T Beale</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="latest_issue_date"></a>26 Dec 2020</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">26 Dec 2020</p></td>
 </tr>
 <tr>
 <th class="tableblock halign-center valign-top" colspan="4"><p class="tableblock"><strong>RM Release 1.1.0</strong></p></th>
@@ -6230,13 +6241,10 @@ <h2 id="_uri_package"><a class="anchor" href="#_uri_package"></a>10. Uri Package
 <h3 id="_overview_8"><a class="anchor" href="#_overview_8"></a>10.1. Overview</h3>
 <div class="paragraph">
 <p>The <code>data_types.uri</code> package includes two types used for referring to information resources. The
-<code>DV_URI</code> type allows data values which are references to objects on the world wide web to be created.
-Its specialisation, <code>DV_EHR_URI</code>, enables any element in an openEHR record to be identified in the
-same way as other objects on the web. The <code>DV_EHR_URI</code> type is convenient, because it is a string,
-like any other URI, and is therefore easily transportable and processable. Because it has its own
-scheme space, 'ehr', instances can be globally unique, as long as EHR identification is globally
-unique. <code>DV_EHR_URIs</code> are used to express all runtime paths in the EHR. The <code>uri</code> Package is illustrated
-below.</p>
+<code>DV_URI</code> type allows data values which are references to objects on the world wide web to be created. The specialisation <code>DV_OPENEHR_URI</code> provides a representation for URIs that may be used within an openEHR data environment, i.e. to refer to any openEHR data artefact, including in the EHR, demographics, or future artefact types such as guidelines, plan etc.</p>
+</div>
+<div class="paragraph">
+<p>The final specialisation, <code>DV_EHR_URI</code>, provides the specific semantics for representing as a URI the reference to any element in an openEHR EHR. The <code>DV_EHR_URI</code> type is convenient, because it is a string, like any other URI, and is therefore easily transportable and processable. Because it has its own scheme space, 'ehr', instances can be globally unique, as long as EHR identification is globally unique. <code>DV_EHR_URIs</code> are used to express all runtime paths in the EHR. The <code>uri</code> Package is illustrated below.</p>
 </div>
 <div id="rm_data_types_uri" class="imageblock text-center text-center">
 <div class="content">
@@ -6366,7 +6374,43 @@ <h4 id="_dv_uri_class"><a class="anchor" href="#_dv_uri_class"></a>10.3.1. DV_UR
 </table>
 </div>
 <div class="sect3">
-<h4 id="_dv_ehr_uri_class"><a class="anchor" href="#_dv_ehr_uri_class"></a>10.3.2. DV_EHR_URI Class</h4>
+<h4 id="_dv_openehr_uri_class"><a class="anchor" href="#_dv_openehr_uri_class"></a>10.3.2. DV_OPENEHR_URI Class</h4>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 11.1111%;">
+<col style="width: 33.3333%;">
+<col style="width: 55.5556%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Class</strong></p></th>
+<th class="tableblock halign-center valign-top" colspan="2"><p class="tableblock"><strong>DV_OPENEHR_URI</strong></p></th>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Description</strong></p></th>
+<td class="tableblock halign-left valign-top" colspan="2"><div class="content"></div></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Inherit</strong></p></th>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><code><a href="#_dv_uri_class">DV_URI</a></code></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Functions</strong></p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Signature</strong></p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Meaning</strong></p></th>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><strong>1..1</strong></p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>as_urn</strong> (): <code><a href="/releases/BASE/latest/foundation_types.html#_string_class" target="_blank" rel="noopener">String</a></code></p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
+<p>Generate URN form of this URI.</p>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_dv_ehr_uri_class"><a class="anchor" href="#_dv_ehr_uri_class"></a>10.3.3. DV_EHR_URI Class</h4>
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
 <col style="width: 11.1111%;">
@@ -6389,7 +6433,7 @@ <h4 id="_dv_ehr_uri_class"><a class="anchor" href="#_dv_ehr_uri_class"></a>10.3.
 </tr>
 <tr>
 <th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Inherit</strong></p></th>
-<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><code><a href="#_dv_uri_class">DV_URI</a></code></p></td>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><code><a href="#_dv_openehr_uri_class">DV_OPENEHR_URI</a></code></p></td>
 </tr>
 <tr>
 <th class="tableblock halign-center valign-top"><p class="tableblock"><strong>Invariants</strong></p></th>
@@ -6404,9 +6448,15 @@ <h4 id="_dv_ehr_uri_class"><a class="anchor" href="#_dv_ehr_uri_class"></a>10.3.
 <div class="sect2">
 <h3 id="_syntaxes_3"><a class="anchor" href="#_syntaxes_3"></a>10.4. Syntaxes</h3>
 <div class="sect3">
-<h4 id="_dv_ehr_uri_syntax"><a class="anchor" href="#_dv_ehr_uri_syntax"></a>10.4.1. DV_EHR_URI Syntax</h4>
+<h4 id="_dv_openehr_uri_syntax"><a class="anchor" href="#_dv_openehr_uri_syntax"></a>10.4.1. DV_OPENEHR_URI Syntax</h4>
+<div class="paragraph">
+<p>The syntax of a <code>DV_OPENEHR_URI</code> is an openEHR path within any openEHR-defined data instance, scoped by any URI scheme-space used in openEHR.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_dv_ehr_uri_syntax"><a class="anchor" href="#_dv_ehr_uri_syntax"></a>10.4.2. DV_EHR_URI Syntax</h4>
 <div class="paragraph">
-<p>The syntax of a <code>DV_EHR_URI</code> is an openEHR path, inside the 'ehr' URI scheme-space, and is one of the forms:</p>
+<p>The syntax of a <code>DV_EHR_URI</code> is an openEHR path, inside the 'ehr' URI scheme-space, and takes one of the forms:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -6999,5 +7049,6 @@ <h2 id="_references"><a class="anchor" href="#_references"></a>References</h2>
 Last updated 2022-11-17 15:24:01 UTC
 </div>
 </div>
+<script src="https://specifications.openehr.org/js/asciidoctor-tabs.js"></script>
 </body>
 </html>

docs/data_types/master00-amendment_record.adoc

@@ -4,11 +4,18 @@
 |===
 |Issue|Details|Raiser, Implementer|Completed
 
-|[[latest_issue]]
+|[[latest_issue]]2.2.0
+|{spec_tickets}/SPECRM-90[SPECRM-90^]: Add new `DV_OPENEHR_URI` type as descendant of `DV_URI`.
+|S Iancu, +
+E Sundvall, +
+M Polajnar
+|[[latest_issue_date]]01 Nov 2024
+
+|
 |{spec_tickets}/SPECRM-101[SPECRM-101^]: Correct error in `_less_than()_` description in various `DV_ORDERED` descendants: `DV_QUANTIFIED`, `DV_COUNT`, `DV_QUANTITY`, and the DV date/time types to indicate that the result is 'this object < other'.
 |B Verhees, +
  T Beale
-|[[latest_issue_date]]26 Dec 2020
+|26 Dec 2020
 
 4+^h|*RM Release 1.1.0*