Product Director Report for Atlanta (Sept 2019)

This week, the HL7 and FHIR communities met for the annual Plenary WGM at the Atlanta Marriott Marquis.

Connectathon / Meeting size

The connectathon had 413 participants which is significantly bigger than our previous biggest connectathon:


A few people asked me whether the connectathon is going to get bigger than the main HL7 meeting, but that won’t happen because many connectathon attendees stay on for the main meeting, and this was also the biggest HL7 meeting ever with almost 800 participants.

I think that this is natural; as digital transformation starts to bite into the healthcare eco-system, there’s naturally and appropriately more interest in HL7 and other digital health standards organizations, given the key role digital health standards will play in the future.

The FHIR program is a broad and swiftly moving river now – there’s such a lot going on that there’s simply no way to summarize everything. Across the community, we reviewed hundreds of change proposals, discussed design paradigms, development methodology, governance approaches, and performed technical clinical testing/validation. But there’s some notable outcomes to report on.

FHIR Publishing Plan

Previous, I wrote that R5 would be expected to be published in Q3 2020. I also said that:

We will be surveying our members and partners later this year to determine whether our normal cycle is appropriate, or whether the community would prefer for us to wait longer to publish so that there can be more convergence on a single version

We will still survey our members and partners later this year, but the emerging consensus in our community who were at the meeting this week is that we’d be better to focus on quality and testing and that there’s no great need to publish in Q3 2020. At this meeting we agreed that we won’t start the publishing preparation cycle until after the next meeting (which is in Sydney in early February 2020). That means that the earliest we can publish is now Jan 2021, though we have not yet committed to that date.

The  overall R5 roadmap hasn’t changed much other than the changes to dates.

We are planning to publish a Technical Correction in a couple of weeks times which addresses a number of issues in the published R3 and R4 specifications. I’ll post about this once we release the changes.

Patient Merge

One strong theme that attracted a lot of attention this meeting was dealing with Patient Merge. This has emerged as a significant safety issue in real world implementations of FHIR, so we are seeking to provide guidance, and possibly normative standards, around how Patient merge works, and manifests on the FHIR RESTful API. IHE is also looking at publishing Patient merge related specifications, and we’ll be working with them.

The challenge here is that Patient Merge/Unmerge (or link/unlink) is a difficult challenge with all sorts of incompatible solutions deeply embedded into healthcare institutions. So it’s not going to be easy to solve, but it’s certainly very important. I’ll blog about the technical issues associated with Patient Merge in the future.

Patient Advocacy

HL7 supported ePatient Dave to attend this meeting. You can read Dave’s writings about why he’s involved with HL7 in his blog. At the request of the board, HL7 is planning to create a formal Patient Advocacy / Empowerment group to represent patient interests.

I think that this is important because while it might be true that we are all patients, we haven’t all experienced healthcare in the turns people into focused advocates. A focused group that is organised around representing patient interests is just as a good idea as separating out your governance, management and methodology.

Based on discussion this week, probable interests for a patient advocacy group might include:

  • Reviewing work products of other work groups to identify places where a patient perspective might enhance the value or success of the work
  • Engage with other work groups to provide support in the way of patient scenarios, evaluating language for accessibility, providing perspective on patient considerations, etc.
  • Developing informative guidance for patients, caregivers, practitioners and developers related to patient/caregiver facing applications, data access and use
  • Developing or assisting in the development of specifications for patient managed data (e.g. patient diaries)

If you’re interested in this activity, join us on our chat.

Clinical Genomics Changes                

Turning to a specific technical issue, the Clinical Genomics (CG) workgroup has asked to correct several canonical URLs in the terminology list:

That is, remove the trailing slashes. The trailing slashes appear to be have been introduced into the R4 spec as an editorial error.

We have approved making this change as part of the technical correction due out in a couple of weeks if we can be sure that this change will not impact on implementers by 27th Sept. If you are an implementer that uses one of these code systems, please contact Patrick Werner ASAP.

FHIR Accelerators

One really active area of development in the HL7 community is the FHIR Accelerator Program. The HL7 FHIR Accelerator Program is designed to assist implementers across the health care spectrum to work with HL7 to create of FHIR Implementation Guides or other informative documents

The current Accelerators are:

Additional Accelerators will be announced imminently.

In the future, I’ll include notes from the Accelerator projects as part of the meeting reports.

See you all in Sydney, Australia in February 2020.

FHIR R4 is published

HL7 is pleased to announce that FHIR R4 is now published.

R4 is the culmination of 18 months of extensive work to finalize the base parts of the specification, and incorporate changes and enhancement requests received from implementation partners across the world.

The most significant change in FHIR Release 4 is that the base platform of the standard has passed a normative ballot, and will be submitted to ANSI as a normative standard. This means that future changes should be backward compatible, so that applications that implement the normative parts of R4 no longer risk being non-conformant to the standard. The following portions of the standard are now normative:

  • The RESTful API, the XML and JSON formats, and the basic datatypes
  • The Terminology layer (CodeSystem and ValueSet)
  • The Conformance Framework (StructureDefinition and CapabilityStatement)
  • The key resources Patient and Observation

Thousands of other R4 updates and changes have been made in response to implementation experience and quality review processes.

FHIR Release 4 marks a significant milestone with the introduction of a normative base. This new maturity will help support our very active and growing community


Publishing a new Version of FHIR is a massive piece of work involving  a big community. It’s impossible to track – let alone acknowledge – everyone who’s contributed to publishing FHIR R4. We’ve given it a go in the credits page.

Report from 2018 September Working Group Meeting

This is the product director’s report from the 2018 September Working Group Meeting, held in Baltimore.

Ballot Status

Our focus this meeting was ballot reconciliation for the R4 milestone. We balloted R4 in 5 parts:

  • Infrastructure – RESTful API, formats, data types, etc
  • Terminology and Conformance – Profile/Extension definition framework, and Code system/Value Set
  • Patient
  • Observation
  • Everything else (‘core’)

The first 4 ballots were normative, which is an ANSI term for a full standard. That means that we’ll be more tightly constrained in the types of changes we can make – generally “no breaking changes”.

Negative comments for the Infrastructure and Patient ballots were able to be resolved without making substantive changes. However, for both Terminology and Conformance, and Observation, ballot reconciliation and editorial review led to 2 substantive changes each. As a consequence, we’ll be re-balloting a total of 4 substantive changes in an out-of-cycle ballot from Nov 6th to Dec 6th. These ballots are only on the 4 specific changes, and ballot responses may only be provided by the members who participated in the prior 2  ballots for FHIR R4 (so there’s no additional sign-up allowed during the “notification of ballot period”).   If you signed up for the Sept. ballot but did not vote, by default you won’t be able to vote in this third ballot.  However, if you’d like to be reinstated in the pool for this out-of-cycle ballot you should submit an appeal HL7 HQ.

We’ll be very strict about scope for this third ballot.  You’re free to submit feedback about the specification for consideration for R5, but we won’t be accepting any feedback for R4 as part of the ballot process other than comments specifically related to the 4 changes up for review.

Recirculation ballot: if there are any negatives that are not withdrawn from our normative ballots for the FHIR content, then HL7 will conduct a special vote amongst the members that balloted on the document to check that they will agree with the committee’s disposition of all non-withdrawn negative comments.  It provides all ballotters a chance to adjust their final vote – changing it to affirmative or negative.  The recirculation process adds 2 weeks to the publication cycle, pushing it into the Christmas period.  We’ll be talking with negative ballotters about whether they’re comfortable withdrawing their negatives votes so we can avoid this extra step if at all possible.

The final decision on pass or fail is based on the final count of votes for the final vote for each ballot grouping (Sept. for Infrastructure and Patient and Nov. for Terminology/Conformance and Observation) as adjusted by recirculation if that occurs.  If we get 75% affirmative votes, the content will pass.  If not and we pass by 60%, we have the option of publishing as STU instead.  If that doesn’t happen, then we’re faced with a brand-new ballot cycle.  We therefore encourage all of those who are part of the ballot pool to participate in the November cycle and, if necessary, the recirculation process, to ensure that the outcome reflects the will of the community.

Despite this complexity, we are still hopeful we will gain the support of the community so we can publish the final version of R4 in late December this year.

Fire Alarm

There was a fire alarm during one of the committee meeting slots. (yes- a real fire alarm, but as you can imagine, there was a great deal of joking about FHIR alarms). Here’s a photo of the FHIR-I committee demonstrating committee best practice by continuing the meeting in the park outside the hotel:park-work

Quote from Michel from Firely: “Fire will not keep us from completing FHIR!”

.. and that serves as a great example of the spirit of the whole meeting. (btw, it was a false alarm)

Roadmap planning

It’s a few years since HL7 published a road map for the FHIR specification and community. We’ll be working on this in the lead up to the San Antonio meeting in January, and I’ll be publishing a formal roadmap soon after.

We’re getting strong feedback from the market about FHIR: the potential is great, but there are plenty of deployment and adoption issues. Of course, that’s not a surprise, given what we know of the healthcare system. Part of the roadmap will definitely be focused on identifying technical barriers to adoption and working with the market participants to resolve those (through new standards, connectathons, and supporting regulatory and market initiatives).


The connectathon at the start of the meeting was our biggest ever – 286 listed participants:

connectathon progress

h/t Sandra Vance for the graph and for administering the connectathon again.

I’ve given up trying to even track the sheer variety of activities that are taking place at the connectathon – it’s a remarkable gathering of thought leaders and doers. But here’s some of the subjects that were worked on at the connectathon:

  • CDS Hooks (the biggest track, as usual)
  • Bulk Data / Data Analytics support
  • Accessing Clinical Notes from EHRs
  • Subscriptions / Application Synchronization
  • Questionnaires
  • International Patient Summary
  • Practical security of data exchange
  • Document handling
  • Evidence Based Medicine
  • Public Health case reporting
  • Clinical Research
  • … and many more

Implementation Guides

FHIR is a platform standard – a set of APIs and content models for supporting healthcare across the world. A few implementations (clinical data repositories, personal heath repositories) can use FHIR just as it is. But as soon as you start dealing with applications that depend on each other, or with clinical workflows, then you need additional agreements on top of what everyone agrees to internationally.

We call the documents that publish these agreements ‘Implementation Guides’ and they include a combination of:

  • Human readable documentation (web site) and computer readable documentation (in an NPM package)
  • Profiles and extension definitions
  • Value sets, Code Systems, mappings between code systems
  • API definitions & Choreography
  • Examples & Test Scripts (and conformance requirements)
  • Security and deployment agreements.

We’re still maturing our overall tool chain and publishing support for these documents – while we’re scaling up our ability to produce, review, and publish them. We’ve felt some growing pains around this process and we’re continuing to refine our tools and processes.

We’re going to see a lot more of these in the coming year. The September 2018 ballot included 14 implementation guides along with the core FHIR specification – and reconciliation is proceeding.

Note that publishing implementation guides is not a goal in itself; an implementation guide only has value if there’s a community that cherishes it, abides by it, and maintains it over time. One priority as we mature our processes is to ensure that this community perspective is maintained.

Personal Note

We’re just about finished publishing FHIR R4, our first with some normative content. All the signs are that it’s going to be a landmark milestone. Indeed, the opening of the HL7 WGM coincided with a pivotal blog from ONC that FHIR adoption is at an inflection point in the USA.  It’s been a remarkable ride, and I look back on it with amazement. The real strength of FHIR is not the technical spec (though I’m proud of that), it’s the community: thousands of people contribute to the FHIR community development process, many going far beyond the call of duty.

Together, we’re going to change the world.


Community Consultation: URLs vs References

In an earlier post, I asked for community for comment on changing some elements from uri to Reference:

For the conformance resources, change all elements of type uri where they will always point to a Conformance resource to type Reference(XX).  This will include changes to StructureDefinition (GF#12902)

We received some feedback, and have just revisited the issue. The feedback made it clear that there are 2 different issues on the table here:

  • When you refer to content outside the resource, must the content refer to an actual FHIR resource? or is it allowed to refer to something else (like a PDF)?
  • When you follow the reference, should you actually look it up like a URL? or should you treat it as a canonical reference and look it up by URL on a terminology service or a registry?

After considerable discussion, we agreed to make a set of changes that are much more pervasive to the specification, but actually make less change to implementations. Specifically, we propose:

  • Define two new types of URI called “canonical” and “url”.
  • canonical is an URI (IRI, URL, absolute or relative that refers to a FHIR resource by it’s canonical URL (e.g. that has a .url element). This type allows allows version (using canonical versions)
  • url is always a literal reference (used in a few places including Attachments)
  • References don’t contain canonical URLs anymore (currently this allowed)
  • Canonical works like reference in that: you can specify aggregation, targetProfile, and _include (which means that you’d see canonical(PlanDefinition|ActivityDefinition))
  • uri would still be used where the target of a reference might not be a URL. The Lookup pathway is unspecified (either canonical or literal)

The following elements would have their types changed:

  • StructureDefinition.baseDefinition = canonical
  • ElementDefinition.type.code = uri
  • ElementDefinition.type.profile = canonical
  • ElementDefinition.type.targetProfile = canonical
  • ElementDefinition.constraint.source = canonical
  • ElementDefinition.binding.valueSet[x] = canonical, uri
  • CodeSystem.valueSet = canonical
  • CodeSystem.supplements = canonical
  • ValueSet.include.valueSet = canonical
  • ImplementationGuide.package.resource.source[x] = [think about it]
  • ImplementationGuide.package.resource.exampleFor = canonical
  • = canonical
  • CapabilityStatement.instantiates = canonical
  • CapabilityStatement.implementationGuide = canonical
  • = canonical
  • = canonical
  • = canonical
  • = canonical
  • = canonical
  • CapabilityStatement.messaging.supportedMessage.definition = canonical
  • CapabilityStatement.document.profile = canonical
  • SearchParameter.derivedFrom = canonical
  • SearchParameter.component.definition = canonical
  • OperationDefinition.targetProfile = canonical
  • OperationDefinition.binding.valueSet[x] = uri | canonical
  • OperationDefinition.base = canonical
  • OperationDefinition.inputProfile = canonical
  • OperationDefinition.outputProfile = canonical
  • OperationDefinition.param.binding.valueSet = uri | canonical
  • QuestionnaireResponse.questionnaire = canonical
  • Questionnaire.derivedFrom = canonical
  • Questionnaire.options = canonical
  • MessageDefinition.base = canonical
  • MessageDefinition.parent = canonical
  • MessageDefinition.replaces = canonical
  • MessageDefinition.focus.profile = canonical
  • MessageDefinition.allowedResponse.message = canonical
  • GraphDefinition.profile = canonical
  • = canonical
  • Meta.profile = canonical
  • ExampleScenario.workflow = canonical
  • ConceptMap.source[x] = uri | canonical
  •[x] = uri | canonical
  • ConceptMap.unmapped.url = canonical
  • TerminologyCapabilities.expansion.definition = canonical
  • TerminologyCapabilities.expansion.profile = canonical.

(note that this list only includes changes to infrastructure resources – other resources will also be affected)

Given that this is the second consultation on this issue, and that time is running tight, we’ll only open this consultation for a week – comments must be in by CoB Monday 26th February

Report – January 2018 meeting + Community Consultation

The January HL7 WGM was held last week in New Orleans. I found this a very laid back and cool meeting – perhaps it was a New Orleans thing? I’m sure that the HL7 Parade helped – but we did get plenty done – connectathon, ballot reconciliation, clinicians on FHIR, planning for normative, and more.

Girls on FHIR

We had really cool swag this meeting:


That’s a riff on a Hunger games t-shirt, and also a way for us to celebrate our many female contributors, though we didn’t want to leave the guys out – they could get the same t-shirt with “HL7 on FHIR” on it.

Ballot Outcome / Normative FHIR

The first ballot in the release 4 cycle for FHIR closed just before the HL7 meeting. We had excellent participation for a draft-for-comment ballot: 40 affirm, 81 negative and 51 abstain (for those not familiar with HL7 balloting, those are pretty good numbers, and we would expect most of the negatives to be withdrawn, though that’s not actually required for draft-for-comment ballot).

There were plenty of line items (319) – including a number that focused on Normative process issues, and some that caused significant debate.

The main take-away from the meeting is that we expect the normative ballot to go ahead as planned, though we are taking the opportunity to do some formal consultation around a few contentious issues – see below.

Clinical Notes

There was plenty of discussion at the meeting about how to best represent ‘Clinical Notes’ in FHIR. One of the problems with this is just what is a clinical note? there’s such a wide array of meanings for ‘clinical note’ from a few sentences written into a record, to a carefully constructed narrative letter to a fellow clinician, through to a fully structured
data rich transfer of care.

It’s clear how some of these things are represented in resources, but not all of them, and there’s no single coherent picture – though it’s not clear whether there should be. We had a lot of circular discussion, and we didn’t come to any strong conclusions, but we did agree that we will construct a connectathon track around this question to further investigate the optimal solution.


We’re seeking comments about how to understand record keeping around the relationships between mother and child. The health, treatment, and records of mother and child are deeply linked, but there is real variation between jurisdictions and institutions about how privacy is maintained, and how the links are represented. There’s some previous work in HL7 on this, and in other organizations – we’ll be revisiting
this subject, and seeking comment, and making a proposal for how these links should be represented in FHIR Resources.

Community Consultation

There are 4 items for which we are seeking community consultation on the basis that they represent breaking changes to FMM4-5 level artifacts. Comment is sought from anyone who has implementations that are impacted by the following changes.

Note about this: if we’ve gone to the trouble of making breaking changes and then seeking feedback about them, you should assume that they are potentially pretty significant, and investigate. Don’t regret not paying attention later.

Note also that we could just ballot these as part of the normative ballot, and call that the formal consultation, but we’d rather get comments on them immediately in case they change our mind about what to take to ballot.

Please submit formal feedback to by CoB Friday 23rd Feb. (or join discussion at

1. Removal of default values

A series of gForge tasks and ballot items related to the practical implications of missing values, and in particular default values. After long discussion at the New Orleans meeting (3 whole quarters!) we propose to make the following changes prior to ballot:

  • Remove ElementDefinition.defaultValue[x]
  • Clarify that ElementDefinition.meaningWhenMissing should only be documented when it says something of substance
  • advise committees not to create models where meaningWhenMissing is important (where possible)
  • Committees will review elements that currently have default values with a view to making them mandatory

This actually has fairly far reaching impacts. To help reviewers, here’s the current list of elements
that have a default value assigned:


… quite a lot, as you can see. This is a significant change. GForge task 15121

2. Addition of Reference.type

The FHIR-Infrastructure committee has decided to bring back an element that we removed very early in the FHIR process: Reference.type, it will be a code, bound to ResourceType, with a cardinality of 0..1. If present, it has to be consistent with the actual reference. Adding Type like this may have unexpected consequences, so while this isn’t strictly a breaking change, we want to seek opinions on this. GForge 13543

3. Removing Patient.animal

We have received a few items of feedback regarding the inclusion of the animal part of the Patient resource which the Patient Administration workgroup would like some additional feedback from the FHIR community prior to making a final decision for the normative definition of Patient.

There is no argument that the animal component is not part of the 80% (as per normal FHIR guidelines) and has been an intentional exception to the rule, the desire being to make a definitive statement that veterinary usage is a part of the scope of FHIR.

Most systems will either be all human, or all animal (veterinary), and not both. However systems like lab and pharmacy do handle both human and animal content.

So what’s the issue then?

  1. The Patient resource is going normative, and this part of the resource has not been adequately tested/verified with real systems (which is a part of the FMM progression scales)
  2. The current backbone element is marked as a modifier element, which isn’t a modifier like anywhere else in FHIR. Other properties that are modifiers impact how to interpret the resource itself. For Patient, it impacts how you might interpret other resources.
  3. Patient Administration is missing feedback from the many sides of veterinary – domestic and agricultural. The content we currently have appears to satisfy the domestic side of things (pets etc) but not clear how this would work with herds or exotic species.

Resources: GForge Tasks: 14880 Move Patient.animal to a standard extension and 14393 Patient.animal needs a meaning when absent &  Discussion

4. URLs vs References

We previously sought comment about gForge task #12902. Feedback from implementers has caused us to revisit this proposal again – look out for a post about this on my personal blog.

FHIR R4 Ballot & Community Consultation

The first of the R4 ballots is about to open. This is an important release cycle for the FHIR Communtity: it’s the first normative ballot cycle, and some of the FHIR content will be balloted as normative. Notes of interest:

  • This particular ballot is the first of three ballots to lead to the normative parts of R4
  • Once the parts finally become normative, there can be no breaking changes in those parts (well, it’s kind-of possible, but it takes multiple cycles and years)
  • Any substantive change during ballot reconciliation requires reballot – therefore committees balloting normative content will be highly motivated to refuse proposals for change
  • After this draft for ballot, there is no way to change what is selected to be balloted as normative or not for the rest of this cycle, nor to make substantiative changes to it

So we are looking for good review on this draft for comment ballot on the following things:

  • What content has been selected for normative
  • How the normative status is presented (clearly, hopefully)
  • The technical content of the normative material
  • Any suggestions for content that needs further implementation experience in the next few months

If you want to join in, and you haven’t already signed up, well, the ballot sign-up closes today. If you missed out, you can still comment through gForge.

Here’s some of the significant changes that have come with the introduction of normative content:

  • Every page has a clearly marked status now
  • There’s colors and markers for status (see here, herehere, and here for examples)
  • The ballot introduction explains the division of the FHIR specification into different packages, and the concept of ‘mixed status resources’

Along with the publication of the First R4 ballot, it’s time to do another round of consultation about proposed breaking changes to FMM4/5 content – almost all of which is slated to go normative in R4. Here’s a list of the change proposals:

  1. Include the PractitionerRole as an alternative target type for the Patient.generalPractitioner reference (GF#14224)
  2. Change the URL of the brithplace extension from ‘’ to (GF#12974)
  3. Change ElementDefinition.type.targetProfile from 0..1 to 0..* (GF#12465)
  4. For the conformance resources, change all elements of type uri where they will always point to a Conformance resource to type Reference(XX).  This will include changes to StructureDefinition (GF#12902)
  5. Add ElementDefinition.isModifierReason (0..1 string)  and possible replace .isModifier (GF#13065)
  6. Rename OperationDefinition.parameter.profile to OperationDefinition.parameter.targetProfile (to be consistent with ElementDefinition) (GF#13561)

If you’re an implementer who is affected by one of more of these changes, and you want to express an opinion, then send an email about the change to, describing your implementation, how the change impacts on you, and your opinion on it. Notes that some of these are pretty arcane things only of interests to a few toolsmith type people, so if you don’t know what they, that’s not a problem. Also, strictly, #2 is not a FMM=4+ change, but the PA work group wanted to seek opinions anyway. Given where we are in the ballot cycle, and holidays etc, this comment period is open until Friday Jan 26 (noon Eastern) – close in time for the HL7 Workgroup meeting.

Btw, outcomes from the last round of consultations:

  • Renaming ValueSet.compose: Community input was negative, and the committee didn’t make the change (we’re going to rename $compose instead)
  • Use of Observation.related and types: Community input was muted but leaned positive, and the change is included in this ballot publication
  • Adopting GitHub Flavored Markdown: community input was positive, and this change will be adopted (but hasn’t been applied to the specification and tools yet)




Proposed Breaking changes for FHIR R4

According to the FHIR maturity model that is part of the FHIR development process, we must consult the community if we are going to make breaking changes to artefacts that are labelled level 4 or 5 maturity (though there’s some lack of clarity as to what exactly is a breaking change, and what the right process should be).

At the recent meeting in San Diego, a number of breaking changes to maturity 4/5 resources were proposed, and we are seeking feedback on these:

  • Rename ValueSet.compose to ValueSet.definition (Vocab)
  • Question on the use of related types with Observation (OO)
  • Proposal to adopt GitHub Flavored Markdown (FHIR-I)

In addition, while we are consulting, we are seeking feedback on an additional change:

  • Proposal to remove ImagingManifest (II)

Each of the changes is described below, along with the proposed justification. If you have already implemented systems that will be impacted by these changes, and you’d like to have your say, please send an email to by Friday 20th October that details your implementation, the impact the change will have, and your opinion about the change.

Note: if you don’t have an actual implementation, and you still have an opinion, we’d still like to hear it – you can let us know through one of our normal channels (see

Renaming ValueSet.compose

ValueSet.compose is a verb — “compose the value set this way”, but that’s not language that connects with the wider community as well as ValueSet.definition would – “this is the definition of the value set content” (which is the “Content Logical Definition”) in the Vocab work group’s wider value set work). Also, ValueSet.definition matches ValueSet.expansion grammatically. Finally, ValueSet.compose overlaps in name with the $compose operation.

For these reasons, the work group would like to rename .compose to .definition. There’s no other semantic changes – it’s just a straight rename, to reduce confusion.

Note that ValueSet is planned for normative in R4 – there won’t be any other chance to make this change.

Use of Observation.related and types

Are you using Observation.related? how? The Orders and Observations Work considering removing .related and replacing it with:

  • member : Observation 0..*   type: Reference(Observation)
  • derived: Observation 0..*  type: Reference(Observation)

The other things related does would be relegated to extensions, or to the Provenance resource. The task proposing this (GForge #10118) was discussed at the Sept WGM by the Orders and Observations Work Group and is the direct result of internal FHIR methodology review and discussion which resulted in a proposal to substantially change the .related structure. This would simplify the structure of Observation, but the OO work group has been hesitant to make a significant change without meaningful implementer input.

Because our past attempts to get implementer feedback by reaching out to the FHIR community did not result in any response, the work group has deferred this tracker several times. As the Observation resource approaches normative status, there is increasing concern regarding making substantive changes. Implementer feedback is sought regarding whether that perceived benefits of this proposal is outweighed by the costs it imposes on implementation.

Adopting GitHub Flavored Markdown

Currently, the markdown data type specifies that the content is Gruber’s original markdown syntax, with an STU note soliciting feedback about adopting CommonMark instead. Feedback on this has generally been in favor of adopting commonmark, except that it doesn’t support tables, and it allows raw HTMlL. The community has indicated a strong preference for GitHub Flavored Markdown (GFM), and we propose to adopt this as a replacement. Note that the table extension in GFM are likely to find their way into commonmark, which would mean that we’d be using CommonMark with a profile that says ‘no HTML’

In practice, this will mean updating some existing code – e.g. a different markdown processing engine, and different generation, though the markdown syntaxes are somewhat compatible, and markdown degrades gracefully anyway.

Note, again, that the markdown data type is slated to be normative next time, so there’ll be no more opportunity to make this change. (though we could settle for pure CommonMark if the GFM extensions are brought into CommonMark – that would be a non-substantiative change). For further discussion, see

Proposal to remove ImagingManifest

The II committee (joint between DICOM and HL7) would like to remove the ImagingManifest resource. It’s a little hard for most implementers to differentiate between ImagingStudy and ImagingManifest, and the DICOM use cases for which ImagingManifest was defined (XDS-I) have been replaced by MHD-I which uses WIA (Web Image Access), leaving the use case for ImagingManifest somewhat obscure.

Hence the proposal is to remove ImageManifest and ensure that ImagingStudy can meet the identified needs.

Note that this is not a change that affects a maturity >=4 resource, so community consultation is not needed. However the committee asked for wider feedback. For further discussion, see

FHIR Product Director’s Report from 2017 Sept (San Diego) Meeting

Last week, the HL7 and FHIR communities met for the annual Plenary WGM. This time, the meeting was held at the Hyatt Regency La Jolla, which was a great facility for the HL7 meeting. Thanks to Mary Ann Boyle, who’s taking over from Lillian in organizing the WGMs – they are a big event to organize.

HL7 Formal Strategy

The HL7 Board announced its core strategic goals during the Plenary session:

  • Enhance the public image and achieve recognition by stakeholders as the leading SDO for worldwide health data interoperability standards
  • Secure long-term sustainable revenue to realize the vision and improve customer experiences (internal and external)
  • Establish FHIR as the primary standard for global health data interoperability
  • Enhance and maintain quality of and accessibility to HL7 standards in current use

With regard to the FHIR specific goal, the board provided these strategic objectives:

  1. Increase understanding of FHIR usage and value of usage worldwide (Immediate)
  2. Achieve symbiotic link of brand and financial benefit between HL7 and FHIR.(Immediate)
  3. Demonstrate the value of FHIR in enabling interoperability (Midterm)
  4. Ensure resources are most effectively focused to enhance FHIR (Midterm)

As you can see, FHIR is front and center… I guess we’re all going to be busy in the coming year making this strategy a reality. At a later time I’ll blog about how we can realize these goals.

FHIR Foundation

The FHIR Foundation is now ready to take members. You can sign up here. The annual fee for individual members at this time is US$250. For that, you get:

  • The knowledge that you’re helping maintain the viability of the FHIR ecosystem
  • Access to the Product Director’s monthly report summarizing the FHIR community progress
  • Access to member’s forum (discuss future of the FHIR Foundation)
  • Access to the member’s market place where job/contract opportunities are
    publicized (and these are starting to flow)

We’ll be adding new additional benefits in the future, as discussed with members. We’re hoping that individual memberships will cover the basic year to year costs of keeping the FHIR Foundation viable (legal/accounting fees etc).

The FHIR Foundation isn’t yet ready to open for organizational members, but it’s our intent that we will be soon. We believe that any company or institution selling services related to FHIR (consulting, middleware, implementation tools etc) will want to be part of the FHIR Foundation, and we’re working on services related to  that now. Note that this is not the same as providing healthcare services using FHIR interfaces, though of course we’ll be building membership benefits for those kind of organizations too.

One again, the FHIR Foundation thanks Google for providing the cloud infrastructure on which the services are hosted.


The meeting started with the biggest connectathon we’ve had to date – we had over 218 attendees. It’s become clear that we need to rework the way connectathons are managed – we need more organization and more preparation, as they continue to grow. With that in mind, we’ve asked whether anyone is interested in taking on a formal role as the event organizer (If you’re interested, contact me directly).

There were 22 proposed connectathon tracks for this connectathon. At least 2 of them didn’t get enough participants to get off the ground when it came to it, but most did. Each track provided a very brief summary presentation of outcomes, some of you can find in the links below.

As always, the connectathon is very important to us as a way to validate how the specification works. We will continue to add new streams as our community interests broaden. I plan to blog about some of the streams individually, and some streams have already blogged.

Reports and Blogs:

Clinicians on FHIR

The meeting closes with the Clinicians on FHIR event, where we engage Clinicians by working with ClinFHIR to record real clinical cases with the purpose of identifying gaps or deficiencies in the FHIR specification. This was our 10th event. The organizers of the CoF are developing processes to more clearly document clinical scenarios, testing, and feedback to the FHIR development process, and as part of that, we held a new breakout session for Beginners to help get them up to speed on the process.

The Clinicians on FHIR is another important way for us to validate how the specification works.

SMART App Launch Ballot

The Smart App Launch Specification was balloted in the lead up to this meeting. We received plenty of ballot comments, which is great. We’re confident that we’ll be able to publish the first STU for this specification later this year. Most of the comments related to clarification and clarity in the specification, though we’ll be noting some open issues to work on for future versions of the specification.

Community Consultation

Part of the FHIR Maturity Process is that once an artifact is at level 4/5, breaking changes require formal community consultation. In the next week, I’ll be issuing requests for comment on (at least) the following breaking changes:

  • ValueSet.compose, rename to ValueSet.definition (Vocab)
  • Question on the use of related types with Observation (OO)
  • (II) Proposal to remove ImagingManifest
  • (FHIR-I) Proposal to adopt GitHub Flavored Markdown

Notifications on these will be provided in the following places:

Normative Plans

Overall, our plans are unchanged from last time, though we’ve clarified the
time lines. High points:

  • Draft for comment, Dec/Jan: lining up for ballot
  • Mixed normative/STU, Apr/May: Main normative ballot
  • 2nd Normative + STU, Aug/Sept: 2nd chance ballot
  • Publication Mid-Dec

Those are pretty firm deadlines – we’ll slip normative content back to STU rather than hold up the timeline, since various jurisdictions and consortium initiatives are synchronizing their timelines to this (though HL7 can never provide any firm promises in this regard – we have to follow our processes)

A few additional resources are being considered candidates for normative. Last call for comments about which resources should be candidates will be in November (watch this space). After the draft for comment goes out, resources can be dropped from the normative list, but not added.

Bulk Data

The US ONC has asked to work on adding new capabilities to the FHIR specification to increase support for API-based access and push of data for large number of patients in support of provider-based exchange, analytics and other value-based services. This is a high priority work item for them this year. See write up of plans for further information regarding our proposal – this should lead to a connectathon track at HL7’s January meeting in New Orleans, at which all are welcome.

Tooling EcoSystem

The FHIR tooling ecosystem is starting to fill out quite nicely. In particular, the FHIR registry is now entering pilot mode. Please feel free to use, and (for now) provide feedback through

We’ve been working on documenting the tools we have and need – see the HL7 wiki for further information. This is still draft work, and we’re looking for further feedback and community participation.


The FHIR Proficiency Certification process was trialed at the San Diego meeting. So far, preliminary results show that we’re broadly on the right track. We still plan to have the certification fully available for the January meeting in New Orleans. Congratulations to

Yunwei Wang, IMO

who was the first person to pass the certification. Intending candidates should note that the test aims to ensure that you are familiar with the scope and shape of the full FHIR specification. Knowing the RESTful API and the resources is not enough for proficiency certification (people who know this stuff well from the connectathons/other implementations will still need to read up on the rest of the specification – terminology, intent, licensing, maintenance procedures, etc).

New Areas for the specification

The HL7 technical committees are taking up new areas of functionality and
adding them to the FHIR Specification as draft/STU for the forthcoming
release 4:

  • Public Health Case Reporting and Reportability Responses (PHER)
  • Occupational Data for Health (PHER)
  • Laboratory Test Catalog (OO)
  • BiologicallyDerivedProduct ( blood transfusion, and hematopoietic cell transplant material.) (OO)
  • Medical Device Nomenclature/Vocabulary Service (Dev)
  • Insurance Plans (FM)

If you’re interested in any of these, please get in contact with the relevant committees.

Forthcoming Events


FHIR Release 3 Posted

HL7 is pleased to announce that Release 3 of FHIR has just been published.

The FHIR community invested a huge amount of work in this release – hundreds of people have contributed to the specification, and there have been thousands of Change Proposals processed (>2400). Most of these change proposals arose from 3 different places:

  • Implementation Experience (Trial use is working)
  • Alignment with other standards
  • Internal Quality Review processes

Some of the key changes:

  • Added support for Clinical Decision Support and Clinical Quality Measures
  • Broadened functionality to cover key clinical workflows
  • Further development of Terminology Services, and support for Financial Management
  • Defined an RDF format, and how FHIR relates to Linked Data
  • Incremental improvements and increased maturity of the RESTful API and conformance framework

The FHIR specification is very much the living record of the community of users who share the experience of trying to solve problems with it. It’s getting ever more difficult to provide meaning recognition to all the people and organizations who contribute. Still, we’ve tried – see the FHIR credits page.

In addition to FHIR Release 3, today we’ve also published the first release of the US Core Implementation Guide. This generalizes the lessons of learnt through the Argonaut process, and publishes the agreements as a base profile for all use of FHIR in the US context. ONC and other (e.g. HSPC) implementation guides will build on this, and the Core Implementation Guide will provide a general base for consistency across all these contexts.

We expect that the FHIR specification will continue to evolve in the future as we responds to the interoperability needs of the robust FHIR implementation community. Our priority is to advance the well tested platform parts of the FHIR standard to a full ANSI-approved normative standard. I will post more about this later.


FHIR Product Roadmap January 2017

R3 plans

The FHIR project is presently finalising “STU3” (Standard for Trial Use, release 3). This 3rd major milestone is currently close to completion. We’ve been meeting in San Antonio this week to finalise ballot reconciliation, perform testing and quality activities, and we are now focusing on preparing the final publication package. Following our publication plan we expect to be publishing release 3 on or about Mar 20.

R4 plans

Once R3 is published, we will start working on release 4. The various committees that manage the different parts of Release 4 have been discussing their scope of work for R4, and planning their engagement and implementation activities to support that this week.

Some of the major things under consideration for Release 4:

  • Improvements across all domains
  • Cds-hooks integrated in FHIR Specification
  • Query language framework
  • Support for integrating research and clinical practice

The most significant change is that R4 is expected to be the first ‘normative version’. It’s important to understand what that means. We will continue to follow our overall maturity model, where content gradually matures through testing and implementation activities that demonstrate success in the real world. The end of the process is “normative” (“FMM level 6”), where the standard becomes stable, and breaking changes are no longer considered.

Only some portions of the specification are candidates for being normative. We are currently considering balloting the following parts of the specification as normative:

  • Infrastructure (API, data types, XML/JSON formats, conformance layer resources like StructureDefinition and ValueSet)
  • Administration (amongst others Patient, Organization, Practitioner)

We will continue to seek and receive comments about this. Some clinical resources may be considered, depending how implementation experience unfolds this year.

Overall planned R4 timeline:

  • Dec 2017: publish first draft of R4 for comment (finalise plans for normative sections)
  • Jan 2018: first R4 based connectathon(s)
  • April 2018: ballot R4
  • May – Sept 2018: ballot reconciliation
  • Oct 2018: publish FHIR R4

We will conduct a round of market consultations in Aug/Sept 2017 to seek comment on this timeline from the FHIR community.

Note that this timelines anticipates that we publish R4 in October 2017 irrespective of the outcome of the normative ballot. Anything that has not passed normative ballot will continue to published as STU. We are still working on preparation, quality and balloting processes to support the normative FHIR ballot.

Longer term, we anticipate following R4 with a roughly 18 month publication cycle, with increasing normative content.

Implementation Progress

FHIR is a specification for a common API for exchanging healthcare data between information systems. Any information system supporting the healthcare system can choose to implement the common API, and exchange data following the rules. FHIR enables a ‘healthcare web’ to exist, but doesn’t actually create it.

HL7 is pleased to work on the FHIR specification with many hundreds of partners, who are all implementing the specification to exchange data in service of the healthcare needs to their enterprises, their customers, and, ultimately, patients. HL7 does not ‘implement’ the specification (other than various prototype/test services) – our partners and other healthcare services do.

Argonaut Project

One particularly important sub-group of the FHIR community is the Argonaut project, which is a joint project of major US EHR vendors to advance industry adoption of FHIR and we’ve had many questions about the Argonaut implementation timeline for EHR access. With regard to the Argonaut community:

  • The Argonaut STU2 specification for Common Clinical Data Set elements is close to being finalized and will be announced shortly.  The Argonaut STU3 specification for Provider Directory will be published after final balloting of STU3
  • Most Argonaut members who are certifying an API with ONC are using the Argonaut specification; most certifications are expected in Q1/Q2 2017
  • Software roll-outs have commenced — progress will vary depending on the vendor
  • It is presently unknown what the adoption rate by provider institutions will be — MU and MACRA in the US provide incentives to make a patient-facing API available by the end of 2017
  • Some of the Argonaut interfaces provide additional functionality not yet described in the Argonaut specification, but there is considerable appetite for additional services beyond what is currently available. The Argonaut project will be making announcements about its future plans shortly which will be announced in a press release, through collaboration channels, and at