LMS 365 | Course Creator & Catalog Add-in Installation Guide

Picture 7LMS 365 | Course Creator & Catalog Add-in Installation Guide

Version 1.5.14.X

 

 

 

CONTENTS

OVERVIEW AND SOFTWARE REQUIREMENTS3

Audience3

About LMS3653

Subscribe to Alerts4

Server software requirements4

Best performance practices4

Client requirements5

INSTALLING THE ADD-IN5

DEPLOYING THE ADD-IN IN YOUR TEAM SITE8

Preparing the Team Site to run the Add-in for the very first time9

Activating SideLoading Feature9

Enabling Custom Scripting Option10

Setting the Administrator permissions11

Required Add-ins Installation13

Running the Add-in15

ADDING COURSE CATALOG WEB PART18

SETTING UP PERMISSIONS FOR AZURE AD20

LICENSE INFORMATION20

Trial License21

Activate a License21

UPDATE24

UNINSTALL26

OVERVIEW AND SOFTWARE REQUIREMENTS

Audience

This guide has been written for the Tenant Administrator to install the LMS365 | Course Creator & Catalog Add-in and associated Add-ins and Web Parts and create a fully working solution.

For detailed information about configuring the LMS365 | Course Creator & Catalog Settings please consult the User Guide.

About LMS365

LMS365 is a collection of add-ins which will enable you to create new course sites, including selected add-ins, in SharePoint Online. A short description of each add-in is listed below.

LMS365 | Course Creator & Catalog Add-in is the main add-in that brings all add-ins together, it allows you to create new course sites and provides a course catalog, for this to happen it requires Full Control permissions on your tenant. It also utilises other add-ins such as the SCORM & AICC Player, Learning Module Builder, Quiz Builder and Assignments & Grade Book Add-in. To be able to automatically add add-ins to new course sites it requires the SideLoading feature to be activated on the same site where the LMS365 add-in is installed. For more information see the description below on how to activate the SideLoading.

LMS365 | SCORM & AICC Player Add-in – is the SCORM & AICC player for LMS365 and can be automatically included to the new course sites created by the LMS365 | Course Creator & Catalog Add-in. To do this, the SCORM & AICC add-in must be installed on the same site as the LMS365 | Course Creator & Catalog add-in before any new course sites can be created.

For more information on the SCORM & AICC Player add-in installation see the “LMS365 | SCORM & AICC Player Add-in Installation Guide” available on http://help.lms365.com/

LMS365 | Learning Module Builder Add-in - is designed for organizing Documents, Videos, SCORM/AICC 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.

LMS365 | Quiz Builder Add-in - is designed for creating quizzes that can be used as intermediate or final tests in the learning process. A Quiz is a type of examination consisting of several question types such as Multiple Choice, Multiple Answer, True or False. The interactivity and complexity that quizzes provide get Learners more interested and involved in the learning process.

LMS365 | Assignments & Grade Book Add-in is designed for creating, managing, tracking and grading Assignment tasks on course sites created by the LMS365 | Course Creator & Catalog Add-in. To do this, the Assignments & Grade Book Add-in must be installed on the same site as the LMS365 | Course Creator & Catalog Add-in before any new course sites can be created.

Subscribe to Alerts

You can subscribe to alerts by visiting the download area or by using the QR code showing on the left.

http://eepurl.com/5Bk79.qr.5Server software requirements

The Add-in has been developed to run within the Microsoft Office 365 SharePoint Online environment.


Best performance practices

Our add-ins associate Learner role users with members of a SharePoint group (by default SharePoint Members Group). Due to SharePoint limitations the maximum number of enrolments per course is 5000 users.

Our LMS365 | SCORM & AICC Player Add-in was tested with 3000 concurrent learners.

Client requirements

Brower Type

Supported

Designed to work with Internet Explorer 11

Yes

Designed to work with Internet Explorer 10

Yes

Designed to work with Internet Explorer 9

No

Designed to work with Internet Explorer 8 or earlier versions

No

Designed to work with the latest version of Firefox

Yes

Designed to work with the latest version of Google Chrome

Yes

Designed to work with the latest version of Safari

Yes

INSTALLING THE ADD-IN

To install the LMS365 | Course Creator & Catalog Add-in to your local Add-in Catalog you must follow the steps listed below:

  1. 1. Login to the Office 365 Admin Center http://login.microsoftonline.com/ with your Administrator Account;

  2. 2. On the left-side menu you will see Admin tab, click it and then SharePoint”:

Picture 4

  1. 3. On the left side you will see apps, click it followed by App Catalog shown on the top of the page. In some cases you might have to create the Add-in Catalog before you are able to move on to the next step. For assistance creating the Add-in Catalog go here.

  2. 4. In preparation to the installation of the LMS365.add-in file to the App Catalog you will need to upload the LMS365 add-in images also provided in the zip file “Course Creation and Catalog Add-in” (download it from our download area). They must be uploaded to the assets library of the App Catalog. To do this click Site Settings followed by Site Contents. Click the Site Assets library and upload the LMS365 Images and Icon, not the LMS365.add-in file.

  3. 5. To upload the LMS365 | Course Creator & Catalog add-in to the App Catalog click Apps for SharePoint link in the left navigation bar. Click upload icon Picture 16 and browse the LMS365.add-in” file, which can be found in the zip file (download it from our download area). Once the add-in is uploaded click edit icon Picture 17 and enter the details as shown in the table below and then click Save.

Field

Value

Name

LMS365

MetaData Language

English

Default MetaData Language

Short Description

Learning Management System for Office 365

Description

LMS365 unites advanced learning technology with the authoring, collaboration, and social features of Office 365® to create a powerful learning management system learners already know how to use.

 

LMS 365’s unique approach makes it easy to respond to any training need in the most efficient, effective way without programming, system integration, unwanted complexity, or technology overkill.

Icon URL

https://[TENANT].sharepoint.com/sites/apps/SiteAssets/LMS365_App_Logo.png

Icon Description

Learning Management System for Office 365

Category

Training

Publisher Name

ELEARNINGFORCE International

Support URL

http://www.lms365.com/support

Image 1 URL

https://[TENANT].sharepoint.com/sites/apps/SiteAssets/CC1.jpg

Image 1 Description

Course Catalog Administrator View

Image 2 URL

https://[TENANT].sharepoint.com/sites/apps/SiteAssets/CC2.jpg

Image 2 Description

Course Creation Page

Image 3 URL

https://[TENANT].sharepoint.com/sites/apps/SiteAssets/CC3.jpg

Image 3 Description

Course Site with My Learning Module App Part

Video URL

http://help.lms365.com/Pages/Videos.aspx

Enabled

Featured

Picture 19

For the installation of the Add-in the user must have Tenant Administrator rights and Site Collection Administrator rights. Please note that the Add-in can be installed on Team Sites only.

DEPLOYING THE ADD-IN IN YOUR TEAM SITE

Go to the Team Site you wish to install the LMS365 | Course Creator & Catalog Add-in and follow the steps below:

  1. 1. Click Settings and Add an App from the drop-down;

  2. 2. Locate the LMS365 | Course Creator & Catalog Add-in and click to install the add-in:

Picture 8

  1. 3. Click “Trust it” to enable the Add-in to function properly:

Picture 20

Preparing the Team Site to run the Add-in for the very first time

Before you can start using the Add-in, you must activate SideLoading feature on your Team Site as well as enable “Custom Scripting” on your tenant. Activating “SideLoading” feature is required to enable the LMS365 | Course Creator & Catalog Add-in to automatically insert the SCORM & AICC Player, Learning Module Builder, Quiz Builder, and Assignments & Grade Book Add-ins when new Course Sites are created. Enabling “Custom Scripting” option is required to successfully create courses and training plans.

Activating SideLoading Feature

You are able to activate the ‘SideLoading’ feature of your Team Site by downloading the LMS365_SLA.zip file from our download area. Extract the file to your computer and run the LMS365_SLA.exe and enter the requested information:

Picture 1345054439

Site URL:

Simply copy and paste the URL of your Team Site removing anything after the team site.

For example:

https://exampledomain.sharepoint.com/hr/lms/_layouts/15/start.aspx#/

becomes

https://exampledomain.sharepoint.com/hr/lms/

Login & Password:

These must be of a Global Administrator.

Picture 5

Only the Global Administrators which are simultaneously Site Collection Administrators can activate this feature.

Enabling Custom Scripting Option

To ensure courses and training plans are created successfully you need to have ‘Custom Script’ options enabled in the tenant settings.

To do this, follow the steps:

  1. 1. Go to the SharePoint Admin Center;

  2. 2. Select Settings;

  3. 3. Under Custom Script select ‘Allow users to run custom script on personal sites’ and ‘Allow users to run custom script on self-service created sites’:

Picture 2

  1. 4. Click OK button. It takes about 24 hours for the change to take effect.

For more information see the following link.

Setting the Administrator permissions

Picture 461

It is required to add LMS365 administrator to the site Owners group in order to administer the add-in.

 

 

To do this, follow the steps:

  1. 1. Go to Site Settings”:

Picture 473

  1. 2. Click People and groups” link:

Picture 22

  1. 3. Select the Site Owners Group from the left menu and click it followed by New and Add Users”:

C:\Users\AGEUCH~1\AppData\Local\Temp\SNAGHTMLbecbb745.PNG

  1. 4. Add the user(s) you want to be able to administer the LMS365.

Picture 460

There may be a delay between adding yourself to the Group and the add-in allowing access. This is normal SharePoint behaviour and outside of our control.

 

 

Required Add-ins Installation

During course creation, you can select add-ins to be added to the new course site:

Picture 18

NOTE:

It is possible to use this feature only after SideLoading feature activation.
The selected add-in should be installed on your tenant.
You’ve got to be a site collection administrator in order to create course sites with add-ins.

If LMS365 SCORM & AICC Player, Learning Module Builder, Quiz Builder, and Assignments & Grade Book Add-ins have not been installed to your site before, you should trust them manually to complete correct add-in installation:

  1. 1. Go to the course page after course creation and click Trust LMS365 | SCORM Player”, “Trust LMS365 | Learning Module Builder”, Trust LMS365 | Assignments & Gradebook or “Trust LMS365 | Quiz Builder links in the left menu:

Picture 1345054440

  1. 2. Confirm trust:

Picture 34

You will be redirected to the Add-in Administration Back-End. Now the Add-in Part is correctly added to your course site to make SCORM/AICC, Learning Module and Assignments content available for learners.

Running the Add-in

To start using the LMS365 | Course Creator & Catalog add-in, click the link that is showing in the Recent items in the left navigation menu. Alternatively you can go to the Settings > Site Content and click the LMS365 | Course Creator & Catalog Add-in.

When you run the add-in for the very first time, you will be required to select Tenant Region for LMS365 data storage.

NOTE:

If you have added the Course Catalog Web Part to your site, you will see the following message:

 

Picture 449

 

Go to the Administration Back-end and select necessary Region:

Picture 9

Then click Next button. You will presented with the following screen:

Picture 12

From this page you can confirm the Tenant Region or go back to select another one.

NOTE:

Remember that you can select Region once only (i.e. if you have previously selected the Region, there will be no such a step for other add-ins). After you have selected the Region, it will be applied for all add-ins of LMS365 suite and could not be changed on your own initiative (only by request).

After you have selected the Region and the tenant has been provisioned, you will be asked to accept the License Agreement. Check option “I accept terms in the license agreement” and click Continue to accept the license agreement and start using the Add-in. If you do not accept the license agreement you are unable to use the add-in and you must uninstall the add-in from your tenant.

After you accept the terms and conditions this page will not be shown again, even if you install the add-in to another site within your tenant:

Picture 23

Once you have accepted the License Agreement you will see the LMS365 | Course Creator & Catalog License Activation page:

Picture 451

You can activate license as described below.

You can run your Course Catalog from Course Catalog page:

C:\Users\AGEUCH~1\AppData\Local\Temp\SNAGHTMLc19c495.PNG

Or you can add the Course Catalog Web Part to your team site as described below.

ADDING COURSE CATALOG WEB PART

The LMS365 | Course Creator & Catalog Add-in comes with a Web Part named Courses Catalog. The Web Part will allow the users to see the Course Catalog from with their Team Site and enroll and visit courses from there.

To add the Web Part you must edit the page:

Picture 31

Once in Edit Mode you click the Insert Tab followed by Web Part, select Course Catalog in LMS365 category and click “Add”:

Рисунок 839122759

The Web Part has now been inserted in the page and will state that there are “No available courses in the catalog”:

C:\Users\AGEUCH~1\AppData\Local\Temp\SNAGHTML1865548.PNG

Click the Save icon in the Menu to save the page:

Picture 30

The page will now be saved.

SETTING UP PERMISSIONS FOR AZURE AD

Setting up permissions for Azure AD is a requirement for adding Azure AD Group principals as site members, and synchronizing user’s information, such as user’s manager and tracking whether user’s profile is active or disabled.

NOTE:

We support Dynamic Azure AD Groups as well. For more information visit https://azure.microsoft.com/en-us/updates/azure-active-directory-dynamic-membership-for-groups.


Azure AD must be configured to trust our add-ins to be able to read users’ data.

To give the application permissions to read users data you need to run a powershell script:

Connect-MsolService

$appPrincipal = Get-MsolServicePrincipal -AppPrincipalId 50823217-d01d-4bab-ad1d-fa9554467fa1

Add-MsolRoleMember -RoleMemberType ServicePrincipal -RoleName "Directory Readers" -RoleMemberObjectId $appPrincipal.ObjectId

The script adds LMS365 | Course Creator & Catalog add-in to the Directory Reader role. It means that the add-in can read users data.

The script requires Windows Azure Active Directory Modules for Windows PowerShell:

https://docs.microsoft.com/en-us/powershell/msonline/

NOTE:

The LMS365 | Course Creator & Catalog add-in should be installed prior to running the script.

NOTE:

Other ELEARNINGFORCE add-ins will also be able to read members of Azure AD groups after running this script.

Picture 25

Running the script requires Tenant Administrator rights.

 

LICENSE INFORMATION

Picture 27

User has to be added to Site Owners group as described in section Setting the Administrator permissions to be able open LMS365 | Course Creator & Catalog add-in Administration Back-end.

Trial License

The Free Add-in comes with a 30 day trial license included and the number of users is unlimited. There is no need to obtain a license during the trial period.

To check the status of the license, go to the Administration back-end and click License Information tile. License information will be displayed:

Picture 468

  • • Start Date – shows start date of the trial period;

  • • End Date – shows end date of the trial period;

  • • Current number of users – shows current number of users (Learner group members in courses are counted. Only unique learners are counted across each course). Current number of users is counted for all sites of the tenant;

  • • License Key – field for entering license key.

The number of users will increase when Learners are enrolling in courses.

Activate a License

If you have received a License Key from ELEARNINGFORCE you can add this in the License Key field and click Activate button:

Picture 21

Upon successful License activation a confirmation page will be displayed:

Picture 24

To check the status of the license click License Information tile. License information will be displayed:

Picture 29

  • • Start date – shows start date of your license;

  • • End Date – shows end date of your license;

  • • Max number of users – shows maximum number of users allowed by your license. If maximum number of users was exceeded it is possible to delete users to meet the license limitations (delete Learner from a course or delete a member of Visitors group);

  • • Current number of users – shows current number of users (Learner group members in courses are counted. Only unique learners are counted across each course). Current number of users is counted for all sites of the tenant;

  • • License key – shows last symbols of your license key.

NOTE:

License does not count disabled users.

A “License Error” will appear within the Course Catalog Web Part when license conditions are not satisfied. Learner will see the following message:

Picture 13

LMS365 Administrator will see the following message in the Web Part and in the Administration Back-end when license has expired:

Picture 14

OR the following message when the maximum number of users was exceeded:

Picture 15

UPDATE

To update the LMS365 | Course Creator & Catalog Add-in, upload a new version of the App Package to the App Catalog:

Picture 11

To do this, follow the steps described here.

After the uploading is done, an update for the add-in will be available on your Tenant:

  1. 1. Go to Settings > Site Contents;

  2. 2. Open the Add-in settings and select About:

Picture 1

  1. 3. Click Get It button to get a new version of the add-in:

Picture 1345054436

  1. 4. Click Trust it button to enable the Add-in to function properly:

Picture 1345054437

The new version of the add-in is now will be available.

UNINSTALL

To uninstall the LMS365 | Course Creator & Catalog Add-in from your SharePoint site, do the following:

  1. 1. Go to Settings > Site Contents;

  2. 2. Open the Add-in settings and select Remove:

Picture 464

  1. 3. Confirm the uninstall:

Picture 10

The Add-in will be deleted from the site. The Web Part “Courses Catalog” will be deleted from all pages, to which it had been added.

Picture 28

All Users who are members of Owners group can uninstall the Add-in.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Please sign in to leave a comment.