Share this page:

Health Level Seven International (HL7)
Keep up to date and get involved in the latest from HL7 International, the HL7 Canada Constituency, the HL7 Canada Council, and the pan-Canadian messaging standards.
Members: 292
Contact: Joel Francis
Type: Open
Access: Public
Keep up to date and get involved in the latest from HL7 International, the HL7 Canada Constituency, the HL7 Canada Council, and the pan-Canadian messaging standards.

About


What is the HL7 Community?

The HL7 Community is a place to share lessons learned and learn about new and existing HL7 Standards implemented in Canada, such a version 2, version 3, CDA and FHIR.

This community is where requests to make changes to any of the pan-Canadian messages occur and where implementers come for OID requests in Canada or find Canadian OIDs in the HL7 OID Registry.

Canada is proud to have a thriving HL7 Canada Constituency and actively participates in HL7 Ballots.

To become a member of this community select Join Group in the Group Menu.

LEADER

Ron G Parker, Chair, HL7 Canada Affiliate

Co-Chair, HL7 International Council

KEY RESOURCES

HL7 Artifacts (Standards, Release notes, Education etc)

Activity

Bradley Brazill joined a group
Logo
Keep up to date and get involved in the latest from HL7 International, the HL7 Canada Constituency, the HL7 Canada Council, and the pan-Canadian messaging standards.
Cross-post - StatCan has just shared the following information and is seeking input on their metadata standard. I would encourage you and your organizations to participate in this very important consultation. Link to participate .... "(le français suit) Hello, Statistics Canada is working on addressing information gaps on Canada’s LGBTQ2+ population, and is updating and developing metadata standards (definitions and categories of a concept) to better respond to the information needs of LGBTQ2+ communities. In response to this data need, Statistics Canada invites you to provide feedback on the proposed updated gender and new sexual orientation and LGBTQ2+ standards. These will enable Statistics Canada to publish more data about diverse groups of Canadians, and provide evidence for policy and program planning and evaluation. For more information and to review the standards, please access the following link: ... Feedback on the proposed standards can be provided by email in English or French to statcan.csds-lgbtq2-cnsd-lgbtq2.statcan@canada.ca. In your response, please include your name and your organization (if you are proposing changes on behalf of an organization). The consultation is open until March 12, 2021. We encourage you to share this information with your colleagues and contacts who would be interested in providing feedback. Thank you. Bonjour, Statistique Canada cherche à combler les lacunes statistiques sur la population LGBTQ2+ et à mettre à jour et à développer des normes de métadonnées statistiques (définitions et catégories d’un concept) pour répondre davantage aux besoins en information sur les communautés LGBTQ2+. En réponse à ce besoin en matière de données, Statistique Canada vous invite à nous transmettre vos commentaires sur la mise à jour proposée sur la norme sur le genre et les nouvelles normes relatives à l’orientation sexuelle et au statut LGBTQ2+. Vos commentaires permettront à Statistique Canada de publier plus de données sur divers groupes de la population canadienne et de soutenir l’évaluation et la planification de politiques et de programmes. Pour plus d’information sur la consultation et pour participer à la révision des normes, veuillez cliquer sur le lien suivant : ... Les commentaires sur les normes proposées peuvent être envoyés par courriel en français ou en anglais à statcan.csds-lgbtq2-cnsd-lgbtq2.statcan@canada.ca. Tous les commentaires doivent inclure votre nom et celui de votre organisation (si vous proposez des changements au nom d’une organisation). Cette consultation est ouverte jusqu’au 12 mars 2021. Nous vous encourageons à partager cette information avec vos collègues et vos connaissances qui seraient intéressés à participer à cette consultation. Merci. Tina WL Chui, Ph.D. Director |Directrice Diversity and Sociocultural Statistics |Diversité et Statistique Socioculturelle Statistics Canada |Statistiques Canada Telephone | Téléphone: 613-854-5269 Cory Chobanik Director | Directeur Centre for Statistical and Data Standards | Centre des normes en matière de statistiques et de données Statistics Canada | Statistique Canada Telephone | Téléphone: 613-697-2974 Laurent Martel Director | Directeur Centre for Demography | Centre de démographie Statistics Canada | Statistique Canada Telephone | Téléphone: 819-962-6800 "
Karla Ortiz joined a group
Logo
Keep up to date and get involved in the latest from HL7 International, the HL7 Canada Constituency, the HL7 Canada Council, and the pan-Canadian messaging standards.
Bryan Dearlove joined a group
Logo
Keep up to date and get involved in the latest from HL7 International, the HL7 Canada Constituency, the HL7 Canada Council, and the pan-Canadian messaging standards.
Hello everyone: Sorry for the delay in posting this, the past week was extremely busy. Attached is the.... Featured in this presentation deck: - an update on accessibility updates to Simplifier.net - updates on available HL7 online training - a report on the Jan 2021 HL7 Virtual Working Group meeting, featuring links to videos and presentations to the General meeting sessions, as well as video links to a large number of record Working Group sessions on a variety of topics. Also featured, are brief cameo shout-outs by celebrities. Download the file and just click on the red Click buttons on the screen. Enjoy! Ron P. HL7 Canada Affiliate Chair.
Some time ago, HL7 International started charging a $100 USD fee for registering OIDs in their registry. In January 2018, this fee jumped to $250 USD. As of January 2021, the fee to register an OID with HL7 directly is $500 USD. Infoway as the HL7 Canada delegated organization is able to register OIDs for free and is passing that ability on to its members. If you have a public OID that you need to register, you should take advantage of your InfoCentral account and register it through Infoway. To register an OID, the member fills out an OID registration form. There is one flavour of the registration form for Code Systems and one for Identifier types. You then submit the registration form to this forum and the HL7 Canada Community will review and QA the request. If appropriate, an Infoway SME will then register the OID with HL7. The turnaround time is 5-7 business days with HL7 and once HL7 has finalized the OID, it will be returned to the requester. This is a fairly simple process so take advantage if you have an OID you need to register! There is an InfoCentral page around OIDs: InfoCentral Home page > Tools > ... The page contains the registration forms, the guidance on registration as well as some very good links to other OID information.

Events



Upcoming events:
Tue Apr 06 @12:00PM - 01:00PM
HL7 International Canada Community Meeting
Tue May 04 @12:00PM - 01:00PM
HL7 International Canada Community Meeting
Tue Jun 01 @12:00PM - 01:00PM
HL7 International Canada Community Meeting

Forum

Cross-post: StatCan Sex-Gender Metadata (about the data) Standards Consultation - Open to March 12, 2021 02/12/21
Cross-post - StatCan has just shared the following information and is seeking input on their metadata standard. I would encourage you and your organizations to participate in this very important consultation. Link to participate .... "(le fr...
HL7 Canada Community Feb 2nd Call Presentation 02/08/21
Hello everyone: Sorry for the delay in posting this, the past week was extremely busy. Attached is the.... Featured in this presentation deck: - an update on accessibility updates to Simplifier.net - updates on available HL7 online train...
Need to register an OID for your HL7 project? Do it with Infoway! 02/05/21
Some time ago, HL7 International started charging a $100 USD fee for registering OIDs in their registry. In January 2018, this fee jumped to $250 USD. As of January 2021, the fee to register an OID with HL7 directly is $500 USD. Infoway as the HL7...
Advance Notice - Ontario Health | ONE Access Viewlet Framework – Developer Guide + Ontario Context Management System FHIR Implementation Guide 01/14/21
Reminder to the Community: The Provincial Review period for the Ontario Health ONE Access Framework Developer Guide and Ontario Context Management System FHIR IG closes in one week on January 21st. Please contact us at: ... if you would like to pa...
Participate in the HL7 Canada Election for Two New Positions 01/07/21
Hi Sheridan, great to see you offering here, this is much appreciated! Ron P.
Participate in the HL7 Canada Election for Two New Positions 01/07/21
Hi Harsh, and thanks for this. Ron P.
Participate in the HL7 Canada Election for Two New Positions 01/07/21
Name: Sheridan Cook Home City: Toronto, Ontario (Halifax, NS later this year) Employer: Gevity Consulting, Inc. Nomination: Private Sector Representative Qualifications & Aspirations for HL7 Canada Council: I'm a FHIR iGuide author (US & CA...
Participate in the HL7 Canada Election for Two New Positions 01/06/21
Hello, I would like to self nominate for the public sector member at large position. Note: There is an issue while attaching the form to this forum. I have copied the content here. If required, I can forward the form to Infoway via email. Please...
Participate in the HL7 Canada Election for Two New Positions 01/04/21
Happy New Year everyone, This is just a reminder that the nomination period for the 2021 HL7 Election begins today and closes on Jan 17th. For details on nominations and the election process, please review earlier posts in this topic. Best Reg...
Download Package for HL7 Intl Jan 2021 Ballot Cycle Now Available 12/28/20
Hello HL7 Intl Canada Community: The ballot documentation and comment spreadsheets for the upcoming HL7 Intl Jan 2021 Ballot has been posted ... on InfoCentral. In this compressed folder (ZIP file) there is an Excel file that acts as an index...
International Patient Summary (IPS) and upcoming HL7 Connectathon 12/16/20
There is an International Patient Summary Track at the upcoming ..., Jan 13-15, 2021. I’m wondering if there are any issues/questions regarding IPS that anyone in the Canadian community would like brought up during that Connectathon. Also, I’m wo...
Dec 1st 2020 HL7 Intl Canada Community Meeting Presentation 12/01/20
Hello everyone. Here is the link to today's HL7 Intl Canada Community ... There are some links in here to: HL7 Canada Council Member Nomination Form HL7 Canada Council Terms of Reference HL7 Jan 2021 Ballot Item Descriptions For...
Participate in the HL7 Canada Election for Two New Positions 12/01/20
Hi Katie, There is no reason why a graduate student cannot run for election. The only requirement that must be met is that the nominated person SHALL have paid the HL7 Canada membership fee. Please review the document referenced in the origina...
HL7 Canada Community Call - Agenda and New Call Coordinates 12/01/20
Good day everyone. Here is the agenda for today's HL7 Intl Canada Community Call: Upcoming HL7 Canada Council Elections HL7 Jan 2021 Ballot HL7 JIRA Balloting testing underway HL7 Board Organizational Refresh Task force update O...
Participate in the HL7 Canada Election for Two New Positions 12/01/20
Hi Joan, I'm wondering if graduate students are permitted to run (if they have adequate experience)? Thank you, Katie

Tasks


Tasks


Time Tracking


Gantt

Documents

Click Manage documents to:

  • view the complete list of documents or documents grouped by folder
  • upload a new document

Note: Group members are not currently notified when new documents are added. To notify others, you must post the URL to the new document in the forum. (Notification of document uploads is a feature in development.)

Manage documents You may need to login and/or be a member of the group to access this content.

Canadian Core Profiles ( 20 Documents )

Community Presentations ( 14 Documents )

HL7 Canada Council ( 40 Documents )

HL7 Reports ( 4 Documents )

Implementation ( 9 Documents )

Documents for implementers of HL7 v3. For context, see HL7 standards page.

Meeting Presentations ( 42 Documents )

Presentations relative to a specific HL7 Community meeting

OIDS ( 9 Documents )

Terminology ( 7 Documents )

Identifier OID Registration Form_ShoppersDrugMart_Type4

Published on Oct 07, 2020 by Vania Granese

Identifier OID Registration Form for ATLAS Alliance

Published on Oct 04, 2020 by Vania Granese

Identifier OID Registration Form Aware MD

Published on Sep 03, 2020 by Vania Granese

HealthcareProviderRoleType Request August 2020

Published on Aug 19, 2020 by Anil Patel

Simplifier.net Long-Term Requirements and Guidelines

Published on Apr 07, 2020 by Joel Francis

Identifier OID Registration Form - QHR

Published on Mar 06, 2020 by Vania Granese

HealthcareProviderRoleType Feb 2020 Request

Published on Feb 28, 2020 by Anil Patel

Video

The PrescribeIT Stack: Implementation

Learn more about the resources and support available to PrescribeITTM implementers. This overview of the implementation guide for PrescribeITTM Presenters: Andrew Liu, Director, PrescribeITTM Service Management Dean Matthews, e-Prescribing Business Operations Lead

01/23/18

Solutions

  • Canadian FHIR Registry
  • Canadian URI Registry
  • FHIR Terminology Service API
  • FHIR Uniform Resource Identifier (URI)
  • HAPI FHIR
  • HAPI v2
  • HL7 Explorer
  • InfoRMS
  • Message Builder
  • Message ReMixer
  • Object Identifier (OID)
  • SNOMED CT Browser
  • Terminology Gateway
  • Terminology Service API
  • TermManager
  • TermWorks
  • Webhook Notifications

The Canadian FHIR® Registry supports collaborative development in an effort to accelerate sustainable growth of FHIR, locally and internationally. The registry is the home of national FHIR profiles recommended for use in Canada, including extensions, value sets, URIs and other useful, commonly used components. It is also host to a growing number of national, jurisdictional and locally shared FHIR projects, and is open to all Canadian implementers.

The Canadian FHIR Registry offers:

  • seamless integration of profile editing using Forge (free FHIR profile editor)
  • designated project space
  • supports project teams of up to 100 individuals
  • online authoring of implementation guides
  • integration with source control tools such as GitHub
  • version controlled environment

The Canadian FHIR Registry blends software development best practices with the requirements of modelling in FHIR, essential to delivering successful project requirements while having continuous access to structure validation, rendering and publishing.

Organization projects can be viewed without logging in. To edit or request a new project, This email address is being protected from spambots. You need JavaScript enabled to view it. with the details.

View projects in the Canadian FHIR Registry

Service Level Agreement and Business Continuity

Simplifier.net should not be used in a production setting, as 24/7 support is not provided by Infoway or Firely®.

A project created in the Canadian FHIR Registry can be linked to an existing GitHub account. GitHub serves as a secondary backup and can sync the content in the project accordingly. Read details on how to set this up

Users of the Canadian FHIR Registry on the Simplifier platform can expect the following response time from the Firely team for any issue encountered.

Issue Premium Support Description
High Priority
  • Response time < 4 hours
  • Resolution time < 8 hours
Work halts and affects a large number of users
Medium Priority
  • Response time < 4 hours
  • Resolution time < 16 hours
Able to continue working but affects a small number of users
Low Priority
  • Response time < 4 hours
  • Resolution time < 24 hours
Able to continue work and affects a couple of users
Tickets
  • Unlimited
Able to influence the product’s road map

Read an overview of the Service Level Agreement between Infoway and Simplifier.net.

All project artifacts are backed up weekly at midnight on Sundays. Each snapshot will be retained for 10 days. The project owner can request an as-is snapshot containing all the necessary artifacts such as text, xml, json, md and image files by contacting This email address is being protected from spambots. You need JavaScript enabled to view it..

Forge License Agreement

As per the statement issued on the Firely blog,  Securing the future of Forge, the free version of Forge will be licensed for non-commercial use only starting January 1, 2020. To continue using Forge, users will need to be part of a paid plan on Simplifer.net. The current contract between Infoway and Firely for Simplifier.net allows for an unlimited number of users of Forge. Infoway has received confirmation from Firely that this will remain unaffected until December 31, 2021. If the authors in Simplifier.net belong to projects that are part of the Canadian FHIR Registry, they will be given rights through the administration processes of the platform conducted by Infoway.

The Canadian URI Project is a repository of identifier and code system namespaces. Capturing key metadata as FHIR® NamingSystem resources provides an automatic mapping of OIDs to URIs or vice versa.

To make the discovery of these artifacts more flexible, the Canadian URI Registry (alpha) was developed to allow artifacts to be queried via plain text, OID, URI or their respective identifiers. These identifiers are created according to the URI guidelines and posted to the FHIR Solution Architecture Workstream for approval.

It is important to note that all searchable artifacts are to be curated via the Canadian URI Project in Simplifier. There are ongoing discussions with the FHIR Solution Architecture Stream to have a single representative manage data for their respective jurisdictions.

A scheduled task is run periodically, making all new or modified artifacts searchable after a 20 minute window.

Search the Canadian URI Registry (alpha)

FHIR web services used to access terminology data

FHIR Terminology Service APIs enable automated exchange of clinical terminology content and resources. It allows developers to easily implement healthcare applications that programmatically consume codes and subsets without requiring in-depth expertize in the fine details of terminology.

terminology gateway APIFHIR Terminology Service API

 

A Uniform Resource Identifier (URI) is a globally unique string of characters that provides a simple and extensible means for identifying a resource. URIs are used to identify a namespace or the location of a resource. URIs are human-readable and offer the potential for resolvability. The HL7 FHIR® specification recommends using URIs to have all resources resolvable and to comply with the FHIR RESTful paradigm.

URI Registration Process

  1. Requestor shall first check that the URI does not already exist in the Canadian URI Project, Jurisdictional Registry (if exists) or HL7 FHIR Specification
  2. FHIR URIs must not be proposed for Subsets to be published on the Terminology Gateway as they will be generated automatically.
  3. Requestor shall contact the owner or respresentative for either:
  4. Forum posts shall have the following format:

    Subject: New URI Request
    • Description: “A description of the URI”
    • Responsible Body & Contact Information
    • Proposed FHIR URI: URI as per URI Guidelines
    • Existing OID (if exists)
    • To be published (optional): Jurisidictional repository/ Canadian URI Registry
  5. There will be a wait period of five business days for the communities to react to the forum post with comments, questions or requests for clarification.
  6. Update Forum post will be updated with the new URI.
  7. Publishing the URI in the Canadian URI Registry and Jurisdictional Registry. This is highly recommended to prevent any misuse or duplication of URIs but it is optional.

See a flowchart of the FHIR URI Registration Process (pdf).

Open source integration tools useful for health IT integration projects

HAPI FHIR® is a simple-but-powerful library for adding FHIR messaging to applications. It is pure Java compatible and licensed under the business-friendly Apache Software License, version 2.0.

HAPI FHIR

 

External Solutions for API integration

Open source integration tools useful for health IT integration projects.

HAPI v2
 

HAPI for HL7 v2 messages is an open-source, object oriented HL7 v2.x parser developed for the Java platform

HAPI FHIR
 

HAPI FHIR is a simple-but-powerful library for adding FHIR messaging to your application. It is pure Java compatible and licensed under the business-friendly Apache Software License, version 2.0.

Open source integration tool useful for health IT integration projects

HAPI for HL7 v2 messages is an open-source, object oriented HL7 v2.x parser developed for the Java platform.

HAPI v2

  HL7 Explorer retired November 29, 2019

HL7 Explorer retired on November 29, 2019 with no further updates or maintenance. Access will continue “as is”.

NOTE: HL7 Explorer is not currently available due to a technical issue.

Please contact This email address is being protected from spambots. You need JavaScript enabled to view it. if you have any questions or concerns.

Enhanced browsing of HL7 v3

Infoway HL7 Explorer is a powerful browser for HL7 v3 structures, vocabulary and references. Used in conjunction with the pan-Canadian releases, HL7 Explorer makes locating details and information more efficient.

In November 2017, the Canadian HL7 InfoCentral community determined that there was no longer any need to do further updates to the pan-Canadian Version 3 messages. As a result, the December 2012 releases of MR02.06.01 and CeRx 4.4.2 are the latest pan-Canadian publications of these standardized messages.

The HL7 Explorer, the Master Terminology Worksheet (MTW) and all other messaging related artifacts are aligned with the latest releases.

Overview
 

Learn about the features HL7 Explorer: search once, graphical representation, quick hints, etc.

MR 02.06
 

HL7 Explorer applied to the MR 02.06 HL7 v3 maintenance release

CeRx 4.4.2
 

HL7 Explorer applied to the CeRx 4.4.2 HL7 v3 maintenance release

 

 

Standards versions available for viewing in HL7 Explorer

Standard URL 
CA MR 02.06 https://sl.infoway-inforoute.ca/extra/ca/mr0206-html/html/search.html
CA MR 02.05.01 https://sl.infoway-inforoute.ca/extra/ca/mr020501-html/html/start.html
CA MR 02.05 https://sl.infoway-inforoute.ca/extra/ca/mr0205-html/html/start.html
CA MR 02.04.03 https://sl.infoway-inforoute.ca/extra/ca/mr020403-html/html/start.html
CA CeRx 4.4.2 https://sl.infoway-inforoute.ca/extra/ca/cerx442-html/html/search.html
CA CeRx 4.4.1 https://sl.infoway-inforoute.ca/extra/ca/cerx441-html/html/start.html 
CA CeRx 4.4 https://sl.infoway-inforoute.ca/extra/ca/cerx44-html/html/start.html
BC V02R04 https://sl.infoway-inforoute.ca/extra/bc/v02r04-html/html/start.html
NS CeRx 4.3 https://sl.infoway-inforoute.ca/extra/ns/cerx43-html/html/start.html
NS R02.04.03 https://sl.infoway-inforoute.ca/extra/ns/r020403-html/html/start.html
AB MR2007 https://sl.infoway-inforoute.ca/extra/ab/mr2007-html/html/start.html
AB R02.04.03 https://sl.infoway-inforoute.ca/extra/ab/r020403-html/html/start.html
AB R02.04.00 SHR https://sl.infoway-inforoute.ca/extra/ab/r020400-shr-html/html/start.html
AB R02.04.03 Imm https://sl.infoway-inforoute.ca/extra/ab/r020403-imm-html/html/start.html

Request Management Solution

Infoway Request Management System (InfoRMS) is Infoway's request for change (RFC) tool for SNOMED CT®, pCLOCD/LOINC® and pan-Canadian Subsets. Not sure if you have access to InfoRMS? Manage your InfoRMS Access in your user profile.

 

snomed ct SNOMED CT

In order to ensure that SNOMED CT RFCs are addressed in an efficient and timely manner, it is the requestor's responsbility to:

  1. Ensure that the content does not exist in either the International or Canadian editions of SNOMED CT;
  2. Ensure that the request conforms with the most recent Editorial Guidelines;
  3. Provide the date of implementation;
  4. Provide reference material that is publicly available, authoritative, recent and relevant to the request (Wikipedia is not considered appropriate);
  5. Support the request with a clear justification for the change and an appropriate use case for context;
  6. Ensure all mandatory InfoRMS fields have been completed prior to submission.

Login to submit or follow requests to SNOMED CT 

 

pCLOCD leaf symbol pCLOCD/LOINC

Prior to submitting a pCLOCD/LOINC request, it is the requestor's responsibility to:

  1. Ensure that the content does not exist in LOINC or the pCLOCD;
  2. Ensure that a similar or equivalent term has not already been requested, by way of searching the online LOINC Submissions Queue;
  3. Ensure that a similar or equivalent term has not already been accepted and under development for the next official release, by way of searching LOINC Pre-release terms;
  4. Comply with Regenstrief Editorial Guidelines (note: login required)

Login to submit or follow requests to pCLOCD/LOINC 

 

subsets magnifying glass on monitor Subsets

Prior to submitting a Subset request, it is the requestor's responsibility to:

  1. Validate the content against the subsets in Terminology Gateway
  2. Comply with the appropriate proper terminology Editorial Guidelines

Login to submit or follow requests to pan-Canadian Subsets 

  Message Builder retired November 29, 2019

Message Builder retired November 29, 2019 and is no longer supported. The source code and all supporting documentation is available as-is on GitHub:

Please contact This email address is being protected from spambots. You need JavaScript enabled to view it. if you have any questions or concerns.

  Message ReMixer retired November 29, 2019

Message ReMixer retired on November 29, 2019 and is no longer accessible.

Please contact This email address is being protected from spambots. You need JavaScript enabled to view it. if you have any questions or concerns.

Pan-Canadian Standards use Object Identifiers (OIDs) to distinguish between objects by assigning a numeric string that enables other systems to understand the unique information that is being shared between various systems.

Canada Health Infoway (Infoway) has an arrangement in place with HL7 International that allows Infoway to submit OIDs to HL7 International on behalf of Canadian Implementers free of charge. There is a $500 USD fee per OID request if done directly with HL7 International.

To submit an OID, download the registration form that corresponds to your OID request.

  • For all non-jurisdictional and Infoway owned subsets, email the completed form to This email address is being protected from spambots. You need JavaScript enabled to view it.
  • All other requests must be sent to the Jurisdictional Representatives for OIDs

.

OID submission guidelines

  1. Jurisdictional Teams require 5-7 business days to process each request. It will be incumbent on the requestor to reply within this time frame to any questions and follow up as required. Any failure to do so will result in an automatic rejection and require resubmitting the request.
  2. The Requestor must post the OID requests on the following forums ONLY after consulting with the Jurisdiction/Infoway SME:
  3. Forum posts shall have the following format:

    Subject: New Namespace/CodeSystem/Subset OID Request
    • OID Description: “A description of the OID”
    • OID Symbolic name: Symbolic name guidelines
    • Responsible Body & Contact Information
    • Proposed FHIR URI: URI as per URI Guidelines
    • To be published: Canadian URI Registry/Terminology Gateway

  4. There will be a wait period of 5 business days for the communities to react to the forum post with comments, questions or requests for clarification.
  5. FHIR URIs must be proposed for all jurisdictional and non-jurisdictional OID requests according to the URI Guidelines and must be published in the Canadian URI Registry. Publishing the URI is an optional but highly recommended step. The Requestor will submit a validated FHIR® NamingSystem resource object based on the NamingSystem profile to their jurisdictional representative who will then upload it.
  6. FHIR URIs must not be proposed for Subsets to be published on the Terminology Gateway as they will be generated automatically.
  7. The Forum post will be updated with the new OID.

Browse International and Canadian Content

SNOMED International's SNOMED CT® browser allows users to browse and search the SNOMED CT International Edition to explore concepts and relationships. It also provides access to browse national extensions from SNOMED International member countries including the Canadian Edition of SNOMED CT in English and French.

snomed browser Browse SNOMED CT Now

 General Documentation

Browse, download and leverage the terminology used in Canada

Terminology Gateway is a web based solution framework that enables the distribution and sharing of terminology concepts, subsets and concept maps, making them available for web browsing, download or real time query.

terminology gatewayBrowse Terminology Gateway Now

RESTful web services used to browse terminology data

Terminology Service RESTful APIs enable automated exchange of clinical terminology content and resources. It allows developers to easily implement healthcare applications that programmatically consume codes and subsets without requiring in-depth expertise in the details of terminology.

terminology gateway APITerminology Service API

 

Apelon’s TermManager is a web-based data mapping solution which is provided by request for free to individuals who have Standards Access. It provides comprehensive mapping capability to SNOMED CT® and the Canadian Edition of SNOMED CT with multi-user work flow options and flexible output formats.

 Implementation Guidelines & Resources

  • This email address is being protected from spambots. You need JavaScript enabled to view it. - Email your request to This email address is being protected from spambots. You need JavaScript enabled to view it. with the following information:
    • Your InfoCentral username.
    • Is this a new request or are you renewing your access to use TermManager?
    • Intended Use: Please describe the project and mapping requirements. Please Note: TermManager is limited to mapping with SNOMED CT. As more terminologies are available, they will be added.
    • Local Terms: Please describe the source of your local terms (EMR, LIS, etc.).
    • Please describe your requirements/project if they don't fit the above.
  • TermManager Release Notes

knowing Learn More

  • This email address is being protected from spambots. You need JavaScript enabled to view it.
  • Apelon Mapping Tool Presentation
  • SNOMED CT Education
  • TermManager User Guide
  • How TermManager Works
  • TermManager FAQs

Apelon’s TermWorks is an easy-to-use data mapping solution that is provided by request (free of charge) to individuals who have Standards Access. It brings powerful terminology capabilities directly to the desktop. TermWorks combines Microsoft® Excel® spreadsheet software with web services-based terminology processing to give organizations comprehensive mapping capability to SNOMED CT® and the Canadian Edition of SNOMED CT.

 

knowing Learn More

  • This email address is being protected from spambots. You need JavaScript enabled to view it.
  • SNOMED CT Education
  • Apelon User Guide
  • Infoway User Installation Guide
  • How does TermWorks Work?
  • TermWorks FAQs

Automated notifications of new content in Terminology Gateway

A webhook is an HTTP callback. When new content is published in the Terminology Gateway, a publishing event will be POSTed to each registered webhook, notifying their respective owners about the publication.

Webhook registration

Individual users can register for webhook notifications by sending an email to: This email address is being protected from spambots. You need JavaScript enabled to view it. and specifying the webhook endpoint. Upon registration, a unique api_id will be assigned to the webhook. Each notification POSTed by the Terminology Gateway will contain the api_id, allowing the endpoint to verify that the notification was indeed issued by the Terminology Gateway. The api_id must be echoed back by the webhook endpoint in the body of the notification response.

Webhook interface

The webhook endpoint must serve HTTP requests conforming to the following interface:

HTTP Request

{
  "api_id": "cb570e5a2748f349f9119431db836b3a23fdb6571afee34c0432d87220f2431b",
  "base_url": "https://termapi.infoway-inforoute.ca/rest/v1/",
  "notification_time": "2017110711:07:00",
  "targets": [
    {
      "id": "2.16.840.1.113883.2.20.6.1",
      "name": "Canadian Clinical Drug Data Set (CCDD)",
      "type": "package",
      "version": "20171016",
      "effective_date": "20171016",
      "publication_time": "2017103015:20:23",
      "message": "Monthly CCDD update for October 2017"
    },
    {
      "id": "2.16.840.1.113883.2.20.3.443",
      "name": "PrescribeIT",
      "type": "package",
      "version": "LPR2",
      "effective_date": "20171103",
      "publication_time": "2017110309:37:22",
      "message": "PrescriptionMedicinalCode version reflecting the October 2017 CCDD update"
    }
  ]
}
				
  • api_id: as previously mentioned, each notification POST contains the api_id granted at registration.
  • base_url: the base URL for the native REST API endpoint of the originating system. This can be used to call back the Terminology Gateway via APIs in order to programmatically download updated content.
  • notification_time: the timestamp of the webhook notification in yyyyMMddHH:mm:ss format.
  • targets: list of updated targets. Each entry in this array corresponds to a Terminology Gateway artifact (subset, codesystem, map, package) that was updated and is therefore subject to the notification. The target list will only include artifacts for which the user has registered to receive notifications. Users can register to receive notifications about content updates using the Terminology Gateway User Interface or by invoking the native REST APIs.

    Each of the notification targets contains the following fields:
    • id: the artifact id, typically an OID
    • name: the artifact name
    • type: the artifact type: subset, codesystem, package or map
    • version: the published version id
    • effective_date: the effective date associated to the artifact version, in yyyyMMdd format
    • publication_time: the publication time in yyyyMMddHH:mm:ss format
    • message: optional message describing the published artifact version

HTTP Request

HTTP Response code: 200 for success, any other response code will be interpreted as an error
Sample HTTP Response Body:

{
  "api_id": "cb570e5a2748f349f9119431db836b3a23fdb6571afee34c0432d87220f2431b",
  "result": "success",
  "message": "Successful processing of the webhook notification"
}
  • api_id: as previously mentioned, each notification response must echo back the api_id granted at registration.
  • result: success if the web hook notification was successful, any other value will be interpreted as an error.
  • message: optional response message.


Error handling

When receiving an error as a result of a webhook notification, the Terminology Gateway will retry the notification four times at 15 minutes intervals. If still unsuccessful after four notification attempts, the system will drop the notification and will notify the user by email that the webhook couldn't be invoked.

Sample code

Demo code for a sample webhook endpoint can be found here: 

https://github.com/CanadaHealthInfoway/tgateway-webhook

Web Conference

Please login to acquire access to the InfoCentral web conferencing.

Members

Joel Francis
Canada Health Infoway
OFFLINE
Contact
Joan Harper
Canada Health Infoway
OFFLINE
Admin
Linda Monico
Canada Health Infoway
ONLINE
Admin
Andrea MacLean
Canada Health Infoway
ONLINE
Admin
Bradley Brazill
Eastern Health
OFFLINE
Member
Karla Ortiz
CD-ED
OFFLINE
Member
Bryan Dearlove
Mayfair
OFFLINE
Member
William Wu
IntuCare Inc
OFFLINE
Member
Warren Kufuor-Boakye
Alberta Health Services
OFFLINE
Member
munazzah afzal
n/a
OFFLINE
Member
Snezana Dudas
SHA
OFFLINE
Member
Bing Pitre
RAMQ
OFFLINE
Member
David Berkowits
EMR Healthcare Informatics Ltd.
OFFLINE
Member
Harmony Hill
Centre for Distance Education
OFFLINE
Member
Sheridan Cook
Gevity Inc
OFFLINE
Member

Prince Edward Island is one step closer to implementing a provincewide EMR solution. Read the news release to learn… https://t.co/rYrlsT9PB4

by Infoway

InfoCentral logo

Improving the quality of patient care through the effective sharing of clinical information among health care organizations, clinicians and their patients.



Login Register