Elentra Settings
Elentra ME settings, are application settings stored in the elentra_me.settings
table. These settings can be used enable/disable modules and features, as well as customize the Elentra experience. There are many settings that have been created over the years, while new ones get added with every release.
Creating New Settings
To create a new setting, you must create a migration that will run the query to insert your new settings. Click here to learn more about creating migrations for a new Elentra setting.
Naming Convention
Please follow these rules when creating new settings. Additionally, settings should always reflect the positive state of an action. Use "enabled" not "disabled", "show" not "hide" and so on, and set the default values accordingly.
When you need a setting to enable/disable a module/feature Format:
[module/feature]_enabled
Examples:
absence_enabled
calendar_assignments_enabled
When you need a setting to customize a feature Format:
[module/feature]_[action]_[detail]
Examples:calendar_display_hour_date
calendar_display_weekend
cbme_enable_tree_aggregate_build
When you need to store information Format:
[module/feature]_[detail]
Examples:api_reservation_class
cbme_ondemand_expiry_offset
List of Available Settings
Last updated: Elentra ME 1.23.0 release
|
|
| 1.18 | Enable to use the Absence Management Module |
|
| |||
|
|
| 1.15 | When the setting allow_program_coordinator_manage_booked_slots is set to 0 in the settings table (by default it’s 1), the pcoordinators won’t be able to (1) delete slots that have off-service learners booked in them, (2) make any changes to the slot spaces |
|
| |||
|
| 1.19 | settings for use with external room reservation tool | |
|
|
| ||
|
|
| ||
|
| 1.13/1.14? | These settings are about adhoc distributions and which form completion methods are allowed. | |
|
| 1.13/1.14? | These settings are about adhoc distributions and which form completion methods are allowed. | |
|
|
| 1.23 | Allow the target of an assessment task to send a reminder to the assessor |
|
| 1.26 | Sort the Assessments page in the specified order | |
|
| 1.26 | Sort the Assessments page in the specified order | |
|
| 1.26 | Sort the Assessments page in the specified order | |
|
| 1.26 | Sort the Assessments page in the specified order | |
|
|
| 1.23 | |
|
|
| 1.23 | Specify which distribution methods should expire at the end of the expiry_date set in the distribution |
|
| On A&E dashboard for admin? For all users? | ||
|
| 1.13/1.14? | These settings are about adhoc distributions and who can trigger a task once the distribution has been created. | |
|
| 1.13/1.14? | These settings are about adhoc distributions and who can trigger a task once the distribution has been created. | |
|
| |||
|
|
| An API token from Box.com (for integrating folders and files within a Box.com account as Event Resources) | |
|
|
| The expiration value for an API token from Box.com (for integrating folders and files within a Box.com account as Event Resources) | |
|
| 1.17 | Defines whether or not assessments from a course gradebook are displayed on a learner's dashboard calendar | |
|
| 1.27 | Allow staff and faculty to select a curriculum period to change the dashboard calendar date to the start of that curriculum period. | |
|
| |||
|
| |||
|
| Defines display on learner dashboard calendar | ||
|
| |||
|
|
| used to control whether or not to show learners their rotation schedule in the event calendar view on the dashboard | |
| ||||
| ||||
|
| Learner dashboard calendar? | ||
|
| Defines display on learner dashboard calendar | ||
|
| Deleted in 1.18 | ||
|
| 1.18 | Set which days to exclude from dashboard calendar ( 0 is sunday, 1 is monday etc..) | |
|
| 1.18 | Set which days to exclude from events calendar ( 0 is sunday, 1 is monday etc..) | |
|
| 1.27 | Stores and loads the date last used, so a user can leave the dashboard and the calendar will be where they left it. | |
|
|
| ||
|
|
| Start calendar from Monday on dashboard. Overridden by default by calendar_excluded_days_dashboard | |
|
| Start calendar from Monday on events page. Overridden by default by calendar_excluded_days_events | ||
| ||||
| ||||
| ||||
| ||||
| ||||
|
|
|
| used to allow org. to not require faculty to consent to lecture capture in personal profile |
| Defines whether you use automated lecture capture feature for learning events. | |||
| ||||
| ||||
| ||||
| If using lecture capture, defines when videos will be available after a recorded learning event. | |||
| This is a recording of the event. | |||
| ||||
| Lecture Recording | |||
|
| |||
|
| |||
|
|
|
| |
|
|
|
| Hide future Cases from learners |
|
|
|
| allows CBME org. to apply embargo conditions to Rubric forms so they are hidden from targets until specific conditions met |
|
|
|
| Defines whether more than one Contextual Variable combination per assessment tool is permitted. |
|
|
|
| Defines whether an organisation is using the CBME module (will change learner view of dashboard) |
|
|
| This defines whether the CBME Objective Tree abstraction layer will attempt to read from an aggregated version of the CBME objective tree table instead of the main CBME Objective Tree table. The aggregates are scoped to tree ID, user and/or course. | |
|
|
| This defines whether or not the CBME Objective Tree abstraction layer will attempt to build aggregate trees when needed. | |
| This defines whether or not the CBME Objective Tree abstraction layer will read/write CBME Objective tree datasets to cache. | |||
|
|
|
| Enables CBME Visual Summary Dashboard added in https://elentra.atlassian.net/browse/ME-4557 |
| When creating a new CBME Objective Tree Version, the CBME Abstraction Layer will attempt to utilize a memory table when building a new version, instead of using the CBME objective tree table directly. Enabling this feature greatly improves version creation performance. It should only be enabled when the database user has access to create memory tables. | |||
|
| 1.19 | allows on-demand tasks to have an expiry date added | |
|
| 1.19 | if using automatic expiry for on-demand tasks, set duration of time after which they should expire | |
|
| 1.19 | if using automatic expiry for on-demand tasks, use to control which workflows have the automatic expiry applied | |
|
|
|
| |
|
| optional, if selected you will have the ability to add new assessors. By default these added assessor will be stored in the cbl_external_assessors table. If you want the added assessor to be an internal user you must also merge ME-1434 to get this complete feature | ||
|
| toggle whether faculty directors get the staff workflow view. Default is off (0) - all faculty get the faculty workflow view | ||
|
| to toggle whether the “Trigger Assessment” button on /admin/assessments gets switched over to use the workflow view. Default is off (0). | ||
|
| optional, if selected a short cut icon will be displayed to learner in their cbme dashboard beside corresponding EPAs | ||
|
| CBME specific. Defines whether or not you allow programs uploading CBME data to select between using standard key and enabling competencies or program-specific key and enabling competencies (Step 3 of data import?) | ||
|
|
| Enable/Disable new lottery module | |
|
|
| Enable/Disable Manage Instructors | |
|
|
| Enable/Disable Manage Locatons | |
|
| Stores a Housing Department ID for an organization | ||
|
| Granular clinical events - allows learner to accept, reject or modify a scheduled granular clinical event | ||
|
| dictates which filter is the default when land on Admin > Clinical Experience | ||
|
| used to control whether users can leave communities they were added to by an admin | ||
| Hides the user view of pcoordinators on a course page | |||
|
|
| ||
|
|
| Send request membership emails to all admins of a community | |
|
| Defines whether or not you allow members of a community to view file versions (on Document pages only?) | ||
|
| Enables the category select (primary, secondary, tertiary) in the new Curriculum Tag Selector | ||
|
|
| Determines whether course re-ordering in Manage Courses is enabled | |
|
| |||
| example: | Enables automatic course website access to any specified group/role combination. Value must be a JSON object | ||
|
| Enable/disable auto-enrolling course audience into a course website. You can still override this on a per-course basis, by adding a record in the course_settings table, using the course ID and the same shortname course_website_autoenroll_audience | ||
|
| 1.19 | option to have Associated Faculty on course setup tabs automatically made Administrators of the related course websites | |
|
| Defines whether you let users create hierarchical tag sets in Manage Curriculum | ||
|
| Sets the maximum number of hierarchical levels in a tag set in Manage Curriculum | ||
|
| |||
|
| 1.19 | allows org. to disable Curriculum Tracks feature so it won't display in System Settings) | |
|
| Enables curriculum weeks which is required if you want to use Units or Cases | ||
| 1 |
| ||
| ||||
|
| This goes hand in hand with unauthenticated_internal_assessments and enable_distribution_assessor_summary_notifications. When using unauthenticated distribution assessments, you probably want an single summary email with a link to each task rather than an email for each new task. This disables the per-task reminders. | ||
|
|
|
| |
|
|
|
| |
|
|
| allows you to configure which duty hour options display to learners | |
|
|
|
| Allows faculty to update their email address if SSO is enabled. |
| This adjusts the emails for distribution assessments to have a nightly summary of all new tasks, and then a weekly summary of tasks that are still incomplete. | |||
|
|
|
| Allows staff and faculty users to have a personalized A&E prompted responses tab where they can take action on prompted responses |
|
| |||
|
| These settings define who can specify if an eportfolio is assessalbe (in the case that the eportfolio is attached to a gradebook). | ||
|
| |||
|
| |||
|
| |||
|
|
|
| |
|
|
| allows you to set a default color for events added to the calendar, can help with school branding | |
|
|
| allows org. to hide discussion and comments section of learning event page | |
|
|
| Defines whether you allow learners to bulk download events from their Events tab | |
|
| Defines whether free text objectives can be entered on a learning event page | ||
|
|
| used to control whether events with recently added or updated links change color | |
|
|
| ||
|
|
| ||
|
| |||
|
| |||
| 1 | 1.19 | Show learners the time estimates for event resources | |
|
| 1.19 | allows for admin/teaching faculty to enter estimated times to complete resource attached to events | |
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| allows you to configure whether or not to automatically apply a course filter on the curriculum tag selector used on a learning event page | |
|
|
| ||
|
|
| ||
|
|
| ||
|
| 1.19 | allows for easy renaming of learning event resource category | |
| Defines whether to run html_encode when importing questions. Use when the questions you are importing contain HTML markup. | |||
|
|
| ||
|
| |||
|
|
| ||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
|
| Add ability to enter an Adjusted Total to the Grading Spreadsheet for a Course Gradebook https://elentra.atlassian.net/browse/ME-4194 | |
|
|
| used to control whether to allow a course gradebook to accept values over 100% | |
|
| 1.26 | Include email in gradebook assessment CSV | |
|
| 1.26 | Include username in gradebook assessment CSV | |
|
| Allows you to provide documents to learners via a course gradebook | ||
|
|
| ||
|
|
| define whether an unentered grade in a Course Gradebook assessment is ignored or counts as 0 https://elentra.atlassian.net/browse/ME-4821 | |
|
| define a passing grade as used in System Report > Learner Report > Student Report Card | ||
|
|
| Sets the maximum value for the GPA, used in grading scales under admin - system settings - grading scales | |
| 0 |
| Enables Housing based distributions https://elentra.atlassian.net/browse/ME-2170 | |
|
| defines whether or not to include names of users in prompted response notifications in Assessment and Evaluation items | ||
|
| |||
|
|
|
| Determines whether learners can see their status history; i.e the "epastatushistory page" where rating scale updates and advisor comments/files are displayed |
|
|
|
| Enable to turn on the Learner Explorer and allow faculty and admin staff to see an overview of a learner's performance across courses on gradebook assessments |
|
|
|
| sets whether or not users can see UI to manage learner levels on course enrolment tab *previously this was not currently added to Elentra by default, developers may need to manually add this setting |
|
| (Only applicable to Queen's?) | ||
|
|
|
| Allows learners to mark their own attendance at events based on their physical location |
| Defines whether you are using the Logbook feature (i.e., getting students to log encounters). | |||
|
| used to control whether or not to allow learners to create logbook entries for courses where their enrolement in the curriculum period has passed | ||
|
| Define the threshold for level of completion to trigger 'complete' status in Clinical Experience > Logbook | ||
|
| This defines whether or not you allow admin users to assign curriculum objectives to objects in the Learning Object Repository. | ||
|
| Defines whether you are using the Lottery module. | ||
| Stores information if you're using a learner record service? | |||
| Stores information if you're using a learner record service? | |||
| Stores information if you're using a learner record service? | |||
| Stores information if you're using a learner record service? | |||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
|
| Enables the Microsoft Teams integration feature |
|
|
| ||
|
| Defines whether or not logbook is active in mobile | ||
|
|
|
| Enable to allow users to optionally send an email when they send a notice via Admin > Manage Notices |
|
|
| Overrides default assessment behavior for peer assessments. Sets default release options(checkbox) for peer assessments (never release, immediately report) | |
| used to control is users’ group and role are displayed in People Search results | |||
|
| Specify the Courses to include the web conference url | ||
|
| Specify the Learning Event Types to include the web conference url | ||
|
| Exclude any Learning Event Types that should never has web conferencing url provided | ||
|
| Provide any intro. text to appear before the url | ||
|
| Provide the name of the web conference platform provider | ||
|
| Define the web conference tool meeting id prefix | ||
|
| Define how long before an event starts users can access the meeting url | ||
|
| Whether or not all faculty will show up when adding curriculum coordinators as course contacts? (Presumably anyone added gets full course and event access) | ||
|
| Whether or not all staff will show up when adding curriculum coordinators as course contacts? (Presumably anyone added gets full course and event access) | ||
|
| Whether or not all faculty members will show up when adding Course Directors to Courses. Also note that non-faculty:directors will not be able to access the CBME Program Dashboard for learners. | ||
|
|
|
| |
|
| Whether or not all faculty members will show up when adding Course Directors to Courses. Also note that non-faculty:directors will not be able to access the CBME Program Dashboard for learners. | ||
|
| Controls whether the podcast link displays | ||
| ||||
|
| Allows for Post Nominal letters IE: Ph.D , MD | ||
|
| 1.27 | Replaces firstname with preferred name through public pages, and displays both on admin pages | |
|
|
| 1.22 | Enables the ability to select and change the preferred pronoun using the field on the user profile |
|
|
| 1.22 | Enables the inclusion of a pronoun field in the user profile |
|
| settings for use with external room reservation tool | ||
|
| settings for use with external room reservation tool | ||
|
|
| settings for use with external room reservation tool | |
|
| settings for use with external room reservation tool | ||
| ||||
|
| settings for use with external room reservation tool | ||
|
|
| A download URL for a specific version of Respondus | |
|
|
| A download URL for a specific version of Respondus | |
|
|
| A download URL for a specific version of Respondus | |
|
|
| A download URL for a specific version of Respondus | |
|
|
| ||
|
| |||
|
| |||
|
|
|
| Enables the option for self attendance in the events setup |
|
|
|
| Enables the |
|
|
| Learners cannot mark their attendance past this number of days. | |
|
|
|
| Automatically approve self-recorded absences. |
|
|
|
| |
| Learning Events (link to web conference tool) | |||
| Defines whether you use sites (aka Manage Locations)? | |||
|
|
|
| Defines whether the Number field of each user will be shown in the Assessment Targets page. |
|
| whether or not the TBL tools in Elentra are available | ||
|
| 1.17 | ||
| ||||
| ||||
| ||||
| ||||
| ||||
| Enables the ability to complete distribution assessments as an internal account user without logging in via a unique hash provided via email | |||
| 1.18 | |||
| ||||
| ||||
|
Last updated