LMS 365 Learning Module Builder Add-in User Guide VERSION X

(1)

LMS 365 | Learning Module Builder

Add-in User Guide

VERSION 1.5.0.X

(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.

(4)

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.

(5)

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:

(6)

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.

(7)

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-and- drop 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:

(8)

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:

(9)

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

(10)

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:

(11)

 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:

(12)

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).

(13)

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:

(14)

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:

(15)

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:

(16)

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;

(17)

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:

(18)

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:

(19)

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:

(20)

(21)

6. EDITING A LEARNING MODULE

To edit a Learning Module:

2. Select the needed Learning Module from the list and click Edit button :

3. Change settings of the Learning Module:

(22)

4. Click Save to save the changes or Cancel to discard them.

(23)

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:

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:

(24)

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:

(25)

7. Click Save Changes above the list of Learning Modules:

(26)

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

Learning Module has been paused, user can continue attempt.

New Attempt Learner has failed an item in the Learning Module, he can view his attempt.

Successfully Completed

Learner has successfully completed the Learning Module, he can open it for review.

Locked 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 icon. The first document of the Learning Module will open:

(27)

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:

(28)

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:

(29)

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:

(30)

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:

(31)

Successfully completed Learning Modules are marked with a green progress line in My Learning Modules Add- in Part:

(32)

9. VIEWING DETAILS OF A LEARNING MODULE

To view details of all Learner’s attempts of the Learning Module, do the following actions:

2. Select the needed Learning Module from the list and click Details button :

3. Information about the selected Learning Module will be displayed:

(33)

- 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:

(34)

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:

2. Select Reports tile in the Administration back-end:

(35)

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;

(36)

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:

(37)

 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.

(38)

11. LANGUAGE

Out of the box LMS365 | Learning Module Builder Add-in is translated to English language only.

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.

NOTE: 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:

(39)

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:

(40)

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: The new translation is applied after page reload.

NOTE: 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.

NOTE: 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.

LMS 365 Learning Module Builder Add-in User Guide VERSION X