Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

The integration services described herein require additional one-time and/or annual fees. For more information, please contact us.

CMaRS is a 3rd party software that manages the annual reappointment cycle of Physicians. CMaRS is integrated with Dual Code's HCE learning environment, meaning that when a Physician completes a course in your organization's learning environment, a proof of completion is sent to CMaRS.

Table of Contents

Getting Started

This service uses Dual Code's LRX (Learning Record Exchange), which is a web services framework offered as part of OCI. This service is disabled on the platform by default and can only be enabled for Dual Code clients who are also under agreement with CMaRS. To enable this service, please contact Dual Code.

Enabling the Service

Once confirmed by CMaRS that you are authorized to use this service, it will be enabled by default in the HCE learning environment. There is nothing for you to enable in the learning environment itself.

Adding the OCI ID Field

CMaRS track users based on a user field called the "OCI ID", which is a global identifier meant to uniquely represent users across the Dual Code network. This field needs to be present for CMaRS integration to work.

To add an OCI ID field:

  1. Go to Site administration > Users > Accounts > User profile fields
  2. Click on "Create a new profile field" and select "OCI ID"
  3. Configure the settings for the field
  4. Click on the "Save changes" button.

Once the field is added, you'll need to enter values for all users in the system in order to be able to send learning records to CMaRS.

Sending the Learning Records to CMaRS

The HCE learning environment allows you to send learning records to CMaRS for any course. That beings said, generally speaking, CMaRS only tracks very specific courses.

To send learning records generated in the HCE learning environment are sent to CMaRS.

  1. Go to the course in question
  2. Go to Course Administration > Learning record exchange
  3. Click on the "Add" button
  4. Select "CMaRS" from the list of recipients.
  5. Click on the "Add" button

From this point forward, learning records for this course will be sent to CMaRS, thereby marking physicians as having completed the course.  Please note the following:

  • There may be a delay on the CMaRS side before a physician is marked as accredited. For the duration of this delay, please ask your CMaRS representative.
  • The following learning records will not be sent to CMaRS:
    • Existing (legacy) learning records
    • Learning records that are uploaded using a CSV file
    • Learning records generated as part of a course equivalency application

Troubleshooting Issues

Q. CMaRS is getting a WS400 error code.

A. The integration with CMaRS currently supports users affiliated with the following Colleges:

  1. College of Physicians and Surgeons of Ontario
  2. College of Midwives of Ontario
  3. Royal College of Dental Surgeons of Ontario

If CMaRS is getting a WS400 error code, it means that the specified user is not affiliated with one of these three colleges. Look at the value of the "OCI ID" field in the user's profile in the learning environment to make sure it is set to one of the Colleges above. If your organization needs to support users affiliated with other Colleges not listed above, please contact Dual Code. Other Colleges can be supported upon request.


Q. CMaRS is getting a WS401 error code.

A. The integration with CMaRS requires that each user have a unique identifier. This is done through the user's OCI ID field stored in the learning environment. For example, if CMaRS is searching for learning records for a Physician with the CPSO #123456, there must exist a user in your learning environment where the OCI ID is College of Physicians and Surgeons of Ontario | 12345.

If CMaRS is getting  a WS401 error code, it means that the specified user does not exist in your learning environment. If you know which user CMaRS is trying to find, look at the value of the "OCI ID" field for the user in question in the learning environment and make sure that his/her OCI ID is set correctly.


Q. We import / upload our user information and the OCI ID is always wrong.

A. If you upload the user information using the procedure explained in Uploading Users, the value for the OCI ID field must adhere to a very specific convention that includes the country, province, and acronym for the college, followed by the unique identifier for the user. All components must be separate by a hyphen (-).  For example, if you are uploading the information for a Physician affiliated with the College of Physicians and Surgeons of Ontario with CPSO #12345, the value you would upload via CSV would be "CA-ON-CPSO-12345".

Below are additional example. Note that only the following Colleges are available for the purpose of CMaRS integration at this point:

CollegeIdentifierExample
College of Physicians and Surgeons of OntarioCA-ON-CPSOCA-ON-CPSO-12345
College of Midwives of OntarioCA-ON-CMOCA-ON-CMO-12345
Royal College of Dental Surgeons of OntarioCA-ON-RCDSOCA-ON-RCDSO-12345


  • No labels