LMS 365 Learning Module Builder Add-in User Guide VERSION 1.5.0.X
CONTENTS LMS 365 Learning Module Builder Add-in User Guide Version 1.5.0.x... 1 Contents... 2 1. The LMS365 Learning Module Builder Add-in... 3 2. Permission Levels... 4 3. Adding My Learning Modules Add-in part... 5 4. Learning Module Builder Add-in Part Settings... 7 4.1 Additional Options for Add-in Part... 8 5. Create New Learning Module... 10 5.1 Managing Documents... 18 5.2 Managing SCORM Packages... 19 6. Editing a Learning Module... 21 7. Managing Learning Modules... 23 8. Passing a Learning Module... 26 9. Viewing Details of a Learning Module... 32 10. Reports... 34 10.1 Learner Reports... 35 10.2 Training Reports... 36 11. Language... 38 2
1. THE LMS365 LEARNING MODULE BUILDER ADD-IN The LMS365 Learning Module Builder Add-in is designed for organizing Documents, Videos, SCORM packages etc. into sequenced learning steps. Learners move to the next step only after they have completed previous one, ensuring progress and making it possible to see where they are in the learning process. There is no better way to expose learners to new concepts in the most efficient order and to ensure learners are not confused or lost along the way. 3
2. PERMISSION LEVELS The LMS365 Learning Module Builder Add-in uses the following minimum permission levels required to install and run the add-in: 1. Site Collection Administrator to install the add-in; 2. Manage for add-in permission request (indicates the activities that an add-in is permitted to do within the requested scope). This add-in permission level corresponds to Designer user permission level. If a user attempts to install an add-in that requests more permissions than the user has, an error message displays to the user informing him that he does not have sufficient permissions to grant the add-in its request; 3. Full Control for people who can administer the add-in (Team Site Owners Group by default); 4. Read for User to run the learning modules within the add-in. 4
3. ADDING MY LEARNING MODULES ADD-IN PART The LMS 365 Learning Module Builder Add-in comes with an Add-in Part. The Add-in Part will provide the UI for users to view and complete Learning Modules. To add the Add-in Part you must Edit the page: Once in Edit Mode click Insert Tab followed by App Part: Insert your Cursor in the location you wish to insert the Add-in Part, select My Learning Modules and click Add: The Add-in Part has now been inserted in the page. Click Save icon in the Menu to save the page: 5
The page will now be saved. To create a new Learning Module, click the Add / Edit / Manage link and select Learning Modules: Alternatively, you can click the add-in name under Site Contents. 6
4. LEARNING MODULE BUILDER ADD-IN PART SETTINGS To access the Learning Module Builder Add-in Part settings, click the Add-in Part Settings link on the Add-in Part: On the Add-in Part settings page you can configure which Add-ins and in what order will be displayed in the LMS365 Learning Module Builder Add-in (by default all are enabled). If you only have the LMS365 Learning Module Builder Add-in installed you will only see on Add-in. If you have other add-ins installed such as the LMS365 SCORM Player you will see both. Select Add-ins to be displayed on the Add-in Part and use drag-anddrop to change their order: Learning Module Builder Add-in without Other Add-ins Learning Module Builder Add-in with SCORM Player Add-in Items from the enabled add-ins (SCORM packages and Learning Modules) will be displayed in the Add-in Part: 7
4.1 Additional Options for Add-in Part To filter items shown in the Add-in Part, do the following: 1. Enter page Edit mode (click the Edit button in the ribbon); 2. Click My Learning Modules Web Part Menu icon ; 3. Choose Edit Web Part: 4. Expand category Miscellaneous: 5. Enter learning modules titles separated by semicolon for modules you want to be shown in the Add-in Part: 6. Save the changes. They will be displayed on the page with My Learning Modules add-in part. To direct users to a custom page after they have finished the attempt, do the following: 1. Enter the Edit mode (click the Edit button in the ribbon); 2. Click My Learning Modules Web Part Menu icon ; 3. Choose Edit Web Part: 4. Expand category Miscellaneous: 5. Enter Redirect URL: 8
6. Save the changes. Redirect works for Exit and Pause buttons in Learning Modules. NOTE: In order to see these options in add-in parts you need to have Custom Script options enabled in the tenant settings. Read more about it at https://community.office365.com/en-us/f/154/t/353558 9
5. CREATE NEW LEARNING MODULE To create a new Learning Module: 1. Click the My Learning Modules link or Add/Edit/Manage > Learning Modules to go to the Add-in Administration Back-end: 2. Click icon on the Add-in Part back-end: 3. Fill in the opened form: 10
Title specify name of the Learning Module; Description specify description of the Learning Module. It will be displayed on the Start Page; Select files to be added to the Learning Module and drag them to the Learning Module editor on the right: Embed select type of embedded item to be included in the Learning Module. Drag the type of item you want to add to the Learning Module to the Learning Module Editor box on the right side of the page. o Video items can be added from sources like Office Video, Office Mix, YouTube, Vimeo etc. To add video item drag it to the Learning Module Editor box and fill in the opened form: 11
Title specify title for the video; Embed code field paste embed code of the video. A preview will be displayed below. Click Insert to add video to the Learning Module. NOTE: For correct display of Office Video and other documents in the Learning Module in IE 11 user should add learningpath.365.systems to the list of trusted sites on his/her browser. To add it, do the following actions: 1. Open IE settings > Internet options; 2. Go to Security tab, select Trusted sites and click Sites; 3. Type https://learningpath.365.systems in the Add this website to the zone field and click Add. o Read and Understand Confirmation ensures that Learner has read and understood all the information presented in the Learning Module. It can be added after all items at the end of the list or after particular item (e.g. you put this option after the third item > Learner confirms that he has read and understood these three items). 12
o Link to documents and files item provides internal documents from SharePointOnline. To add internal documents drag this item to the Learning Module Editor box and fill in the opened form: Title specify title for the document / file; Enter Link paste link of the document / file. Click Insert to add document / file to the Learning Module. System auto detects document type (.doc,.docx,.ppt,.jpg,.jpeg, etc.) and shows icon for it. While passing the Learning Module a link to document / file will open in a new tab. In the current step of the Learning Module the following form will appear: 13
o External Website Link / URL item allows adding external website links / URL. To add necessary link drag this item to the Learning Module Editor box and fill in the opened form: Title specify title for the website link; Enter Link paste link of the website link. Click Insert to add website link to the Learning Module. While passing the Learning Module an external website link will open in a new tab. In the current step of the Learning Module the following form will appear: To edit an embedded item: 1. Press Edit button on the right of the item: 14
2. Make the necessary changes to the item: 3. Press Insert button to save the changes. Documents select documents to be included in the Learning Module. You can create new documents, upload new documents or select already uploaded files by clicking on the file name and dragging it to the Learning Module editor: 15
The system supports the following file types (depending on codes and browsers, there will be some differences):.doc.docx.xls automatically downloaded due to limitations of Excel Viewer;.xlsx.ppt.pptx.pdf.png.jpg.jpeg.bmp.tiff automatically downloaded as default file;.svg.gif.mp4.avi,.mpg (mpeg-1 and mpeg-2) - can be downloaded by clicking on appropriate link;.flv played with a help of mediaelement.js using flash;.wmv is not played in IE9 and Chrome, silverlight activation is required for playing in Firefox;.mp3.wav played in Chrome, Firefox (if it is a PCM file https://en.wikipedia.org/wiki/wav), but is not played in IE; A link to the original file is provided for all media files available to end user. SCORM packages (if the LMS365 SCORM Player Add-in is installed) select SCORM packages uploaded to the LMS365 SCORM Player Add-in on this web by clicking on the package name and dragging it to the Learning Module editor: NOTE: For correct display of SCORM packages in the Learning Module in IE user should add two domains learningpath.365.systems and scorm.365.systems and SharePoint site on which the add-in is installed to the list of trusted sites on his/her browser. To add it, do the following actions: 1. Open IE settings > Internet options; 2. Go to Security tab, select Trusted sites and click Sites; 3. Type https://learningpath.365.systems in the Add this website to the zone field and 16
click Add. 4. Type https://scorm.365.systems in the Add this website to the zone field and click Add. 5. Type address of the SharePoint site on which the add-in is installed in the Add this website to the zone field and click Add. When you drag an item to the Learning Module Editor it is removed from the list of documents. You can drag it back or click Delete button to return it. This will not delete the document from the library, but only remove it from the editor field. If you delete embed video from the Learning Module editor, it is removed and is not stored. You can reorder the list of added items by clicking on the dots symbol ( ) and dragging files to the right position: 17
4. Click Save to save the Learning Module. 5.1 Managing Documents Documents used for Learning Module creation are stored in a separate Document Library on the web that can be accessed from the Learning Module creation form or using a direct link. Click Go to the Document Library button on the Documents field: There you can create new documents using Office Online, upload existing files, edit and manage uploaded files: 18
5.2 Managing SCORM Packages NOTE: SCORM packages can be used in Learning Modules only when the LMS365 SCORM Player Add-in is installed on your site. SCORM packages used for Learning Module creation are uploaded and managed via the LMS365 SCORM Player Add-in. For more information see The LMS365 SCORM Player Add-in User Guide. You can also get access to it by clicking Add/Edit/Manage > SCORM packages: 19
20
6. EDITING A LEARNING MODULE To edit a Learning Module: 1. Click the My Learning Modules link or Add/Edit/Manage > Learning Modules to go to the Add-in Administration Back-end: 2. Select the needed Learning Module from the list and click Edit button : 3. Change settings of the Learning Module: 21
4. Click Save to save the changes or Cancel to discard them. 22
7. MANAGING LEARNING MODULES It is possible to set fixed order of passing Learning Modules for Learners. To do this, user should manage Learning Modules. To edit a Learning Module: 1. Click the My Learning Modules link or Add/Edit/Manage > Learning Modules to go to the Add-in Administration Back-end: 2. In the list of Learning Modules reorder the list by clicking on the dots symbol ( ) and dragging items to the right position: 3. Enable Course Completion option to make one or several Learning Modules obligatory for course completion: 23
4. Click on the Lock column next to the Learning Modules to set prerequisites: 5. A lock icon will appear next to the Learning Module. It means that the Learning Module cannot be started until all previous Learning Modules have been passed. 6. To set prerequisites for all list use Lock icon on top of the column: 24
7. Click Save Changes above the list of Learning Modules: 25
8. PASSING A LEARNING MODULE A list of all Learning Modules of the site is displayed on My Learning Module Builder Add-in Part: Items in the list have different icons depending on their status: Icon Action Description New Attempt Learning Module has not been started yet, user can start a new attempt. Continue Attempt New Attempt Successfully Completed Locked Learning Module has been paused, user can continue attempt. Learner has failed an item in the Learning Module, he can view his attempt. Learner has successfully completed the Learning Module, he can open it for review. The Learning Module has prerequisites and cannot be started until all previous Learning Modules have been passed. NOTE: An attempt can be failed only if a SCORM package included in Learning Module has Out of attempt status. To start a new Learning Module attempt, click New Attempt Module will open: icon. The first document of the Learning 26
SCORM packages are opened using the LMS365 SCORM Player Add-in according to package settings. Documents are opened (depending on the file type) using OWA (if configured on the server), MediaElement.js or can be downloaded to user s computer. To view the list of all documents and SCORMs added to the Learning Module click the Table of Content dropdown: To navigate to the next item in the Learning Module click Next icon in the upper right corner of the page. The next Learning Module item will open: 27
User can navigate to any item in the Learning Module using Table of Content: After Learner clicks Next, the status of current item is changed to Passed. To leave the page saving current progress, click on Exit/Pause icon in the upper right corner of the page: Confirmation Option in the Learning Module requires confirmation of reading and understanding of material presented in all items before it: 28
Without above-mentioned confirmation Learner would not be able to proceed to the Learning Module ( Next button will be disabled), if a Confirmation is in the middle of the Learning Module. However, it would be possible to return to the previous item: Confirmation at the end of the Learning Module would not allow Learner finish the Learning Module without assurance that he has read and understood every item of the Learning Module: 29
If Learner fails a SCORM attempt, failed status is displayed: After all items have been passed, the attempt is completed and you can click Exit button to leave the page: 30
Successfully completed Learning Modules are marked with a green progress line in My Learning Modules Addin Part: 31
9. VIEWING DETAILS OF A LEARNING MODULE To view details of all Learner s attempts of the Learning Module, do the following actions: 1. Click the My Learning Modules link or Add/Edit/Manage > Learning Modules to go to the Add-in Administration Back-end: 2. Select the needed Learning Module from the list and click Details button : 3. Information about the selected Learning Module will be displayed: 32
- Name shows name of Learner; - Status shows Learner s attempt status; - Percentage Completed shows Learner s attempt completion percent; - Date & Time Completed shows date and time of attempt completion; - Actions allows to open Learning Module attempt in preview mode and delete attempts: To export details of the Learning Module, click Export to Excel link: The information will be saved in the.xlsx format on your local computer. 33
10. REPORTS Reporting functionality is available in the LMS365 Learning Module Builder Add-in for owners and contains information related to Learning Modules. The system allows creating two types of reports: by Learner and by Training. Reports are scoped to site level. To view Reports, do the following actions: 1. Click the My Learning Modules link or Add/Edit/Manage > Learning Modules to go to the Add-in Administration Back-end: 2. Select Reports tile in the Administration back-end: 34
There you can select from two types of reports: - Learner Reports show information about Learners training; - Training Reports show information about Learning Module. 10.1 Learner Reports To create a Learner Report, do the following actions: 1. On the opened Reports page select group by Learner from the drop-down list: 2. Use filters to customize information that will be included in your Report: Select select a learner from the dropdown list to include information only about this learner; Include select type of learners to include in the report: Active, Deleted or All; Start Date set start date for the Report; End Date set end date for the Report; 35
3. Click Create Report. An.xlsx report will be created and downloaded to your computer. It contains the following information: Information about all learner s attempts: Learner s name shows name of Learner; Email shows Learner s email address; Account shows user s account; Department shows user s department (information is taken from User List); Number of Learning Modules shows number of Learner s Learning Modules; Completion status shows percent of completed Learning Modules; Date Completed shows date of Learning Module completion; Passed shows percent of passed Learner s Learning Modules; Score shows Learner s average score for Learning Modules; Average time shows average time spent by Learner on the Learning Modules; Attempts shows number of attempts that Learner made to complete all his Learning Modules. Information about each Learning Module on which learner made attempts: Learning Module Title shows Learning Module s title; Status shows Learner s completion status; Passed shows passed status of Learner s Learning Module; Score shows Learner s score for Learning Module; Average time shows time spent by Learner on the Learning Module; Attempts shows number of attempts that Learner made to complete this Learning Module. 10.2 Training Reports To create a Training Report, do the following actions: 1. On the opened Reports page select group by Course from the drop-down list: 2. Use filters to customize information that will be included in your Report: 36
Select select a Learning Module from the dropdown list to include information only about this Learning Module; Include select type of learners to include in the report: Active, Deleted or All; Start Date set start date for the Report; End Date set end date for the Report; 3. Click Create Report. An.xlsx report will be created and downloaded to your computer. It contains the following information: Information about the Learning Module: Learning Module Title shows name of the Learning Module; Created Date shows date of Learning Module creation; Number of Learners shows number of learners for this Learning Module; Number of Attempts shows total number of attempts of this Learning Module by all learners; Average Time shows average time that all Learners spent on this Learning Module; Score shows average score on this Learning Module; Date Completed shows date of Learning Module completion; Information about attempts made: Learner s name shows name of Learner Email shows Learner s email address; Account shows user s account; Department shows user s department (information is taken from User List); Status shows Learner s completion status; Passed shows passed status of Learner s attempt; Number of Attempts shows number of Learner s attempts; Average Time shows average time that this Learner spent on this Learning Module; Score shows average score on this Learning Module and each Learner s score; Date Completed shows date of Learning Module completion. 37
11. LANGUAGE Out of the box LMS365 Learning Module Builder Add-in is translated to English language only. NOTE: NOTE: Out of the box LMS365 Learning Module Builder Add-in English translation can be modified the same way as it is translated to other languages. The LMS365 Learning Module Builder Add-in translation is applied for the whole tenant. To add translation to alternate language(s) for the LMS365 Learning Module Builder Add-in, use Language Files section in Add-in settings: 1. Open the Learning Module Builder Add-in Part settings by clicking on the Add-in Part Settings link on the Add-in Part: 2. On the opened Administration page click Language Files: 38
3. Language Settings page will open: 4. Select an alternative language in the Select Language drop-down (a list of all possible alternative languages is displayed): 5. On the opened Language Settings page type your translation for each phrase in Your choice column and click Save: 39
OR 1. Click Export to save the language file to your local computer; 2. Edit the downloaded.xlsx file locally filling in the Custom Values column: 3. Click Import and select the edited language file from your local computer. 4. Translation from Custom Values column will be displayed in Your choice. Click Save to save the translation. NOTE: NOTE: NOTE: The new translation is applied after page reload. Prerequisite for presenting LMS 365 sites (and also the LMS365 Learning Module Builder Add-in) in more than one language: alternate language(s) should be chosen in site collection s Site Settings -> Language settings. Rules of presenting LMS 365 sites (and also the LMS365 Learning Module Builder Add-in) in different languages (specified by priority from high to lower): 1. The language preferences stored in the user profile. (It takes some time before user language preferences are applied after you change them). See link where to find these preferences. 2. If no language preference is defined in the user profile, the language preferences stored in the user's web browser are used. (You should reopen browser session if you change browser language preference). See link where to find these preferences. 3. If no language preferences are defined in the user's profile and web browser, the default site language is used. If you need the LMS365 Learning Module Builder Add-in be presented only in one specific language, you have to create Site collection (where the LMS365 Learning Module Builder Add-in will be added) in that language and not choose any alternative languages. 40