TimeEdit: Difference between revisions

From UmsWiki
Jump to navigation Jump to search
Kia (talk | contribs)
Kia (talk | contribs)
 
(8 intermediate revisions by the same user not shown)
Line 11: Line 11:
Upload of courses fails if no courses are imported on GetStudents. Verify this with SQL  
Upload of courses fails if no courses are imported on GetStudents. Verify this with SQL  
{| class="wikitable"
{| class="wikitable"
|select distinct Skolefag from  ImportFromDB
|Select Distinct Aktivitet, Skolefag From Students
|}
|}
<br />[[File:TimeEdit Settings.jpg|none|thumb|728x728px]]
<br />[[File:TimeEdit Settings.jpg|none|thumb|849x849px]]


===Description===
===Description===
Enter a name for this setting.
Enter a name for this setting.
===Upload groups===
Upload employee groups from UMS to TimeEdit.
=== Use Activity ID ===
When this is disabled UMS will use the activity field instead of Activity ID. Make sure the field you choose is unique if you have more than 1 administrative system.
===Keep classes alive===
This controls how many days classes are kept in TimeEdit after they have ended.


===Upload courses===
===Upload courses===
Line 25: Line 34:
===Upload course memberships===
===Upload course memberships===
Enable this to add students to the courses being uploaded.
Enable this to add students to the courses being uploaded.
===Keep courses alive===
This controls how many days courses are kept in TimeEdit after they have ended.


===TimeEdit Server connection===
===TimeEdit Server connection===
Line 43: Line 55:
====Password====
====Password====
Password to access the Webservice URL.
Password to access the Webservice URL.
===Use SQL to control data from UMS===
This allows you to enter extra criteria on data extracted from the students table in UMS for each object type sent to TimeEdit


===Employee mail domain===
===Employee mail domain===
Line 63: Line 72:


==Use SQL to control data from UMS==
==Use SQL to control data from UMS==
This gives you access to write SQL statements that control the data extracted from UMS and send to TimeEdit
This allows you to enter extra criteria on data extracted from UMS for each object type sent to TimeEdit


===Employees===
===Employees===
Line 86: Line 95:
  (UserTypes_ID = 1)
  (UserTypes_ID = 1)
  And (Aktivitet Is Not Null)
  And (Aktivitet Is Not Null)
  And (Aktivitet <> '')
  And (Aktivitet <> <nowiki>''</nowiki>'')''
===Courses===
===Courses===
This relates to data found in this SQL statement
This relates to data found in this SQL statement
Line 94: Line 103:
  (UserTypes_ID = 1)
  (UserTypes_ID = 1)
  And (Aktivitet Is Not Null)
  And (Aktivitet Is Not Null)
  And (Aktivitet <> '')
  And (Aktivitet <> <nowiki>''</nowiki>'')''
  And (Skolefag Is Not Null)
  And (Skolefag Is Not Null)
  And (Skolefag <> '')
  And (Skolefag <> <nowiki>''</nowiki>'')''
===Groups===
This relates to data found in this SQL statement
Select *
From Students
Where
(UserTypes_ID = 0)
And (AktivitetsID Is Not Null)
And (AktivitetsID <> <nowiki>''</nowiki>'')''
===Admin Activities===
===Admin Activities===
This relates to data found in this SQL statement<br>
This relates to data found in this SQL statement
  Select * From AdminSystems_Activities
  Select * From AdminSystems_Activities
===Admin Courses===
===Admin Courses===
This relates to data found in this SQL statement<br>
This relates to data found in this SQL statement
  Select *
  Select *
  From AdminSystems_Activities
  From AdminSystems_Activities
Line 113: Line 130:
[[File:Modules Timetable Datasource Add new.png|none|thumb|818x818px]]
[[File:Modules Timetable Datasource Add new.png|none|thumb|818x818px]]


==Parameters==
{| class="wikitable"
|+
!Parameter
!Description
|-
|Debug
|Show XML that is uploaded in log file
|-
|Employees
|Upload employees
|-
|Students
|Upload students
|-
|Activities
|Upload activites/classes
|-
|Courses
|Upload courses
|}
==FAQ==
==FAQ==



Latest revision as of 07:30, 29 August 2022

Prerequisites

Module requirements

  • UMS
  • TimeEdit account

Create TimeEdit settings on templates

Edit a template and apply settings for TimeEdit in order to send data from UMS to TimeEdit

Upload of courses fails if no courses are imported on GetStudents. Verify this with SQL

Select Distinct Aktivitet, Skolefag From Students


Description

Enter a name for this setting.

Upload groups

Upload employee groups from UMS to TimeEdit.

Use Activity ID

When this is disabled UMS will use the activity field instead of Activity ID. Make sure the field you choose is unique if you have more than 1 administrative system.

Keep classes alive

This controls how many days classes are kept in TimeEdit after they have ended.

Upload courses

Upload courses from UMS to TimeEdit. This is courses as defined by UMS

Activities/groups upload can not be disabled.

Upload course memberships

Enable this to add students to the courses being uploaded.

Keep courses alive

This controls how many days courses are kept in TimeEdit after they have ended.

TimeEdit Server connection

All connection information is provided by TimeEdit support.

All information is specific to a customer.

URL (Endpoint)

This URL specifies the endpoint that UMS connects to.

Certificate path

Then XML file you receive from TimeEdit. The certificate must be issued to your school, else you will get this error

Username

Username to access the Webservice URL.

Password

Password to access the Webservice URL.

Employee mail domain

This will be appended to the username to complete a mail address that TimeEdit can use.Example: @inlogic.dk

Students mail domain

This will be appended to the username to complete a mail address that TimeEdit can use. Example: @inlogic.dk

If students are using private mails then leave the field blank and configure metadata where you map general.email with UMS field PrivateMail


Exclude students from classes

Username entered here will prevent them from being member of any activities.

Users will still be uploaded to TimeEdit.

Use SQL to control data from UMS

This allows you to enter extra criteria on data extracted from UMS for each object type sent to TimeEdit

Employees

This relates to data found in this SQL statement

Select *
From Students
Where
(UserTypes_ID = 0)

Students

This relates to data found in this SQL statement

Select *
From Students
Where
(UserTypes_ID = 1)

Activities

This relates to data found in this SQL statement

Select *
From Students
Where
(UserTypes_ID = 1)
And (Aktivitet Is Not Null)
And (Aktivitet <> '')

Courses

This relates to data found in this SQL statement

Select *
From Students
Where
(UserTypes_ID = 1)
And (Aktivitet Is Not Null)
And (Aktivitet <> '')
And (Skolefag Is Not Null)
And (Skolefag <> '')

Groups

This relates to data found in this SQL statement

Select *
From Students
Where
(UserTypes_ID = 0)
And (AktivitetsID Is Not Null)
And (AktivitetsID <> '')

Admin Activities

This relates to data found in this SQL statement

Select * From AdminSystems_Activities

Admin Courses

This relates to data found in this SQL statement

Select *
From AdminSystems_Activities
Join AdminSystems_Activities_Courses On (AdminSystems_Activities_Courses.Activity = AdminSystems_Activities.Activity) And (AdminSystems_Activities_Courses.Adminserver_ID = AdminSystems_Activities.Adminserver_ID) 
Join AdminSystems_Courses On (AdminSystems_Courses.Course = AdminSystems_Activities_Courses.Course) And (AdminSystems_Courses.Adminserver_ID = AdminSystems_Activities_Courses.Adminserver_ID)

TimeEdit field information

Configure Modules > Timetable >Datasource

Create a new datasource in order to get timetable blocks in return from TimeEdit

Parameters

Parameter Description
Debug Show XML that is uploaded in log file
Employees Upload employees
Students Upload students
Activities Upload activites/classes
Courses Upload courses

FAQ

Missing subject / title

Titles in timetable are based on ActivityDescription in UMS (TimeEdit key: studentclass.longdecript).

If bookings are not bound to activities then fill out the comments field in TimeEdit. The Comment field is also displayed on the body text of the booking.


There is no field with ext.id "person.first_name" , "general.email" etc

The missing fields must be configured in the TimeEdit database. You can do this either by making a supportrequest to TimeEdit or download a an administrative tool from TimeEdit, please contact TimeEdit for further information.

How can I test a TimeEdit certificate ?

Download the SoapUI tool and send a soap register-request as shown in the screenshot. If the certificate is registreret correctly at TimeEdit the response will be the key used for 2 factor authentication.