1 of 100

Elentra ME 1.16

Introduction

You have arrived at the user documentation for Elentra ME. These pages are intended for the administrative staff and faculty who are using installations of Elentra ME. A range of topics are listed on the left and clicking on each will open a subset of menu options. We also recommend using the search tool in the top right.

If you are looking for documentation for an earlier version of Elentra, please use the version switcher in the top left.

Technical staff can find our technical documentation at
There is not currently documentation for additional Elentra applications like Continuing Professional Development and Admissions. Extensive development work is on-going for both and we will provide documentation as they are updated and released.

If you don't see what you're looking for, please feel free to reach out on the Slack #help channel if you have access to the or submit a question to .

For more general information about the Elentra Consortium please visit our website:

Support

There are a number of support and communication channels used by the Elentra Consortium in order to adequately address your support needs. If you are new to Elentra development or administration please contact your local designated Elentra Consortium contact or reach out to us at doorbell@entrada.org.

Communication Channels

Entrada Consortium Slack Team
Elentra Mailing Lists (to subscribe please email arush@queensu.ca)
- Community List
- Elentra Learn List (used to distribute invitations to webinars and training activities)
- Developer List
(optional) Weekly School Check-In Web Conference
Bi-Weekly Elentra Consortium Web Conference
Monthly Elentra Learn Training Webinar
Annual Elentra Conference

Feature Requests

The Elentra Consortium relies on participant contributions in order to continue expanding the features we offer. Schools frequently develop features that they require but that might be useful to other consortium members as well.

If you have an idea for a new or improved component of Elentra we recommend speaking to a project manager or software developer at your local institution. They can reach out to other schools within the consortium to identify potential solutions or overlapping needs.

Together, we'll continue to build a great integrated teaching and learning platform.

Reporting Issues

If you discover a bug or issue with Elentra, we would strongly encourage you to report the problem as a bug using our Jira Issue tracker: https://elentra.atlassian.net/projects/ME/issues/filter=allopenissues

If you need access to the issue tracker, please send an email to Kristen MacKinnon at km204@queensu.ca.

Security Reporting

We take the security of the Elentra Platform very seriously. If you believe that you have discovered a security vulnerability please contact us immediately:

Name

E-Mail Address

Telephone Number

Matt Simpson

1-613-533-6000 x78146

Andrew Dos-Santos

1-613-533-6000 x74904

By reporting issues to our team you are helping to create a secure and reliable product.

Elentra Learn Webinars

All webinars can be accessed at https://collaborate.elentra.org/community/elentra-learn

Please note that at present our monthly webinars are not posted on this site, but can be found on our Elentra Collaborate Intranet Portal . If you are employed at a consortium member school and wish to access a past webinar and have not been added to the Elentra Collaborate Intranet Portal, please contact Alice Rush-Rhodes on Slack or via email (arush@queensu.ca).

Past webinar topics include:

Elentra Learn #26 (October 23, 2019) - Elentra JS 2.0 (Technical Focus)

Elentra Learn #23 (July 17, 2019) - Introduction to Elentra CPD

Elentra Learn #22 (May 15, 2019) - What's New in Elentra ME 1.15.0

Elentra Learn #21 (April 10, 2019) - Elentra Collaborate Intranet Portal

Elentra Learn #20 (March 6, 2019) - AAMC Curriculum Inventory Report

Elentra Learn #19 (December 5, 2018) - What's New in ME 1.14

Elentra Learn #18 (November 13, 2018) - Scheduling Tools in Elentra

Elentra Learn #17 (September 5th, 2018) - How to Contribute to Elentra as a Developer

Elentra Learn #16 (August 8th, 2018) - What's New in Elentra 1.13

Elentra Learn #15 (July 11, 2018) - Distributions in Assessment and Evaluation in ME 1.12

Elentra Learn #14 (June 6, 2018) - Elentra Grab Bag: Things you might not know about ME 1.12

Elentra Learn #13 (May 2nd, 2018) - User Experience Development and Process

Entrada Learn #12 (April 4th, 2018) - What's New In Entrada ME 1.12

Entrada Learn #11 (March 7th, 2018) - Using the Entrada API

Entrada Learn #10 (February 7th, 2018) - Communities (types, pages, etc.)

Entrada Learn #9 (December 6th, 2017) - Curriculum Search, Explorer and Matrix

Entrada Learn #8 (November 22nd, 2017) Competency-Based Medical Education in Entrada ME 1.11

Entrada Learn #7 (November 8th, 2017) - Curriculum Management in Entrada ME 1.11

Entrada Learn #6 (October 4th, 2017) - Deep Dive into Exams in Entrada ME 1.10

Entrada Learn #5 (August 30th, 2017) - Deep Dive into Assessment & Evaluation in Entrada ME 1.10

Entrada Learn #4 (July 26th, 2017) - What’s New in Entrada ME 1.10

Entrada Learn #3 (June 28th, 2017) - Setup and Maintenance of Courses in Entrada ME 1.9

Entrada Learn #2 (May 31st, 2017) - Deep Dive into Entrada ME 1.9 Gradebook

Entrada Learn #1 (April 26th, 2017) - What’s New in Entrada ME 1.9

System Setup

After your Elentra installation is active, you'll need to configure some system settings before using other modules and features of the platform. Users with the group and role of Medtech:Admin or Staff:Admin will be able to access System Settings. Here you'll be able to configure things like assessment types, location management, grading scale, departments, and user disclaimers. Generally this is content that will remain consistent across an entire organisation and will not be frequently changed. Note that you set system settings at the organisation level in Elentra so you can have different system settings for undergraduate and graduate medical education programs running on the same installation of Elentra.

Which system settings you configure really depends on how you will be using Elentra. See the list below for some quick start ideas.

If you want to add users: configure departments before importing users (especially faculty)
If you want to create courses: create a curriculum map version, then configure curriculum layout and periods (note that this has moved from Admin>System Settings to Admin>Manage Curriculum)
If you want to schedule learning events: configure learning event types and locations (you'll need courses via Admin>Manage Courses and for rotation scheduling you'll also need to build blocks in the relevant curriculum period but that is done in Admin>Manage Curriculum)
If you want to input grades: configure assessment types (you'll need to configure curriculum layout and periods, and build courses as well but that will be completed elsewhere)
If you want to report using the curriculum inventory: configure assessment and learning event types, and curriculum layout and periods (you'll also need courses, events, and gradebooks setup but those are managed elsewhere)

Instructions for managing some system settings are included here. Other instructions are included with their related module. See a sample list of system settings below.

Organisations

In Elentra, organisation refers to an entity using and managing its own curriculum map version, layouts, tags, courses/programs, learning events, gradebooks, etc. Examples of organisations include undergraduate medicine and postgraduate or graduate medicine. Another example could be nursing or rehabilitation therapy.

You can add and manage organisations through Admin>System Settings. While Medtech:Admin and Staff:Admin users have access to System Settings, ONLY Medtech:Admin can add a new organisation.

How to add a new organisation

Note that this tool is only available to Medtech:Admin users.
Navigate to Admin>System Settings.
Click 'Add New Organisation'.
Provide the required information noting the following: Interface Template: Stock Elentra has one default interface. If you are testing things on an installation with dummy data provided by Elentra, and have different interface options available, we recommend using them only if it has been recommended to you.
Click 'Save'.

Additional interface template information: The Elentra template is entirely configurable by a developer and if you would like additional interface templates, that is customization that your institution can do. Many schools apply their own branding to the look of Elentra or you might create different templates for different organisations using your installation of Elentra (e.g., undergraduate and postgraduate or graduate medical education organizations).

How to edit an existing organisation's metadata

Navigate to Admin>System Settings.
Click on the name of the organisation you want to manage.
Click on the pencil icon and 'Edit' in the top right to change the existing information.
Make the required changes and click 'Save' in the bottom right.

Location

Location Management allows organisations to maintain a list of the sites, buildings and rooms relevant to their institution. In this context, site could refer to an institution, organization, or governing body. Site is the top tier of the location management system; within a site you can add buildings, and within a building you can add rooms. You can also add a phone number for the contact person at the site. Some examples are provided below.

Site: University/College Name, Hospital Name
Building(s): New Medical Building, Abramsky Hall, Student Athletic Centre
Room(s): 201A, 201B, 430, 431, The Caldwell Room
Phone Number: (123) 456 - 7890

Using the locations feature is useful if you plan to schedule clinical rotations or learning events in Elentra. Rotations and their corresponding blocks/slots can be assigned to sites, and learning events can be assigned a site, building and room. The building and room code will be displayed to event attendees so make sure the short codes you use are logical.

How to access locations

Log in as Medtech:Admin or Staff:Admin.
Navigate to Admin>System Settings.
If you have access to multiple organisations, click on the name of the organisation you want to manage locations for.
Click 'Location Management' from the left sidebar.

How to add and manage sites

From the Location Management screen click 'Add New Site'.
Provide the required information noting the following: Site Code: The site code will display with the name on dropdown menus when you are assigning a site (e.g., in a learning event or rotation). Province/State: This option will only be available after you have selected a country.
Click 'Save'. You will be directed to enter buildings for your new site.
When you return to the Sites page, the sites will be listed in the order they were added to the system. There is currently no user interface to reorder the list of sites.
To edit an existing site, click on its name from the Location Management screen and then click the pencil icon beside the site name.
To delete an existing site, click the checkbox beside the site from the Location Management screen. This will cause a delete button to appear. Click 'Delete Selected' and confirm your choice.

How to add and manage buildings

From the Location Management screen click on an existing site.
Click 'Add New Building'.
Complete the required information noting the following: Building Name and Code: Both of these will be displayed on the list of buildings and in learning events. City, Country, and Province: These will default to the same information as the site but you can change it as needed.
Click 'Save'. You will be directed to a page to add rooms to the building.
When you return to the Buildings page, the buildings will be listed in the order they were added to the system. There is currently no user interface to reorder the list of buildings.
To edit existing buildings, click on the cog wheel to the right of the building name.
To delete existing buildings, click the checkbox beside the building name from the list of buildings. This will cause a delete button to appear. Click 'Delete Selected' and confirm your choice.

How to add and manage rooms

New as of ME 1.13! Room Resources to allow you to use Lecture Capture

From the Location Management screen, click on an existing site.
Click on an existing building.
Click 'Add New Room'.
Provide the required information noting the following: Room Number: This can represent the numbering customs in the building. Room Description: This is a required field that collects information. At present users will not see this information. Room Max Occupancy: This collects information and at present will not be displayed to users elsewhere in the system.
Room Resources: This allows you to provide information about the resources in a room. The default list includes projector, television, computer, and capture. Capture is used when you are using Elentra's lecture capture tool.
- If you select 'Capture', you'll be prompted to enter the following information. The examples included assume you are using NCast.
  - Device Name: This corresponds to the code in your NCast recorder manual that is specified for that model. For example, on an M4 recorder this value should be “M4”, whereas on a Hydra model, this code should be “PR720”.
  - Device Address: This is the IP or hostname of the NCast device on your network.
  - Channel: This is the number of the Channel to be used from NCast device’s configuration. Most devices have a limited range available, usually 1 - 100.
  - Stream Prefix: This is the named string of characters that all videos from this Room will be tagged with. For example, “surgery” or “pediatrics”.
Click 'Save'.
The room will appear on the Building Rooms list.
When you return to the Rooms page, the rooms will be listed in the order they were added to the system. There is currently no user interface to reorder the list of rooms.
To edit existing rooms, click on a room name and an edit window will open.
To delete existing rooms, click the checkbox beside the room name. This will cause a delete button to appear. Click 'Delete Selected' and confirm your choice.
If you use Capture as a room resource, you will see a calendar icon at the end of each Room’s row. Clicking on this calendar icon will bring up a modal which allows a link to an .ICS calendar schedule file to be copied. You will need the URL to this .ICS file when configuring your NCast server, which will point to the schedule so that it knows when to start and stop recording.

Departments

A list of departments, divisions, faculties, schools or units can be maintained in Elentra and applied in user profiles. This information is in turn used in some reporting tools (e.g. Faculty Teaching Report By Department).

As of Elentra ME 1.12, if you import users using a CSV, you can include a column for department and add multiple departments as needed.

How to manage the list of departments

Log in as Medtech:Admin or Staff:Admin.
Navigate to Admin>System Settings.
Click on the name of the organisation you want to manage departments for.
Click 'Departments' from the left sidebar.
Click 'Add Department' to add a new entry.
Complete the required information noting the following: Department Type: You can select a department type from a dropdown menu. The options include department, division, faculty, school, and unit. There is no user interface to change this list.

Click 'Save'.
To delete existing entries, click the checkbox beside the item name and then scroll down and click 'Delete Selected'; confirm your choice.

The list of departments will display alphabetically.

Linking departments and divisions

As of Elentra ME 1.12 there is no user interface to link departments and divisions. There is space in the database to create a relationship between a department and its affiliated divisions and a developer with access to the database can do this work if it is required by your organisation. In a user profile you can assign someone to multiple departments and divisions in order to show their multiple affiliations.

Custom Profile Fields

Each department can configure custom profile fields to collect additional information from their members. This allows an administrator to define the custom profile field in terms of the type of information to collect and then create a space in the user's profile for them to provide said information.

Creating a Custom Profile Field

In an administrator role, navigate to Admin>System Settings, pick the appropriate organization if required, and click Department from the left sidebar.
Click on the appropriate department.
Click Department Profile Fields
Click Add Field
Provide the relevant information, noting the following:
- Field Type allows you to customize how information can be collected. The options are:
  - Rich text
  - Plain text
  - One Line text
  - Checkbox
  - External URL (e.g. for people to provide a link to their research project page)
- Indicate using the checkbox if this custom field will be required
Click Add
The newly created field will display on a list of custom profile fields. You can edit, delete, or reorder the custom profile fields using the pencil and trash icons, or the Reorder button.

Completing a Custom Profile Field as a User

Users can complete their custom profile fields in their user profile, accessible by clicking on the user's name in the top right. Within their profile tab options, they will see a Department Specific Information tab and can provide the required information there. In the example below, there is a one line text item.

Event Types

Event Types describe all the different things you might include in scheduled events managed through Elentra. Examples include lectures, labs, directed independent learning, exams, lunch, etc. and the list of event types is customizable. Event types are used several ways:

any event added to a schedule must have an event type defined; you can add multiple event types to one scheduled event
the audience of an event will see its type
the Learning Event Types by Course Report uses event type to summarize the use of different events types within a course

How to manage event types

You must be logged in as an Admin user to manage event types.
Navigate to Admin>System Settings.
If you have multiple organisations, click the name of the organisation for which you want to manage event types.
Click 'Learning Event Types' from the left sidebar. A list of existing event types will be displayed.
Click 'Add Event Type' to add a new event type.
Complete the required fields, noting the following: Description: This field is optional, however it is visible to users when they create events so you may wish to provide it. When users add events to the system through Admin>Manage Events, they can mouseover event types and view the provided description (see above). Medbiquitous Instructional Method: If you plan to use the Curriculum Inventory Reporting tool to report to the AAMC it is recommended that you map your organisation's event types to the Medbiquitous Instructional Methods. If you don't, the CIR tool will omit events with unmapped event types.
Click 'Save'.
The newly added assessment characteristic will now appear on the event types list.
To modify an existing event type, click on it.
Edit it as needed and click 'Save'.
To delete an existing event type, click the checkbox beside the event type you wish to delete.
Click 'Delete Selected'.
Confirm your choice.
You will be returned to the list of event types.

Examples of Event Types being used in Elentra

Assessment Characteristics

Assessment characteristics should be configured if you plan to use course gradebooks. Within a gradebook you will need to define the assessment characteristic for each assessment added. Each assessment type has different extended options for recording data (e.g. the type of included questions for quizzes and exams, or whether to track late submissions for papers and projects).

Elentra comes with a set of assessment types. These include assessment, exam, paper, presentation, project, quiz, RAT, rating, and reflection. Within each assessment type you can further specify assessment characteristics (e.g. oral exam, written exam, OSCE). While there is no user interface to change the list of assessment types, the assessment characteristics list is completely configurable through the user interface. Assessment characteristics can also be mapped to MedBiquitous Assessment Methods if required by an organisation. Whatever is created as an assessment characteristic can later be applied to the assessments listed in a course gradebook (see image above).

Navigate to Admin>System Settings.
Click the name of the organisation for which you want to manage assessment characteristics.
Click 'Assessment Types' from the left sidebar. A list of existing assessment characteristics grouped by assessment type will be displayed.
Click 'Add Characteristic' to add a new assessment characteristic.
Complete the required fields. The description is optional and is not often seen in other parts of Elentra. (It's possible that in the future if you mouseover an assessment characteristic you'll see its definition but that is not a current feature.)
Click 'Save'.
The newly added assessment characteristic will now appear on the Assessment Types list.
To modify an existing assessment characteristic click on it.
Edit it as needed and click 'Save'.
To delete existing assessment characteristics click the checkbox beside the characteristic you wish to delete.
Click 'Delete Selected'.
Confirm your choice.
You will be returned to the list of Assessment Types.

Assessment Response Categories

Assessment response categories (e.g., excellent, good, needs improvement) are used when creating items in the Assessment and Evaluation Module. The categories can also be applied to specific rating scales and when those rating scales are applied to items the response categories will pre-populate.

Navigate to Admin>System Settings.
Click the name of the organisation for which you want to manage assessment response categories.
Click 'Assessment Response Categories' from the left sidebar.
Click 'Add Category'.
Enter the response category.
By default, all categories will be available in reports so uncheck the box if you don't want the category to be available in reports.
Click 'Save'. Remember your new category will be added to the end of the list.
Response categories are displayed in the order they were added to the system, so use the search function to quickly look for existing categories and prevent creating duplicates. Results will appear as you type.
If multiple categories have been created and are overly similar, or you have imported data from another tool and have duplicate categories, you can merge selected categories. To do this, click the checkboxes beside the categories to merge, then scroll down and click 'Merge Selected'.
To delete categories, click the checkbox beside the category you wish to delete and then scroll down and click 'Delete Selected'.

Use of assessment response categories in scales

Use of scales when building assessment and evaluation items

Evaluation Response Descriptors

Evaluation response categories are used to create rubrics in a relatively old Clerkship Evaluation feature. It is strongly recommended that instead of the Clerkship Evaluations feature you use the more recent Assessment and Evaluation module.

Navigate to Admin>System Settings.
Click the organisation for which you want to manage the evaluation response descriptors.
Click 'Evaluation Response Descriptors' from the sidebar.
Click 'Add Descriptor' to add a new descriptor.
Add the response descriptor and set the display order (required).
By default, response descriptors are not made available in reports so tick off the box if you wish to make them available in reports.
Click 'Save'.
To delete descriptors, tick off the box beside the descriptor you wish to delete and then scroll down and click 'Delete Selected'.
Use the search function to quickly look for existing descriptors. Results will appear as you type.

Grading Scales

The grading scale is not a required feature of Elentra and does not currently link with other modules. Eventually, this could be used to configure display options and to show students their grades using the grade scale instead of a raw score. For example, if a learner scores 14/20 they would see the corresponding grading scale grade (e.g. 70% or 2.7).

Navigate to Admin>System Settings.
Click the name of the organisation for which you want to manage the grading scale.
Click 'Grading Scale' from the left sidebar.
A default grading scale is provided and it may be fastest to modify the existing scale to suit your organisation's needs. If so, click on the default scale to edit it.
To add an entirely new scale, click 'Add New Grading Scale'.
Complete the required information noting the following: Applicable Date: Set the applicable date for the relevant grading scale. This ensures that learners see the grading scale relevant to their enrolment and experience. Ranges: Click 'Add Range' to add additional rows. Begin with the lowest range because the system is set up to require a range that starts at zero (you will be able to reverse the display order later). Note that you do not enter a number to denote the top of the range. After you've added a range starting at zero you'll be able to add additional ranges at various starting percentages and the starting values defines the end of the previous range.
To delete a range click the red minus icon in the remove column of the appropriate row.
When you've added all the required information, click 'Save'.
To reverse the display order of the range start values, click the arrow beside Start %.
To edit an existing grading scale click on its title.
Make the necessary changes.
Click 'Save'.
To delete an existing grading scale click the checkbox beside its title.
Click 'Delete Selected'.

Restricted Days

The restricted days tool allows you to indicate days that are restricted within an organization. Once set up, users who try to schedule an event on one of these days when using the recurring event feature will receive a warning notifying them that something is a restricted day (users can ignore the warning and schedule an event anyway if desired).

Managing Restricted Days

Currently you must be a medtech:admin to manage restricted days. We are working to expand this to staff:admin users as well.

New in ME 1.14! You can now specify a reason for a restricted day; the information will display to a user who tries to create an event on the restricted day.

Navigate to Admin>System Settings.
Pick the organization you want to work in if necessary.
Click Restricted Days in the left sidebar.
Click Add Restricted Days.
Add the appropriate days noting that you can add a specific date (e.g. Dec. 25), a weekly day (e.g. every Friday), a monthly day (e.g. the first Wednesday of the month), or a yearly date (e.g. the last Monday of May).
Provide a reason for the restriction.

Click Submit.
The newly created restricted day should display on the list of restricted days.

Viewing Restricted Days When Scheduling Recurring Events

If you are creating a recurring event schedule and one of the dates conflicts with a restricted day, you'll see a warning. Users can ignore the warning and still schedule an event on that day if they so desire.

Curriculum Management

The tools within Manage Curriculum are used to build the structure on which many of Elentra's curriculum mapping features rely.

The structure of curriculum management within Elentra includes:

Organisations (e.g. undergraduate medicine, nursing, pharmacy)
Curriculum Layouts (i.e., divisions of time used to organise units of instruction, e.g., terms, semesters, years, etc.)
Courses
Optional Units (units exist within a course and group learning events together for a learner-friendly overview of the unit)
Events (any scheduled time in your organisation, e.g., lecture, lab, exam)

Manage Curriculum allows users to:

Manage curriculum layouts and curriculum periods (a curriculum period is an instance of a layout and has specific start and end dates)
Manage curriculum tracks (a way to identify groups of related courses)
Manage curriculum map versions (a way to capture linkages between curriculum tags relevant to specific periods of time)
Manage curriculum tags (the taxonomies that can be applied to courses, units, learning events, gradebook assessments, exam items, and assessment items included on forms)
Map one curriculum taxonomy to another curriculum taxonomy (e.g. map national standards to program objectives)

Mapping one curriculum tag set to another

There are two different ways that users can map curriculum tag sets to each other. One way is to do so via Manage Curriculum and the other is to rely on context-based linkages. A default Elentra installation is configured to support mapping via Manage Curriculum; if you want to use context-based linkages you will likely need a developer's help to enable it.

Please note that the intended functionality of Elentra is to take a top-down approach in mapping curriculum tags. For example, you might have exit competencies, program objectives, course objectives and sessional/event objectives. You'd start with your exit competencies and map the relevant program objectives to them, then map the course objective to the program objective, etc.

After these mapped relationships are recorded they can be reported on via the Curriculum Tag Mapping Report.

Mapping curriculum tags to curriculum content

Curriculum taxonomies can also be applied to:

Courses
Units
Events
Gradebook assessments (in a course)
Exam items
Assessment items included on forms

The steps to apply curriculum tags in each of these areas is described in the relevant help section for each feature. Various reporting options to view this information also exist across the various features. Some reporting options are briefly described below.

Commonly used tools accessible to all users include Curriculum Search, Curriculum Explorer, and Curriculum Matrix.

Curriculum Search: Allows you to search for a key term and apply curriculum tags as filters.

Curriculum Explorer: Shows which objectives have been assigned to courses, tagged in events, and tagged on gradebook assessments (view of assessments is not available to learners).

Curriculum Matrix: Shows which objectives have been assigned to specific courses.

Additional tools are available only to specific users. Staff:Admin users will be able to access all of these, but faculty access will depend on the faculty role and course affiliation.

Curriculum Tag Minutes and Mapping Report: Shows which tags have been applied to events in a course.

Curriculum Review Report: Shows events, curriculum objectives, and clinical presentations within a course. (May require modification to use at your institution.)

Assessment Objective Summary Report: Lists assessments within a gradebook and provides their descriptions, and the curriculum objectives applied to them. (May require modification to use at your institution.)

Exam Data (Information and Settings): Provides an overview of the curriculum tags used on an exam and the number of questions tagged with said objectives.

Exam Results Curriculum Tag Report: Provides an overview of learner performance with regard to the curriculum tags applied to the questions.

Curriculum Layouts and Periods

Curriculum layouts define the general blocks of time used within an organization to manage teaching and learning. Examples include year, term, semester, phase, blocks, etc. Courses, modules, or whatever more granular units of instruction are called at your institution live within a curriculum layout.

Within each curriculum layout, curriculum periods are added. A curriculum period has a defined start and end date and is often associated with a specific cohort of learners. An example of three curriculum periods within one layout would be:

Term 1 Class of 2021, Sept. 2017-Dec. 2017
Term 1 Class of 2020, Sept. 2016-Dec. 2016
Term 1 Class of 2019, Sept. 2015-Dec. 2015

One curriculum layout can have multiple curriculum periods. Curriculum periods are required when creating the audience and enrolment for courses/programs and multiple features and reports in Elentra rely on curriculum periods to filter information.

How to create curriculum layouts

Navigate to Admin>Manage Curriculum.
Click 'Curriculum Layout' from the left sidebar.
Click 'Add Layout'.
Complete the required information, noting the following: Curriculum Level: This field collects data but is not used elsewhere in the system. There is currently no user interface to change these levels.
Click 'Save' or immediately add curriculum periods and then save your work.

How to create curriculum periods

From the Curriculum Layout page, click on an existing curriculum layout.
Click 'Add Curriculum Period'.
In the line added below, adjust the start and end date for the curriculum period, add a title (e.g. the relevant cohort), and leave the final column as active.
Scroll up if necessary and click 'Save'.

How to reorder the appearance of curriculum layouts on the screen

Click on and drag a curriculum layout row to the appropriate place in the list and then click 'Save Ordering'.

How to delete a curriculum layout

Click the checkbox beside the layout you wish to delete.
Click 'Delete Selected'.

How to delete curriculum periods

From the Curriculum Layout page, click on an existing curriculum layout.
Click the checkbox beside the curriculum period you want to delete.
Click 'Deactivate'.

Block schedule feature

If a specific curriculum period is a time when learners will participate in clinical learning experiences, you can automatically create a block schedule to apply to that curriculum period. This allows for easy scheduling of clinical learning experiences. Detailed instructions for this process are included in the Curriculum>Rotation Blocks help section.

Blocks in a Curriculum Period

Blocks should be created for curriculum periods in which associated courses will have clinical learning experiences (e.g., clerkship, residency rotations). Later, you'll use blocks to build slots in the rotation scheduler.

How to manage curriculum blocks

You must be logged in with an administrator role to create blocks.
Navigate to Admin>Manage Curriculum.
Click 'Curriculum Layout' from the left sidebar.
Click on the appropriate curriculum layout.
Beside the appropriate curriculum period, click 'Block Schedule'.
Click 'New' in the bottom right.
Provide a Schedule Title (e.g. 1 Week Blocks or Psychiatry Rotations) and description as desired. The title is the title of the set of blocks, not the individual blocks. The start and end dates for the schedule are set by the curriculum period within which you are creating the blocks (you will be able to alter the individual block dates after they have been created).
Click 'Save'.
Now you can create the actual blocks of time within this schedule. Block Type: By default you'll see one, two and four week blocks. (If you'd like to build blocks of different lengths you can get a developer to make a database change to facilitate this.) Block End Day: This is the day you want blocks to end. Start and End Date: Set by the curriculum period in which you are creating these blocks. First Block End Date: Optional. You can use this to force the first block to end on a specific date (useful if the curriculum period starts on an irregular day).
Click the down arrow beside Save and select Autogenerate Blocks; a list of blocks will appear.
Click on any row to edit the block name, or the start and end dates.
You can also add a custom block by clicking 'Add' in the bottom right and providing the required information.
When you have made the required adjustments to the block schedule, click 'Save' on the right above the list of blocks.
You can add multiple sets of blocks to one curriculum period. For example, you might add a set of one, two and four week blocks to one curriculum period. This allows you to schedule learners across blocks of varying lengths during their clinical learning experience.
Toggle between a list and calendar view of blocks using the list and calendar icons above the block end dates. (Note that as of ME 1.12 the calendar icon does not properly display blocks.)

Curriculum Tracks

Curriculum Tracks can be used to create specializations or concentrations within programs or to show a course’s language of instruction. After tracks are created, courses can be assigned to them from the course setup page. Student users can also be assigned to a track which will eventually help them to see the appropriate content (especially where the tracks are language based). Currently this tool functions as a way to collect information but does not interact with any other feature in Elentra.

Adding courses to a curriculum track is done via individual course setup pages. Please see the the Courses help section for more information.

How to create a curriculum track

Navigate to Admin>Manage Curriculum.
Select 'Curriculum Tracks' from the left sidebar.
Click 'Add Curriculum Track'.
Fill in the required information noting the following: Track Public URL: If the track has a public URL you'd like to make available, provide it here.
Set a display order. Curriculum Tracks will not automatically display alphabetically.
Click 'Save'.

How to manage existing curriculum tracks

After a track is created you can add an image for the track. Click on the track name to access the Edit Curriculum Track page and then upload an image via the small gray square on the right side. As of ME 1.12, these images will not be displayed anywhere in Elentra.
To quickly change the display order of tracks on the main Curriculum Tracks page drag and drop them into new positions and click 'Save Ordering'.
To delete unneeded tracks click the checkbox beside the track name and click 'Delete Selected'.

How to assign users to a curriculum track

Note that you'll only be able to assign students users to a curriculum track if you have tracks built for the relevant organization.

Navigate to Admin>Manage Users.
Search for the appropriate user and click on his or her name to access their user profile page.
Scroll down to the permissions section. If an existing permission exists in an organization that has curriculum tracks, you'll be able to select the appropriate track from a dropdown menu.
If you are creating a new permission you'll have to add it first and then select the relevant curriculum track from the dropdown menu.
Click 'Save' at the bottom of the page when you are done.

Curriculum Map Versions

The Curriculum Map Versions feature allows an organisation to create curriculum maps with specific linkages between curriculum tags. Each curriculum map includes curriculum periods and the curriculum tags and mapped relationships between tags are available to be applied to any features (courses, learning events, gradebook assessment entries, etc.) that exist with the curriculum periods included in a specific map.

How to create a curriculum map version

Navigate to Admin>Manage Curriculum.
Click 'Curriculum Map Versions' from the left sidebar.
Click 'Add Version' and fill in the required fields noting the following: Version Status: Draft or published curriculum maps will be available when creating links between curriculum tags and will also be available to be copied to new map versions as needed.
Click on the appropriate curriculum layouts and a list of curriculum periods will be displayed. Click on the appropriate curriculum periods for this map version and save your work.

How to copy an existing curriculum map version

Repeat the steps above and in the Import Options section, tick off the checkbox.
Select the curriculum map version you wish to copy from the dropdown menu.
Click 'Save'.
This will create an identical curriculum map for the new map version which you can then edit as needed.

Curriculum Tag Sets and Curriculum Tags

Curriculum Tag Sets are the different taxonomies an organization uses to tag and track content across the system. The sets are customizable and within each set you can have a hierarchy of tags. Examples of curriculum tag sets include school objectives, clinical presentations, diagnoses, etc. These tags can be applied to courses, learning events, assessment items, exam questions, portfolio artifacts, learning objects, etc. Tag sets can be used as filters when searching the curriculum and are used in multiple reports.

While curriculum tag sets and curriculum tags are connected, there are differences in their creation and management. You must create a tag set first and then populate it with curriculum tags.

How to create a new curriculum tag set

Navigate to Admin>Manage Curriculum.
Click 'Curriculum Tags' from the left sidebar.
Click 'Add Tag Set'.
Complete the required information noting the following:

Tag Set Details:

Title and shortname are required for the tag set. The title is displayed to users when using curriculum tags to label things and when using curriculum search tools.
Standardization: This field was developed for the Competency-Based Medical Education tools in Elentra and identifies a tag set that is standard across multiple courses/programs. It is applicable to the "Stages" tag set that is required in CBME, but can be ignored when creating other tag sets.
Applicable to: Usually curriculum tag sets are applicable to all courses, however you can adjust the setting, if needed. This will control which courses are able to use this tag set to tag learning events and gradebook assessments. (If you are using context-based linkages to tag curriculum that feature will allow access to all curriculum tag sets including those set to be applicable to only some courses.)

Tag Options:

This defines the information and requirements for any tags added to this set. You can control whether there will be a space to record code, title, and description for each tag and whether any of those fields is required. You must have a minimum of one required tag option. If you later download a sample csv in order to import tags to this set the csv will include columns for the required fields configured here.
Hierarchical levels: Here you can set how many hierarchies will be allowed within the tag set (for example you might have a set of objectives that has 3 levels in its structure like Competency, Program Objectives, and Curricular Objectives). If you use multiple levels, provide labels for each.
Be aware that in many Elentra features when users apply curriculum tags to events or items, they will have to click through the hierarchy to find the appropriate tag. Some features also allow users to select the top or second tier of the hierarchy and automatically apply all tags below to the course.

Tag Display Options:

Here you can specify how tags within this set should be displayed in short or long display mode. Some reports will rely on the different display methods and apply your specifications. To change the display order of the components, type in the %d, %t or %c codes as you wish them to appear. A sample of what the short and long display methods will look like will show on the right.

Mappable Curriculum Tag Sets:

One feature of curriculum tags is the ability to map tags from one set to another to create a map of how your curriculum tags overlap. In this section you can define how the tags in the set you are creating can be mapped to other tag sets. Click the down arrow beside 'Browse All Tag Sets' and check off the sets you want to be able to map to, noting there is a select all feature available. To delete any unwanted tag sets from this list click on the small grey ‘x’ beside the tag set name in the 'Selected Tag Set' panel.

Click ‘Save’ to complete the creation of the new tag set. After saving, you will be redirected to the screen where you can add tags to your newly created tag set.

How to delete existing curriculum tag sets

Navigate to Admin>Manage Curriculum>Curriculum Tags.
Click the checkbox beside the curriculum tag set you want to delete and then click ‘Delete Items’.

How to modify existing curriculum tag sets

Navigate to Admin>Manage Curriculum>Curriculum Tags.
Click the name of the tag set and then click ‘Edit Tag Set’ from the buttons on the right. This will open a page where you can edit the tag set information.

How to create new curriculum tags

Navigate to Admin>Manage Curriculum.
Select 'Curriculum Tags'.
Click on the name of the curriculum tag set you want to add tags to.
Either import curriculum tags or add individual tags.

How to import curriculum tags

From a Curriculum Tag Set page, click 'Import from CSV' and a popup window will offer you a sample CSV template file to download. The template file will include some column headings required for this tag set, but a full list of possible CSV headings include: objective_code objective_name objective_description objective_order objective_loggable non_examinable objective_status_id admin_notes
Complete the file with the appropriate curriculum tags (remember to remove the sample line of text).
Import the file via the already open popup window to quickly create your tag set. To import the tags you can drag and drop the file or browse for it on your computer.
If you are uploading to a tag set with hierarchies, select the parent tag you wish to import additional tags to.
Click 'Import'.
You'll see a green success message with the number of tags created and then you'll be redirected to the tag set page where you can view the newly added tags.

How to add new tags one by one

From a Tag Set page, click 'Add Tag'.

Tag Details:

Status: Set this as Active to allow its immediate use; if you use Draft status this tag will not be available to users and you'll have to manually update its status when you want it to be available.
Complete the code, title, and description as needed remembering that the availability of each field and whether it is required is managed at the tag set level.
Set the Display Order if needed. By default the new tag will be added to the end of the list of existing tags.
Non-Examinable: At present this can be recorded for reporting purposes and does not interact or impact the functionality of other features.
Loggable in Experience Logbook: Tick this box if this curriculum tag should be available to learners in the Experience Logbook (usually this is relevant to tags that will be used in clinical learning environments).

Map Curriculum Tags: When creating a new tag you can link it to other curriculum tags if the tag set has been built to allow for such linkages (remember that is controlled at the tag set level).

Click on 'Map Curriculum Tags'.
Use the Tag Set dropdown menu to find the tag you want to map to the tag you are editing.
Click off the popup window in order to see the mapping relationship you've added. It intentionally stays open for you to pick more tags as needed.
To delete a link click the small x beside the mapped tag.
Click 'Save'.

Admin Notes: Use this space to record notes about a curriculum tag (e.g. the committee that requested the tag, reason for changes, etc.)

Click 'Save & Close'.
To add a tag in a hierarchy, navigate to a Tag Set page and click the plus sign beside the tag to which you want to add another level of tag. (Depending on whether you use list or table view you will see the plus sign or may need to hover over a tag until menu icons appear on the right.)
Complete the tag details as you would for other tags and click 'Save'.

Where tag title, code and description display in the Elentra user interface

When building a tag set you can define whether tag title, code, or description are required for each tag added to the set. If you're curious about where this information will display to users, here are some general guidelines for various reports and tools in Elentra:

Curriculum Search: code and title
Learning Events Tab: shows title (currently the filter list is restricted to the 2 objective sets you’ve designated as Curriculum Objectives and Presentations)
Curriculum Matrix: title and description
Curriculum Explorer: title (and description once you click on an objective)
Curriculum Tag Mapping Report: title and description
Curriculum Tag Minutes and Mapping Report: title
Course Website (learner view): title and description
Course Page (no course website built) (learner view): title
Event Page (learner view): code, title, and description

The Curriculum Review Report is being revised for ME 1.15 on to allow for user control over how the curriculum tags display (the report will reflect the Short Display Method you can configure when you edit a tag set).

How to modify your view of curriculum tags

Toggle between a list view and table view of curriculum tags using the small icons beside the Add Tag button.
In table view, add additional visible columns to the table by clicking on the grid with a down arrow beside it. Adding additional columns can allow you to see id, code, title, description, and an overview of existing links between tag sets.

https://vimeo.com/267800298/7e6ccf2e47

How to edit existing tags

Click on the pencil icon available to the right of the tag (you may need to use your mouse to hover over a tag for the menu icons to appear).

How to link curriculum tags

If settings in a curriculum tag set are configured to allow the tags in the set to be mapped to other tags, you can do the mapping from the Tag Set page.

From the Tag Set page click the chain or link icon beside a tag. This will take you to the Map Curriculum Tags tab for this tag.
Use the Tag Set dropdown menu to find the tag you want to map to the tag you are editing.
Click off the popup window in order to see the mapping relationship you've added.
To delete a link click the small x beside the mapped tag.
Click 'Save'.
Note that you can link tags via courses, units, and learning events if you are using an Elentra setting that allows context-based linkages. See more information about this in the Curriculum>Context Based Linkages help section.

How to view tag history

Click on any tag to access its details, mapping, admin notes and history.
This history tab records all changes made to the tag and the user who created the change.

How to quickly view tag details

After you've opened any curriculum tag using the pencil icon to view its details, you can quickly navigate forward and back to view additional tags in the set using the arrows in the bottom left of the screen. Easily jump to the first or last tag using the double arrow.

How to delete curriculum tags

To delete an existing curriculum tag navigate to the Tag Set page.
Depending on your view you'll either see small icons in the right or you'll need to hover over a curriculum tag until you see small icons appear.
Click the garbage pail to delete the tag.

How to export curriculum tags

Navigate to Admin>Manage Curriculum.
Click 'Curriculum Tags' from the sidebar
Click on the name of the curriculum tag set you wish to export.
Click export.
A csv file will download to your computer; it will include objective id, code, name, description, parent, etc.

Context-Based Linkages

This feature is optional and must be enabled in the settings file to be accessible through the user interface.

Context-based curriculum linkages allow you to map relationships between curriculum tags at the course, event, and unit level. These mapped relationships will be visible on the course, unit, and event pages. While this feature creates records of information in the same way that linking curriculum tags through Admin>Manage Curriculum does, the display capabilities are quite different. Using context-based linkages will allow users to click on curriculum tags from within units and events and see the mapped relationships.

There are different areas where you can build context-based linkages and often they are used in conjunction with the Units feature.

Assign curriculum tags to a course and link them to other curriculum tags. Do this from a course setup page. Assign curriculum tags to a unit and link them to other curriculum tags. The list of tags assigned to a unit will be displayed under Week's Objectives. This information, including the context-based linkages, will also display under the Unit Tags section of a weeks page. Do this from a course unit page. Assign curriculum tags to a learning event and link them to other curriculum tags. If you link your event level objectives to a unit tag the learning event will display on the list of week's objectives and show the connection to the unit objective. Do this from a learning event page.

Having a list of events display on a week's page actually comes from linking the event to a unit, not the context-based curriculum tags.

Hot Topics

Hot Topics can be configured to include a list of items your organisation would like to track across learning events. Hot topics function somewhat like curriculum tag sets but they are not available to assign to courses or assessment items. For this reason, your organisation may prefer to build a hot topic taxonomy in the curriculum tag sets via Manage Curriculum. One feature of hot topics is that you can indicate whether teaching about a hot topic was major or minor in a learning event, however there is currently no way to report on this information.

How to manage a list of hot topics

Navigate to Admin>System Settings.
Select the organisation for which you want to manage hot topics.
Click Hot Topics from the left sidebar.
Click 'Add Hot Topic'.
Provide a name and description and click 'Save'.
To delete hot topics, click the checkbox beside the category you wish to delete and then scroll down and click 'Delete Selected'.

How to tag hot topics within a learning event

Navigate to a learning event you want to tag with a hot topic.
From Administrator View, click on the Content tab.
In the Event Objectives section scroll down to the Event Topics section. Click 'Event Topics' to make the list of topics visible.
Tick off the Major or Minor field as needed.
To deselect a topic, click the remove x.
Click 'Save'.
When a hot topic is tagged to a learning event, this information (including major or minor designation) is visible to learners on the learning event page.

How to report on hot topics across the curriculum

Navigate to Admin>System Reports.
The Course Summary Report includes a column to show Hot Topics tagged to specific learning events.
From the Learning Event tab you can apply multiple filters to tailor the list of learning events you are viewing. One of the filters you can apply is Hot Topics. This allows you to generate a list of all events tagged with a specific hot topic.

Curriculum Search

The Curriculum Search tool is available to all users by default and uses boolean search terms to look for content within learning events. It searches event titles, event descriptions, and curriculum tag names. Users can also use advanced options to search files attached to learning events.

How to use Curriculum Search

Type your search term(s) into the search space.
If you want your search results to include files attached to Learning Events, click 'Advanced Options' and click the checkbox just below the search bar.
Click 'Search' and your results will display on the screen.
You can toggle between three different views of your search results:
- List view: This view shows you a list of all returned events. Export your results as desired.
- Timeline view: This view displays the returned events by cohort on a timeline. Scroll through the results or quickly jump from year to year using the links on the right above the timeline. Mouseover an event for its course affiliation and length. View a total count of results returned per cohort in the left sidebar.
- Table view: This view shows you course name, learning event, date, duration, description, unit (if enabled), event types, and teachers. Export your results as desired.

How to use advanced options

Advanced options let you further refine your curriculum search results.

Click 'Advanced Options'.
Select parameters to apply to your search including cohort, academic year, curriculum tag sets, filter fields, course and weeks (weeks will only appear if units/weeks in enabled in your installation).
To add a Tag Set click on the name of the desired tag set and click 'Add' just below the list of tag sets. You can hide this list as desired by clicking 'Hide List'. Adding a Tag Set to your search means only events with something from that tag set will be included in the results.
To use the Search Filter Fields and Search Filter Operator options, imagine creating a sentence to limit your results. For example, "If Event Description is ----" return results. You can create multiple filters to apply to a search and the returned results will only include events that meet the filter parameters.
The Search Filter Operator options include: is, is not, contains, does not contain, starts with, does not start with, ends with, and does not end with.
After you've set your filters, click 'Search'.
To clear just some existing filters click the small x on each filter card. To remove all filters, click 'Reset'.
Make sure to click 'Reset' to clear all filters before beginning a new search.

An example of using advanced search might be that I want to find all events on a certain topic NOT taught by one faculty member. I may already know that Dr. Greene teaches about heart disease but I want to find other instances in the curriculum where another faculty member is addressing heart disease. If I search for "heart disease" and add a "Teachers is not Dr. Greene" filter, the results will give me what I want.

Exporting events: Include or exclude child events

Elentra includes the ability to link multiple repeating events in a parent-child relationship. This is most often used when small groups of learners will complete the same activities in repeating learning events. For example, there may be 10 events scheduled for 10 small groups but each event is essentially identical in terms of content, curriculum tags applied, etc. If you use the parent-child feature some reports will look only to the parent event to collect data and therefore help to report accurately from the perspective of a single learner.
When you export events from Curriculum Search you can choose whether to include or exclude child events.
Searching for key content in your curriculum, and exporting the results can be really useful for external reporting (e.g. research projects, interest group surveys, coroner's office, etc.). Similarly, these exports can help in gap analysis and planning an intentional curriculum.

Curriculum Explorer

The Curriculum Explorer is available to all users by default and allows you to filter by curriculum tag set, course, cohort, and academic year, in order to see where a specific curriculum tag has been applied to a course, learning event, or assessment.

One big difference between Curriculum Explorer and Curriculum Search is that Explorer includes assessments. Currently, the results returned in Curriculum Explorer regarding assessments reflect curriculum tags applied to an assessment in the Gradebook module. It does not return results for individual exam items.

Curriculum Explorer does not currently reflect mapping between curriculum tags. It will only display curriculum tags directly assigned to an event, course, or assessment.

Curriculum Explorer does not currently reflect the parent-child relationship if you create recurring events using the parent-child relationship. It will display results for all events that have been tagged with the relevant curriculum tag.

How to use Curriculum Explorer

Select a curriculum tag set from the dropdown menu.
Select a course, cohort, and or academic year to limit your results. This is optional.
By default, the system will return results for courses to which curriculum tag is assigned and learning events and Gradebook assessments where the tag was applied. If you are only interested in one or two of those, click the category you don't want to disable it.
Click 'Explore'.
In the left pane, you'll see a list of curriculum tags and the number of times they are tagged in the system according to the parameters set above.
Click on a specific curriculum tag to view its results or to drill down to additional tags if the set has a hierarchy.
In the right pane, switch between views of courses, events, and assessments tagged with the objective. These tabs will only show up if you left them enabled and there were results returned.

There is not currently an export tool associated with the Curriculum Explorer.

Curriculum Matrix

The Curriculum Matrix is available to all users by default and provides a quick visual and numerical inventory of where curriculum tags are assigned to courses. The Matrix reflects only those curriculum tags that have been assigned to a course through the Course Setup page, not all tags applied to events, gradebook assessments, etc.

Curriculum Matrix does not currently reflect relationships between mapped tags. It just shows those tags directly assigned to a course. (If context-based linkages are enabled the Matrix shows curriculum tags assigned to the course on initial setup and any added afterwards in the "Course Tags" section.)

The Curriculum Matrix can be a useful tool to help identify where curriculum objectives might be under or over-represented.

The information stored in the Curriculum Matrix can be downloaded as a csv file.

How to use Curriculum Matrix

Navigate to Curriculum>Curriculum Matrix.
Use the Curriculum Tag Set selector to pick a tag set. If the tag set you select includes multiple hierarchies, adjust which hierarchy you are viewing using the small grey numbers to the right of the tag set selector.
Results will display on the screen. A star indicates that a tag is assigned to a course. The number is the column header indicates how many courses the tag is assigned to.
If viewing a tag set with hierarchies, some column headers may appear blue. Click on the tag to open the next hierarchy of tags.
Collapse the view of specific curriculum layouts (e.g., term or year) by clicking on the +/- button beside the layout name.
Click on the name of a tag to see its description (if applicable).
Click 'Download' to download the results of the Matrix in a CSV file.

User Management

Elentra allows you to collect and store information on users in a variety of ways. Each user can have a basic profile but you can configure the system to collect additional information as desired.

Many institutions sync their user records with a centralized authoritative record of users which reduces the work of maintaining a user database.

Information you can collect and store on users through the basic profile includes:

Institutional number
Username and password
Name prefix
First and last name
Gender
E-mail (up to 2 by default)
Phone and fax numbers
Address
Office Hours
Notes/comments
You can allow users to add post-nominal letters to their names, however this setting is disabled by default. If you'd like to use this feature a developer will need to enable it for your institution.
If you have users with identical first and last names we recommend that their middle initial be entered as part of the first name field.

Create Users

Most users require an account to access Elentra. While there are some exceptions to this in that you can create a public community and share it with others, add a guest member to a specific community, or add an external assessor to a distribution of an assessment and evaluation form, most users will have accounts. To create a user account you must include user groups and roles which define user permissions. Only those with admin roles within Elentra are able to manually create users.

Although there is a user interface to manually add individual users, it is strongly recommended that your developers or technical team set up a relay of information from a central, authoritative database (e.g., an existing student information system) to feed users into Elentra. If you are not doing this and wish to bulk import users via a csv file, please see below.

How to bulk import users

Navigate to Admin>Manage Users.
Click 'Import From CSV'.
From the popup window you can download a sample CSV file.
Open the file in your preferred spreadsheet manager and complete the columns. Required fields are listed first followed by optional fields. First Name: Provide the user's given name. If you have multiple users with the same first and last name we recommend including their middle initial with their first name. Last Name: Provides the user's last name. Username: This will be the username for your Elentra installation. email: This should be the user's email and must be distinct for each user. Group: Group defines the user type in the system. Pick from Alumni, Faculty, Medtech, Resident, Staff, and Student. You can only use additional groups if you have added them to the database. Role: Different group types have different role availability as shown in the table below. Many group and role configurations carry different permissions. For more detail about user permissions please see the Permissions help section. Similar to groups, you can only use additional roles if you have added them to the database.

Group

Role

Alumni

Year of Graduation

Faculty

Admin

Faculty

Director

Faculty

Lecturer

Medtech

Admin

Medtech

Staff

Resident

Lecturer

Resident

Staff

Admin

Staff

Pcoordinator

Staff

Translator

Student

Year

Organisation: This should be a numeric id and reflect which organisation a user should be added to if there are multiple organisations on an installation (e.g., undergraduate medicine and postgraduate medicine). When logged in as a Medtech>Admin you can find the organisation id by navigating to Admin>System Settings and clicking on the organisation. When the page for that organisation opens the url will include the org id at the end. You can also ask a developer what the organisation ids for your installation are. Gender: Gender is a required field in your upload but you can leave the cells blank if you don't want to define users' genders. If you do want to provide gender enter M or F. A blank cell will display as Gender:Unknown in the user interface.

Optional fields: Institution Number: The user's university id (e.g., staff or student number). Entry Year: The year the learner entered/will enter a program. Grad Year: The anticipated graduation year. (Make sure your database includes the years you intend to enter.) Note that users will automatically be added to an existing cohort if one exists for the graduation year. Notes: Information provided here will display in the General Comments section of the Personal Information section. Account Status: You can enter active or disabled in this column, you'll be able to change this setting in UI after the user is created. Access Start: Unix timestamp (e.g. 1512086400) or date-time format (2017-12-01 12:35) are accepted. Access Finish: Unix timestamp (e.g. 1512086400) or date-time format (2017-12-01 12:35) are accepted. Department: To enter a department affiliation for a user you must have department's Elentra id code. This is information you can request from a developer or you can find it by looking at a url. To discover the department id for yourself, you must be able to access Admin>System Settings. When you do, click on the name of the organisation you are working with and then click Departments in the left sidebar. Click on a department name and when the page for that department displays the url will include the department id at the end. Password: Passwords can be set using an import but we recommend only importing existing passwords if you exported them from elsewhere. Salt: This is a way to make a password more secure. It is recommended that you use this field only if you've exported a list of users and already have the salt information (and the password). Prefix: Accepted prefixes are Dr., Mr., Mrs., Ms., Prof., Assoc. Prof., and Asst. Prof. Alt Email: This is a second or alternative email the user can provide. Telephone, Fax, City, Address, Postal Code, Country, Province: Provide contact information as desired.
Every column header included in your file must be completed. If there is a column header with no information present delete that column before you upload the file.
If you are importing a significant number of users we recommend limiting your file size to 1000 users or less.
It is recommended that you use different files for different groups (e.g. faculty and learners) as they may not required the same fields and partially complete columns may result in errors. If you have blank cells please fill them with NULL.
After completing the spreadsheet, you can browse to find the file or drag and drop it in place. You will be prompted to match the information included in your CSV against the mapped fields available. Fields that display highlighted with green are required.
At this stage, you can scroll through the imported users to check their data. In the top right, click on the small arrows beside the Row counter. You'll see a summary of the information being uploaded for each user.
Decide whether to send user notification emails to new users (uncheck if you don't want emails sent), and click on Import Users.
You will see a green success message or be prompted to correct something in the CSV file.
Creating user accounts using a csv import will also generate an email confirmation to the user who completed the import. The email will include a list of all users successfully created.

Uploading revised records for users

You are able to upload revised user records to the system. When you do the system will compare the records and in some circumstances ask you to confirm which record you want to use.

The system will respond the following way when you update records: If the user has the same group but a new role compared to their previous record - system will update the role and everything else (start and end date, and account status). You will be asked to confirm whether you want to update the user record. If the user has a different group from their previous record that group will be added to the user's account and all other information will be updated. If the user has the same group and same role as their previous record the system will automatically update everything included in the csv.

When the system finds two records for the same user it will display the two records. Currently, these lines look identical but we are working on adding a popover card to display the conflicting information so users can more easily decide which record to import.

Note that you can choose to update no records, update all records, or individually select which records you'd like to update.

When you look at a list of users note that records displaying in red indicate users with disabled accounts.

How to add individual users

Navigate to Admin>Manage Users.
Click 'Add New User'.
Provide the required information and set Permissions for the user. Note that you must click Add Permission after you've selected the appropriate group and role for the user.
After you've added a permission you may see the option to define a curriculum track if curriculum tracks exist for the relevant organization. Use the dropdown selector to set a user's curriculum track if necessary.
Linking a user to a department may mean that certain reports include the user (e.g., faculty reports, work force reporting). A user can be linked to multiple departments/divisions.
Leave email notification active or turn it off and click Add User. You will see a green success message or be prompted to correct something on the page.

How to create guest accounts for users to access individual communities

To give someone access to a specific community and its documents, navigate to the desired community. You must be a community administrator to add a guest member.
From the Admin Center of the specific community, click 'Manage Members'.
Click the Add Guest Members tab.
Complete the required information and click 'Add Guest'.
You'll receive a green success message and the guest user will receive an email with further instructions. The user will only have access to the specific community.

How to deactivate users

Navigate to Admin>Manage Users.
Search for the appropriate user and click on his/her name.
From the User Management box on the left, click 'Edit Profile'.
Under Account Options set an Access Finish date and time. To immediately end a user's access, change the account status to Disabled and put in the current date and time.
Click 'Save'.

Manage Cohorts

The Manage Cohort tool allows you to create groups of users such as cohorts and course lists. You can add specific learners to cohorts and set them as the audience for courses and events. Cohorts can also be used as a filter setting on the Events tab. Only users with admin. roles in Elentra can manage cohorts.

In some cases cohorts can be automatically populated based on information provided about a user when using a csv import to create users. The graduation year provided in the csv will be used to slot the learner into the appropriate cohort. Note that the appropriate cohort must exist before you import users for this feature to work.

How to add a new cohort

When creating a cohort you can import a csv of users and their affiliated cohorts, or select users to add to the cohort through the user interface.

To import cohorts:

Navigate to Admin>Manage Cohort.
Click 'Import/Export' and 'Import Cohorts from CSV file'.
Download the sample template as needed.
Complete the template and click 'Chose File' to add the template.
Using this tool will create any new cohorts included in the csv and add users appropriately.
Note that this tool cannot be used to create users; any user included in the cohort import must already exist in Elentra.

To manually create and add users to a cohort:

Navigate to Admin>Manage Cohort.
Click 'Add New Cohort'.
Complete the required information, noting the following: Cohort Name: Make this clear as it will show up in various contexts throughout Elentra. Examples include Class of 2021, Class of 2022. etc. Cohorts will sometimes be available as filter options in Elentra. Cohort Type: Define the type of cohort you are creating.
- Cohort: This is generally a full list of learners moving through a program together for a duration of time. They may take multiple courses together.
- Course list: A course list is a type of cohort. It is generally a list of learners in one specific course for a set duration of time.
If you select Course List, note that you'll be prompted to select a specific course.
In the Add Learners section, click on the arrow to access a list menu of user groups. Click through the options to access the users you want to add to the cohort. Note the Select All option at the top of the list in case it is useful.
To remove a name from the list, click the small x beside the name to be removed.
Click 'Proceed'.

Once a cohort exists it can be added as the audience of an enrolment in a course or event, or used as a filter setting on the Events tab.

How to edit an existing cohort

Navigate to Admin>Manage Cohort.
Search for and click on the name of the cohort you want to edit.
To edit the cohort name, click the pencil icon to the right of the name. Change the text and click 'Rename'.
To delete users from the cohort click the red minus button to the right of the user name. You will be prompted to deactivate or delete the user.
You can switch the group type from the dropdown menu. If you are turning something into a course list you'll be required to add the relevant course. If you switch group type you must save your change using the small Save button to the right of Group Type.
You can add additional learners using the same process explained above.
When you have completed your edits to the cohort, click 'Proceed'.

How to delete a cohort

Navigate to Admin>Manage Cohort.
Click the checkbox beside the cohort you wish to delete.
Click the red Delete Selected button.
You will be prompted to deactivate or delete the cohort.
Confirm your choice.

User Permissions

Most use of features in Elentra is based on a users group and role permission. A user can be assigned multiple group and role permissions within an organization and can hold the same permission across multiple organizations.

Below are group and role settings and their general system permissions. Please remember that your installation of Elentra may have customized aspects of the software and changed the access of specific group and roles.

Group

Role

System Permissions

Alumni

Year of Graduation

Have basic read-only access.

Faculty

Admin

Faculty Admin can pretty much do anything in the system within their designated organisation.

Faculty

Director

Course Directors can edit the content of any course pages / website or learning event that they are designated as a "Course Director" for on the Admin > Manage Courses page.

Faculty

Basic read-only access as faculty members.

Faculty

Lecturer

Teaching faculty can edit the content of any learning event that they are scheduled to teach.

Medtech

Admin

System administrators can pretty much do anything in the system regardless of any organizational restrictions.

Medtech

Staff

Have basic read-only access.

Resident

Lecturer

This can be used in UG installations where residents act as lecturers.

Resident

This can be used in UG installations where residents play some role. Do not use this group and role for PG installations of Elentra using CBME; in that case the residents should be student:year.

Staff

Admin

Organization administrators can pretty much do anything in the system within their designated organisation.

Staff

Pcoordinator

Can add, edit, or delete learning events and manage any content within any of the courses they are designated as a "Program Coordinator" for on the Admin > Manage Courses page

Staff

Staff members have basic read-only access.

Staff

Translator

TBD

Student

Year

Students have basic read permissions to most public modules. They can also edit and in some cases remove information that they add themselves (e.g. discussion forum comments). It is important to note that students cannot be granted access to any administrative module within Elentra. There is a hard-coded exit in case all other security restrictions fail and they access /admin/*

Staff>Admin group and role is organisation specific whereas Medtech>Admin can access all organisations within an installation.

If you are creating users for an organisation with Competency-Based Medical Education enabled, you should assign the learners group: student, role: year for the learners to appear on the necessary screens.

A more detailed matrix of user ability across modules can be found here.

For information on Masked Permissions please see the Users>Profile Preferences help section and User Tools>Masking ID.

Clinical Faculty Checkbox

When you add group:role permissions to faculty users you will notice a Clinical Faculty checkbox in each organization they are a part of. When you add a user through the user interface this will automatically be checked off. Note that as of Elentra ME1.12 you cannot set a user as a clinical faculty member in one organisation but not another.

This is mostly a tool to store information and is rarely used elsewhere in Elentra. One place it is used is when reporting on annual reporting. When generating reports on annual reports you can filter by clinical and non-clinical faculty (see below).

User Disclaimers

A user disclaimer can be set up to appear on the start page or your Elentra installation or when users try to access specific courses or communities. This tool is only available to users with admin roles.

How to set a user disclaimer

Navigate to Admin>System Settings.
Click on the organisation you want to set a user disclaimer for.
Click 'User Disclaimers' from the left sidebar.
Click 'Add User Disclaimer'.
Complete the required information noting the following: Effective Date: Set when the disclaimer will show up to users. Trigger: Decide when this disclaimer should be applied. If you select course or courses, you'll have to select the specific course(s). If you select community, you'll have to select a specific community. Additionally, you must be an administrator of a specific community to add a disclaimer to it. When someone declines: Decide what should happen if someone declines the disclaimer. Click the checkbox to receive email notification of any declines. There is currently no user interface add additional emails in the case of a declined disclaimer. Audience: Click the down arrow beside Browse All Users and continue to click through to add your audience. Note that it is intentional that you can only drill down to the role level or user and not individuals. To delete any group from the list, click the small x beside the group.
Click 'Save'.
Edit an existing disclaimer by clicking on the disclaimer title which will open an edit page.
Delete an existing disclaimer by clicking the trashcan icon in the last column.

After a user disclaimer has been accepted by at least one user you can no longer edit the content. If you need to replace the disclaimer, you must delete the existing disclaimer and create a new one.

How to report on user disclaimers

After a user disclaimer is active you can view who has accepted or declined the disclaimer.

Navigate to Admin>System Settings.
Click on the organisation you want to view a user disclaimer for.
Click 'User Disclaimers' from the left sidebar.
Find the name of the user disclaimer you wish to view and click the eye icon in the last column.
A list of users who have approved the disclaimer will be displayed. Click on 'Declined' to view users who have declined the disclaimer.

How users experience disclaimers

When users with an active disclaimer try to access the system or a course/community (depending on how you configure the disclaimer) they will be asked to accept or decline the disclaimer. They also have an option to print a copy of the disclaimer for their own records.

User Metadata

Elentra provides administrators with the option to keep track of any information about users, for example immunization records, police checks, mask and gown size, etc. At present, there is no interface for users to adjust these records about themselves.

How to create a meta data field

Navigate to Admin>System Settings.
Click the name of the organisation you want to create meta data for.
Click 'User Meta Data' from the left sidebar.
Click 'Add Meta Data'.
Complete the required fields, noting the following: Parent: You can created a nested hierarchy of meta data fields (e.g. immunizations: tetanus, measles, influenza, etc.). To do this, you must first create the parent meta data category, then when you create the nested fields, select the parent from the dropdown menu. Restricted to Public: Select Public Viewable if you want users to be able to see their own meta data. Select Restricted to hide the meta data fields from users and allow only administrators to see the information (these items will appear with [Admin view only] on the list of meta data fields). Group: Select the group(s) to apply this meta data to. To delete a group from an existing list, click the minus button beside the group name.
Click Save

How to complete a meta data field

Navigate to Admin>Manage Users.
Click 'Manage User Meta Data' from the left sidebar.
Set the required fields to reflect the information you want to input.
Click 'Show Table'.
Click 'Export/Load'.
Click 'Export CSV' to download a file with the list of users and other relevant column headings.
Complete the file, noting the following:
- Type: Type reflects the meta data you are entering. You do not need to fill this in on the file unless you are uploading multiple meta data categories using one file.
- Value: Make this the main data (e.g. shoe size: value=10).
- Notes: This can be used to record any additional information (e.g. Received record from health unit on Jan. 16, 2015).
- Effective date and Expiry date: These should be listed in yyyy-mm-dd format.
The fields for this import are optional so unused columns should be deleted before importing the file.
Click 'Import CSV' to upload the file.
You will be prompted to map the CSV columns you've included with the meta data fields available in the system. Click and drag any unmapped fields to the appropriate place as needed.
Choose whether to replace existing data with information in the spreadsheet, and whether or not to delete existing records if information is empty in the spreadsheet (click each check box as needed).
Click 'Import'.
Alternatively, you can add individual records one by one by clicking on 'Add record' for an individual from the meta data category main screen.

How to see user meta data

To view user meta data for a group:

Navigate to Admin>Manage Users.
Click 'Manage User Meta Data' from the left sidebar.
Set the required fields to reflect the information you want to view.
Click 'Show Table'.
You'll see a list of all users and their existing records.
This information can be exported as a csv.

To view all meta data for an individual:

Navigate to Admin>Manage Users.
Search for the required user and click on his/her name.
Select 'Edit Meta Data' from the sidebar User Management section.
You'll see a list of meta data records for the user.

How users can see their own meta data

Users can view their user profiles by clicking on their names at the top of the Elentra screen.
If meta data is required/logged for the user s/he will see an Extended Profile tab.
By clicking on this tab users will see any meta data collected for them AND which is set to Public Viewable.
At present, there is no interface for users to adjust these records about themselves.

User Incidents

The User Incident tools allows an organisation to keep a record of an incident involving a user.

How to record a user incident

Navigate to Admin>Manage Users.
Search for the relevant user and click on his/her name.
In the User Management box on the left sidebar, click 'Incidents'.
Click 'Add New Incident'. Note that the system will automatically record and display the name of the user who creates an incident.
Provide the required information noting the following: Severity: Incident Severity cannot currently be configured through the user interface. If you wish to change the available incident severity levels you will need help from a developer. Status: An open incident can be edited for more information to be added including any follow-up. If an incident is closed its appearance will be greyed out when viewing a list of incidents. Dates: Both the incident date and the date of any follow-up can be recorded. Details: Information provided here is not currently visible to the user although it will be accessible to users with permission to view learner incident reports. The system will not automatically record and display the names of users who add to the initial report.
Click 'Save Incident'.
Incidents will display on the user profile page but are only accessible by users with admin roles. By default users do not currently have the ability to access their own recorded incidents.

How to report on open and closed incidents

Navigate to Admin>System Reports.
Scroll down to Learner Incident Reports.
Click on the appropriate report, fill in the necessary information, and click 'Create Report'.
Click on the name of a user or title on an incident to see the details.

User Profile Preferences

Users can view information about themselves (some they can edit, some they can't) through their My Elentra ME Profile.

How to access a user profile

Any user type should see their own name at the top of the page.

Click on the name to open the user profile.
Personal Information tab: Here, users can update their email address, phone number, and mailing address. Faculty users can set office hours. This is also where faculty users can consent to video recording (required to use the automated lecture capture tools, see below).
Extended Profile tab: This will appear only if there is user metadata in place and set to be visible for the user.
Account Information tab: Here, users can view their username and change their password. If CBME is enabled for your organisation, this is also where users can set their PIN for assessment and evaluation forms.
When making any changes, users must click 'Save Profile' when complete.

New in ME 1.13! Faculty users will see a consent checkbox for video capture of lectures on their personal information tab.

How to edit privacy settings

Click the username badge to open the user profile.
Click 'Privacy Preferences' in the Profile card in the left sidebar.
Set the preferred privacy setting and click 'Update Privacy'.

How to edit notification settings

Click the username badge to open the user profile.
Click 'Notification Preferences' in the Profile card in the left sidebar.
Active Notifications tab: Users can search for and delete any active notifications from here. Active Notifications usually includes any comment and discussion threads a user signed up for from a learning event.
Community Notifications tab: Users can enable or disable community notifications here. This will overrule the community setting (e.g., if the community admin. creates an announcement and sets it to notify community members).

How to provide admin assistants access to faculty accounts

This tool is available to most users, except Faculty:Faculty who have read-only access. Note that it this tool is not just the storage of administrative assistant information; for example, it allows an administrator to act in the system under the identity of the faculty member. As a result, this feature should be used carefully.

Click the username badge to open the user profile.
Click 'My Admin Assistants' in the Profile card in the left sidebar.
Type in the name of another user, and click on it.
Set access start and finish dates and times to limit when the admin. will be able to be masked as the faculty member. By default it will set access to for one week.
Click 'Add Assistant'.
To remove an admin. assistant click the checkbox beside their name and click 'Remove Assistant'.

In this example a faculty member has granted three admin assistants access for different lengths of time.

If faculty link their account with admin. assistants, the admin assistants will see a Permission Masks card on their sidebar and can select to use another id at any time during the active linkage.

Profile Photos

Elentra allows there to be two profile photos stored for each user: an official photo and a user uploaded photo. The official photo must be uploaded by an administrative user. If a user's account has both an official photo and a user uploaded photo, the official photo will be used first.

User photos appear through out Elentra. Some examples include in People Search and when triggering or completing Assessment and Evaluation forms.

Photos can be imported through the user interface in a user's profile but there is also a photo import tool that a developer can use to bulk import multiple official photos.

Please note that if a user does not want his/her photo displayed in Elentra s/he can change his/her privacy settings in the user profile. If users select Minimum Profile their photos will be hidden from other users.

Photo Import Tool

If you want to bulk import user photos you will need help from a developer. The work a non-technical staff member can do is to prepare a folder of the required photos. Each photo should be named using Lastname_Firstname.jpg and/or StudentNumber.jpg. You don't have to worry too much about the size of the photos since Elentra will automatically resize them as needed.

Profile Photo Upload by User

If users want to upload their own profile photos they can do so through their profile. On the main Personal Information page, users can hover over the empty photo spot and click Upload Photo to add a photo.

Note that they can toggle between the official and uploaded photos to view the two photos they might have on file.

A user can't delete his or her photo. They can upload a new photo to overwrite their existing uploaded photo.

Student Management

There are a variety of tools available to help manage student records while they are active in your organisation.

User Profile: Store basic information like name and contact information
User Meta Data: Store additional information like vaccination records, background checks, etc.
Incident reports, disciplinary action and formal remediation can also be recorded through Elentra
Medical Student Performance Records: Pull in existing data from Elentra and allow learners to submit additional documentation to forward to residency matching bodies
Observerships: Allow learners to request observerships and have them be approved (or not) by curriculum coordinators
Leaves of Absence: Track leaves of absence
Attendance Tracking: Track learner attendance at the event level

Some of these topics have their own help sections while others are addressed below.

Disciplinary Actions

When an organisation wishes to record disciplinary action taken in response to a student's behavior, they can do so using the Discipline feature of the student's user profile.

Note that the Manage Incident feature might also be useful in this context and more information about Manage Incidents can be found in the User Management help section. Note that whereas Incidents is available to use with any user, Discipline is available only on student user profiles.

How to add a disciplinary action to a learner's profile

Navigate to Admin>Manage Users.
Search for the appropriate user and click on his/her name.
From the Student Management box on the left sidebar, click 'Disciplinary Actions'.
Click 'Add Disciplinary Actions' to create a new disciplinary action.
Provide the relevant details and click 'Add Action'. Unlike Incidents, the creator of a disciplinary action will not automatically be recorded and displayed.
Currently, learners can't view their own disciplinary actions.
To delete an existing action click the red minus icon beside the relevant action.

By default learners can not see their own discipline records through Elentra and such records are only accessible by users with admin roles.

Formal Remediation

When an organisation wishes to record formal remediation taken in response to a student's performance or behavior, they can do so using the Formal Remediation feature of the user profile.

How to add formal remediation to a learner's profile

Navigate to Admin>Manage Users.
Search for the appropriate user and click on his/her name.
From the Student Management box on the left sidebar, click 'Formal Remediation'.
Click 'Add Formal Remediation' to create a new remediation action.
Provide the relevant details and click 'Add Remediation'. Unlike Incidents, the creator of a formal remediation entry will not automatically be recorded and displayed.
Currently, learners can't view their own formal remediation records in Elentra.
Delete an existing remediation by clicking the red minus icon beside the relevant remediation action.

By default learners can not see their own remediation records through Elentra and such records are only accessible by users with admin roles.

Leaves of Absence

Elentra can be used to track learner leaves of absence. These need to be logged by a curriculum coordinator and can be done through a user's profile page.

Navigate to Admin>Manage Users.
Search for the appropriate user (the person taking leave) and click on his/her name.
From the Student Management box on the left sidebar, click 'Leaves of Absence'.
Click 'Add Leave of Absence' to create a new absence.
Provide the relevant details and click 'Add Absence'.
Delete an existing absence by clicking the red minus icon beside the relevant absence.

MSPR

The MSPR is a collection of information about a student including activities completed during medical education, comments about student performance in clinical settings, amount of time spent in different departments or specialities, etc. In Canada, this information is provided by undergraduate medical education offices to the Canadian Resident Matching Service (CaRMS).

Additional information about how to manage and use the MSPR in general can be found in the MSPR help section.

Observerships

When a learner submits an observership, a program coordinator can approve their observership request.

How to enter an observership as a learner

From any page in Elentra, click on your name badge in the top right corner to open your user profile.
From the Profile window on the sidebar, click 'My Observerships'.
Complete the required information.

How to approve observerships as a program coordinator

Navigate to Admin>Manage Users.
Search for the appropriate user and click on his/her name.
From the Student Management box on the left sidebar, click 'Observerships'.
Pending observerships will be displayed for you to approve.

How to report on completed observerships

Navigate to Admin>System Reports.
Scroll to MSPR Reporting and click on 'Observership Report'.
Set the date range and additional filter fields if desired, and then click 'Create Report'.

Communities

A community can be set up by any user to provide a space to share documents, have online discussion, etc. It can be set up as protected and only accessed by authenticated users and further can be configured to require registration or not, etc. There are three types of communities which can be used for different purposes. The three types are: community, course website, and learning module. More detail is in the Community>Types help section. All communities can be configured to include features like announcements, discussion boards, document sharing, quizzes, events, polling, etc.

Notably, communities is one of the few modules of Elentra that is not organisation specific. That means you can see communities created within one organisation across all organisations and you can add users from any organisation to any community. When users are logged in they can access any of their communities without toggling between their organisations.

Often an organisation's staff maintains course website communities, committee communities, and learning modules. Individual users can create communities for their study groups, professional learning communities, sports teams, etc.

Community Types and Uses

There are three types of communities: generic communities, learning module communities and course website communities.

Generic Communities

A community (most generic) would be most appropriate for a school committee, student work group, or social group. By default it just has a home page but users can add announcements, discussions, document sharing, etc. Through these functions you can post announcements (and send email notification of announcements to registered community members), host discussions, use poll and quiz functions, etc. Examples: Curriculum Committee, Surgery PBL Group 2, Undergraduate Cooking Club.

Learning Module Communities

Learning module communities are most appropriate to use if you want to create an educational module for users (e.g. a module on infection control in the hospital). The pages you can select from include introduction, objectives, foundational knowledge, testing understanding, etc. Users will be able to navigate through the pages as you've set them up. You can embed video, images, etc.

Course Website Communities

New in ME 1.16, you can now copy a Course Website. You can edit the content of the Course Website to update it for any course changes and rename the copied Course Website for the new academic year.

You can use a course website community to turn the basic information about a course completed through the course set up page, into a course website. A course website uses a template to create pages like background, course calendar, units, prerequisites, course aims, etc. The Learning Objectives and MCC Presentation pages are configured to auto-populate with the curriculum tags assigned to the course through the course setup.

Creating a Community

Any user can create a community and communities are not organisation specific. For that reason, a community built in one organisation will be visible to users in other organisation.

Click 'Communities' in the main tab menu.
Click 'Create a Community'.
Step 1: Choose a category for your community by clicking on the appropriate title (e.g., Administration, Courses, Careers in Health Care). The list of community categories cannot be changed through the user interface but can be adjusted by a developer if desired by your organisation. Categories may be later reviewed to see how users are using communities but there are no filter settings or reports that rely on these categories.
Step 2: Provide the required details, noting the following:

Community Details

Name: Pick a descriptive but concise name.
Keywords: These will not be visible to users but will be applied when someone searches for an existing community.
Description: This will be displayed to any user who searches for or tries to access the community.
Shortname: This will be part of the community url. It must be lower-case, less than 20 characters, and include only letters, numbers, underscore or period. After this is set there is no user interface to change the url so pick carefully!
Type: Select the appropriate type from the dropdown menu. More detail about community types is available in the Communities>Types help section.
If you are creating a course website, indicate which course should be connected to the community. Note that you can connect multiple courses to one course website and they will share their student-facing website. More information about this is in the Courses>Websites help section.
Template: A selection of templates are available but only those applicable to the community type you select will display. Click on the magnifying glass icon in the corner of each template to see a sample of its appearance. The templates are titled with their suggested uses.

Community Pages

Different types of communities have different pages available. In generic communities the only page included by default is Home. Tick off the additional pages required. In course websites, a series of default pages are required. You will be able to add additional pages but there is not ability to delete or hide the included pages (unless you get a developer to change this in your installations database). In learning modules, you must check off any pages you wish to include.

Community Permissions

Here you can control how users access and use the community. Details about each option are included inline on the screen.
Many organisations set the permissions for their courses as Protected Community and Open Community but of course it is up to each organisation to decide this.
Click 'Create'.
You will be redirected to the community and as the creator of the community can manage all pages. You'll notice an Edit button on each page. Click on it to add or edit content on any page. Additional information about managing a community is in the Communities>Manage help section.

Additional information about creating a course website can be accessed in the Courses>Website help section.

Community Pages

Anyone who is the administrator of a community can use various tools to manage community content and pages. If you create a community you will automatically be a community administrator. Different pages are templated to serve different functions and different community types come with specific page types. In most communities you can delete pages or hide them from view if they are unneeded (one exception is course websites which require you to use the templated pages). You can add pages of most types to any community and control which users have access to the page and how they interact with it (e.g. can upload or download files, can comment on files, etc.)

What types of pages exist

Within each community, a variety of pages are available. Below are listed the pages and their basic functions.

Default Content: Allows you to add any information to the page using the rich text editor (includes ability to embed media and post images).
Announcements: Allows you to post announcements to the community. You can also choose to send notifications to community members when announcements are made. Announcements can also be set to be made visible on the home page (set this from the home or background page itself).
Discussions: Allows community members to initiate and participate in discussions. Once a discussion space has been created by a community administrator (this includes a category and a forum), users will be able to create topics within the forum. The system is set up to allow threaded discussions and users can also subscribe to an RSS feed of a discussion using Live Bookmarks, My Yahoo! or another RSS application. Note that a discussion page added to a course website will have slightly more options than a discussion page in a generic community; for example, in the course website when you add a forum to a discussion page you can restrict access to the forum to specific course groups.
Document Sharing: Allows community members to upload, share, and download files. Folders and subfolders can be created to help organise files. Permissions can be set at the file and document level to control who can upload new versions of a document, who can access it, etc.
Events: Post events for the community and choose whether or not to notify members of said event. Allows user to provide a title, date and time, and description for an event.
Galleries: Galleries allows you to create folders in which to store images. Permissions can be set to allow users to upload, view, and comment on images. Images will display using thumbnails.
Polling: This page allows you to create polls and make them available to members of the community.
Quizzes: This page allows you to post quizzes created through Manage Quizzes.
BasicLTI Consumer: LTI stands for Learning Tools Interoperability and is a way for one system to send a user to another system fairly seamlessly. This page type allows you to connect to an LTI provider your school has an existing arrangement with (e.g. Khan Academy, turnitin, Quizlet, etc.). You'll need to provide specific information from the LTI provider in the applicable fields. In some cases LTIs are free so you might not need a key and secret.

Please note that for all of the listed page types and their functions, the audience will be members of the specific community. If you want to create a notice to display on the main Elentra dashboard in the Message Center you should use Admin>Manage Notices. If you want to create a poll targeting all students, faculty or staff you should use Admin>Manage Polls. If you want to create scheduled learning events to be associated with a course, specific audience, faculty, etc. and to display in faculty and learner calendars you must use Admin>Manage Events. When you use page types and their features in a community space they are for members of that community only.

Course Website

Most of the pages included in a course website template are default content type and allow you to add information. The exceptions to this are the Background, Course Calendar, Learning Objectives and MCC Presentations pages; these have some information that will auto-populate based on information provided during the course setup.

Background: This page will display the name and contact of a course director and curriculum coordinator (if applicable). It will also display any content added to the Course Description of Director's Message fields on the Manage Courses>Course Setup page. If you enable display community history for this community, that history will display on the background page. As of Feb. 2018, additional text added via the background page text box will not show up. If you enable announcements or events for this community, they will also not display on the background page (even if you check that they should).
Course Calendar: This page will display a list of all events within a course.
Prerequisites: This page is blank unless content is added.
Course Aims: This page is blank unless content is added.
Learning Objectives: This page will be populated with the curriculum tags assigned to the course through the Course Setup tab.
MCC Presentations: This page will be populated with the clinical learning objectives assigned to the course through the Course Setup tab.
Teaching Strategies: This page is blank unless content is added.
Assessment Strategies: This page is blank unless content is added.
Resources: This page can have text added to it. It will not automatically display the resources added to the course via Manage Courses (we are exploring changing this).
Expectations of Students: This page is blank unless content is added.
Expectations of Faculty: This page is blank unless content is added.

Learning Module

Community Title: This is the title page of the learning module. It could include information like the affiliated course, intended audience, or instructions for using the module.
Introduction: This page introduces the learning module.
Objectives: This page is blank unless content is added.
Foundational Knowledge: This page is blank unless content is added.
Formative Assessment: This page is blank unless content is added.
Test your understanding: This page is blank unless content is added.
Summary: This page is blank unless content is added.
Credits: This page is blank unless content is added.
Print Version: This page provides users with the ability to export the learning module in a print-friendly version.

How to add content to community pages

When logged in and on a community page, you have two options to manage the content on community pages.
In many community templates as a community administrator you'll see an Edit button on most pages. By clicking on the button you'll be taken to a screen where you can edit the content and save your work. As a community administrator you'll also see an Admin Center card in the left or right sidebar. Click on 'Manage Pages' to access a list of all pages in the community.
Click on the name of the page you wish to edit.
Adjust the page attributes (e.g. parent page, menu and page title, etc.) and add any content you wish to.
Click 'Save'.

How to add new pages to a community

Log into Elentra and navigate to the community you want to edit.
If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Manage Pages' to access a list of all pages in the community.
Click 'Add New Page'.
Set the page details and add content if needed. Remember that different pages serve different functions. For an overview of page types see above.
Click 'Save'.
Add the required content to the page.

How to control access to individual pages

Access a page either by clicking on the Edit button or by navigating to Manage Pages and clicking on the page name.
In the Page Permissions section, check off the tick boxes to decide who can view the page. Scroll down and click 'Save'.
Note that in some community types (e.g., course website), the required pages can not be hidden from the menu.

How to hide pages from view

Access a page either by clicking on the Edit button or by navigating to Manage Pages and clicking on the page name.
In the Page Option section, set the page visibility to 'Hide this page from menu'. This will prevent users from seeing the page, however the page still exists. If a user knows or guesses the url s/he will be able to access the page. Scroll down and click 'Save'.

How to nest pages

Access a page either by clicking on the Edit button or by clicking Manage Pages in the Admin Center and clicking on the page name.
In the top section of the page settings, find the 'Page Parent' section. Select a parent page from the dropdown options. Scroll down and click 'Save'.
This will create pages that are children, or nested, below other pages.
The first and second levels of menu titles will show up on the menu. Additional levels will show up on tabbed or list menus once the parent page is clicked on. This will appear differently depending on the template you've selected. See samples of different nesting page displays below. The Committee, Learning Module and Virtual Patient templates will allow for a mouseover display of second level menu titles and then will display third level titles in a list on the left side. The default and course website templates will display the first and second levels down the left side and third level titles as tabs across the top of the page.

Announcements

How community administrators can post announcements

As a community administrator, navigate to a community and click the Announcements page.
Click 'Add Announcement'.
Provide a title and announcement body.
If you wish to send out notifications to the community members that the announcement has been posted check off the appropriate box.
Set the Time Release Options for the announcement. This controls when that announcement will start and stop being visible to users.
Click 'Save.'
To edit or delete existing announcements, navigate to the community announcement page and click 'edit' or 'delete' beside the announcement you want to modify.

How community members can view announcements

Depending on how a community is set up, announcements might be displayed on the community home page. However, if they are not, community members can still access announcements from the Announcements page.

Navigate to a community and click the Announcements page.
The announcements will be displayed.

Community members can subscribe to an RSS feed of the community announcements by clicking on the small RSS icon.

Allowing community members to post announcements

As a community administrator you can set the Announcement page permissions to allow community members or browsing non-members to post announcements.

Click on the Announcements page within a community.
Click 'Edit Page'.
Scroll down to the Page Permissions section and make your choices.

If you allow members to post announcements, you can additionally configure whether or not you'd like community administrators to have to moderate member-created announcements.

Members will have the same options as administrators when creating announcements (e.g. to notify members of the community and to time release the announcement).
If the announcement is to be moderated, members will be notified of that.

If you are a community administrator, you will be alerted to announcements requiring review on the Announcements page.

Click to view the announcements and release, edit, or delete them as appropriate.

If you release an announcement, it will appear on the Announcements page for community members to view.

Discussions

How community administrators can start discussions

As a community administrator, navigate to a community and click 'Discussions'.
Click 'Add Discussion Forum'.
Provide a title, description and category. The forum category will be the most easily viewable label for users, think of it as a folder or label for the discussion forum. You can eventually create multiple discussion forums within one category. The description will be visible to users once they have clicked the category name.
Set permissions for the discussion forum. You can customize which community member types can view the forum, write new posts, and reply to posts.
Set the Time Release Options for the discussion forum. This controls when the discussion forum will be accessible to users.
Click 'Save.'
To edit or delete an existing discussion forum, navigate to the discussions page, click on the category name, and then click 'edit' or 'delete' beside the discussion forum you want to modify. If you delete a discussion and it was the only discussion forum in a category, the category will also be removed.
Note that community members who participate in discussion forums have the option to post anonymously, however, community administrators will be able to see the identity of all users who post to a discussion, whether anonymous or not. If you have faculty in community administrator roles responding to discussion posts it may be worth letting them know that students may be posting anonymously.
Using Discussions in a Course Website/Community: Note that if you use Course Groups you will have the option to customize a discussion board to have a specific course group as its audience.

How community members can participate in a discussion thread

Navigate to a community and click 'Discussions'.
Click on a discussion category name.
Click on a discussion forum title.

Creating a new post

Click 'New Post'.
Add a post title and body.
Users can choose to make their comment anonymous by checking the box beside 'Hide my name'. Note that the user's identity will still be visible to community administrators.
File Attachments: Users can select a file from their computer to upload with their comment.
Set the Time Release Options to set when the comment will be visible to community members.
Click 'Save.'
The author of a comment and community administrators can edit or delete existing comments by clicking 'edit' or 'delete' beside a comment.

Responding to a comment

Navigate to a community and click 'Discussions'.
Click on a discussion category name.
Click on a discussion forum title.
Click on a topic title.
Click 'Reply to Post'.
Add text, decide whether to make the post anonymous, attach a file if required, set time release, and click 'Reply'.
The author of a comment and community administrators can edit or delete existing comments by clicking 'edit' or 'delete' beside a comment.

Subscribing to Discussions

Users can use subscribe to discussion forums using an RSS feed or email notifications.

Document Sharing

As a community administrator, navigate to a community and click 'Document Sharing'.
Click 'Add Shared Folder'.
Provide folder details noting that you can create sub-folders as needed. The folder description will be visible to community members.
Set permissions for the folder. You can customize which community member types can browse the folder, upload files, and comment.
By default folders are visible to students. If you'd like to hide the folder from students, click the appropriate radio button.
Set the Time Release Options for the folder. This controls when the folder will be accessible to users.
Click 'Save.'
To edit or delete an existing folder, navigate to the document sharing page, click on cog to the right of the folder title and then make a selection from the dropdown menu.
Note that within document sharing you can reorder folders, move files within folders, and expand all folders to view all files. Click on the appropriate button for each task from the document sharing page.

Remember, a community member's ability to upload files in a folder is controlled by permission settings when the folder is set up.

Navigate to a community and click 'Document Sharing'.
Click 'Expand All Folders' to quickly view all existing files if desired.
Click the cog beside a folder name and select 'Add File' from the dropdown menu.
Browse your computer or drag and drop a file into place.
Provide file details and set the access method and file visibility.
Batch File Permissions allows you to customize who can view and upload new versions of files.
Batch Time Release Options controls when this file will be accessible to other community members.
Complete the Acceptable Use Agreement by checking the box and click 'Upload File(s)'.
To delete or modify an existing file, click on the cog to the left of the file title and select the appropriate action.

Community members can share urls and HTML through a document sharing space; their ability to do so is controlled by permission setting when a folder in document sharing is set up.

Navigate to a community and click 'Document Sharing'.
Click 'Expand All Folders' to quickly view all existing files if desired.

For urls

Click the cog beside a folder name and select 'Add Link' from the dropdown menu.
Provide link details and if applicable open the Advanced Settings menu. Access Method: Define where the URL should open. Iframe Javascript Resizing: Select whether the resize the iframe. Session Variables: More information coming soon. Hide link from students: Define whether or not to allow students to see the link.
Batch Link Permissions allows you to customize who can view and upload new versions of links. If you select Course Groups you'll be able to further set how browsing non-members can interact with the link (assuming your course community is open beyond enrolled learners).
Batch Time Release Options controls when this link will be accessible to other community members.
Click 'Save'.
To delete or modify an existing link, click on the cog to the left of the link title and select the appropriate action.

For HTML

Click the cog beside a folder name and select 'Add HTML' from the dropdown menu.
Provide document title, description, and content.
Set the access method.
Decide whether or not to hide the document from view.
Set viewing permissions to customize who can view the document.
Set the Time Release Options to control when this document will be accessible to other community members.
Click 'Save'.
To delete or modify an existing HTML document, click on the cog to the left of the document title and select the appropriate action.

How community members can comment on shared documents

Navigate to a community and click 'Document Sharing'.
In Document Sharing, click 'Expand All Folders' to quickly view all existing files if desired. Click on a file name.
If you don't expand all files, click on the appropriate folder and then file name.
Click 'View Latest' to view the document (it will open or download depending on how its creator set it up).
Click 'Add File Comment'.
Provide a comment title and enter text into the comment body.
Click 'Save.'
The author of a comment and community administrators can edit or delete existing comments by clicking 'edit' or 'delete' beside a comment.

Events

How community administrators can post events

Please note that these events do not get added to a learner's calendar the way events scheduled via Manage Events do. To schedule events that apply to all learners in a cohort and should appear in an organisation's schedule please use Admin>Manage Events.

As a community administrator, navigate to a community and click 'Events'.
Click 'Add Event'.
Provide event title, location and start and finish times.
Provide details or a description of the event.
If you wish to send out notifications to the community members that the event has been posted check off the appropriate box.
Set the Time Release Options for the event. This controls when the event will be accessible to users.
Click 'Save'.
To edit or delete an existing event, navigate to the event page, and then click 'edit' or 'delete' beside the event you want to modify.

How community members can view events

Depending on how a community is set up, events might be displayed on the community home page. However, if they are not, community members can still access these items from the applicable page.

Navigate to a community and click 'Events'.
The events will be displayed.
Note that on the events page users can switch between viewing the day, week, month, or year's worth of events.

Galleries

As a community administrator, navigate to a community and click 'Galleries'.
Click 'Add Photo Gallery'.
Provide gallery details including title and description. The gallery description will be visible to community members.
Set permissions for the gallery. You can customize which community member types can view the gallery, upload photos, and comment.
Set the Time Release Options for the gallery. This controls when the gallery will be accessible to users.
Click 'Save.'
To edit or delete an existing gallery, navigate to the gallery page, and then click 'edit' or 'delete' underneath the gallery you want to modify.

How community members can post images in a gallery

Navigate to a community and click 'Galleries'.
Click on a gallery name (remember a gallery must be built by a community administrator).
Click 'Upload Photo'.
Select a photo and provide a title and optional description. If a title is not provided, the filename (e.g., IMG_342.JPG) will appear in the title space when the image is displayed.
To be notified when users comment on the photo, click the checkbox beside 'Receive notifications...'.
Set the Time Release Options to control when this document will be accessible to other community members.
To accept the Acceptable Use Agreement click the appropriate checkbox (required).
Click 'Upload'.
To more easily upload multiple images at once, click 'Add Another Photo' which will increase the spots where you can upload images.

How community members can comment on images in a gallery

Navigate to a community and click 'Galleries'.
Click on a gallery name (remember a gallery must be built by a community administrator).
Click on an image.
Click 'Add Photo Comment'.
Type a comment (a title is not required, although will display in bold if provided).
Click 'Save'.
Comments appear in the order they were made with the oldest comment at the top of the list.
Users can edit or delete their own comments.
To quickly view more images in the gallery, use the Previous Photo and Next Photo buttons.

Polling

How community administrators can set up a poll

These polls function differently than polls set up via Manage Polls. These polls will only show up to users when they are in a community and navigate to the polling page (community administrators can send a notification to let community members know a poll is available).

As a community administrator, navigate to a community and click 'Polling'.
Click 'Add Poll'.
Provide polling details including title and description.
Decide whether or not to allow multiple votes by clicking the appropriate radio button. If you allow users to have multiple votes you should type in how many each gets (leave at zero for unlimited votes).
Set up the polling question in the Question Details section. Question: This is what you are asking. If you'd like to create a poll with multiple questions you'll need to create your first question, save the poll, and then you can add additional questions. Multiple Responses: Check this off to allow respondents to choose more than one response. If you pick this, type in the range of response numbers each participant can give (e.g., between 2 and 4 responses allowed). Responses: Add answer options here. Click on the blue plus button to add your response option. After your first response is added to the list, type in another and click the blue plus button again. Edit a response by clicking on it. Delete a response by clicking the red trash can icon. Reorder responses by clicking on a response and dragging it to the place you want it to be.
Set permissions for the poll to customize which community member types can view the poll, vote, view results (on an ongoing basis-usually most appropriate for the person controlling the poll), and post-vote results (meaning who can view the results only once they have already voted-usually most appropriate for the audience of a poll).
You can restrict voting to specific community members by clicking on 'Select specific members to vote'. If you choose this option, click on 'Select Group & Role' to refine the list of options. Begin to type in a name and click on it when you see the appropriate user.
If you wish to send out notifications to the community members that the poll has been posted check off the appropriate box.
Set the Time Release Options for the event. This controls when the poll will be accessible to users.
Click 'Proceed'.
You can now add additional questions if desired. To do so, click 'Add New Question'. Questions can be edited or deleted by clicking on the blue pencil icon or red trash can icon.
When you have added additional questions or made other changes, click 'Save'.
To edit or delete an existing poll, navigate to the polling page, and then click 'edit' or 'delete' beside the event you want to modify. You may also see a 'vote' option if the poll is set up to allow administrators to vote.
After at least one vote has been cast, administrators will also see a 'history' option beside a poll name. Click 'history' to see the current poll results.

How community members can participate in a poll

Navigate to a community and click 'Polling'.
Locate the appropriate poll and click 'vote'.
Whether the community member can view the poll results depends on how the poll is set up.

Quizzes

The Quizzes page of a community allows you to post links to quizzes created through the Elentra quiz module.

When an administrator adds a quiz s/he will be walked through several questions to configure the quiz as desired. Choices you can make include:

title and description (both will display to users)
optional or required
shuffle question order or not
time limit (in minutes)
number of attempts
immediate or delayed quiz results, or hiding the quiz results
time release options

Administrators can click the pencil icon beside a posted quiz to edit its settings.

Administrators can click the bar graph icon to view quiz results.

When community members view a quiz page they'll see all available quizzes. Completed quizzes will have a green check mark beside them and score and feedback accessible (if the quiz was set to release feedback).

External URL

An External URL page type allows you to add a url to a community. The menu title will be a live link that redirects a user to a new site when they click on it.

BasicLTI Consumer

As of ME 1.16, LTI Providers are added and configured in System Settings to use LTI Consumers in Course Pages, Course Websites and Learning Events.

Elentra offers the ability to integrate with LTI tools such as Quizlet, Turnitin, Google Classroom, etc. There are three areas where a LTI Consumer can be used: Course Pages created when a Course is added, Course Websites in Communities and Learning Events.

Managing Communities

Anyone who is the administrator of a community can use various tools to manage the community and its membership as well as view community statistics. If you create a community you will automatically be a community administrator. Note that being a community administrator is completely separate from the user permissions set via the user profile. Any user type can be made a community administrator.

Medtech:Admin. and Staff:Admin. users in the system can access all communities via Admin>Manage Communities and change community settings and membership from there. Simply click on the cog beside the appropriate community title and select 'Manage Community Members' or 'Manage Community.' If an admin user is also the administrator of a community, they'll be able to access a Manage Pages option from this cog as well.

General users will have to access a community from the Communities tab in order to edit its settings or members (assuming they are a community administrator).

How to add members

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Manage Members' to access a list of all members in the community.
Click 'Add Members' from the subtab menu.
Click 'Browse All Members' to access a user group and then select the group you'd like to look in.
Type in a name to search for a user or scroll through the list. Click the checkbox beside the name(s) of users you'd like to add.
After you have checked off all applicable names, click 'Add Members'.
To view the members you've added, click the Members tab.

How to promote members to be community administrators

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Manage Members' to access a list of all members in the community.
Click 'Members' from the subtab menu.
Click the checkbox beside the names of users you'd like to make administrators.
In the Select Member Action dropdown menu, select '3. Promote to administrator'.
Click 'Proceed'.
To view the members you've promoted to administrators, click the 'Administrators' tab.

How to demote, remove or ban members

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar.
Click on either the Members tab or the Administrators tab to see a list of different users.
Click the checkbox beside the names of users whose status you'd like to change.
In the Select Member Action dropdown menu, select the appropriate action.
Click 'Proceed'.

Removing a member will allow that person to rejoin the community at a later date. Deactivating or banning a user means the user will receive a message alerting them to this fact if they try to access the community and they will not have the option to rejoin.

How to edit the details or permissions of a community

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Details' or 'Permissions' as needed.
Edit the details or permissions of the community as needed and click 'Save Changes'.
Confirm your changes.

How to change a community's template

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Details'.
Switch the template you'd like to apply to the community and click 'Save Changes'.
Confirm your changes by clicking 'Save Changes' again.

How to view community statistics

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Manage Community'.
Click on the Statistics tab where you can view data usage, activity points and a tally of members by member type.
The quota usage listed under statistics is a soft limit and once exceeded will not prevent you from posting content. If you'd like to enforce a quota at your institution you'll need a developer's help.

How to deactivate a community

If you are an administrator of a community, you'll see an Admin Center card in the left or right sidebar. Click on 'Manage Community'.
Click the Deactivate tab.
Click the checkbox to indicate you understand what deactivation means.
Click 'Deactivate Now'.

Subscribing to Community Notifications

Users can manage the communication they receive from communities they are members of. There are two ways users can do this. They can subscribe to individual pages through the community itself, or they can use their user profile Notification Settings tool to manage multiple community notifications at once.

From within a community users can navigate to most page types and subscribe to an RSS feed or opt in to email notifications for that page.

Galleries - opt in at the gallery folder level Documents - opt in at the folder and subfolder level Discussions - opt in to a discussion forum Polling - opt in for all polls Announcements - opt in for all announcements Events - In the case of an Events page, the user can also subscribe to calendar updates or download a static calendar of all currently posted events.

For tips on using the RSS feed, please see the RSS Feed help section.

How to edit notification settings

Click the username badge beside the logout button to open the user profile.
Click 'Notification Preferences' in the Profile card in the left sidebar.
Active Notifications tab: Users can search for and delete any active notifications from here. Users most often see listings for discussion and comments they have subscribed to for individual events.
Community Notifications tab: Users can enable or disable community notifications here. This will overrule the community setting (e.g., if the community admin. creates an announcement and sets it to notify community members).

Next Previous

Public/Guest Accounts

You can invite members of the public to be community members. To do so you must be a community administrator.

Navigate to the Admin Centre of a community and click on Manage Members.
Click on the Add Guest Members tab and provide the required information.
Click 'Save'.
This will create a guest account for the user.

If you take this approach and invite members of the public to join a community please note that some of the public community members have limited access to certain functions.

Public users can't make their own discussion posts.
Public users can't vote in polls.
Public can't upload files or comment on files.

Courses

Courses/programs are used to house and organise course objectives, associated faculty and administrative staff, student enrolment, assessments, course groups, etc. Scheduled learning events are associated with courses. After a course has been set up it can be linked to a course community which creates a course website.

Unlike many content management systems, Elentra does not require you to create a separate instance of a course each academic year. When a course is built you define an enrolment period for it and set an audience for that enrolment period. By adding multiple enrolments and audiences to a course you make it accessible to various learners but the content stored on the course setup tab (i.e., curriculum layout, course name, course code, course contacts) is not unique to those audiences.

As of Elentra ME 1.15, users do have the ability to create unique course websites for different iterations of a course. This is achieved by creating course communities (aka websites) for the course and associating the course website with a specific curriculum period. (More information on course websites here.)

Individual learning events, which are mapped to a course, are available only to the specific audiences for the events.

This help section addresses course creation and the setup, enrolment, groups, and reports tabs. It also includes information on setting up a course website. Information about the CBME and Gradebook tabs can be found elsewhere (note that CBME help resources are provided in Elentra through the CBME tab).

Creating Courses

Creating a course is the first step to populating it with objectives, creating groups, setting up a gradebook, etc. If your organisation has units enabled, your setup process will be slightly different.

How to create a new course

Navigate to Admin>Manage Courses.

Click 'Add New Course'.

Complete each of the required steps noting the following:

Course Setup:

Curriculum Layout: This defines the curriculum layout for this course and will dictate the available curriculum periods used later when setting enrolment for the course. (If no curriculum layouts are set up, proceed to Admin>Manage Settings>Select Organisation>Curriculum Layout or see here.)
Course Name: This will display to users on Courses tab and in all associated learning event pages.
Course Code: This will display as part of the course identification visible to users on individual learning event pages and will also be used in the list of events from the Learning Events tab. The course code is also used in the breadcrumbs when you are managing courses and their different pages so codes should be logical.
Course Colour: If you select a colour, it will be used to identify learning events that are a part of this course on the learner calendar. (You can further customize the colour of specific events when you create them.)
Course Credit: If you track credits per course you can enter that information here.
Clinical Experience: Use this section to indicate if a course includes clinical experiences. If you plan to use the logbook for a course you must say that it includes clinical experiences.
Course Type: Indicate if the course is optional or core curriculum.
This presently creates metadata. It doesn’t impact the course template or anything else.
Curriculum Tracks: Curriculum Track options will only display if you have curriculum tracks built within an organisation. These can be configured through Manage Curriculum. Assigning a course to a curriculum track allows you to identify those courses that share characteristics (e.g. help prepare learner for a specific program, provide a minor, etc.)
Reminder Notifications: These optional e-mail notifications are specific to faculty teaching events in the course. The default settings for email notifications are 30, 7 and 3 days in advance of an event. Through the database/settings table a developer can customize when and how often email reminders about teaching responsibilities are sent out. Note that timing of emails will apply to all courses in your organisation (you currently can't have one course where faculty get emails 10 and 5 days from the event, and another course where faculty get emails 15 and 7 days from the event). For the complete text included in the email by default please see the bottom of the page.
Course Permissions: An open course will allow all logged in users to access it. If you attach the course to a community or course website you'll be able to set permissions for the course website as well.
Audience Sync: Choose whether or not to automatically sync your audience with the LDAP server.

Lecture Capture:

You will only see lecture capture options on a course setup page if lecture capture is enabled for your organization.

You can enable lecture capture support at a course by course level.
Lecture Capture Support: Turn on or off as needed. On will allow consenting faculty to be recorded in eligible rooms.
Default Recording State: This dictates whether or not all events will automatically be recorded (on) or not (off).
Allow Faculty Override: This dictates whether or not faculty can change the default setting on their events (on) or not (off) via the event content page.
Event Types Capture Permitted: This allows you to specify which event types you want to automatically record (e.g. lectures). You can select more than one event type per course. To delete a selected event, click on the small x to the right of the event type.

Tip: If you don't have learners set up in your organisation, scroll to the bottom of the page and click 'Proceed'.

Course Enrolment:

Complete this section when you have the appropriate learners active in your organisation and added as cohorts or class lists as appropriate.
When selecting an enrolment period, the available options will depend on the Curriculum Period defined in the Course Setup section. You can add multiple curriculum periods, cohorts or individuals to a course enrolment.
After selecting an enrolment period from the dropdown options, click 'Add Audience'.
Choose to add a cohort, course list, or individual. Note that a cohort does not need to be assigned to a specific course in order to be added as an audience. However, a course list must be linked to a course via Manage Cohorts before it will be available to be added as an audience. (See more information here.)
Click 'Proceed'.

You will see a green success message indicating that the course has been created. You'll be redirected to the full course setup tab to provide additional details about the course.

How to delete a course

Navigate to Admin>Manage Courses.
Search for the course you want to delete as needed.
Click the checkbox beside the course information for the course you want to delete.
Click 'Delete Courses'.
Confirm your choice.
You will get a green success message on the screen.

Reminder Notifications: Email text to course faculty

Dear %TO_FIRSTNAME% %TO_LASTNAME%,

%CC_FACULTY_TEXT%This is an automated notice to remind you that you are scheduled to teach in the following learning event.

Event Title: %EVENT_TITLE% Phase: %EVENT_PHASE% Event Date / Time: %EVENT_DATE% Event Duration: %EVENT_DURATION% Event Location: %EVENT_LOCATION% Associated Faculty: %ASSOCIATED_FACULTY_TEXT% To update your event click this link: %EVENT_LINK% Important things to do before your learning event: 1) Review Learning Objectives Please review your objectives to ensure that they accurately describe the learning objectives of your event. 2) Update Learning Event Resources The following resources are attached to this event for the learners to download. Please upload your new lecture notes or other resources and remove any outdated content. %RESOURCES_TEXT%

IMPORTANT: If you are going to have your assistant add your electronic resources to the site on your behalf and they have not been CC'd on this e-mail already, please forward this e-mail to them so they are able to easily find your learning event by clicking the following link: %EVENT_LINK% 3) Update the Event Type Each learning event has an event type associated with it to help identify the type of teaching that is taking place during this time (lecture, small group, case study, etc). Please ensure that the event type listed accurately represents the type of learning of this session. Need help editing your learning event? Contact your Curricular Coordinator for help with uploading files and editing event details.

Save a tree: Please consider the environment before printing this e-mail.

Course Setup

Course Setup: The first section of this page is complete with the information provided when creating the course. If you need to edit any of that information you can do so (see Creating Courses page for details).

Lecture Capture: (New in ME 1.13!) This option will only display if lecture capture is enabled for your organization. This section of this page may also be complete with the information provided when creating the course (see Creating Courses page for details). If you need to edit any of that information you can do so here.

Course Contacts:

Assigning someone as a course/program director or curricular/program coordinator will allow that person to edit the course content, including all associated learning events. Their contact information will also be displayed on the course background page if you create a course community/website for the course.
Assigning someone as associated faculty will allow that person to be assigned as a grader to exams. Their contact information will also be displayed on the course background page if you create a course community/website for the course.
Assigning someone as a teaching assistant can result in that person's information being displayed on the relevant course page (if the appropriate setting is turned on) but will not give the user any additional permissions.

The list of course contact options can be modified by a developer in the language file of the Elentra installation if, for example, you want Course Director to say Program Director.

Course Keywords: This is an optional feature that can or cannot be used in Elentra; by default it is not enabled. Keywords allows you to assign Medical Subject Headings (MeSH) to courses and later to specific learning events. The Course Keyword feature is separate from curriculum tag sets and as such has limited reporting abilities when compared to a tag set. (The MeSH keywords are reported on in the Curriculum Inventory Reporting tool if you use it.) If your organisation has a list of keywords to be tracked across the curriculum it is recommended you make those words a curriculum tag set.

To effectively use the MeSH keywords feature a developer will need to import a connection to the the MeSH database to your installation of Elentra. To hide the keywords feature entirely, a developer will need to delete some tables from your installation.

Course Objectives: There are two user interfaces to support adding course objectives. Which interface you see is controlled by a setting technical staff would have to adjust. If you see the heading 'Course Tags' instead of Course Objectives, please see more detail below in the Course Tags section. If you don't see any option to add Course Objectives or Curriculum Objectives it may be because there are no tag sets built for your organisation. Go to Admin>Manage Curriculum to build tag sets.

Map curriculum tag sets or individual curriculum tags to a course by clicking 'Show Curriculum Tag Sets' and clicking through to the appropriate tag set or tag and checking it off. Assigned curriculum tags will be accessible to tag at the event level and in gradebook assessments. They will also display on a course website if you use the standard template and are visible to learners from there.

For your primary tag set displaying under 'Curriculum Objectives' you may see the option to designate a tag as primary, secondary or tertiary. If you use this feature the objectives will be displayed under primary, secondary and tertiary headings on the course page visible to learners.

The curriculum tag set designated as Curriculum Objectives will be immediately visible on the right side. All other curriculum tag sets will appear under "Other Objectives".

Note that if you want students to be able to log specific objectives those objectives should be assigned to the course.

Course Tags: If your Elentra installation is using the Quick Tag Selector setting, you'll see a Course Tags heading instead of Course Objectives. If you aren't using the Quick Tag Selector setting you won't see this section of the page.

Select the appropriate Curriculum Period from the dropdown menu.
Select the appropriate Curriculum Map Version from the dropdown menu. (Configure a curriculum map via Admin>Manage Curriculum if necessary. More information can be found in the Curriculum>Map Versions help section.)
Select curriculum tags from the dropdown menu. Whatever is added as a Course Tag will display on the course page.
If you choose to, you can click on a curriculum tag added as a course tag and map it to another curriculum tag. This is context-based linking. The linkages you create will be reflected in the map of the curriculum tag if you have enabled the tag set to be mappable to the appropriate tag set; however, the link will not be automatically recorded in the history of the tag. (It's possible that your organization doesn't have context-based linking turned on. If it doesn't, you won't have this option.)
The course tags and any context-based linkages you create will be displayed on the course page.

Course Reports:

Indicate which reports should be available to be generated from this course by selecting them from the available options. In stock Elentra you will see Report Card and My Teachers as available report types. There is no user interface to control which reports are available to which organisations within an installation of Elentra, but the database can be configured to allow specific reports to be accessible to specific organisations.

Report Card does not fully function right now but it is intended to allow users to select a learner, and view a table showing curriculum tags as rows, and learning events, simulations, and logbook across the top. In each grid matrix you see a completion rate (e.g. 1/3, 2/5) in terms of attendance and completion. For the learning events the denominator is the number of events where attendance was required and that curriculum tag was applied. The numerator is how many times the learner was present at those events (this tool assumes you are using attendance tracking in Elentra).
My Teachers will provide a report displaying the names and email addresses of all teachers active in the course. You can select the teachers you want and generate an email list to quickly communicate with people.

Course Enrolment: This will appear near the bottom of the screen but was already completed during the initial course build. If you need to edit the enrolment you can do so from here.

Course Syllabus: If this feature is enabled users will be able to generate a PDF summarizing the course information provided in the course website tabs. There is a default undergrad template that comes with stock Elentra. Syllabi will be accessible from the Courses tab where all courses are listed. Syllabi will only display while a course is running (i.e., as in during the course's defined curriculum period). Please note that there may be up to a 24-hour delay between enabling a syllabus for a course and it being visible to users because of a required behind-the-scenes action that runs every 24 hours.

After completing the required fields in Course Setup, click 'Save'.

Course Content

On the Course Content tab you can provide a course description, director's message, and different types of resources.

Course Setup

You can add an external link if you have an external course page or resource you’d like users to access when trying to view this course. If you will be connecting this course to an Elentra built course website (using the Communities module), leave this blank for now. If you use another LMS provider to house course information and you'd like to link to it, add the appropriate url here.
Note that if you have linked a course to a course community and wish to unlink it you must do so from the Administration page for that community. You cannot unlink a course from a course website from the Course Content tab.
If you wish to redirect all course clicks to the external website click the checkbox underneath 'External Website URL'.
Add a course description and director’s message if desired. Both of these will be visible to users. If you go on to create a course website and link this course to it, the course description and director's message will automatically display on the course website background page.
After you've input content, click 'Save'.

Course Objectives (without units and context-based linking turned on)

Any objectives assigned to the course will be displayed here in a list. For the curriculum objectives assigned, you can configure your Elentra setup to allow individual courses to edit the wording of specific objectives. To do so, click 'edit' beside the objectives code and a window will open allowing you to edit the objective text.

Course Resources

As of ME 1.16, LTI Providers are added and configured in System Settings to use LTI Consumers in Course Pages, Course Websites and Learning Events.

Files and links attached here will be made available to all users accessing the course. The links and files will be displayed to users when they click on a course title.
LTI Provider: Use this if your organisation is partnering with another educational content provider to deliver content or other tools to learners (e.g. Khan, Quizlet, Turnitin, etc.). If you plan to create a course website via the Communities module to use with this course you'll able to add an LTI provider page to that website.

Course Enrolment

This page displays the list of learners enrolled in the course and is based on the information provided in the course setup page.

You can search for users, download the course enrolment, and toggle between a list and a grid view of learners. Additionally, you can switch periods to view different enrolments for the course.

From the enrolment page, you can click on learner names to see their profiles, but you can’t manage enrollment on this page. That information is controlled by adding the appropriate audience in the course enrolment section of the course setup page.

Course Website

When you add a new course, you are adding information to the database about that course and users will be able to see a simple course page. However, to make a more robust online course community for learners and faculty you should also create a course website for a course. This is done using the Communities feature of Elentra. Using a community template for a course offers a more complete view of a course and its contents and allows for additional features like discussion boards, polls, file sharing, etc. Often we refer to the community for a course as its course website.

Here is how a course without a website will appear to users:

Here is how a course with a website will appear to users:

Note that the course website relies on a templated set of pages (e.g., background, calendar, prerequisites, etc.). The template shown and described below comes with stock Elentra but if your organization requires a different template, or you want different templates for different courses, e.g., clinical and nonclinical, that is customization work that can be done.

How to create a course website using the communities module

Note that you must create a course via Manage Courses before you can create a course community (please see here for more information).
From the main menu, click on the Communities tab.
Click 'Create a Community' and then click on 'Courses, etc.' in the Official Communities section.
Fill in the required information, noting the following:
Community Name: Pick a descriptive but concise name. This will display on the list of communities and will be used if a user searches for a community.
Community Keywords: These will not be visible to users but will be applied when someone searches for an existing community.
Community Description: This will be displayed to any user who searches for or tries to access the community.
Community Shortname: This will be part of the community url. It must be lower-case, less than 20 characters, and include only letters, numbers, underscore or period. After this is set there is no user interface to change the url so pick carefully! For the purposes of uniformity you may wish to discuss naming conventions with anyone else who may be creating course websites within your organisation.
Community Type: select ‘Course Website’ from the dropdown menu.
Community Pages: When you select Course Website a list of default pages will appear (see detail regarding each page below). You cannot deselect any default pages to exclude them. When the course website is created these pages will be visible to users. (If you'd like to have a course website template that allows users to deselect or later hide templated pages you'll need help from a developer.)
Community Courses: select the appropriate course to link this community to. You can connect multiple courses to one website and they will share a student-facing web presence. If you do this, some pages will display information from both courses (e.g. Learning Objectives, MCCs) whereas some pages will only show information from one course (e.g. the course description and course director's message populate from the first course).
Course Curriculum Periods: Select the appropriate curriculum period for this course website. If only one curriculum period exists for a course, it will automatically be selected.
Community Permissions: Use these options to control access to the course website.
Click 'Create'.

If you get an error saying you must specify a Community Type but don't have the option to do so on the screen, you are likely working in a second organisation (e.g., you're working in postgraduate medicine and the first organisation in your installation was undergraduate medicine). When a second organisation is created through the user interface, community types are not automatically copied into the new organisation. A developer can copy the community types for you and you'll be able to use communities properly.
Note that any faculty listed in the course contacts section of a course will automatically be made administrators of the course website community.

Templated pages details

The following pages are included in the course website community template:

Background: Add any background information as needed. Turn on additional information to populate the page with announcements, upcoming events, and community history (e.g., new members joining). Click Save when done. (Feb. 12, 2018: Note that the display of announcements and events is currently not working and only community history will show up.)
Course Calendar: You can add customized text to the top of this page; by default it displays learning events scheduled in the course via Manage Events (change the date range from day, month, week, year etc. to change your view). If you add free text, click 'Save' when done. Note that this is different from the learner's customized calendar accessible from the dashboard. From the course website, you'll see all events scheduled for this course in a list format.
Prerequisites: You can add customized text to this page. Click 'Save' when done.
Course Aims: You can add customized text to this page. Click 'Save' when done.
Learning Objectives: You can add customized text to the top of this page; by default it displays the learning objectives/curriculum tag sets assigned to the course through the Content tab under Manage Courses. If you add text, click 'Save' when done.
MCC Presentations: You can add customized text to the top of this page; by default it displays the Clinical Learning Objectives assigned to the course through the Content tab under Manage Courses. If you add text, click 'Save' when done.
Teaching Strategies: You can add customized text to this page. Click 'Save' when done.
Assessment Strategies: You can add customized text to this page. Click 'Save' when done.
Resources: You can add customized text to the top of this page. If you add text, click 'Save' when done. Note that course communities are associated with all enrolment periods tied to the course and are not currently cohort specific. If you attach resources to a community, all learners across multiple cohorts will be able to view them. If you added resources to a course when you created it via Manage Courses, those resources will not automatically populate this page (updated February 12 - we are considering changing this in ME 1.12).
Expectations of Students: You can add customized text to this page. Click 'Save' when done.
Expectations of Faculty: You can add customized text to this page. Click 'Save' when done.

Adding content to pages

Once a course community or website is created, users who are designated as Community Administrators can manage the pages just like any other community. When viewing a course website, switch to Administrator view if necessary, and then look for the Admin Center box on the sidebar. Click Manage Pages to adjust content, reorder pages, or add a new page. For quick editing access, click the Edit Page button from any community page at any point.

How to manage community, community members, and community reports

When you build a course website and associate it with a course, individuals listed on the course contacts page (e.g., course director, curriculum coordinator, associated faculty) will automatically be made administrators of the course website. As admins. they will be able to edit page content, add additional pages, etc. Managing additional members is similar to other communities so please see the Communities help section for more detail.

Managing a course website in terms of permission settings, statistics and details is also like other communities so please see the Communities help section for more detail.

Community Reports is a tool unique to course websites that allows you to review which community members have viewed pages, taken specific actions, etc.

From the Admin Center, click 'Community Reports'.
Click on 'Select Filter' and select the appropriate filter (member, module type, page, action).
Click the checkbox beside the appropriate member/module/page/action and click 'Apply'. You can select filters from different filter types to further refine your results.
To delete a filter, click the small x beside it.

Course Groups

Once there are learners enrolled in a course/program, you can create groups of learners within a course. Course groups are useful for assigning small groups of learners to specific learning events (e.g., repeating clinical skills sessions where small groups of learners all do the same thing), and can also be used to link tutors to assigned learners. Linking tutors and groups of learners allows faculty to review specific students’ logged encounters, or act as academic advisors (especially relevant if you are using the competency-based medical education module of Elentra). Tutors linked to groups will also be able to access any community shared resources restricted to that group.

How to create groups through the user interface

Navigate to Admin>Manage Courses.
Search for the course you want to work with and either click on the course name and then the Groups tab, or click the cog to the right of the course name and select Groups from the dropdown menu.
Check that you are working in the correct Curriculum Period, adjusting it as needed with the dropdown menu.
Click 'Add New Groups'.
Create a group name prefix (e.g. Family Medicine Group) noting that this will be applied to all groups created with an automated suffix added (e.g. 1, 2, 3, 4).
Group Type: Choose to create a specific number of empty groups (input the desired number) or have the system automatically populate groups.
If you choose to have the system auto-populate groups, define the group parameters, noting the following: Learners: Include all learners or select specific learners from the enrolment list for the relevant Curriculum Period. Groups: Either set a number of groups or set a group size requirement. Populate Groups: Select to base groups on gender (balanced or homogenous) or not.
Click 'Add'.
You will see a green success message on the screen and will then be shown the newly created groups.

How to upload a CSV file to create and populate groups

Navigate to Admin>Manage Courses.
Search for the course you want to work with and either click on the course name and then the Groups tab, or click the cog to the right of the course name and select Groups from the dropdown menu.
Check that you are working in the correct Curriculum Period, adjusting it as needed with the dropdown menu.
Click the Import/Export button and select Import. You’ll be prompted to download a sample CSV file to use to import groups and group members.
Follow the column headings to create your CSV file. Group Name: Provide the appropriate group name. Tutors: List the tutor(s) for the group. Use the format 'Last name, First name; Last name, First name'. For example: Smith, John; Doe, Jane Tutors Numbers: List tutor number(s). Separate entries with a semi-colon if necessary. Learner Name: Use this format: 'Last name, First name'. For example: Smith, John Only enter information for one learner per line. Learner Number: Enter the learner's institutional number (e.g., student number).
Save your file as a csv when completed.
Search for or drag and drop your completed file into the import window.
Click Import CSV.
You will get a green success message. Close the import window and you should see your newly created groups on the screen.

How to create the same groups across multiple courses

Note that groups are specific to a course enrolment and at present apply only to one course. If you want to use the same groups across courses, you can download groups from one course and import them to another course, OR you can create additional cohorts at the organisational level and apply those cohorts to multiple courses through a course enrolment and audience. Unless a group will be together repeatedly for the duration of their medical education, we recommend using the first approach.

Navigate to Admin>Manage Courses.
Search for the course that has the groups you want to recreate and either click on the course name and then the Groups tab, or click the cog to the right of the course name and select Groups from the dropdown menu.
Check that you are working in the correct Curriculum Period, adjusting it as needed with the dropdown menu.
Click the Import/Export button and select 'Export to CSV file'. A file will download to your computer.
Depending on how you are setting up your groups, you may want to change the group names in the CSV file (e.g., Anatomy Group 1 becomes Microsystems Group 1). You can also change tutor information if necessary. Complete any required changes and save your file with a recognizable name.
Navigate to the course where you want to create new groups and follow the instructions above in "How to upload a CSV file to create and populate groups".

How to delete existing groups

Navigate to Admin>Manage Courses.
Search for the course you want to work with and either click on the course name and then the Groups tab, or click the cog to the right of the course name and select Groups from the dropdown menu.
Check that you are working in the correct Curriculum Period, adjusting it as needed with the dropdown menu.
Tick off the box beside the group name you want to delete (note that you can select all), and click Delete Groups.
Confirm your choice by clicking Delete again.

How to add tutors to existing groups

Navigate to Admin>Manage Courses.
Search for the course you want to work with and either click on the course name and then the Groups tab, or click the cog to the right of the course name and select Groups from the dropdown menu.
Check that you are working in the correct Curriculum Period, adjusting it as needed with the dropdown menu.
Click on a group name.
Under the Group Details, Tutors field, begin to type the name of the desired tutor. Click on the name to add it and it will be displayed in a list below the tutor search box.
To delete an existing tutor, click on the X to the right of the tutor name.

How to manage members in existing groups

Navigate to Admin>Manage Courses.
Search for the course you want to work with and either click on the course name and then the Groups tab, or click the cog to the right of the course name and select Groups from the dropdown menu.
Check that you are working in the correct Curriculum Period, adjusting it as needed with the dropdown menu.
Click on a group name.
To delete existing members, click the tick box beside the user name and click Delete Members.
To add new members to the group, scroll to the bottom of the page, and follow the onscreen instructions. Note that a learner must be enrolled in the course in order to be added to a group (you can adjust course enrolment via the Setup tab of a course management page).

How to view all groups and members in a course at once

You can export a CSV of groups within a course. When you do this you'll have the option to export a CSV or a printable CSV. The printable CSV provides group names, tutor names and learner names but leaves out users' institutional numbers.
There is currently no tool to view all the groups one learner is assigned to across an organisation.

Viewing a user's group membership

Please note that there is currently no user interface to see a list of all groups a user is part of. (Users can see all the communities they are a part of from the Communities tab and My Communities card.)

Scheduling Events

Elentra uses the word event to describe any scheduled time in an organisation's calendar. Events can be learning oriented and include lectures, labs, clinical experiences, independent reading time, etc. or can represent other activities including lunch, paperwork collection, clubs, committee meetings, etc. The types of events included in a calendar are up to the organisation. Scheduling events is accomplished through the Manage Events tab and is available to users with administrative role types (e.g., staff>admin). Faculty members assigned as course or program directors can view and edit events within their own course(s), however, they cannot schedule events through the user interface.

Some notable features of scheduling events with Elentra include:

the ability to export and import CSV files to create schedules,
the ability to copy existing events into a new schedule, including mapped curriculum tags, event descriptions and instructions, and affiliated resources,
the ability to easily create recurring events,
the ability to create parent child links between repeated recurring events (e.g., 10 small groups all doing the same thing) to create accurate reports about event types and durations across a course, and
the ability to group events in a unit within a course.

For information about scheduling clinical learning experiences (e.g. rotations) please see here. For information about scheduling granular clinical events within rotations please see here.

Once scheduled events exist they can contain detailed information including affiliated faculty, learners, curriculum tags, locations, resources, instructions, etc. Further information about managing the content of events and features like attendance tracking, history, and statistics is available in the Events help section.

Elentra allows you to report on scheduled events in a variety of ways. Highlights include:

a report listing learning event types and durations across courses (e.g., 12% lecture, 25% small group activity, 5% self-assessment),
a report listing which curriculum tags are used across events within a course, and
reports on faculty hours across courses (at the individual and departmental level).

Creating and Managing a Schedule

To create a schedule of events that can be populated with instructors, learners, resources, etc. you must be logged in with administrator or pcoordinator permissions. While you can create an entirely new schedule using a CSV or manually (one event at a time), if you have an existing course, the fastest option to make a draft schedule is to copy an existing schedule.

In addition to uploading a csv of events, you can also create individual events that appear immediately in the schedule. To do so, navigate to Admin>Manage Events and click 'Add New Event'. At that point, follow the instructions in the Manually Add New Event section below. Using this method, the event will immediately be live in the system upon saving.

New in ME1.14! The csv import tool for draft event schedules has been updated to support recurring events and the parent-child event flag. Additionally, we've added support to import teacher assistants, tutors, and auditors.

A known limitation at present is the ability to import locations based on site-building-room codes. We are working on resolving this.

How to create a new schedule of events

Navigate to Admin>Manage Events.
Click 'Manage My Drafts'.
Click 'Create New Draft'.
Provide a logical draft name and an optional description, then click 'Create Draft'.

Draft Schedule Permissions

If you would like to give additional users access to a draft schedule, you'll need to add them as authors to the draft. Return to Admin>Manage Events, and click 'Manage My Drafts'. Click on the appropriate draft and then click the greyed out Draft Information heading. Add users to Draft Authors by beginning to type a name and clicking on the appropriate name in the displayed options. In stock Elentra you will be able to add staff:admin users to draft schedules but there is a setting for this that can be configured to allow you to add faculty and other staff as draft authors. You'll need a developer to help you change these settings if you'd like to.

At this point you can import a CSV file or manually add new events.

Import CSV File

You will need to have a file prepared with your schedule information. This could include date, start time, event title, audience, duration (in minutes), attendance required, etc. For a detailed list of the event information you should and can provide please see below.
Tip: Depending on the events you're scheduling it may be useful to download an existing schedule from elsewhere in Elentra, modify it, and upload it as your new schedule.
Click 'Import CSV File'.
Drag and drop or browse your computer to find the required file and then click 'Import'.
Use the drag and drop tools to match the information in your CSV with the relevant fields in Elentra. Fields that are matched and green indicate required fields; fields left in the top section that are red are required and you'll need to add them to your CSV and reupload it.
After you have matched your columns, click 'Import'.

Manually Add New Event

Click 'Add New Event'.
Complete the required information, noting the following: Event Colour: The colour selected will be displayed on the calendar. Recurring Event: More detail is available in the Recurring Events help section. Time Release Options: This controls when the event will be visible to users in the system.
Click 'Save'.

Publish or Approve Draft Schedule

After you've added the necessary events, you need to publish or approve your draft; this will cause the events you created to be imported to the system and make them accessible for adding content.

Click Publish Drafts or, if you are returning to a draft you previously worked on navigate to your drafts, tick off the box beside the schedule you want to publish and click Publish Drafts.
Confirm your choice.

Your schedule will now show as approved on your drafts list and within about an hour, the scheduled events will be live in your system. If the events do not appear and you can still see and reopen your draft schedule, it's possible that the background action required (a cron job) is not turned on or is set to run very infrequently. If needed, speak to a developer to investigate further.

Editing an Approved Draft Schedule

If you need to make immediately changes to a recently published draft schedule, you can reset it to open as long as the background action required (a cron job) has not happened yet.
Click the checkbox beside the schedule you want to open.
Click 'Reopen Drafts'.
Confirm your choice. Your schedule will now show as open again on your drafts list and you can click on it to edit events.

Calendar Preview After you've drafted some events, use this tool to preview the calendar view of drafted events.

Note that you will be unable to create event content until the drafted events are published.

Schedule CSV import column headings and information

As mentioned above you have two typical scenarios when creating draft event schedules:

A: You are creating an entirely new schedule from scratch.
B: You are rolling/copying forward events from an existing course.

If you use option B, you will be able to export the list of existing events, tweak it, and reimport it. It is important to note that an event export from the draft schedules area will give you more information than you can actually import back to the draft events.

Here is the list of available export fields automatically included:

Draft Event
Original Event (this will represent the event you intend to copy)
Parent Event
Parent ID (this field will not be relevant on any subsequent draft event import)
Recurring Event
Term
Course Code
Course Name
Date
Start Time
Total Duration
Event Type Durations
Event Types
Event Title
Event Description
Location
Audience (Cohorts)
Audience (Groups)
Audience (Students)
Audience (Faculty)
Teacher Numbers
Teacher Names
Objectives Release Date

Here is the list of optional export fields you can add:

Student Names
Faculty Names
Release Date
Release Until
Child Events
Required Preparation
Free Text Objectives
Curriculum Objectives
MCC Presentations
Hot Topics
Attached Files
Attached Links
Attached Quizzes
Attendance
Attendance Required
Auditor Numbers
Auditor Names
Teacher Assistant Numbers
Teacher Assistant Names

Note that if you have exported a schedule there will be some columns exported which you cannot re-import. These columns can be deleted before uploading data or left for your own reference.

The following columns are required on a draft schedule import:

Course Code: Enter the course code for the course to which this event should belong.
Start Time: This is what time the event should start. Enter in 24 hr. format.
Event Type Durations: If you have multiple event types scheduled in one event, this column can be used to indicate how much time is allotted to each event type. Enter the time in minutes and separate times with semicolons and a space. For example, 60; 60. Put the times in the same order as you list the event types in the next column. If there are not multiple event types scheduled during an event, this column will be identical to the Total Duration column.
Event Types: If you have multiple event types scheduled in one event, this column can be used to indicate what those events are. Event types must match the list of event types in your organisation (found in Admin>System Settings>Event Types). Examples include lecture, lab, small group learning, etc. Type in an event type and separate it from another with a semicolon and space. For example, lab; lecture; patient interview. Remember to keep the order the same as the event type duration column.
Event Title: Enter the event title.

You should also have:

Draft Event:
- If you are creating a completely new schedule of events (i.e. you did not roll forward a schedule), create an arbitrary number and enter it in this column (e.g. 22221, 22222, 22223, 22224, etc.).
- If you have exported a CSV of copied events, this column will already be populated for you.
Original Event:
- If you are importing a completely new schedule (i.e. you did not roll forward a schedule), create an arbitrary number and enter it in this column (e.g. 22221, 22222, 22223, 22224, etc.). The Draft Event and Original Event should match.
- If you have exported a CSV of copied draft events, this column will be populated with the unique id numbers of the existing events. You must copy the draft event ids into this column before uploading it.

The following columns are optional to import on a draft event schedule:

Parent ID: This column is applicable only if the event is to be linked as a child to a parent event. If it is, enter the id of the relevant parent event. If the event is not a child event leave this column blank. This field accepts any integer greater than 0.
Course Name: Enter the course name. (You can omit this since you've already provided the course code, however some people find it useful to include for their own reference.)
Term: This refers to the curriculum layout the course is a part of. Curriculum layouts are defined at the organisation level and can be found in Admin > Manage Curriculum > Curriculum Layout. Examples include terms, years, phases, etc. You can also view curriculum layouts from the Courses tab where the layouts will be the headings above groups of courses.
Date: Enter the date. Multiple formats are accepted.
Total Duration: This is the total duration for the event (including different event types). Enter in the number of minutes.
Event Description: Enter the event description.
Location: Use this column only if you don't have sites loaded for your organization. Manually type what you'd like users to see.
Audience (Groups): If the course to which the event belongs is using the groups function and one or more groups is the audience for this event, provide the group name here. Group names can be found via Admin>Manage Courses>select course>Groups.
Audience (Cohorts): If a specific cohort is the audience for this event, enter the cohort here.
Audience (Students): If individual students need to be added to the audience, provide the names in this column.
Audience (Faculty): If specific faculty are to be included in the audience, enter their institutional id. Separate multiple numbers with a semicolon.
Attendance Required: If attendance is required for this event and will be taken via the Elentra attendance feature enter a 1. If the Elentra attendance feature will not be used for this event, enter 0.
Objective Release Dates: If there are specific release dates for the objectives linked to this event, enter 1. If not, enter 0.
Teacher Numbers: Enter the institutional id of any teachers to be linked to this event. Separate multiple numbers with a semicolon.
Tutor Numbers: Enter the institutional id of any users to be linked to this event as tutors. Separate multiple numbers with a semicolon.
Teacher Assistant Numbers: Enter the institutional id of any users to be linked to this event as teacher's assistants. Separate multiple numbers with a semicolon.
Auditor Numbers: Enter the institutional id of any users to be linked to this event as auditors. Separate multiple numbers with a semicolon.
Recurring Event: This column can take any integer value greater than zero.
- If you are creating a brand new schedule, enter the original event id of the first event in the series in the recurring event column for the main event and each subsequent recurring event; events that have the same id will be grouped together as recurring events.
- If this is a recurring event you have copied forward, enter the draft event number of the first event in the recurring series.
Free Text Objectives: This can be text and will populate the free text objectives box on the event content page (if such a box is enabled).

Please note that the parent-child relationship and recurring event UI will not be displayed until the draft events are published. If you preview a recurring event with the parent-child feature enabled, it will look like the children do not exist; once published the appropriate events will appear connected.

Teacher Name: This is not a required field and will not be checked by the system; however, some people find it useful to include in their CSV to more easily view who is teaching what.
Location Room: This gets exported but can not be imported in ME 1.14

Copying an Existing Schedule of Events

Elentra allows you to copy an existing schedule of events and roll it forward to be added as a new schedule in the same or a different course. This can save significant amounts of time as you can also copy forward event resources, curriculum tags, etc.

If you copy forward recurring events that do or do not have the parent-child id feature enabled these links will also be maintained in the copied events.

How to copy a schedule of events

Navigate to Admin>Manage Events.
Click 'Manage My Drafts'.
Click 'Create New Draft'.
Provide a logical draft name and an optional description.
Click on the greyed-out words Copy Forward Existing Learning Events.
Complete the required information noting the following: Copying Learning Resources: Decide which resources should be included in the new draft events. Courses Included: Select the course where the scheduled events are and the course to which your new scheduled events will belong. In most cases, this will be same course. Note that you can add multiple destination courses if required (to delete an unwanted destination course click 'Remove' beside the course name). Copy Start and Finish: These dates define the start and end dates of the existing events in your source course and should match when the course happened (usually people select the most recent version of the course). New Start Date: Select the date on which you'd like the copied events to start. Elentra will respect the spacing and timing of all events to be copied.

After you've made your selections, click 'Create Draft'.
If there are no changes you wish to make to the schedule, you can publish the draft now.
Click the checkbox beside draft you wish to publish and click 'Publish Draft'.
You may be asked to review the draft. Note that if you have included resources to copy forward, you can decide on this screen whether to set all resources to draft mode when the newly scheduled events are published. After you've made your choice click 'Confirm'.

Within about an hour the scheduled events will be live in your system. If you wish to change information about the events, see further instructions below.

How to edit events before publishing a schedule

Please review the content in the Creating and Managing a Schedule section about column headings before you edit your existing events.

After you've copied the events, use the export and import tools to make adjustments to the scheduled events including their times, teachers, audience, etc. You can export a CSV of the existing schedule, make adjustments, and upload the CSV. When you export the events you'll be prompted to select which fields to include in the export; consider the fields you may need to edit or review to help you decide what to include in the exported file. (A list of these fields and what they include can be found on the Creating and Managing a Schedule help page.)
After you've exported a file you can edit it in your preferred spreadsheet tool. Tips for adjusting the schedule include using the find and replace function if there are consistent changes across the schedule (e.g. all audience group 2020-1 will become 2021-1, or one tutor is replacing another across multiple events). When you upload your revised CSV, the system will register the changes in the CSV and apply them to the draft schedule.
If you choose to import a csv, click 'Import CSV'. You will be prompted to match the column headings from your CSV with the available import fields. The system will try to match this for you as much as possible but you may need to manually move some. To do so, drag and drop the appropriate field name with the column heading from your file.
When the events are as you wish them, click 'Publish Draft' and within about an hour the scheduled events will be live in your system.

Recurring Events

One feature of Elentra is the ability to schedule recurring events. The advantage of a recurring event is that you can simultaneously edit a variety of event characteristics including title, location, event type, associated faculty, event description, required preparation, objectives, etc. across multiple events. What you edit and for which events is entirely customizable.

You can create recurring events in different configurations including a custom series or events that repeat daily, weekly, or monthly.

If you eventually copy a schedule forward, recurring event status, as well as parent-child links if enabled, will be maintained.

New in ME 1.14! We are changing our vocabulary from recurring events to event series. This work is partially complete so you will continue to see a mix of terms in the user interface.

As a result of the first part of this development, you can now provide more details about each event in an event series when building the events through the user interface. Instead of only defining course, title and dates on initial build you can now additionally specify a teacher, course audience, and location.

How to manually create an event series

For all event types, navigate to Admin>Manage Events and click 'Add New Event' to begin.
Select a Course, Event Type, and event duration.
Under Event Details add a title, provide a first event date, and unit (if applicable). Next, follow the instructions for each specific recurring event type.

How to create a custom series of events

Select Custom Series from the Event Series dropdown menu.
Enter the number of events you want to have in this series (remember one will exist as the original so type in a number one less than the total you want) and click 'Set Frequency'.
Adjust the title, date, time, location, associated faculty, associated learners, audience options, and start and release dates for each event as needed.
To make these events children of a parent (and therefore have them reported only once in learning event type reports, etc.), tick off the small box beside "Events created in this series are considered child events."
To completely rebuild your list of events, click 'Rebuild Event Series' on the top event card.
Click 'Save' at the bottom of the page.

How to create events that repeat daily

Select Repeat Daily from the Event Series dropdown menu.
Set how often you want the event to recur and set an end date. The system includes and counts weekends so bear that in mind if you use this scheduling tool.
Click 'Set Frequency'.
Note that the first event you create will be imported into the system, so even though the list of events starts with Event 1 that will actually be the second event in the series.
Adjust the title, date, time, location, associated faculty, associated learners, audience options, and start and release dates for each event as needed.
To make these events children of a parent (and therefore have them reported only once in learning event type reports, etc.), tick off the small box beside "Events created in the series are considered child events."
To completely rebuild your list of events, click 'Rebuild Recurring Events List'.
Click 'Save'.

How to create events that repeat weekly

Select Repeat Weekly from the Event Series dropdown menu.
Set the day of the week on which you want the event to repeat and provide an end date for the event series.
Click 'Set Frequency'.
Note that the first event you create will be imported into the system, so even though the list of events starts with Event 1 that will actually be the second event in the series.
Adjust the title, date, time, location, associated faculty, associated learners, audience options, and start and release dates for each event as needed.
To make these events children of a parent (and therefore have them reported only once in learning event type reports, etc.), tick off the small box beside "Events created in the series are considered child events."
To completely rebuild your list of events, click 'Rebuild Recurring Events List'.
Click 'Save'.

How to create events that repeat monthly

Select Repeat Monthly from the Event Series dropdown menu.
Set when and how often you want the event to recur and set an end date.
Click 'Set Frequency'.
Note that the first event you create will be imported into the system, so even though the list of events starts with Event 1 that will actually be the second event in the series.
Adjust the title, date, time, location, associated faculty, associated learners, audience options, and start and release dates for each event as needed.
To make these events children of a parent (and therefore have them reported only once in learning event type reports, etc.), tick off the small box beside "Events created in the series are considered child events."
To completely rebuild your list of events, click 'Rebuild Recurring Events List'.
Click 'Save'.

Parent Child Feature

Elentra includes the ability to link multiple repeating events in a parent-child relationship. This is most often used when small groups of learners will complete the same activities in repeating learning events. For example, there may be 10 events scheduled for 10 small groups but each event is essentially identical in terms of content, curriculum tags applied, etc. If you use the parent-child feature some reports will look only to the parent event to collect data and therefore help to report accurately from the perspective of a single learner.

Note that the parent child relationship is only available for events that are part of the same course.

If you eventually copy a schedule forward, recurring event status, as well as parent-child links if enabled, will be maintained.

How to create parent child relationships between events

There are several ways to create parent child relationships between events, you can either do so when creating recurring events through Admin>Manage Events, include the information on a spreadsheet you are importing to a draft schedule, or link existing events through the event setup page.

For more details about using the parent child relationship with recurring events please see the Recurring Events help section.

For more details about using the parent child relationship when importing a schedule using a csv please see the Creating a Schedule help section.

If you have already created multiple events and want to link them using the parent child feature you must know the event titles or id numbers of the events intended to be children. A consideration in terms of workflow when linking events through the event setup page is that without the 'recurring' feature being used you can't easily bulk change anything in the linked child events. Manually linking events like this is a feature from before the recurring event tool existed.

Navigate to Admin>Mange Events.
Find the intended parent event by applying filters or looking in a specific time frame.
Click on the event title. (Alternatively, you could use curriculum search to find the event but then make sure you switch to Administrator View to edit the event.)
On the event Setup page scroll to Child Events just above the Time Release Options header.
Type in the intended child event id or title, click on the desired event, and click 'Add'.
Added child events will be displayed in a list. On the setup page for a child event it will list the parent event.
Click 'Save' at the bottom of the page.

Impacts of using the parent child relationship

Not every feature of Elentra reflects the connections made between events using the parent child relationship.

Curriculum Search does respect the parent child relationship and only return results for the parent. (In fact, curriculum search won't look at child events so even if a child event has distinct content from the parent, that won't be reflected in the search results.)

Curriculum Explorer does not respect the parent child relationship and returns all events regardless of relationship.

The Learning Event by Type Report does respect the parent child relationship.

Lecture Capture

New in ME 1.13! The Elentra lecture capture tool allows you to automate recordings of specific event types in specific room locations and have the resulting videos posted as resources to the relevant events.

The Elentra lecture capture tool is designed to work with NCast telepresenters. For more technical information about how to setup your NCast tools, the required calendar feeds, etc. please contact Alice Rush-Rhodes (arush@queensu.ca).

To use the lecture capture tools you must provide the appropriate information in various parts of the platform. You need to:

Define the technical resources in rooms stored in System Settings>Locations (see for more information).
Configure courses to automatically record sessions via Manage Courses (see for more information; you'll need to scroll down to the lecture capture section).
Ensure faculty have consented to recording their sessions (see for more information).
Optionally manage events as needed to edit recording status (e.g. if faculty can turn recordings on and off).

At the start of each day, a background process checks all events that are set to be recorded that day. The system automatically creates a streaming resource that will be available 30 minutes after the end of the recording and posted to the relevant event. (An organization can modify the 30 minute duration in the settings table - ask a developer for help to do this.)

Learners will see resources added to events as shown .

Event Pages

All events scheduled into Elentra can have information about them recorded. This can include date and time, location, audience, faculty, attendance, objectives, resources, etc.

Curriculum coordinators and program coordinators can access and edit the content of learning events for their affiliated contents. Faculty assigned to a course as its director can also access and edit the content of learning events in their course. Faculty>Faculty can only edit the content of learning events for which they are listed as teachers.

Learner View of Learning Events

The learner view of an event will depend a bit on how the event is configured and what information is added to it.

The first example shared here is the default learning event page (without context-based linkages or units in use).

Curriculum layout and course name are given.
Event title is displayed.
Event description and required preparation (optional fields).
Event information is displayed based on what is configured during event setup (e.g. not all events have locations, not all events will show the audience).
Objectives assigned to the event are shown.
Resources for the event are displayed (they can be sorted into Before Class, During Class, After Class, and No Timeframe).
Discussions and Comments area for the event.

If lecture capture is in use, videos will appear as resources once they become available. If not yet available, the date of availability will appear.

Event Setup Tab

The event setup page includes the basic information about an event. Much of this will be completed when creating the event, either manually or through Manage Drafts.

How to complete or edit an event setup page

Complete the required information noting the following: Event Colour: If you select a colour here it will display on the learner calendar and override the course colour selected. Course Unit: This option will only be visible if you have weeks and units enabled for your organisation. If no units display make sure that you have created units within the course through Admin>Manage Course on the Units page for the relevant course. Additional instructions are available in the Units help section. Event Location Building: If you need to add locations use Admin>System Settings and the Location tool. Event Types: Define the event type noting that you can include multiple event types within one event. Adjust their durations as needed. Associated Faculty: Add teachers to this event by beginning to type a name, clicking on it and clicking 'Add'. Note that you can define an associated user as a teacher, tutor, teacher's assistant or auditor. Audience Options: If you make attendance required the event will show as required in a learner's schedule, and you'll be able to record attendance during the event itself. There are some options available when taking attendance and for more information please see the Attendance page of this help section. Associated Learners: If you opt to create a custom event audience you'll be prompted to select an audience type. You can assign a cohort, course group, or individual(s) as the audience. One thing to consider here is whether you will role this event into a new schedule in the future. If yes, the easiest option is to leave associated learners as all those enrolled since then every time you role the event forward you don't need to adjust the audience.

If you add multiple cohorts or groups to an event you'll be able to specify how much time each group will exposed to for the event. For example, if you assigned a medicine cohort and a pharmacy cohort to a sixty-minute event you could indicate that the meds students will be there for the full hour, while the pharmacy students will be present for thirty minutes. To use this tool, add your audiences and then click on the grey clock icon beside the cohort/group name. This will open an Event Audience Time Override window where you can click and drag the slider (from either side) to set the appropriate time for the audience you're working with. Click the 'Warn me' checkbox if you want to be alerted to overlapping times. Click 'Close' to save your changes. When times have been adjusted for specific audiences the small clock icon will display green.

Child Events: You can manually enter an event name or id number here to link multiple events using the parent child feature. This restricts Curriculum Search and some curriculum reports to reflect only the parent event. For more information, please see the Parent Child information in the Scheduling help section.

Time Release Options: Leave this empty to allow users in the event audience to access the event at any point. If you complete these fields you can control when learners will be able to view and access this event, and when it will stop being available (if desired). Note that there is another tool that allows you to apply time release options to specific resources when adding them to learning events.

By default when you save this page you will directed to the event content page. If you'd like to go somewhere else, use the dropdown menu to select your destination after saving. Then click 'Save'.

Event Content Tab

The content tab of an event page is where you can provide learners with details about the contents of the event.

The first several fields on the page (date, time, duration, etc.) are controlled on the event setup page and only displayed on the event content page.

Complete the remaining required information noting the following: Event Types: You can edit the event types of the content page (this allows faculty to adjust the event types in their events if you allow them to). Note that you cannot adjust the event duration on this page; if you change the event types their total time must equal the original duration. (In default Elentra faculty can adjust the learning event types in their own teaching events. This can be disabled if you only want administrative staff to have that ability.) Medbiq Resources: If you are using the Curriculum Inventory Reporting Tool or your organisation is tracking Medbiquitous information you can select a Medbiquitous resource from the dropdown menu. (The list of Medbiquitous Instructional Methods can be configured in Admin>System Settings.) This information will not be visible to learners on the event page but will be reported in the Curriculum Inventory Reporting Tool. Event Description: Provide details about the event here. This information will be visible to learners on the event page and will also appear in Curriculum Search results and some reports (Curriculum Review Report, Course Summary Report). Note that this a rich text editor and you can embed media, change the font, etc. Required Preparation: Provide details about what learners should do to prepare for this event. This information will be visible to learners on the event page and when they preview events from the dashboard calendar. Event Keywords: This is an optional feature that can be turned on or off in your installation. Once on, it can be used to map Medical Subject Headings (MeSH) keywords to a learning event. Keywords will be displayed to the learner on the event page. If you have an organisation specific list of keywords it is suggested that you build it as a curriculum tag set. The keywords feature is specific to MeSH terms. Keywords are not reflected in Curriculum Search results. Free-Text Objectives: This is an optional field that can be turned on or off in your installation and can be organisation specific. If on, it allows faculty to type in objectives relevant to the event. These objectives will be displayed on the learner view of the event page and can also be viewed across an entire course using the Curriculum Review Report. Mapped Objectives: Here you can check off which of the curriculum tags assigned to the course apply to the specific learning event. Click the checkbox beside a curriculum tag to apply it to the event. If you wish to tag additional curriculum tags, including any not assigned to the course, click on 'Map Additional Objectives'. Click through the hierarchy of tags as needed until you can select the one(s) appropriate for the item. As you add curriculum tags, what you click on to select will be listed under the Event Specific Objectives section.

Note that if your organisation has week/units enabled the objectives area of the event content page will display a bit differently. For more information please see the Units help section.

Event Resources: To add resources to an event you have two options: a Quick Add drag and drop tool and the regular Add a Resource tool. The Quick Add tool is useful for files, whereas the the regular tool allows you to add different types of resources.

Use the Quick Add tool by dragging and dropping resources into the greyed out upload area or clicking 'Browse' and selecting the files to upload. Before the files are added, you can decide how users will view the resource, provide a title for the file(s), and decide whether to add timed release dates (click yes to enable and then provide the appropriate dates). You can include a copyright statement in the quick add resource box as well (there is no user interface to configure this, a developer will need to). Note that if you post multiple files through the quick add tool they will all have the same settings applied to them. If you use the Quick Add tool to add files to an event that is part of an event series, the resource will only be added to the event that you are editing; it will not be added to all events in the series. To do add one resource to multiple events in a series, use the Add a Resource tool instead.

Using the Add a Resource button will allow you to upload different resource types including:

Audio/Video - This allows you to attach audio or video files to the event, such as a Podcast or video clip.
Exams - This will direct you to the Exams page where you can select and exam and create a post for it.
Feedback Form - This allows you to attach a form created through the Assessment and Evaluation module to the event.
Lecture Notes
Lecture Slides
Link
Online Learning Module - This allows you to attach a learning module from another vendor to the learning event using a url. You can also set whether a proxy is required to be enabled (use this if learners have to authenticate to access the learning module).
Other files
Quiz - This allows you to attach a quiz created through the Quiz Module to the learning event. You'll be able to set additional parameters to the posted quiz like whether questions should be shuffled, the number of minutes allowed, the number of attempts allowed, and how learners will view their results (if at all).
Streaming Media - This allows you to embed streaming media into the learning event Resources section using an embed code.

Each resource behaves a bit differently when added, but generally you can set the following parameters through the Add a Resource wizard:

Whether the resource is optional or required
When the resource should be accessed (before, during, or after class, or no timeframe)
Whether to add timed release dates to the resource (Note that the system looks at whether a resource is to be accessed before, during, or after class and if you opt to time release resources, the system will require a time that matches the before, during, or after parameters.)
Whether to set the resource as published or draft (a draft resource will not be accessible to the event audience)
How to view the resource
The title and description of the resource

Posting an event resource includes a copyright statement users accept by default if they proceed to post the resource.

After posting a resource to an event, you'll see it displayed on the event page. Small badges identify characteristics of the resource. View a preview of the resource by clicking on the download arrow.

Edit an existing resource by clicking on the resource title to reopen it.
Delete a resource by clicking on the trashcan icon.

When resources are posted to a learning event, a tally of resources will be displayed in the learner calendar when learners mouse over an event. This gives learners a quick view of what is included in an event.

Additionally, LTI Providers such as Quizlet, Google Classroom, etc. can be added as a Learning Event resource.

Event Attendance Tab

On the Attendance tab of an event page you can record attendance for an event. You have two options to do so: manually by checking off each present learner or using Kiosk mode.

How to manually enter attendance

Click the checkbox beside the name of each learner in attendance. Click the checkbox again to change the attendance status.
Changes are saved constantly so there is no Save button on the page.
Search for a learner by typing in his/her id number.

Kiosk mode

Kiosk mode allows learners to swipe their school ids to complete the attendance record for the event. To use kiosk mode your organisation must set up some hardware and link it to Elentra to record attendance.

Once attendance kiosk mode has been configured it is easy to use.

Navigate to the relevant learning event page.
Click on the Attendance tab.
Click 'Kiosk Mode'.
When the green check mark comes up, learners can begin to swipe their cards.

You can download a CSV of learner attendance (blank or after completion) using the Download CSV button at the bottom of the page.

Information about potential hardware you could use is posted below.

Event History Tab

The history tab of an event page allows you to view changes made to that event. It records the date, time, user name and the nature of the change made. For example, March 2, 2017 10:15am Philip Smith updated clinical presentations.

Event Statistics Tab

The Statistics tab of a learning event page displays a list of users who have accessed the page. Additionally it shows how many times a user has viewed a page and when the most recent view was. The page also shows the total number of unique users to access the event and the total number of event views.

Reporting on Events

Monitoring Resource Views

If you have posted resources to an event you are able to see which users have accessed the resource.

Navigate to the appropriate learning event.
Switch in to Administrative view if you aren't already in it.
On the card for any posted resource click 'View'. You'll see a list of the audience members for the event, the number of resource views and the most recent view of the resource.

You can also rely on the Statistics tab to see which users have used viewed the event.

Overview of Event Data

To get an overview of all events within a course, and some of their content and curriculum tags you can rely on two different reports: the Curriculum Review Report and the Course Summary Report. For more information about these reports please see the System Reports>Curriculum help section.

Recurring Events Tab

Note that this tab will only display if the event you are editing is part of a recurring event series.

Calendar

What users see

On the learner dashboard, learners have a calendar view of upcoming events that include them in the audience.

Learners can toggle between day, week, and month view.
Learners can download or subscribe to a calendar.
From the calendar, learners can click on an event title to see more events details or navigate to the event page.
As of ME 1.15, Faculty now have a graphic calendar view on their dashboard under the Learning Events tab. In addition, they will see a list of all events with which they are associated under the heading My Teaching Events.
Faculty can select to view different time periods using the Events taking place dropdown menu.
Staff and other users not associated with any learning events will not see any calendar on their dashboard. Admin. users will see a calendar that displays the schedule of the most recently created cohort.

Where events come from

The calendar is automatically populated with all scheduled events.
To have something display on the calendar, add it as a learning event via Admin>Manage Events.
The Events calendar in a Course Community also shows scheduled learning events.

Calendar Subscription

Users can subscribe to receive ongoing updates to event dates and times. There are two places learners can subscribe to calendars: the dashboard (gives access to course calendars) or within a community events page (access to events created within that community only). Faculty can subscribe to a calendar of their teaching events.

Learners can subscribe to or download a calendar from their Dashboard page.

If CBME is enabled in your organisation, learners can scroll down the page or click 'My Event Calendar' from their dashboard options (by default their dashboard will show their CBME data at the top of the page). Without CBME enabled learners will land on a dashboard page with their calendar upon logging into the system.
Below the calendar, click 'Subscribe to Calendar or Download Calendar'.
Click to select All Calendars or Individual Course Calendar. For the second option, indicate the appropriate course using the dropdown menu.
Click 'Subscribe' to get a version of the calendar that will not allow you to edit events but will update automatically to reflect changes made to the schedule in Elentra. After clicking Subscribe you can click to copy the subscription URL and add it to your calendar tool or click 'Subscribe to Calendar'. Your computer will likely prompt you to choose an application to open the link.
Click 'Download' to get a version of the calendar that you can edit but that will not automatically update based on changes made within Elentra. (You will be able to re-download the schedule at any time.)
Click 'Download Calendar'. Your computer will prompt you to choose an application to open the download or you can save the file. If you save the file you can later add it to your preferred calendar tool.
Events in the calendar will display any required preparation supplied in the event and will include a link to the learning event.

Faculty can subscribe to a calendar that displays the learning events the individual faculty member is associated with.

From the dashboard, scroll to My Teaching Events and look for the small calendar icon in the bottom right.
Right click on Subscribe to Calendar.
Click 'Copy Link Location/Address' or Send Link to Device/Services depending on the browser being used and how you want to subscribe.
If you click Subscribe to Calendar a file will download to your computer or you many be prompted to open the file with an application. This can provide a file that can be added to a calendar tool but it will provide a static calendar of events.
There is currently no user interface for faculty to subscribe to individual course calendars.

On a community events page, you can get a static version of the calendar or subscribe to an automatically updating version.

To subscribe to an automatically updating version of the calendar of events, right click on the calendar icon. Click 'Copy Link Location/Address' and paste the link into a subscription feed for your preferred calendar tool.

If you click on the calendar icon your computer may automatically download an ics file or may prompt you to choose an application to open the download or you can save the file. If you save the file you can later add it to your preferred calendar tool. This will provide a static version of the calendar including already created events. You can re-download it later to update your calendar.

Please note that it can take up to 24 hours for any changes made to Events in Elentra to appear on your subscribed calendar (Google Calendar, Outlook, iCalendar).

Units/Weeks

The units and weeks feature allows an organisation to add curriculum layout placeholders that divide each curriculum period (Year 1, 2, etc.) into weeks, e.g., Week 1, Week 2, Week N, and assign events to those units in each course. To facilitate this, certain settings have to be in place in the software. If you are not seeing weeks or unit options and you think you should be, please ask a developer at your institution to check the settings table and make sure weeks is enabled.

Using the weeks and units feature requires a couple of steps. First, an administrative user has to build the global weeks for an organisation; next, units can be added to courses and linked with the weeks structure. Finally, events can be linked to a unit. Doing this populates a learner view of Weeks that displays all units across courses and lets learners drill down into a unit to view its objectives, affiliated events, and resources.

Using the weeks feature means that you can also apply weeks as a filter in a variety of places in Elentra. You can use weeks to refine your search results in Curriculum Search, on the Events page, and in the Curriculum Tag Minutes and Mapping Report.

Creating Units

To facilitate the weeks feature, certain settings must be in place. If you are not seeing weeks or unit options and you think you should be, please ask a developer at your institution to check the software settings.

How to create a list of global weeks for an organisation

Remember that weeks are global across an organisation. As such, it is recommended you keep the naming fairly generic (e.g., Week 1, Week 2, Week 3, etc.).

Navigate to Admin>Manage Curriculum.
On the Manage Curriculum card on the left sidebar, click 'Curriculum Weeks'.
Click 'Add Week'.
Provide a week title, select a curriculum period (called category on the screen), and provide a week order (leave at default 0 to just add the week at the end of any existing weeks). Week order will dictate the order in which existing weeks will appear in the learner view.
Click 'Save'.
You will see a green success message and be redirected to the list of existing weeks.
Edit any existing weeks by clicking on the week title.
Delete any unwanted weeks by clicking the checkbox beside the week and clicking 'Delete Selected' at the bottom of the list of weeks.

How to add units to a course

Weeks must be set up at the organisational level before you can add weeks to a course. See above for more information.

Navigate to Admin>Manage Courses.
Search for the course you want to work with.
From the cog to the right of the course name, select 'Units'.
Ensure you are in the correct curriculum period and, if needed, switch it using the dropdown menu.
Click 'Add New Units'.
Provide the required information noting the following: Unit Code: This will display to learners in the weeks overview and be in the title of the unit page. If you use this, it is recommended that you maintain parallels between week and unit names. Unit Title: This will display to learners in the weeks overview and be in the title of the unit page. Unit Description: This will be visible to learners when they click on a unit to view it. Week: Select a week to apply this unit to. Week Chair: Begin to type a name, click on the desired name and then click 'Add'. This will be visible to learners. Unit Order: This defines the order in which the unit will display to learners. It is recommended that you keep this at 0 and let the week order dictate the display order.

How to apply curriculum tags to units

Add any desired curriculum tags to the unit by clicking on 'Select Curriculum Tags' and drilling down to the appropriate tag.
These unit tags will be displayed in two places on the learner week view: the Weeks Objectives and the Unit Tags list. If you later contextually link sessional objectives to your Unit Tags from an event page, those linkages will be available to view under the Unit Tags list on the Weeks summary view.
If your organisation has enabled context-based curriculum tag linking (that is, you can link curriculum tags to each other at the unit and event level), you can click on any curriculum tag added to the unit to add additional curriculum tags under it. More information about context-based curriculum tagging is available in the Curriculum>Context Based Linkages help section. Note that you can use the weeks function without using context-based curriculum tagging.
Click 'Save'.
Note that in a course, you can only link one unit to a week and have it display properly to learners.

How to link learning events with a week

After units have been added to courses and linked with weeks, you can link events to each unit through an event Setup page. This will create the connections to have learning events show up on the Weeks summary view.

If you are manually adding a new event through Manage Events you will add a Course Unit on the Adding Event screen.

If you have an existing event and you want to link it to a unit navigate to the event Setup page and add the Course Unit. You can find a specific learning event via Admin>Manage Events or using the Curriculum Search feature (if you know the event title).

Learner View of Units

The learner weeks view is accessible from the Weeks tab on the main tab menu. It provides an overview of the weeks and units across multiple courses. By clicking on a unit learners can access a summary of the week including resources, objectives, learning events, and unit tags. Learners have the option to bulk download resources included in the unit and can print a list of all objectives.

“Week Objectives” shows curriculum tags applied to the unit. If learning events have been tagged with a curriculum tag and that curriculum tag has been contextually linked with one of the week objectives assigned to the unit, the curriculum tag and learning event will display under the list of week objectives.

“Unit Tags” shows tags assigned to the unit and any tags contextually-linked to the unit tags (view the latter by clicking on the unit tag to expand a list below it). (This information will only be visible if context-based linkages are enabled in your installation.)

Cases

New in ME 1.15! Thanks to a collaboration with Kaiser Permanente, a new module called Cases has been created to support case-based learning in Elentra.

Cases in Elentra allows you to group learning events from across courses into cohesive patient narratives to present to students. Whether your curriculum is systems-, discipline-, or problem-based, you can link lectures, labs, small group activities, etc. from multiple courses to a case and give learners an easy way to view the inter-related learning events. Cases have a designated timeframe to help keep things organized and content within cases can be mapped with curriculum tags at the event or unit level (use of Units with Cases is optional).

Features:

The Learner Dashboard shows current cases for quick access.
The Case tab stores all cases so learners can easily review past materials. Search and filter options allow learners to quickly find cases by most recent, date range, case status or instructor.
An administrative page to manage all cases (also includes search and filter options).

It is important to note that a case can include learning events from one curriculum period. As such, if you have a longitudinal case that students will return to over the course of a year, you would need to have a curriculum period spanning that year and use it for any courses that include learning events that are a part of the case.

Creating and Managing Cases as an Administrator

To uses Cases, a developer will need to enable cases in the settings table in the database. If you are also using units you will also need weeks enabled in the database.
To create and manage cases, you must have Medtech:Admin or Staff:Admin permissions.
There are multiple possible workflows to use Cases. The general recommended workflow is as follows:
- Create courses with active enrolments. (This associates a curriculum period with the course which is necessary for the case wizard to find relevant learning events.)
- Add learning events to Elentra.
- Create cases.
Alternatively, you can build weeks within your organization and then associate cases with those weeks. Please see the Units/Weeks section for further information about configuring weeks for your organization. Note that if you are the administrator creating weeks for use with Cases, you should create a week for each case you intend to create.
You could also build weeks within your organization and units with courses and then associate units with cases. (Learning events would be linked to units and therefore connected to the case.)
For any of these options you should have courses with audiences created before you begin. For the recommended workflow, you should also have your learning events created before creating a case.

Here are detailed steps to follow the recommended workflow for creating a case:

Navigate to Admin>Manage Cases.
Click '+ Add Case' in the top right hand corner.
Follow the three step Case creation wizard to guide you through the creation process.
Step One
- Set the start and end date of the case, the Curriculum Period, title, description or summary, photo and case contact. This information will appear on the Dashboard when the case is active during the selected date range. The date range set for the case will also impact the learning events you are able to include in the case.
- Note: The start and end date for the case must be within the specified curriculum period. The curriculum periods displayed in the drop down are all active curriculum periods.
- Click 'Make Draft' to save and return to your case later, or scroll up and click 'Proceed' at the top of the case card to move on to the next step. While in draft mode, a case will not be visible to learners.
Step Two
- Associate a case with a week. By default, the system will create a week automatically and if following the recommended workflow, this is the option you will use.
- Click 'Make Draft' to save and return to your case later, or scroll up and click 'Proceed' at the top of the case card to move on to the next step.
Step Three
- Select Learning Events to associate with the case. Events can be selected from the 'Select Event' drop down. Only events that are note already associated with a case and that occur during the start and end date of the case specified in step one will appear. Note that there is an 'Add All' option at the bottom of the list to use as needed. To remove an event from a case, scroll down and click on the 'Remove' button beside the event title.
Once all steps have been completed, the 'Publish' button will be available to post the case. After clicking Publish, the case will show as published on the Manage Cases screen and the case will be visible to learners. (See Cases tab below.)

Note: When you create a case using the recommended workflow, a global week is automatically created in the database. You can view these weeks via Admin > Manage Curriculum > Manage Weeks, only if you have the weeks setting enabled in the database.

Using Cases if you already have Weeks and Units Built

If your organization already has units built in courses but you'd like to leverage the Cases function, you can create Cases and add units to them on Step 2 of the Cases wizard.

To associate a case with an existing week, click on 'Create Week automatically' and you'll be shown a list of existing weeks you can associate the case with.
On Step 2, you also have the option to associate units with a case. This could be useful if your organization was already using units prior to your decision to use case. A unit does not need to be selected unless you have previously created units for courses in Admin > Manage Courses > Units.

Note that when creating a case, as soon as you save it as a draft, the system will create a week for the case. Therefore, if you want to attach existing weeks and units to a new case, make sure you do so on Step Two before saving your draft.

Note: If you have set up Units in courses, and affiliated a unit with a case, you will also be able to select the case when creating new learning events by clicking on the Course Unit field. Only the cases that are available during the timeframe of the learning event will be visible in the drop down. When you go to Admin > Manage Cases and select the case that was attached to the learning event, it will automatically appear in the list of Associated Events and update the unit count of the case.

Cases tab

The easiest way to see all cases is to go to the Cases tab.

You will be able to see the status of all the cases (Not Started, Feature, Completed), the date range of when they are scheduled and the instructors of the case. You can search for cases or filter them based on most recent, least recent, case status or date range. The main function of this tab is to search for cases.

Clinical Experience

Elentra supports a variety of features to support clinical learning experiences. Granular Clinical Scheduling and the Clinical Lottery modules have been added to ME 1.15.

Main features:

Logbook for documenting completion of clinical tasks during rotations and clerkship
Clinical Lottery for determining a learner's preference for rotation positions
Rotation Scheduling for work-place based learning
Granular Clinical Scheduling for scheduling clinical events within rotations
Electives for clerkship students
Leave Tracking

Accessing My Learners in Clinical Experience

How to access My Learners in Clinical Experience

Navigate to Admin>Clinical Experiences.
You will land on the My Learners tab but in case you don't, click the 'My Learners' tab under the Clinical Experiences heading.
Each learner card displays the learner name, email, photo and institutional id.
Search for a learner as needed, and if you can't find someone, ensure that you are in the correct curriculum period using the dropdown menu on the right.

After finding the correct learner, you'll be able to access pages relevant to this learner. Options you might see include Assessments, Logbook, Lottery, CBME, and Leave Tracking.
Note that you can download enrolment from the My Learners tab.

Logbook

We released a version of logbook in ME 1.13 but ME 1.14 adds several features, including reporting options, and makes a few other changes to how the logbook should be set up. Please carefully check which version of Elentra you are using before you proceed!

The logbook module in Clinical Experiences allows an administrator to define requirements like number of entries, learner role in the experience, and the setting of the encounter.

Several steps are required to use the logbook:

Build a new curriculum tag set and flag each applicable tag as "loggable" (complete via Manage Curriculum).
Set a course as including clinical experiences and assign the appropriate curriculum tags to the course (complete via Manage Courses>Setup tab).
Define the requirements for each loggable encounter (complete via Manage Courses>Logbook tab).
Have learners complete and log encounters (learners access this via the Logbook tab on the main menu).

Set Curriculum Tags as Loggable

To make curriculum tags available as loggable you must flag them as such in Manage Curriculum. If a tag is not set as loggable you will still be able to assign it to a course, but it will not be visible under the course Logbook tab.

Unlike ME 1.13, you can now use a curriculum tag set that has 1 or 2 hierarchical levels for logging. The maximum level of hierarchies for the logbook curriculum tag set at this time is 2 levels. Any further levels will not be shown in the UI. See images displaying curriculum tag hierarchy at the bottom of the page.

You must be a user with administrative role permissions to edit curriculum tags.

New in ME 1.14 you can set an entire tag set to loggable at once!

To set an entire tag set as loggable:

Navigate to Admin>Manage Curriculum.
Click 'Curriculum Tags' from the Manage Curriculum card on the left sidebar.
Click the checkbox beside the appropriate curriculum tag set.
Click 'Make all loggable' below the list of tag set titles.
To set all tags within a tag set as not loggable, click 'Make all unloggable'.

If you wish to specify that certain curriculum tags within a tag set are loggable and others aren't, you must individually set each tag as loggable.

Navigate to Admin>Manage Curriculum.
Click 'Curriculum Tags' from the Manage Curriculum card on the left sidebar.
Click on the appropriate curriculum tag set.
In list view, hover over a curriculum tag and click the pencil icon to edit the tag. In table view, click the pencil icon to edit the tag.
Click the checkbox beside "This curriculum tag should be loggable in the Experience Logbook."
Click 'Save'.

Tags set as loggable will be available to any course to which they are assigned as course objectives.

Sample Tag Set with 2 Levels

In this sample the entire tag set is called Logbook Objectives. The Logging Categories (Level 1 hierarchy) are Entrustable Professional Activities, Tasks/Procedures, and Encounters.

Each of the level 1 categories have additional tags nested underneath them.

If you have a 2+ level hierarchical tag set and are manually inputting additional tags note that the children nested beneath a top level tag will inherit the loggable setting of that tag. For example, if the entire Entrustable Professional Activities

Course Setup Required to use Logbook

In both ME1.13 and ME 1.14, the logbook can only be used if you use the traditional method of assigning course objectives, not the quick tag selector option (images below to help you know which you use).

After curriculum tags are set as loggable, they must be assigned to a course and the requirements for each tag defined.

Assigning Curriculum Tags to a Course

To assign objectives to a course you must have administrative role permissions; the task is completed via Admin>Manage Courses on the Setup tab of a course. Remember, for both ME 1.13 and ME 1.14 you can't use the logbook if you use the quick tag selecto

You can find more detail about the steps required to assign objectives to a course on the Course Setup help page but one important detail to note is that you need to pay attention to how you assign the objectives depending on whether you have a tag set with a one or two level hierarchy.

If you have a one-level tag set, you should assign each individual curriculum tag that you intend to require logging for.

If you have a two-level hierarchy and you want to include all of the second level curriculum tags, you should assign the top level objective to the course, not the subset of objectives. In the example below, note that Entrustable Professional Activities is added to the course, but EPA 1, 2, 3, and 4 are not checked off. They will be added automatically. If you have a two-level hierarchy and you want to include only some of the level 2 curriculum tags, then you should individually select them.

Setting Logging Requirements for Each Curriculum Tag

New in ME 1.14! You can now configure requirements for each individual curriculum tag at a more granular level (e.g. specify the role and setting requirement for each tag within a set).

You have the option to define course sites, entry requirements, roles, and settings (called Environments on the admin. side) for all loggable tags. The options you define will dictate the requirements learners have to fulfill and also what options display to them when they create an entry by using a logging form.

Entries lets you define how many encounters a learner is required to have for a tag or tag set, as well as whether notes or an observer (of learner performance) is required.
Roles lets you define in what capacity a learner participated in an encounter; learners will pick from this list when they log an entry.
Environment lets you define the settings a learner can pick from when they log an entry.

Whether you are working with a 1 or 2 level hierarchy tag set will impact what you see in the user interface.

Display of Curriculum Tag Sets

On a Course Logbook tab you'll see a list of objectives assigned to a course. Remember that the way you configured a tag set (level of hierarchies) and how you assigned objectives to a course will impact how this list displays.

Here's what I assigned to the course:

And here's how the logbook objective configuration shows up:

Setting Requirements for Loggable Tags

Navigate to Admin > Manage Courses.
Click on the name of a course and then the Logbook tab, OR click the menu cog to the right of the course name and select Logbook.
Make sure you are working in the correct curriculum period, or switch it if necessary.
Click 'Edit' beside any curriculum tag or tag set to set its configuration.
If working with a 2 level hierarchy tag set, click the plus icon on the 'Overall configuration for <tag set title>' to open the overall configuration options. This allows you to apply a default configuration to all tags in a set and then make individual changes as needed.

Entries

Define the settings you want as a default, noting the following:
- Require Notes: If you check this off, the learner will be required to include notes (which could be a reflection) when they log an entry for this tag.
- Require Observer: If you check this off, the learner will be required to indicate the name of the person who observed them when they log an entry for this tag.
- Min: Use the plus and minus buttons to indicate if there is a minimum number of encounters required for this tag.
  - If using a 2 level hierarchy tag set, the notes and observer setting in the Overall configuration will apply to all included nested tags, however, the Min. set here is for the total number of encounters for the set.
Click 'Apply'.
You will see a success message.
- If you are using a 2 level hierarchy tag set, the Overall configuration menu will collapse and you can adjust the entry requirements for individual tags as needed (e.g. remove notes requirement from a certain tag, or indicate specific minimum numbers for individual tags).
- Click 'Apply' for each tag when complete.
- Click 'Close'.

Roles

On the Roles tab you can define whether or not a learner is required to indicate the role they played in an encounter. The default options are observed, performed with help, and performed independently.

Click 'Edit' beside a tag/tag set.
- If you are using a 2 level hierarchy tag set, click the plus icon beside the tag set name to reopen the Overall configuration menu, then click on 'Roles' to apply a default setting to all tags.
Check off 'Require Roles', this will open a list of roles to select from.
Check off each role that you want to include for a tag; when you do this you will have the option to set a minimum required number as needed.
Click 'Apply'.
You will see a success message.
- If you are using a 2 level hierarchy tag set, the Overall configuration menu will collapse.
- To adjust the role settings for an individual tag, click on 'Settings'. This will open another menu (you should see your default settings already applied). Adjust the role options and requirements for individual tags as needed.
- Click 'Apply' for each tag when complete.
- You will get a success message.
- Click 'Close' to collapse the card.

Environments

On the Environments tab you can define whether or not a learner is required to indicate the setting of an encounter, and specify the environments available to learners when they log entries. The default options are displayed below.

Click 'Edit' beside a tag/tag set.
- If you are using a 2 level hierarchy tag set, click the plus icon beside the tag set name to reopen the Overall configuration menu, then click on 'Environments' to apply a default setting to all tags.
Check off 'Require Environment/Settings'; this will open a list of roles to select from.
Check off each role that you want to include as an option for a tag; when you do this you will have the option to set a minimum required number as needed.
Click 'Apply'.
You will see a success message.
- If you are using a 2 level hierarchy tag set, the Overall configuration menu will collapse.
- To adjust the role settings for an individual tag, click on 'Settings'. This will open another menu; click 'Environments' (you should see your default settings already applied). Adjust the environment options and requirements for individual tags as needed.
- Click 'Apply' for each tag when complete.
- You will get a success message.
- Click 'Close' to collapse the card.

Checking Logbook Configuration

You can reopen a curriculum tag card at any time to view a summary of all the minimum requirements you've configured for a tag or tag set. Learners will see similar tags on their logbook entry pages.

In the example below the tag requires 5 entries to be logged in total, and the minimum requirements are that 1 is in the clinic, 1 in an emergency setting, etc. It is possible to a learner to fulfill multiple requirements with one logged entry (e.g. a task performed with help in an emergency setting). Please see the note here about communicating logbook requirements to leaners.

Course Sites

At the bottom of the Logbook page you can define sites available to learners when they log entries for a course. Your options will depend on the sites defined in Manage Locations. Please see more detail on the System Settings>Location help page.

Click anywhere in the 'Select a site' bar.
Hover over a site name and click on it or press Enter to add a site to the list.
Sites will display in the order added to the Course Sites list.
To remove a site from the list click the small 'x' beside the site name.
Click 'Save'.
You will get a success message.

Learner Use of Logbook

To access the logbook learners must be enrolled in a course that is marked as including clinical experiences, and has loggable curriculum tags configured with minimum requirements.

Learners have a separate page for each course they are enrolled in and can log entries for any course while its curriculum period is active.

A note on communicating logbook requirements with learners: As of ME 1.14 there is not a user interface that easily allows learners to see all details of all their requirements in one table. While learners can view how many entries have to be observed, how many have to be in a particular setting, etc. there is not a matrix view that shows them how these configurations interact. For that reason, you may find it useful to provide students with a table that shows them these requirements, especially if you have complicated logbook requirements.

Accessing a Logbook

Click 'Logbook' from the main tab menu.
Click the grey chevron to the right of a course name to switch courses. Click on the name of the course you want to log an entry for.
You'll see a list of curriculum tag sets that include loggable tags and an overview of the requirements for a specific tag set.
- The percentage beside the tag name shows current completion.
- Click on a label (e.g. Clinic) to view its details (e.g. 2 required, 0 completed). Grey labels show the entries required and green cards show the entries completed.
- Click the plus icon on the right side of a tag to view overall completion.
- Click the tag name or black chevron beside the tag name to view a list of existing entries.
Click on an entry to open your options. Click 'Show Entries' to view previously logged entries, or click 'Add Entry' to log something new.

Adding An Entry

Click 'Add Entry' at the top of the logbook.
Complete the information, noting the following:
- Encounter Date: This is required and can be set to before the current date if a learner needs to log a past experience.
- Encounter Time: This is automatically set to the time when the form was triggered but can be adjusted as needed.
- Rotation: This will be preset with the course you were looking at but can be adjusted as needed.
- Clerkship Site: Click anywhere in the bar to access a list of available sites, and then click on the appropriate site. (If no sites were configured for the course logbook this option will not appear.)
- Patient Age Range and Gender: These will appear as default fields on all logging forms and Gender will automatically be 'Not Specified'.
- Clinical Tasks: This is where the learner can indicate which tags they are logging with this form. Learners can add more than one tag to a form; if they do they will have a place to log the details for each tag.
- Preceptor: This field will appear if an observer is required for this entry. Start typing a name to get a list of people, and then click on the appropriate name.
  - If a learner is logging multiple tags on one form, they will see a Global Preceptor option. This allows them to easily apply the same preceptor to all the tags (although they can still change the preceptor on a specific task).
- Role: Click anywhere in the bar to access a list of available roles, and then click on the role that best describes what you did during this encounter.
- Setting: Click anywhere in the bar to access a list of available settings, and then click on the setting in which you completed this encounter.
- Users can clear the contents of a form by clicking the eraser icon.
  - Users will be asked to confirm their decision. Click 'OK' to confirm.
- To deselect a task and remove it from the logging form click the small x beside the eraser icon.
  - Users will be asked to confirm their decision. Click 'OK' to confirm.
Click 'Save'. You will get a success message and the entry will be added to your list of logged entries.

Checking your completion status

Access the Logbook tab from the main tab menu.
Select a course for which you have logbook requirements.
You’ll see an overview of the requirements for each loggable objective (e.g. setting names, roles, etc.). Click on a specific label to see your requirements and progress within that category.

Click the + icon on the right of the card to expand it and view the overall count of logged entries.

Click the down chevron to view a list of all logged entries within that requirement.

If a top level card is the title of a hierarchical tag set, you’ll see multiple objectives within that set when you expand the card. Click the down chevron beside an objective to view a list of all logged entries for that objective.

How to Edit an Existing Tag

From the detailed view shown immediately above, click on the pencil icon in the left column of the entry.
Make any required changes and click 'Update'; you can also delete the entry from this screen.
You will get a success message confirming your action.

Logbook Reporting

Staff:admin users as well as staff:pcoor and faculty:directors affiliated with a specific course will be able to access Admin > Clinical Experience and the logbook.

Navigate to Admin>Clinical Experience.
Click on the Logbook tab below the Clinical Experience header.
By default the page will load one course and its most recent curriculum period, as well as 'Learners who have incomplete logbooks'.
- The way this works is that the system checks learners’ rotation schedules and sees which rotation the learner is currently scheduled in. If learners are half way through a rotation but have less than 50% of the logging requirements complete, they are deficient. (Note a developer can change this threshold in the database as required.)
- If a learner is for some reason enrolled in two blocks within the same rotation, the system will take the dates of the second block to measure completion.
You can change the filter options or search for an individual learner.
- Filter by course to view all learners enrolled in a course. Note that you can apply multiple courses so carefully check you’ve included the ones you want. After you select a course, you can set the appropriate curriculum period.
- Filter by cohort to view all learners in a cohort.
- To remove a course or cohort from the list, click the small ‘x’ beside the course/cohort name.

Monitoring a Course

Monitoring an Individual's Log

Once you see learner cards, click the + icon on the right to see an overview of all the learner's courses and their logbook count in each.

Click ‘View Details’ on a learner card to open a new tab from which you can download a CSV of the learner’s logged entries in each course or view details inline.

Click ‘View Details’ on a course card to see an overview of progress.

From each objective you can click the + icon to see an overview, and then click ‘View entries’ to see a list of individual logged entries.

Download a CSV of what you view on your screen at any point.
- CSV will include: learner name, learner #, learner email, list of courses and number of pending entries for each course.
Some CSV options will offer you two download versions:
- Course overview: Show total count of required and logged entries organized by course.
  - This will include learner name, learner #, learner email, course name (called rotation), objective, required, and logged.
- Course entries: List all logged entries for the learner with details like date, role, setting, etc.
  - This will include learner name, learner #, learner email, course name (called rotation), objective, required, logged, encounter date, patient age range, patient gender, role, setting, site, preceptor, and notes (called reflection).

Lottery

Introduction

Elentra's Lottery module is designed to streamline the process of generating a rotation schedule for the clinical portion of the curriculum. The module provides administrators with the ability to create, manage, and configure lotteries, while also providing learners with the opportunity to provide feedback by ranking and submitting their preferences. Each lottery incorporates its learners' preferences into a processing algorithm, which can be run one or more times, with each variation creating a draft schedule that tracks the level of calculated learner satisfaction. Resultant draft schedules may then be compared based on their learner satisfaction scores and manually edited as needed, and once an administrator has reviewed their chosen draft schedule, it can be published as the finalized schedule.

Sample Process

The following is a high-level example of the process an organization may go through when configuring and running a lottery using the Elentra module.

Create a Lottery for a specified curriculum period, providing a title and visibility date, then selecting a draft schedule to determine its audience and available rotations.
Schedule a Stage within the created Lottery by setting the date and time when it should be available to learners to provide their preferences.
Create a series of Options for the Stage, one for each different arrangement of scheduled rotations.
The scheduled Stage opens on its specified date and time.
While the Stage is open, each learner logs in and ranks the Options in order of which ones they prefer the most.
The Stage closes on its specified closing date and time.
The Stage is then manually executed with a set number of variations. For each variation, a potential draft schedule is generated, incorporating the learners' ranked preferences and schedule availability.
The variations are reviewed to determine which is the most viable, with the highest learner satisfaction. The chosen variation is merged into the Lottery's working schedule.
The Lottery's working draft schedule is reviewed and published.

Glossary

Curriculum Period: a period of time that defines the beginning and end of a curriculum.
Lottery: a container associated with a specific curriculum period that defines an audience and contains one or more stages.
Audience: the collection of learners that will be scheduled by the lottery processing. The audience is determined by the initial draft schedule that is selected when creating a lottery.
Learner: a single audience member.
Stage: each stage is contained within a parent lottery, and defines the period of time when it will be "open" for the lottery's audience of learners to rank that stage's options, in order of preference. After a lottery has closed, a stage may then be executed, transforming the learners' submitted preferences into partial rotation schedules that are merged into the final working schedule.
Working Schedule: each lottery has its own working copy of a rotation schedule, which is populated through the process of executing stages.
Option Type: options can be created as one of two different types to provide flexibility. The option type to be used is specified when creating a stage:
- Sequential: each option created within the stage will consist of a stream of multiple blocks, in varying arrangements.
- Singular: each option created within the stage will consist of a single block
Option: an ordering of one or more clerkship blocks, also known as a stream, track, grid, or group. Options are defined by an administrator and later ranked by learners in order of their preference. If a stage is set to “Singular” mode, each option will contain one block, whereas with “Sequential” mode, each option can contain multiple Blocks in varying arrangements.
Ranking: when a stage is open, each learner in the audience is tasked with reviewing the stage's options and submitting their preferred ranking. This list that maps the options to their ordered preferences is a learner's ranking.
Block: defines the specific period of time and optionally, the location where a learner will complete some form of task or content related to a particular course.
Slot: a slot defines the site and occupancy spaces available for a block. Blocks can have multiple slots, each of which may define their own minimum and maximum number of spaces.
Space: represents an actual vacancy within a slot, and serves as the link that allows learners to be assigned to a specific rotation within a schedule.
Site: the physical location where a rotation takes place. Each block within an option may specify one or more sites where the rotation may occur.
Variation: a variation is the result of an executed stage. Each variation represents a partial rotation schedule that the admin can review and adjust, or merge into the lottery's working schedule.
Satisfaction Rating: this is a percentage rating value that shows how close a variation was to the ideal scenario, where every learner received their top choice. The higher this value, the higher the number of learners who received their preferred option.

Managing Lotteries

Lotteries Overview

The Lotteries Overview is the landing page for Elentra's Lottery module, and consists of a stacked list of all existing lotteries (represented as separate Lottery Cards) that are associated with the currently selected curriculum period.

Curriculum Period Selector

At the top of the lotteries overview is a dropdown selector labelled Term & Curriculum Period. Lotteries are always bound to a specific curriculum period. To view the list of existing lotteries, or to create a new lottery you must first select a curriculum period.

Once a curriculum period is selected, a stacked list below will be populated with any existing lotteries, and the inline Add Lottery button will become enabled, allowing the admin to create a new lottery.

Note: If the currently selected curriculum period has ended, the Add Lottery button will be disabled, and any existing lottery cards will be unavailable for editing.

Lotteries List

Each lottery associated with the selected curriculum period will be represented in this list as an individual Lottery Card. Just above this list of cards, there are controls for searching through and sorting the list of lotteries. To search for a specific lottery by name, you may use the Search Lotteries input field, or adjust the Sort By selector to arrange the list in ascending or descending order, by either the title or date.

Lottery Cards

Lottery Card

Each lottery that appears in the stacked Lotteries List is represented as a separate Lottery Card, which provides administrators with useful controls, and information about the status and details of a lottery.

Card Header

A lottery card is divided into three parts - a header, a body, and a footer. The card header showcases the administrator-provided title of the lottery, and off to the right-hand side, a toggle that expands or collapses the lottery card. An upward-pointing chevron icon means the lottery has been expanded, while a downward-pointing chevron indicates the lottery is in its collapsed, default state.

Card Body

When a lottery card is in its default, collapsed state, a simple set of meta information is displayed. This meta information consists of two separate counts, one for the number of stages contained in the lottery and another for the total number of learners in the lottery's audience.

Expanded Content Tabs

When a lottery card is expanded by clicking the downward-pointing chevron button at the right of the card header, a new content window will appear within the card. This content window is comprised of two content tabs, Schedule and Stages, which allow the admin to view more in-depth information about the lottery.

The "Schedule" Tab

The Schedule tab displays the lottery's working schedule which is comprised of unique, stacked rows, one for each learner in the audience. Each learner row displays a combination of all their pre-existing rotations, plus any new rotations that have been assigned to the learner. These newly assigned rotations are typically added when a stage has been drafted, and one of the drafted Schedule Variations is merged into the lottery's schedule.

When the administrator is ready to publish the lottery's working schedule, they may use the action button below the rotation schedule, labelled Publish Schedule. This button action has a confirmation dialogue modal to prevent accidental merges.

The "Stages" Tab

The Stages tab contains a condensed summary of all stages associated with the lottery. Stages are listed in compact, stacked rows that state clearly the type of stage, their current status, and information on stage timing (this is presented slightly differently depending on whether the stage is upcoming, active, or has closed).

When a stage's current status is "Open", this means that the stage is available to learners at that time. In the case of any open stages, additional information is provided in the form of a progress bar and a button-activated modal. The progress bar displays as a linear gauge that represents the total number of lottery audience learners, relative to the number of them that have submitted their rankings. Clicking the View Learner Status button to the right of the progress bar opens the modal, which allows an administrator to see in greater detail which learners have submitted and which learners haven't.

Card Footer

The card footer contains several action buttons. On the right side are Edit and Delete buttons, and on the left there is a Manage Stages button, which will open up the Stages Overview for that lottery.

Creating a Lottery

Walkthrough

While the full process of using the Elentra Lottery module has many steps on the way to generating a published schedule, the first of these steps is fairly simple, and that is to create a Lottery. In the context of this module, a lottery acts as a container, that defines an audience of learners and is tied to a specific curriculum period. In order to create a new lottery, we first need to navigate to the Lottery module in Elentra, then select the curriculum period to which the lottery belongs.

To navigate to the Lottery module on your Elentra installation, click Admin > Clinical Experience, then click the Lotteries tab link, which will take you to the Lotteries Overview. Select the desired curriculum period from the dropdown selector labelled Term & Curriculum Period, then click the Add Lottery button.

This action will open the lottery creation form, which will prompt you for some details in order to proceed. Start by providing a descriptive Title, then move on to the Visibility Date and Visibility Time, which determines when the audience of learners will be able to see the lottery in their My Lotteries dashboard.

The title of a Lottery will eventually be displayed to Learners in their My Lotteries dashboard, so make sure to choose a helpful and unique title.

Next, you'll need to select a Draft Schedule to import. The lottery schedule will act as a working copy of the schedule specified here. The audience of learners and available rotations are automatically determined by the schedule chosen for import. Once ready, click the Confirm button, then once again for the confirmation modal that will pop up.

After the process completes, you will be returned to the Lotteries Overview, where you will now see your newly created Lottery card in the list. You're now ready to create a Stage for the Lottery.

Editing or Deleting a Lottery

Modifying Existing Lotteries

Editing a Lottery

Each Lottery Card has its own Edit button. When this button is clicked, the selected lottery will be opened in a form similar to the one used when Creating a Lottery, with the existing data pre-populated. Only the Title, Visibility Date, and Visibility Time fields will be editable, as once a lottery has been created, the Draft Schedule may not be changed.

Note: While the Visibility Date and Visibility Time fields will be editable, modifying these dates is highly discouraged, as it can cause unexpected behaviour, especially for lotteries further along in the process of building and executing stages.

Deleting a Lottery

Each Lottery Card also has its own Delete button. When this button is clicked, a confirmation dialogue box will be shown, to verify that the lottery should indeed be deleted. A warning notice will be displayed above a minimalistic summary outlining all of the associated stages, that will be deleted along with the lottery if the Confirm button is selected.

Managing Stages

Stages Overview

The Stages Overview is reached by clicking the Manage Stages button in the footer of a Lottery Card. It is a focused view that displays a list of all existing stages (represented as separate Stage Cards), which are associated with the selected lottery.

A simplified version of the selected lottery card appears at the top of the page, and just above that is a Lotteries link with a backwards-facing chevron button, which when clicked will return the administrator back to the Lotteries Overview.

Stage Schedule

Each stage associated with the selected lottery will be represented in this list as an individual Stage Card. Just above this list of cards, there are controls for searching through and sorting the list of stages. To search for a specific stage by type, you may use the Search Stages input field, or adjust the Sort By selector to arrange the list in ascending or descending order, by either the title or date.

Stage Cards

Stage Card

Each stage that appears in the stacked Stages List is represented as a separate Stage Card, which provides administrators with useful controls, and information about the status and details of a stage.

Card Header

A stage card is divided into three parts - a header, a body, and a footer. The card header displays the type of stage (Sequential, Singular, or Site), and off to the right-hand side, a toggle that expands or collapses the stage card. An upward-pointing chevron icon means the stage has been expanded, while a downward-pointing chevron indicates the stage is in its collapsed, default state.

Card Body & Footer

The body of a stage card contains information pertaining to the timeframe and duration of the stage, as well as a Status Badge that indicates what state the stage is currently in. When the stage card is expanded, by clicking the downward-pointing chevron button at the right of the card header, a text input field becomes visible, where administrators may add any pertinent Notes.

The footer of a Stage Card contains several buttons and controls, most of them context-specific. Because these controls are context specific, and are determined by the stage status, a list of these possible statuses is provided below, along with screenshots of each card's appearance.

Stage Statuses

Options Required

The Stage is currently lacking any administrator-defined Options. You may Edit or Delete the Stage, or click Manage Options to begin creating Options for Learners to rank.

Ready

The Stage has one or more Options defined, and is awaiting its open date. You may add or modify existing Options before then by clicking the Manage Options button, or Edit/Delete the Stage if necessary.

Open

The Stage is open to learners so they can provide their Option rankings. Because Learners are actively ranking the Options, the button to navigate to the Options Overview is labelled as View Options, and will take you to the overview in a read-only, non-modifiable state.

Closed

The ranking process has ended, and drafting of Schedule Variations may be initiated. As Learners have already ranked their Options, you may only View Options, with the Options Overview presented in its read-only, non-modifiable state. Your next step is to specify the number of Schedule Variations to generate (1 - 5) based off of the Learner feedback, and click the Draft Schedule(s) button to initiate the drafting process.

Draft in Progress

Drafting has commenced and the algorithm is in the process of generating Schedule Variations. All controls will be locked down until the drafting process has completed.

Draft Succeeded

The drafting process has generated at least one viable Schedule Variation. You may still View Options (presented in their read-only state), or click Redraft Schedule(s) to generate a specified number of new Schedule Variations. If you do not need to perform a redraft, clicking Review Schedules will allow you to review the generated Schedule Variations.

Draft Failed

The drafting process did not generate any viable Schedule Variations. This means the specified number of Schedule Variations were generated, however none of the variations are viable (inviability is usually due to a variation having one or more Learners who could not successfully be scheduled any rotations). You may View Options to inspect them in a read-only state, Review Schedules to check the variations to see where they went awry, Delete the Stage, or Redraft Schedule(s) to try again.

Merged

A Schedule Variation from the drafting process has been merged into the Lottery's working schedule. You may View Options in their read-only state or Delete the Stage.