LMS 365 | Assignments & Gradebook Add-in Installation Guide

Picture 4LMS 365 | Assignments & Gradebook Add-in Installation Guide

Version 2.2.1.51

 

 

 

 

 

  1. OVERVIEW AND SOFTWARE REQUIREMENTS

 

    1. 1.1 Audience

This guide has been written for the System Administrator to install the LMS365 | Assignments & Gradebook Add-in and Web Part and create a fully working solution including uploading the LMS365 | Assignments & Gradebook Add-in.

For detailed information about configuring the Settings please consult the User Guide.

    1. 1.2 About the Add-in

The LMS 365 | Assignments & Gradebook Add-in has been developed to run on Office 365 SharePoint Online Team Sites.

The Add-in is not yet supported for SharePoint 2013 On Premise.

The LMS 365 | Assignments & Gradebook Add-in is a part of the LMS 365 suite of Learning Add-ins. It interacts with LMS365 | SCORM & AICC Player Add-in.

    1. 1.3 Server software requirements

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

 

    1. 1.4 Client requirements

A supported browser such as Internet Explorer 11 onwards. Recent versions of Chrome and Firefox are also supported.

 

 

  1. INSTALLING THE ADD-IN

 

NOTE:

For the installation of the Add-in the user must have Site Collection Administrator rights.

 

To install the add-in click Settings icon Picture 477 and select Add an App from the Menu as illustrated:

 

Picture 44

 

Enter Assignments & Gradebook in the Search Field and click on Search:

 

Picture 1

 

 

 

 

The Search Result will tell you it has found results in the SharePoint Store as shown:

 

Picture 11

 

Click the results link and you will be presented with the following screen:

 

Picture 16

 

Click the Assignments & Gradebook Add-in Icon.

 

You will be presented with the following screen from where you can add the Add-in to your Site:

 

 

 

Picture 19

 

You will be asked to confirm that you wish to add the add-in. Click on Continue to confirm:

 

Picture 23

 

When you get the confirmation page, you can click Return to site:

 

Picture 26

 

You must click Trust it button to enable the Add-in to function properly:

 

Picture 25

 

You will now see the Add-in installed on your Team Site:

 

Picture 454

 

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 My Assignments Web Part to your site, you will see the following message:

 

Рисунок 28

 

 

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

 

Рисунок 20

 

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

 

Рисунок 448

 

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

  1. INSTALLING THE WEB PART

 

The LMS 365 | Assignments & Gradebook Add-in comes with a Web Part. The Web Part will provide the UI for users to see the Assignment Tasks and be able to complete Tasks assigned to them.

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 My Assignments in LMS365 category and click “Add”:

 

Рисунок 449

 

The Web Part has now been inserted in the page. Click Save icon in the Menu to save the page:

 

Picture 457

 

The page will now be saved.

 

NOTE:

You can insert and use the Add-in Part as well. In the Edit Mode, insert your cursor in the location you wish to insert the Add-in Part, select “My Assignments” and click “Add”:

 

Picture 30

 

 

To get to the Administration Back-end you can click the Add / Edit/ Manage button Рисунок 450 on the Web Part or on the Add-in title above Site Contents:

 

Рисунок 455

 

  1. SETTING THE ADMINISTRATOR PERMISSIONS

 

To have access to the Back-end Administration you have to be a member of the Site Owners Groups. If you are not, you will get the following error message:

 

Picture 459

 

The name of your group will differ from the one on the image above.

To add yourself to the Site Owners Group, do the following:

  1. 1. Go to Site Settings:

 

Picture 475

 

  1. 2. And click People and groups link:

 

Picture 464

 

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

 

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

 

  1. 4. Add the user(s) you want to be able to administer the LMS 365 | Assignments & Gradebook Add-in:

 

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

 

By default, an email invitation will be sent to the user(s). To disable this function click “Show Options” and uncheck Send an email invitation box.

  1. ADDING AZURE AD GROUPS

 

SharePoint Online allows adding Azure AD Group principals as site members. This great ability helps a lot, but there is no out of the box ability to get members of the Azure AD groups. It means that your Azure AD should be configured to trust our add-ins to be able to read members of Azure AD groups.

To give the application permissions to read users data you need to run a PowerShell script as described in LMS 365 | Course Creator & Catalog Add-in Installation Guide.

 

Picture 2

Running the script requires Tenant Administrator rights.

 

 

  1. LICENSE INFORMATION

    1. 6.1 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 get access to the license information, go to the Administration Back-end, click License Information link in the Settings section of the sidebar, and then Assignment & Gradebook:

 

Рисунок 17

 

NOTE:

New administration center is available only if Course Creator & Catalog Add-in is also installed on the site. Otherwise, a stand-alone add-in is administered in the old administration center.

 

To activate the Trial license, fill in the form and click Activate button:

 

Рисунок 18

 

Upon successful License activation a confirmation page will be displayed:

 

Рисунок 21

 

Picture 7

You do not need to enter License Key to activate a Trial license.

 

 

To check the status of the license, go to the Administration Back-end, and click Assignment & Gradebook link under License Information link in the Settings section of the sidebar. The following information will be displayed on the License Information page:

 

Рисунок 22

 

  • • 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, Visitor group members in usual sites are counted. Only unique users are counted across each site where Add-in is added). 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.

 

    1. 6.2 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\SNAGHTML24ce9ae3.PNG

 

Upon successful License activation, a confirmation page will be displayed:

 

Рисунок 29

 

After license activation, the following information will be displayed:

 

Рисунок 462

 

  • • 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, Visitors group members in usual sites are counted. Only unique users are counted across each site where Add-in is added). 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:

 

Рисунок 471

 

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

 

Рисунок 472

 

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

 

Рисунок 41

 

    1. 6.3 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, which you want to delete from all sites where add-in is installed. 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 Рисунок 461. Information will be presented in the following form:

 

Рисунок 463

 

  1. UPDATE


The update of the LMS365 | Assignments & Gradebook Add-in is taken care of automatically via the Office Market Place.

Within 24 hours after a new version has been released, a notification that an update is available will appear on Site Contents page. A link is provided to immediately install the update. The update is installed without first uninstalling the earlier version. The update infrastructure tests the update installation and rolls it back if there are any errors.

For more information you can go to http://msdn.microsoft.com/en-us/library/office/dn265910.aspx

 

  1. UNINSTALL

 

Picture 10

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

 

To uninstall the LMS365 | Assignments & Gradebook 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 469

 

  1. 3. Confirm the uninstall:

 

Picture 27

 

The Add-in will be deleted from the site. The Web Part “My Assignments” will be deleted from all pages, to which it had beed added. All information about your Assignments and attempts will be stored and will become available after next installation of the Add-in. All Attachments uploaded to the Add-in will be removed, and will not be restored after next installation.

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.