Table 1 URI patterns for central resources

URI path template

Example path(s)

Description

/ehr:{ehr_id}/{object_id}::{creating_system_id}::{version_tree_id}

/ehr:12344321/56d03821-8e89-cca769b7d39e::test2.eee.mi.imt.liu.se::1

Fetches a VERSION, identified by creating_system_id combined with version_tree_id, from the VERSIONED_OBJECT identified by object_id. URIs containing fragments (after a # sign) will have the same effect. Thus /ehr:12344321/56d03821-8e89-cca769b7d39e::test2.eee.mi.imt.liu.se::1#path will also fetch the entire VERSION from the server and let the client deal with the fragment.

/ehr:{ehr_id}/{object_id}::{creating_system_id}::{version_tree_id}/…

/ehr:12344321/56d03821-8e89-cca769b7d39e::test2.eee.mi.imt.liu.se::1/content[openEHR-EHR-SECTION.vital_signs.v1]/items[openEHR-EHR-OBSERVATION.blood_pressure.v1]/data/

Fetches only the part of a VERSION specified by the path after the id. This can be used by applications that for example due to privacy reasons only want to retrieve part of a version.

/ehr:{ehr_id}/{object_id}/{command}

/ehr:12344321/56d03821-8e89-cca769b7d3/all_version_ids

Fetches object lists or metadata of different kinds depending on command, see openEHR specifications [8] for details.

/ehr:{ehr_id}/{object_id}@{versionLookup}

/ehr:12344321/56d03821-8e89-cca769b7d39@latest_version

/ehr:12344321/56d03821-8e89-cca769b7d39@2005-08-02T04:30:00

Fetches version based on lookup command, for example the version that was current at a specific time.

/multi/ehr:{ehr_id}/{object_id}…

Ad-hoc queries in the ‘multi’ use case can also produce lists or reports, sometimes containing detail hyperlinks pointing to versioned objects. By prepending multi to the path such objects can optionally be fetched from, and thus logged by, the multi database instead of the single database, if desired.

/ehr:{ehr_id}/contributions/

/ehr:12344321/contributions/?start = 1&end = 5&descending = true

HTTP GET returns all contributions for the EHR identified by ehr_id, paged by variables start (default 1) and end (default 20) the default ordering is descending (most recent contribution listed first).

HTTP POST is used to commit a contribution; all new and changed VERSIONs should be included in the body of the POST. The current LiU EEE implementation accepts either XML or serialized Java objects. Some web-based applications will instead of POSTing to this URI prefer to use the /cb/{committer_id}/{ehr_id}/{cb- id}/commit/ command (described in Table 2) that calls the same verification and storage mechanisms internally.

/ehr:{ehr_id}/contributions/{contribution_id}/

/ehr:12344321/contributions/7a11c126-e1af-4022-9c36-f046693bb237/

Fetches the contribution identified by contribution_id