# Detected a potential breaking change in Common IM that doesn't seem to be documented

**Category:** [General Discussion](https://discourse.openehr.org/c/general-discussion/132)
**Created:** 2023-01-30 20:31 UTC
**Views:** 782
**Replies:** 1
**URL:** https://discourse.openehr.org/t/detected-a-potential-breaking-change-in-common-im-that-doesnt-seem-to-be-documented/3503

---

## Post #1 by @pablo

From RM 1.0.2 common.pdf section 5.1 (https://specifications.openehr.org/releases/1.0.2/architecture/rm/common_im.pdf):

` A FOLDER instance contains more FOLDERs and/or items, which are references to other (usually versioned) objects`

Note the "usually".

The description in RM 1.1.0 is the same (https://specifications.openehr.org/releases/RM/Release-1.1.0/common.html#_overview_4) but the UML clearly shows a binding of the items OBJECT_REF to VERSIONED_OBJECT, which determines that the reference is not to a "usually" versioned object, it is always that way.

![](upload://laTPMara4BkiwXXzBZhQl8D5cKV.svg)

So somewhere between RM 1.0.2 and 1.1.0 this was changed and the change log wasn't recorded. Note this is a breaking change if any FOLDER.items reference to a different object type than VERSIONED_OBJECT, like directly referencing a COMPOSITION instance in 1.0.2. With this UML that reference won't be possible in RM 1.1.0.

This is similar to what @sebastian.iancu mentioned here https://discourse.openehr.org/t/whats-allowed-in-folder-items/1539/11?u=pablo because they implemented items without the constraint that was added to the target in RM 1.1.0 (or maybe before that?)

In any case this is a subtle breaking change that might affect many for ended up kind of silently in the spec.

---

## Post #2 by @pablo

@SEC :index_pointing_up:

Just found this forgotten conversation, though might not have been an issue for anyone and might still be the case. Just in case someone is curious...

---


**Canonical:** https://discourse.openehr.org/t/detected-a-potential-breaking-change-in-common-im-that-doesnt-seem-to-be-documented/3503
**Original content:** https://discourse.openehr.org/t/detected-a-potential-breaking-change-in-common-im-that-doesnt-seem-to-be-documented/3503