2022-10-31 SEC Call notes

Meta

10 min

Opening

USEFUL Jira RESOURCE: CRs I have not accepted.

SEC Jira board.

Main Agenda

30 min

REST API update

Sebastian Iancu

OpenAPI Strategy

• https://discourse.openehr.org/t/open-api-strategy/2668

• API Blueprint => OpenApi

Overview for REST API 1.1.0 work to be done

Progress:

• some progress on tests

• test 11 - some code generation output now compiling C#, Groovy, Dart… (many more)

• test 12 - validation; checks using mock server

• made adjustments to JSON schemas based on test runs;

Need to make _type field optionality settable.

30 min

JSON schema update

Pablo Pazos

Working on 2 versions of schemas -

• canonical one

• relaxed one for API

New Github issue ITS-JSON #14

Pieter Bos Very nice work Pablo! I did a quick scan, and I see four categories of changes:

1. entry points, I can add these to the generator

2. small problems in the BMM, we can fix them in the BMM and regenerate

3. Some discussion points about whether we should change some things

4. inconsistencies between base and rm spec - the bmms use base! These are mainly classes used in the AOM, and we need to check actual implementations instead of fixing them to the RM spec I think

Chase up semantics of ACCESS_SETTINGs in RM.

15 mins

Links in archetypes

Thomas Beale

See Discourse post.

Ian McNicoll - make it look like Entry → Entry ‘containment’ view; BMI example; prefer ENTRY attribute; will be difficult to specify in advance what the target looks like

Erik Sundvall

• Think about what version of target is pointed to - a specific version or the entire versioned object (meaning pointing to the latest version?) Likely Both kinds should be allowed.

• Also be clear about at what timepoint(s) constraint/link/citation checking is expected to be done by the application/CDR. Llikely only during construction and storage of the COMPOSITION citing the the target).

Diego Boscá Tomás - use rules - consider what it looks like in rules.

Erik Sundvall point to an inner path, e.g. Weight: Real value.

Pablo Pazos How is the runtime ref actually created, and how does the constraint help the data builder do it?

Link target may already exist; may be in same Contribution (BMI example - can be done either way).

Thomas Beale : don’t see how Entry ‘virtual attribute’ will work.

AQL querying should work the same, regardless of what the (say) BMI structure is. Need to work out link following, also Folder ‘containment’ in AQL generally.

Ian McNicoll nested problem lists - e.g. ‘related problem’

Other example - point to lab analyte CLUSTER, e.g. by fixing LOINC code in the constraint.

Reports - solvable as well by this approach.

10 mins

Entity model - resources, parties, assets.

Thomas Beale

See draft.

Tips and Tricks

Hackers' Corner

Next SEC call

Outstanding topics:

• HighMed - FHIR bridge - put back to Q2 2023

Agenda items: