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

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

Version 2.0.0.0

 

 

 

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 and training plan 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.

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, Ordering Answers or Matching Answers. 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 enable “Custom Scripting” on your tenant. Enabling “Custom Scripting” option is required to successfully create courses and training plans.

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.

If ‘Custom Script’ is not enabled on the tenant, you will see the following message on the course/training plan creation form:

Рисунок 458

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.

 

 

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:

 

Рисунок 456

 

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

Рисунок 475

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

Рисунок 476

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:

Рисунок 452

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

Рисунок 453

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 Course Creator link under License Information link in Settings section of the sidebar. License information will be displayed:

Рисунок 450

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

NOTE:

Deleted/disabled in AD users are not counted in current number of users.

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:

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

Upon successful License activation a confirmation page will be displayed:

Рисунок 455

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

Рисунок 448

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

Deleted/disabled in AD users are not counted in current number of users.

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

Рисунок 35

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

Рисунок 36

NOTE:

When maximum number of users has been reached or license has expired, you have 14 days period for handling license issues. During this period, the system does not stop working, only a warning (depending on what has happened) appears in the Administration Back-end:

 

Рисунок 39

Рисунок 40

 

Learners could continue working with the LMS during the 14 days period. After 14 days period (if license issues have not been handled), Leaners will see the following message when trying to access the add-ins:

 

Рисунок 41

 

Managing Activated License

After you have activated License, you can specify e-mail notification settings. In Notifications section, you can specify whether to send e-mail notifications when maximum number of users is reached and/or number of days when license is about to expire and/or number of days after license is expired. In the first case, specify number of users in % (you can specify several number of days separated by comma; by default, 50 and 99 % are set), in the second, specify number of days before license expires (you can specify several number of days separated by comma; by default, 30, 14, 7, 1 days are set), and in the third case, specify number of days after license expires (you can specify several number of days separated by comma; by default, 0, 5, 10 days are set), and then choose user(s) who will receive notification:

Рисунок 32

In the User Administration section, you can specify users that you want to unenroll from all courses and training plans. To do this, specify the needed user(s) and then click Unenroll button:

Рисунок 33

To download user license report, in which all users that are counted in the license will be specified, click Export to Excel button Рисунок 457. Information will be presented in the following form:

Рисунок 463

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.