Activity Application Summary and Guide

Activity Application Summary and Guide

This document is designed for site administrators who are involved with the activity applications process.  

Activity Application Introduction 

The EthosCE Activity Application module—also known as the “Course Application”—allows authenticated users to submit activities for review and approval by CME administrators. These administrators can then review the submissions, make edits, and, if appropriate, convert them into full courses or series.

CME User Roles 

When the Activity Application module is enabled, two new system roles become available:

  • CME Manager: Administrators with the CME manager role can edit and update fields in the activity application and modify all user submissions.  

  • CME Reviewer: Administrators with this role can only modify the applications assigned to them and convert their assigned applications into courses or series. 

User Access to an Activity Application 

Only authenticated users can submit Activity Applications. Even if the module is enabled on your site, the link to access and submit the application is not automatically visible to users.

This is intentional, as each organization may have different processes and requirements for how applications should be submitted.

You may share the application in two ways:

  • Add the link to your site navigation: If you want all logged-in users to access the application directly, you can add the application page to your site's menu.

  • Share the link externally: If you'd prefer to limit access, you can send the application URL directly to users via email or other communication channels.


Follow the steps below to find and share the Activity Application page link.

 

Navigate to the Activity Application page.

 

Navigate to the Activity Application page.

1

Open a new tab on your web browser.

2

Copy and paste the following URL path to the end of your production site web address:  

 

admin/structure/entity-type/course_application/course_application/add

Activity Application User Workflow

Watch the video below for a preview of the user experience when completing the Activity Application, including a look at the application fields from the user’s perspective.

For a more in-depth understanding of this feature, you can also take the on-demand Activity Application training course.

 

Submitting an Application - User Workflow.mp4

The Manage Tab

The Manage tab contains key administrative fields used to track and review submitted Activity Applications. This is especially relevant for site and CME administrators responsible for managing application workflows.

Activity Application Submission Date

The submission date for an Activity Application is recorded when the user first submits the form.

An application is officially submitted when the user selects "Yes" for the statement "This form is complete and ready for submission" and then clicks the Submit button. This original submission date remains unchanged, even if the application is edited later.

After submission, users cannot make further changes if the submission value is set to "Yes." However, administrators with edit access can reset the value to "No" to allow users to make additional edits.

Assigning a CME Reviewer

Once an application is submitted, the CME Manager will receive a notification and can then assign a CME Reviewer to evaluate the submission.

To assign a CME Reviewer, follow the steps below or watch the video demonstration provided:

1

Log-in as a CME manager.

2

Navigate to the Activity Application dashboard.

3

Click the "Edit" link for the application you want to edit.

4

Click the "Manage" tab.

5

Type in the CME reviewer's name. Only accounts with the "CME reviewer" role will appear.

6

Select the application status.

7

Click "Submit.

Assigning a CME Reviewer Tutorial

Activity Application- Assigning a CME Reviewer.mp4

CME Reviewer Field

The CME reviewer field lets you assign the application to a user with the CME reviewer role. Only CME managers can assign CME reviewers, and you’ll only see users with the CME reviewer role in the dropdown.

Activity Application Status

The Application Status is a helpful dropdown that allows admins to keep users informed about the progress of their applications. This status appears on all Activity Application dashboards.

Please note that this is not a workflow field—it does not trigger any automated actions. Site admins must update the status manually.

For step-by-step instructions on updating the application status or returning an application to the submitter for edits, see: Activity Applications States and Feedback Workflow.

Application Status Taxonomy Terms

The options for Application Status are managed through taxonomy terms, which can be edited by users with the Site Admin role.

For more information about how these terms are auto-populated, see the Taxonomy Terms section below.

The system includes a rule that automatically sends an approval email to the application author whenever a course application is updated with a status that starts with “Approved.”

For example, you can create a custom status like “Approved by Manager.” As long as it begins with “Approved,” the system will still trigger the approval email.

Taxonomy Terms

Several fields in the Activity Application—such as Application Status —are populated using taxonomy terms. These lists include default values but can be customized based on your organization’s needs.

Depending on how you application is configured, some of this content may not apply.

As a Site Admin, you can update, add, or remove taxonomy terms for any of these fields.

Follow the steps below to navigate to the Activity Application Status taxonomy page and view the complete list of terms:

 

View the Full List of Taxonomy Terms

1

Open a new tab on your web browser.

2

Copy and paste the following URL path to the end of your production site web address:

 

admin/structure/taxonomy/course_application_statuses

Taxonomy Terms in use: Updating Taxonomy Fields

You may use the links below to access each taxonomy list used in the Activity Application. From these pages, you can review and edit the terms that appear in corresponding sections of the application.

Audience Tab

In the Audience section of the Activity Application—where it says, “This activity is intended for providers in the specialties of…”—taxonomy terms are used to list medical specialties.

You can update or edit these specialty terms by following the path below.

/admin/structure/taxonomy/target_specialities

Gap Analysis Tab

In the Gap Analysis > Barriers section of the Activity Application—under the question, “How will you measure if changes in competence, performance, or patient outcomes have occurred?”—you’ll see taxonomy terms used for the available selections:

  • Knowledge/Competence

  • Outcomes/Population Health

  • Performance

When a submitter selects one of these options, the system automatically generates a list of related selections. These auto-generated options are also managed through taxonomy terms.

You can update or edit these terms by following the paths provided below.

 

Update and Edit the Barriers

Knowledge/Competence

/admin/structure/taxonomy/knowledge_competence

Outcomes/Population

Health

/admin/structure/taxonomy/patient_outcomes_population_health

Performance

/admin/structure/taxonomy/performance

Application Status (Manage Tab)

In the Manage Tab under Application Status, you’ll see a dropdown menu. You can update any of the options in this list by following the path below.

/admin/structure/taxonomy/course_application_statuses

Converting an Activity Application into a Course

A CME Manager or CME Reviewer can convert an approved application into a course by selecting the “Create Activity” tab in the application menu. This tab is only visible once the application has been approved.

After the application is converted, the tab will change to “View Activity.”

Shared fields—such as Start Date, Expiration Date, Event Date, and others—will automatically transfer from the application to the new course shell. Applications are Related to a Single Course

After creating a course through an activity application, that course is linked to the original application. Each application can only be connected to a single course.

If RSS is enabled on your site, you’ll have the option to convert the application into either a course or a series.

Converting an Activity Application into a Course.mp4

Cloning a Course Application

A CME Manager or CME Reviewer can clone a previous Activity Application to allow for resubmission and review.

Editing Course Application Form Fields

Editing an Activity Application form can be complex. It is recommended to try this on your test environment before making any changes in production. You may also submit a support ticket to request changes to the activity application form.

Watch the video below on editing Activity Application form fields.

Editing Activity Application Form Fields.mp4

For more information please see:

Field mapping allows specific fields from an application form to be automatically copied into the course node. However, this only occurs if field mappings are explicitly configured—they are not applied by default.

Ensure that field names and data types are compatible to avoid unexpected behavior. Without proper setup, data entered into the application will not auto-populate into the course—even if the fields appear to match.

Important Considerations and Limitations

1. Field Limit

EthosCE currently supports a maximum of approximately 50 custom fields per activity application form. Attempting to add more may lead to performance issues or unexpected behavior. Plan your form design accordingly.

2. Risk of Deleting Fields

Deleting a field from an application form can have unintended consequences, especially if that field has been used in existing or past applications:

  • Deletion affects all historical data, including submissions from users.

  • Mapped fields that are removed can result in data loss or application errors.

  • Once a field is deleted, any data associated with it is not recoverable through the interface.

3. Retroactive Application

Field mappings are not retroactive. Mapping a field today will not transfer previously submitted data into the course. Only new applications submitted after the mapping has been configured will populate the course fields.

E-mail Rules Summary

This section explains the three default email rules associated with the Activity Application module.

These rules are automatically active and ensure that specific email notifications are sent to the application submitter and relevant administrators.

Below are the three email rules:

1

When the field "This form is complete and ready for submission" is set to "Yes" and the Authenticated User clicks "Submit," this sends an email to all users with the role 'CME Manager.'

2

A 'CME Reviewer' receives an email when a course application is assigned to them. Also, an email is sent to the submitter on who is assigned to their Activity Application.

3

An email is sent to the Activity Application author when any admin sets the 'Application Status' to any option beginning with "Approved."

Managing Metadata

This section reviews how to access your metadata for better management of this information.

The Manage tabs control all the backend metadata for a course application. Follow these two steps to navigate to the Manage (metadata) Tabs:

1

Open a new tab on your web browser.

2

Copy and paste the following URL path to the end of your production site web address:

admin/structure/entity-type/course_application/course_application