Itslearning: Difference between revisions

From UmsWiki
Jump to navigation Jump to search
Kia (talk | contribs)
Kia (talk | contribs)
Line 116: Line 116:
This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created. If left blank there are no criteria.
This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created. If left blank there are no criteria.


==== Organization API Client ID ====
====Organization API Client ID====


==== Organization API Client secret ====
====Organization API Client secret====


====Use test installation====
====Use test installation====
Line 130: Line 130:
This section explains how to create a hierarchy in itslearning. [[File:Itslearning Sub accounts.jpg|none|thumb|620x620px]]
This section explains how to create a hierarchy in itslearning. [[File:Itslearning Sub accounts.jpg|none|thumb|620x620px]]


====DisplayName====
====Description====
This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created.
This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created.


Line 140: Line 140:


====Example of how UMS will build a hierarchy====
====Example of how UMS will build a hierarchy====
The first two root elements come from the '<nowiki/>Sub accounts' settings.
All courses that UMS creates will be put in 'UMS Courses'.


All groups will be sorted in the hierarchy. Groups that are not sorted in the hierarchy will be put in 'UMS Groups'.
All groups will be sorted in the hierarchy. Groups that are not sorted in the hierarchy will be put in 'UMS Groups'.
Line 153: Line 150:
This section explains how to create a hierarchy in itslearning. [[File:Itslearning Sub accounts.jpg|none|thumb|620x620px]]
This section explains how to create a hierarchy in itslearning. [[File:Itslearning Sub accounts.jpg|none|thumb|620x620px]]


====DisplayName====
====Description====
This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created.
This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created.


Line 163: Line 160:


====Example of how UMS will build a hierarchy====
====Example of how UMS will build a hierarchy====
The first two root elements come from the '<nowiki/>Sub accounts' settings.
All courses that UMS creates will be put in 'UMS Courses'.


All groups will be sorted in the hierarchy. Groups that are not sorted in the hierarchy will be put in 'UMS Groups'.
All groups will be sorted in the hierarchy. Groups that are not sorted in the hierarchy will be put in 'UMS Courses'.


All template security groups will be created in 'UMS Template Groups'.
All courses that becomes inactive will be put in 'UMS Courses archive'.


[[File:Itslearning hierarchy.jpg|none|thumb|920x920px]]
[[File:Itslearning hierarchy.jpg|none|thumb|920x920px]]

Revision as of 11:18, 2 April 2019

Our itslearning integration is developed for schools that want to avoid hour-long administrative tasks. The integration automatically creates, maintains, and deletes users based on data from your student administrative system. It also creates and maintains group rooms, which teachers and students can use for teaching purposes. The rooms automatically use the language you require and can be categorized according to your needs, making them easier to find. Rooms that are no longer in use are deleted automatically.

Configuration in UMS

This allows users to log into itslearning with the same password they use to access the school’s IT-system. The itslearning integration gives you an easy overview and ensures that the users’ data is always managed correctly, without requiring any manual updates. This frees up time for the IT-department so they can focus on other tasks.

Prerequisites

Module requirements

UMS

What to have ready

  • Request a test page from Its learning. It's learning will send username, password and url for the test page.
  • The use must be systemAdministrator on the test page
  • As System Administrator will you have access to the following displayed on the image below

Make sure that "Manage API" is enabled, as shown in the image below

Click on "Manage Enterprise web services" as shown in the image below

Fill out in the following points, as shown in the image below.

  • Title
  • Username (If set to auto-generate, new username will be generated. If set to import, will username be imported from ums)
  • Password (If set to auto-generate, new password will be generated. If set to import, will password be imported from ums)
  • User profile data (choose which permerts should sync to it's learning)
  • System to use must be set to IMS-Enterprise
  • URL to service (copy url for it to be used later)
  • Username (copy url for it to be used later)
  • Password (copy url for it to be used later)

Installation

Open UMS Configurator and go to Template > itslearning. Click the first manage button.

You will now see an overview of your itslearning settings.

itslearning settings

Description

Give the Site settings a name.

Organization settings

Choose the Organization setting you want to use for this site setting.

Users

Username

Choose a column from the students table. Its default is <Not used>. This means that the username will be the same as in Active Directory.

This column will be used as the login.

Delete users

Delete the users when they are no longer active

Keep inactive before deleting

Wait this number of days before deleting inactive users

Template security groups

Check the box to create, update, and delete template security groups that has an itslearning setting attached.

Upload student information

Check these boxes to send and update information on students:

  • Address
  • Phone
  • Mobile Phone
  • Mail

Upload employee information

Check these boxes to send and update information on employees:

  • Address
  • Phone
  • Mobile Phone
  • Mail

Site

See LMS Settings for options that are not described below.

Language

The language used for a site when it is created

Course category

The category is put on the site when it is created

Activity sites

See Site selection settings

Course sites

See Site selection settings

Organization settings

Description

Give your Organization setting a name.

Username

Type your username for API connection (contact itslearning to acquire your username).

Password

Type your password for API connection (contact itslearning to acquire your password).

Source organization

Type the source organization for API connection (contact itslearning to acquire the source organization).

SQL Criteria

This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created. If left blank there are no criteria.

Organization API Client ID

Organization API Client secret

Use test installation

Enable this to use a test installation instead of production.

Installation ID

This is an ID you set in UMS to specify the multiple organization settings belong to the same itslearning installation.

itslearning installations that has the same URL should normally have the same ID in UMS.

Sub accounts

This section explains how to create a hierarchy in itslearning.

Description

This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created.

Database field

Select a column from the students table use the contents of that column to build the hierarchy.

SQL Criteria

Select only rows that match the SQL sentence. If left blank there are no criteria.

Example of how UMS will build a hierarchy

All groups will be sorted in the hierarchy. Groups that are not sorted in the hierarchy will be put in 'UMS Groups'.

All template security groups will be created in 'UMS Template Groups'.

Sub accounts Courses

This section explains how to create a hierarchy in itslearning.

Description

This is an overall SQL sentence that is used when creating groups. It is used in conjunction with the sub account settings. This has no impact on courses being created.

Database field

Select a column from the students table use the contents of that column to build the hierarchy.

SQL Criteria

Select only rows that match the SQL sentence. If left blank there are no criteria.

Example of how UMS will build a hierarchy

All groups will be sorted in the hierarchy. Groups that are not sorted in the hierarchy will be put in 'UMS Courses'.

All courses that becomes inactive will be put in 'UMS Courses archive'.

Site Settings

You need to attach a cohort setting to a template. This will tell UMS that cohorts will be created from this template.

Description

Enter a description for this setting.

Template

Enter a template that is used when creating courses.

SQL Groups

See LMS Settings for this option.

Group Settings

You need to attach a cohort setting to a template. This will tell UMS that cohorts will be created from this template.

Description

Enter a description for this setting.

Template

Enter a template that is used when creating groups.

SQL Groups

See LMS Settings for this option.

FAQ