Difference between revisions of "Test"

From InsightWiki
Jump to navigation Jump to search
Line 1: Line 1:
AD Links is an additional module in Insight. It allows users to log in to Insight using their Active Directory account. This is essential for student logins and optional for staff logins. <br> <br>
+
==Usage==
  
As AD Links is an additional module of Insight, a separate charge applies. Please contact <span class="plainlinks">[mailto:sales@tascsoftware.co.uk sales@tascsoftware.co.uk]</span> for further information. <br> <br>
+
{{Additional module}}
 +
Student events is an additional module in Insight. It allows students to make a reservation or booking. This could be an appointment to careers advice day or audition for the school play. Alternatively, students could book themselves onto a school trip if there a limited places, or a selection of available trips.. <br> <br>
  
=Configuration=
+
As Student events is an additional module of Insight, a separate charge applies. Please contact <span class="plainlinks">[mailto:sales@tascsoftware.co.uk sales@tascsoftware.co.uk]</span> for further information. The Events module also include '''[[Parents evening]]''' and '''[[Events]]'''. <br> <br>
  
==Importing Identifying Numbers into Active Directory==
+
=Student events=
  
An identifying number must appear in each AD record in order for Insight to link with the Active Directory. It is recommended to use the Admission Number for students, although the UPN or SIMS PersonID can also be used. For staff only the SIMS PersonID can be used. <br> <br>
+
Student events are configured via the [[manage student events]] page. <br> <br>
  
A list of staff PersonID numbers can be obtained from Insight. Go to: <br>
+
The student events page will show each of the sessions that are available. There may be multiple sessions available, but each student can only book into one session. In the example below, the session refers to the staff member who is available for a careers advice day. <br> <br>
''Accounts > AD Links'' <br>
 
Click the '''Staff report''' button to download a file containing the PersonID numbers for all staff. The file is in XML format but you can open it in Excel <br> <br>
 
  
It is possible to use SIMS AD Provisioning to import Admission Numbers into the Active Directory for students. Alternatively you can use a script from TASC Software to perform this provisioning for you. The TASC script can also be used to import SIMS PersonID numbers for staff. The TASC script will enter the chosen identifying number into the EmployeeID field in Active Directory. <br> <br>
+
Each session will have one or more available slots. Students will be booked into one of these slots. The slots could refer to times during the day, seats on a coach, audition slots, etc. When a student is booked into a slot, a tick will appear next to that slot and it will become unavailable for all other students. <br> <br>
  
If you wish to use the TASC Software script you will need a CSV file called INPUT.CSV in the format. The file must have exactly two columns; the first column must show the AD Username and the second column must show the identifying number. <br> <br>
+
<div>[[Image:student_event2.jpg]]</div> <br> <br>
  
The script file can be downloaded here: '''<span class="plainlinks">[http://www.tascsoftware.co.uk/wiki/PARS/files/import.vbs import.vbs]</span>''' <br>
+
==Configuration==
(right click and select Save As to download) <br> <br>
 
  
Once you have downloaded the file, edit it in Notepad (right click and select Edit). The first line of the file will read: <br>
+
Student events is an additional module in Insight. It allows students to make a reservation or booking. This could be an appointment to careers advice day or audition for the school play. Alternatively, students could book themselves onto a school trip if there a limited places, or a selection of available trips.. <br> <br>
CONST strDomain="MyDomain" <br> <br>
 
  
You need to edit this so that your domain appears between the quotation marks, instead of MyDomain. Save the file, then place it in a new folder with your CSV file. The folder must contain nothing else. Double click the import.vbs file to run the script which will update your Active Directory. <br> <br>
+
As Student events is an additional module of Insight, a separate charge applies. Please contact <span class="plainlinks">[mailto:sales@tascsoftware.co.uk sales@tascsoftware.co.uk]</span> for further information. The Events module also include '''[[Parents evening]]''' and '''[[Events]]'''. <br> <br>
  
==Settings within Insight==
+
==The Manage student events page==
  
[[Image:ad_links_page.png|thumb]]
+
There are a number of buttons on the top toolbar that allow you to create, manage and edit Student Events. <br> <br>
  
The following settings are entered into the AD Links page, which is accessed via: <br>
+
<div>[[Image:ManageStudentEvents1.jpg]]</div> <br> <br>
''Accounts > AD Links'' <br> <br>
 
  
'''Check in AD when logging in''' must be enabled for Active Directory logins (if this is switched off, all AD logins will be disabled). <br> <br>
+
==Creating a Student event==
  
Next enter the '''Domain''', '''Domain reading user''' and '''Domain reading password''' fields. <br>
+
Click the Add button from the top toolbar to begin creating a student event. This will open a window where you can perform configuration. There are two types of student events; stand alone events and concurrent student events. <br> <br>
The domain should be in the form: mydomain.local. Click the '''Check''' button when you have entered these details to confirm that Insight can access the Active Directory. <br>
 
''In some cases you may see a message reading "A trust relationship does not exist between ..."; This should not cause any issues or be a cause for concern.'' <br> <br>
 
  
By default Insight will check the EmployeeID field for the Admission Number (ADNO) to identify students. This will also be required for staff if you want them to log in using the Active Directory details, but they do not have trusted login accounts in SIMS. <br> <br>
+
===Stand alone student events===
  
Enable the '''Use alternative AD field in place of EmployeeID''' option if you would prefer to use an AD field other than EmployeeID. You then need to enter your choice of field into the '''Name of alternative field to use''' setting. <br> <br>
+
====Details tab====
  
'''Use student email addresses from AD''' <br>
+
A stand alone student event will not be affected by other student events. To create a student event, click the button at the top left with the plus symbol. A window will open where you can configure your event. <br> <br>
The alternative is to use the email addresses in SIMS <br> <br>
 
  
=Single Sign On=
+
'''Description''' <br>
 +
:This is the name of the event - students will be able to see this when making their bookings. <br> <br>
  
An additional benefit of using this method to log in is that it supports Integrated Windows Authentication in supported browsers.  This means that if the user is logged onto a computer within the domain, their account information can be used to log into Insight seamlessly (e.g. without entering their account details again). <br> <br>
+
'''Open & Close''' <br>
 +
:These are the dates where students can make bookings to the event. <br> <br>
  
To implement seamless login, direct those users who you expect to be able to login using their Active Directory details to the ADSSO.aspx page initially. For example: <br>
+
'''Allow parental booking''' <br>
{|
+
:If parents are allowed to make bookings on behalf of the students then use this option; it will allow parental accounts to make bookings as well as students. <br> <br>
|Use this address:||<span style="color:#36b"><nowiki>https://insight.myschool.co.uk/ADSSO.aspx</nowiki></span>
 
|-
 
|Rather than this:||<span style="color:#36b"><nowiki>https://insight.myschool.co.uk/secure.aspx?ReturnUrl=%2f</nowiki></span>
 
|} <br>
 
  
If the user is not already logged into the domain, they will be redirected to the normal login page, where they can still enter their Active Directory username and password. If you do not expect a user to be able to log in this way, they should be directed to the normal login URL. <br> <br>
+
'''Number of sittings''' <br>
 +
:Each sitting has its own slots, and it is slots that students will book. If you are creating a career advice event, then the slots might be the names of the staff members who will be available for the event. Each staff member will have their own list of slots that students can book. <br> <br>
  
=Troubleshooting=
+
:Once you have selected the number of sittings, a list will appear at the bottom of the window. Each sitting should be given a name. Each sitting also has a capacity - this is the number of slots that will be available to students. <br> <br>
  
==Accounts Not Linked==
+
:Slots can also be named - typically they will be given names relating to the times of the day that they represent i.e. slot 1 is "9:00", slot 2 is "9:10", etc. To name the slots, click the button under the slot names column. This will open a window - either name the slots by manually typing into the boxes or click the Times button to automatically name the slots as times during the day. <br> <br>
  
Check on the Users page: <br>
+
<div>[[Image:slottimes2.jpg]]</div> <br> <br>
''Accounts > Users'' <br> <br>
 
  
*The students' usernames should include @DOMAIN
+
:You can also give each sitting a description. This provides more information about the sitting. If you are creating a career advice day, then each sitting could represent a staff member, and the description could let the students know which field the staff member knows most about e.g. "IT specialist". <br> <br>
*Use filtering to find a student who does not
 
*Check in AD that they have the correct identifying number in the correct field
 
*Check in SIMS that the identifying number is correct
 
*Check the correct field is specified on the AD Links page
 
*Click Test
 
*Resynchronise <br> <br>
 
  
==Failed logins==
+
====Students====
  
===Accounts Not Linked===
+
Finally you need to decide which pupils should be able to make bookings to the event. To do this, click the Students tab at the top of the window. Click the Add students button and select the relevant students. <br> <br>
  
Check on the Users page: <br>
+
===Concurrent student events===
''Accounts > Users'' <br> <br>
 
  
The students' Insight accounts should include @DOMAIN (where DOMAIN is replaced by your AD domain). If any of the students' accounts do not contain this, then those accounts are not linked to the Active Directory and will not be able to log in. You can search for these accounts by filtering to see those where the username does not contain @. <br> <br>
+
Student events can be configured to interact with each other; this might be used if you want students to select their favourite 3 options from a list of possibilities; if a student makes a booking in a sitting in one event (i.e. a sitting called "Alton Towers") they will not be able to make a booking in the same sitting (again called "Alton Towers") in another event. <br> <br>
  
If you find any accounts that are not linked to AD, then log in to Active Directory and check that the student's AD record has the correct identifying number in the correct field. If the AD record appears to be correct then log in to SIMS and check that the identifying number in AD is correct. Once the necessary corrections have been made, perform a '''[[User_management#Student|Synchronisation]]''' via the Users page. <br> <br>
+
Student events will be configured in the same way as single student events, above. Each of the linked student events will need to have the same start and end date. <br> <br>
  
===Activity Report===
+
If different events have sittings with the same name as each other (e.g. Event 1 has a sitting called "Alton Towers" and Event 2 has a sitting called "Alton Towers") then pupils will only be able to make one booking to ''either'' of those sittings, even though they are in different events. <br> <br>
  
If students' accounts are linked to the Active Directory but they are not able to log in using their AD details then visit the AD Links page via: <br>
+
For example, you might create 3 student events, called "1st choice", "2nd choice" and "3rd choice". In each of these events, the list of sittings will represent the different school trips that the students can opt to attend. The number of slots for each sitting represents the number of places available on the trip. If a student makes a booking for "Alton Towers" in the 1st choice event, then they will not be able to book "Alton Towers" in their 2nd or 3rd choice, although the other school trips will still be available. <br> <br>
''Accounts > AD Links'' <br> <br>
 
 
 
Click the '''Activity Report''' button. This will open a window showing the most recent login attempts from AD linked users. This report will tell you if a user has entered an incorrect password. If a user's login attempt does not appear on this report then they are attempting to log in using a username that Insight does not recognise. <br> <br>
 
 
 
===Expose AD Fail===
 
 
 
There is a setting in the web.config file that can be changed, which will display information about the Active Directory on the login page. To enable this setting edit the web.config file for Insight, which is typically found via: <br>
 
''C:\inetpub\wwwroot\INSIGHT\web.config'' <br> <br>
 
 
 
Near the bottom of the file is a setting called '''ExposeADFail'''. Set the value of this setting to Yes e.g.
 
<setting name="ExposeADFail" serializeAs="String">
 
  <value>Yes</value>
 
</setting>
 
 
 
Once the value is set to Yes, save the file then attempt to log in to Insight using one of the AD accounts experiencing the problem. The login attempt and you will see a warning message on the login page such as "Invalid username". Hover over the warning message to see further details about the Active Directory connection and login attempt. <br> <br>
 
  
 +
[[Category:Management]]
 
[[Category:Additional modules]]
 
[[Category:Additional modules]]
[[Category:Management]]
 
[[Category:Technical]]
 

Revision as of 14:53, 10 August 2018

Usage

Addmod2.png Additional Module

Student events is an additional module in Insight. It allows students to make a reservation or booking. This could be an appointment to careers advice day or audition for the school play. Alternatively, students could book themselves onto a school trip if there a limited places, or a selection of available trips..

As Student events is an additional module of Insight, a separate charge applies. Please contact sales@tascsoftware.co.uk for further information. The Events module also include Parents evening and Events.

Student events

Student events are configured via the manage student events page.

The student events page will show each of the sessions that are available. There may be multiple sessions available, but each student can only book into one session. In the example below, the session refers to the staff member who is available for a careers advice day.

Each session will have one or more available slots. Students will be booked into one of these slots. The slots could refer to times during the day, seats on a coach, audition slots, etc. When a student is booked into a slot, a tick will appear next to that slot and it will become unavailable for all other students.

Student event2.jpg



Configuration

Student events is an additional module in Insight. It allows students to make a reservation or booking. This could be an appointment to careers advice day or audition for the school play. Alternatively, students could book themselves onto a school trip if there a limited places, or a selection of available trips..

As Student events is an additional module of Insight, a separate charge applies. Please contact sales@tascsoftware.co.uk for further information. The Events module also include Parents evening and Events.

The Manage student events page

There are a number of buttons on the top toolbar that allow you to create, manage and edit Student Events.

ManageStudentEvents1.jpg



Creating a Student event

Click the Add button from the top toolbar to begin creating a student event. This will open a window where you can perform configuration. There are two types of student events; stand alone events and concurrent student events.

Stand alone student events

Details tab

A stand alone student event will not be affected by other student events. To create a student event, click the button at the top left with the plus symbol. A window will open where you can configure your event.

Description

This is the name of the event - students will be able to see this when making their bookings.

Open & Close

These are the dates where students can make bookings to the event.

Allow parental booking

If parents are allowed to make bookings on behalf of the students then use this option; it will allow parental accounts to make bookings as well as students.

Number of sittings

Each sitting has its own slots, and it is slots that students will book. If you are creating a career advice event, then the slots might be the names of the staff members who will be available for the event. Each staff member will have their own list of slots that students can book.

Once you have selected the number of sittings, a list will appear at the bottom of the window. Each sitting should be given a name. Each sitting also has a capacity - this is the number of slots that will be available to students.

Slots can also be named - typically they will be given names relating to the times of the day that they represent i.e. slot 1 is "9:00", slot 2 is "9:10", etc. To name the slots, click the button under the slot names column. This will open a window - either name the slots by manually typing into the boxes or click the Times button to automatically name the slots as times during the day.

Slottimes2.jpg



You can also give each sitting a description. This provides more information about the sitting. If you are creating a career advice day, then each sitting could represent a staff member, and the description could let the students know which field the staff member knows most about e.g. "IT specialist".

Students

Finally you need to decide which pupils should be able to make bookings to the event. To do this, click the Students tab at the top of the window. Click the Add students button and select the relevant students.

Concurrent student events

Student events can be configured to interact with each other; this might be used if you want students to select their favourite 3 options from a list of possibilities; if a student makes a booking in a sitting in one event (i.e. a sitting called "Alton Towers") they will not be able to make a booking in the same sitting (again called "Alton Towers") in another event.

Student events will be configured in the same way as single student events, above. Each of the linked student events will need to have the same start and end date.

If different events have sittings with the same name as each other (e.g. Event 1 has a sitting called "Alton Towers" and Event 2 has a sitting called "Alton Towers") then pupils will only be able to make one booking to either of those sittings, even though they are in different events.

For example, you might create 3 student events, called "1st choice", "2nd choice" and "3rd choice". In each of these events, the list of sittings will represent the different school trips that the students can opt to attend. The number of slots for each sitting represents the number of places available on the trip. If a student makes a booking for "Alton Towers" in the 1st choice event, then they will not be able to book "Alton Towers" in their 2nd or 3rd choice, although the other school trips will still be available.