Difference between revisions of "Test"

From PARS
Jump to navigationJump to search
 
(45 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page is used to send messages via email or SMS, and to generate letters. This page can also be used to record the details of phone calls and meetings. All of this information is saved on the student's contact log. <br> <br>
+
PINs can be enabled in PARS for two factor authentication; the user must login using their SIMS or Active Directory details, then also enter a PIN. The PIN can either be a four digit number received by email and SMS, or a six digit TOTP generated by an authenticator app. <br> <br>
  
=Accessing the External Contact screen=
+
PINs can be disabled for login attempts from given IP address ranges. This allows you to use single factor authentication for logins within the school network and two factor authentication for all other logins. <br>
  
There are a variety of reasons you may want to contact parents from PARS. The External Contact page is always used to send the messages, but the method for accessing the External Contact page changes, depending on the reason you are contacting parents. <br> <br>
+
''Note that some configuration must be performed in PARS before it is able to send emails or SMS messages. See the '''[[Contacting_parents#Configuration|Contacting Parents]]''' page for further information about the configuration required.'' <br> <br>
  
==For General Messages==
+
==Enable PINs==
  
The page is simply accessed via: <br>
+
The PIN settings for PARS are stored in the web.config file for the PARS site, on the PARS IIS server. The web.config file is found in the PARS installaion folder which is usually located: <br>
'''Main Menu > Contact Management > External contact''' <br> <br>
+
C:\inetpub\wwwroot\PARS\web.config <br> <br>
  
You can also click the External Contact button on the Quick Launch Bar at the top of PARS. <br>
+
The web.config file is in xml format and can be edited using Notepad or a similar text editor. To enable PINs in PARS, find the setting called "PINS" and change the value to "On" e.g. <br>
[[Image:quick_launch_external_contact.jpg]] <br> <br>
+
<setting name="PINS" serializeAs="String">
 +
      <value>On</value>
 +
</setting>
 +
<br>
  
==For Absence==
+
==Disable PINs internally==
  
You should use the '''[[Attendance view|Attendance View]]''' page to identify the absent students (see the Attendance View page for instructions to do this). You would then click '''Contact > External Contact''' on the Attendance View page. <br> <br>
+
If you would like to disable PINs for a certain range of IP addresses, find the setting called "PIN_Exclude_IPs". Enter each IP address or range of IP addresses into the value, separated by semi colons. <br> <br>
  
==For Behaviour Incidents==
+
You can specify a range of IP addresses using a subnet mask. The subnet mask must not be in 'classless' format e.g. 192.169.1.0/24 is not acceptable; you should use 192.169.1.0/255.255.255.0 instead. <br> <br>
  
This is to contact parents about individual behaviour incidents i.e. contact all the parents of students who received a Head Teacher's Award this week; contact all the parents of students who received a C4 today; etc. Parents receive one message per behaviour incident and the messages can include information about the behaviour incidents, such as the grounds or the comments. <br> <br>
+
The value field in the web.config file must not include line breaks. <br> <br>
  
The '''[[Edit behaviour incidents|Edit Behaviour Incidents]]''' page is used to select the behaviour incidents for which you will contact parents (see the Edit Behaviour Incidents page for instructions to do this). You would then click the '''External Contact''' button on the Edit Behaviour Incidents page. <br> <br>
+
'''Correct'''
 +
<setting name="PIN_Exclude_IPs" serializeAs="String">
 +
      <value>192.168.0.0/255.255.0.0</value>    
 +
</setting>
  
==For Detentions==
+
'''Incorrect'''
 +
<setting name="PIN_Exclude_IPs" serializeAs="String">
 +
      <value>192.168.0.0/16</value>     
 +
</setting>
  
This is to contact parents about specific detentions. The messages sent to parents can include information such as the reason that the detention was given, or the date and time it is going to take place. <br> <br>
+
'''Incorrect''' 
 +
<setting name="PIN_Exclude_IPs" serializeAs="String">
 +
      <value>192.168.0.0/255.255.0.0
 +
      </value>    
 +
</setting>
  
The '''[[Edit scheduled detentions|Edit Scheduled Detentions]]''' page is used to select the detentions for which you will contact parents (see the Edit Scheduled Detentions page for instructions to do this). You would then click the '''External Contact''' button on the Edit Scheduled Detentions page. <br> <br>
+
You may enter multiple IP address ranges or single IP addresses by separating with a semi colon e.g.
 +
<setting name="PIN_Exclude_IPs" serializeAs="String">
 +
      <value>192.168.0.0/255.255.0.0;172.16.0.0/255.240.0.0</value>     
 +
</setting>
 +
<br>
  
==For Assignments (Homework)==
+
==PINs by TOTP==
  
You can contact parents about a homework assignment, either to notify the parents and/or students that a homework has been set (and email any attachments). Alternatively you can notify the parents of students who have not completed the homework. <br> <br>
+
[[Image:TOTP_kep.png|thumb]]
  
Open the '''[[Assignment diary|Assignment Diary]]''' and select the Assignment, then click the '''External Contact''' button. See the Assignment Diary page for more information. <br> <br>
+
The default method for delivering PINs to users is to send an email and a password containing their temporary PIN. PARS will use the user's mobile telephone number and work email address from SIMS. <br> <br>
  
==For Low Attendance==
+
The alternative is for users to download an authentication app. Users can request a key from the PARS login page which will be sent to them via email and SIMS. Once they have entered this key into their authentication app, they will be able to generate PINs using the authentication app without the need to receive emails and SMS messages. <br> <br>
  
You first need to run an Attendance Report to identify the students with low attendance (e.g. lower than 85%). '''Attendance Summaries > Individual Percentages > Selected Individual Session Attendance''' is a good report for this purpose. <br> <br>
+
To enable PINs in PARS, find the setting called "PINS" and change the value to "On" e.g. <br>
 +
<setting name="PINSBYTOTP" serializeAs="String">
 +
      <value>On</value>
 +
</setting>
  
Attendance Reports are accessed via: <br>
+
Once TOTP PINs have been enabled, users will be able to collect a key for use in their authenticator app. To receive a key the user first needs to attempt to log in to PARS. They will then be prompted to enter a PIN and will also see a cog button. Clicking the cog button will sent a key to the user via email and SMS. <br> <br>
'''Main Menu > Attendance > Attendance Reports''' <br> <br>
 
  
The report then needs to be filtered to show only those students with less than a certain percentage attendance. The '''[[Reports]]''' page explains how to filter reports. Once the report is filtered click the '''External Contact''' button at the top of the report. <br> <br>
+
==Troubleshooting==
  
=Using the External Contact Screen=
+
If you are experiencing trouble in disabling PINs for internal IP address ranges then enter "*log*" as the first item in the list of excluded IP address ranges e.g. <br>
 +
<setting name="PIN_Exclude_IPs" serializeAs="String">
 +
      <value>*log*;192.168.0.0/255.255.0.0</value>     
 +
</setting>
  
==Batch send messages / batch generate letters==
+
PARS will then log information in the Application Log of the IIS server on which PARS is installed. These logs will show which IP address was used during a login attempt and whether it matches any of the ranges that have been excluded. <br> <br>
 
 
Click the generate batch button at the top left of the page. You will be taken to a new page with 3 tabs.
 
 
 
===Stage 1===
 
[[Image:external_contact_batch_stage1.jpg|thumb|The Stage 1 tab when batch sending messages]]
 
 
 
On the left side of the page you will see a list of students whose parents are to be contacted. Deselect any students whose parents you do not want to contact. <br> <br>
 
 
 
In the middle column select the type of person you are going to contact. There are four options:
 
* Students <br>
 
''Contact the students themselves. Emails will be sent to their 'work' email addresses (as set in SIMS)''
 
* Priority 1 contact with Parental responsibility <br>
 
''Contact people who are both priority 1 and have parental responsibility''
 
* Priority 1 contact regardless of Parental responsibility <br>
 
''Contact people who are priority 1''
 
* All contacts with Parental responsibility <br>
 
''Contact people who have responsibility'' <br> <br>
 
 
 
On the right side of the page select the method you wish to use to send your messages. Some of the options include the phrase '''falling back to'''. In these cases, the second method will only be used if the recipient does not have any details to use for the first method e.g. When SMS falling back to email is selected, parents will only receive an email if they do not have an SMS number in SIMS. <br> <br>
 
 
 
''Note that there are some settings that will affect the options shown on this tab. If some options appear to be different or missing, see the [[Additional section at the bottom of this page]].'' <br> <br>
 
 
 
===Stage 2===
 
 
 
This tab will check that, for each student, there is a person in SIMS who can be contacted based on the options selected on the previous tab. <br> <br>
 
 
 
Each student will be listed and any valid contacts (according to their Priority Number and Parental Responsibility) will be shown next to the student. Students are highlighted in red if they cannot be contacted for any reason. <br> <br>
 
 
 
[[Image:external_contact_batch_stage2.jpg]] <br> <br>
 
 
 
*If a student has a contact with a Court Order, the contact's name will appear with a warning symbol. By default contacts with Court Orders will not be contact. See Archie Ansell above.
 
*If a student does not have any contacts with valid Priority and/or Parental Responsibility, then no names will appear next to the student's name. See Adrienne Frost above.
 
*If a student has a valid contact but that contact does not have appropriate contact details (e.g. no SMS number or no email address) then the contact's name will appear with a black icon. See Hilda Boson above. <br> <br>
 
 
 
===Stage 3===
 
 
 
This tab is used to enter the message that will be sent. If you have messages saved in the message bank, dropdowns will appear allowing you to select these messages. Click the relevant button (Email, SMS or Letter) to edit your template message or manually compose a message. <br> <br>
 
 
 
''For instructions to add messages to the message bank, see the [[configuration section lower down this page]]''. <br> <br>
 
 
 
After clicking the SMS, Email or Letter buttons, a Compose Message window will open. You can add merge fields to your message by clicking '''Insert > Field > ...'''. When sending Emails or SMS messages, there is a '''Send at''' field  which is used to delay sending the messages until a later time. This can be useful when sending large volumes of emails. When sending Emails you will see an additional tab to add attachments to your email. Every recipient will receive the same attachment(s). <br> <br>
 
 
 
If your letter includes General Attendance or General Behaviour merge fields, a '''Range button''' will appear on the top toolbar. This button is used to select the date range from which the attendance data will be gathered. <br> <br>
 
 
 
When sending a letter there is an option to Upload a copy of the letter to the student's linked documents in SIMS. <br> <br>
 
 
 
Click the '''Generate''' button at the top left of the screen to send your messages or download your letters. <br> <br>
 
 
 
==Send single message==
 
 
 
Messages can be sent to students or contacts individually. Each person will have their available contact details listed. Click on the Email or SMS buttons to send a message to that person's mobile phone or email address. <br> <br>
 
 
 
You will then see a window to compose your message. You can access the message bank by clicking Insert > Template, or access merge fields by clicking Insert > Field. <br> <br>
 
 
 
==Record meetings or phone calls==
 
 
 
You can type and save the details of any phone calls or meetings using this screen. For telephone calls, find the telephone number that was used then click the Call button next to it. For meetings click the Ad-Hoc button next to that contact. <br> <br>
 
 
 
When recording telephone calls there is an additional Contact Type option. This is used to record whether the call was successful, or whether there was no answer, a voicemail was left, etc. <br> <br>
 
 
 
When recording meetings and telephone calls most information will be recorded on the contact log. This includes the date, time, the name of the staff member recording the information, the person contacted and the student. In the case of telephone calls the telephone number is also recorded. <br> <br>
 
 
 
==View contact log==
 
 
 
There Contact History and History Report buttons are used to access a student's contact log. <br> <br>
 
 
 
Contact History shows a summary of contacts made, but to see the details of each contact you must click the view button. This report is easier to read at a glance but requires more clicks to see the details of a message. The Contact History report can also be used to edit and delete items from the contact log. <br> <br>
 
 
 
The History Report shows all information from the contact log. It is not possible to view the details of letters using this report. Items on the contact log cannot be edited or deleted using this report. <br> <br> <br> <br>
 
 
 
There are two other methods for accessing the contact log. Both of these methods involve using different pages in PARS: <br>
 
* Pupil information
 
* Contact reports <br> <br>
 
 
 
=Configuration=
 
 
 
==Emails==
 
 
 
In order to send emails, PARS needs to be given the SMTP details of your email server. These settings are entered into PARS via: <br>
 
System management > Preferences > Email <br> <br>
 
 
 
At the bottom of this section there is a Send Test Email link which you can use to test the details you have entered. We cannot tell you what these details are; if you do not know your SMTP details, you must find them yourself. <br> <br>
 
 
 
==SMS==
 
 
 
In order to send SMS messages you must have an account with TextAnywhere and enter those account details into PARS. If the details have not  been entered into PARS you will be able to select SMS as a method of contact. <br> <br>
 
 
 
[[Image:noSMSonGenerateBatch.jpg]] <br> <br>
 
 
 
The details of your TextAnywhere account are entered into PARS via: <br>
 
Contact management > Configure > Configure SMS <br> <br>
 
 
 
==Message Banks==
 
 
 
=Additional=
 
 
 
==FAQs==
 
 
 
===One or more of my templates is not available from the dropdown===
 
 
 
===I only see "Students" under the Recipients section of the Stage 1 tab===
 
 
 
===What date range is used for attendance data?===
 

Latest revision as of 11:42, 20 July 2018

PINs can be enabled in PARS for two factor authentication; the user must login using their SIMS or Active Directory details, then also enter a PIN. The PIN can either be a four digit number received by email and SMS, or a six digit TOTP generated by an authenticator app.

PINs can be disabled for login attempts from given IP address ranges. This allows you to use single factor authentication for logins within the school network and two factor authentication for all other logins.

Note that some configuration must be performed in PARS before it is able to send emails or SMS messages. See the Contacting Parents page for further information about the configuration required.

Enable PINs

The PIN settings for PARS are stored in the web.config file for the PARS site, on the PARS IIS server. The web.config file is found in the PARS installaion folder which is usually located:
C:\inetpub\wwwroot\PARS\web.config

The web.config file is in xml format and can be edited using Notepad or a similar text editor. To enable PINs in PARS, find the setting called "PINS" and change the value to "On" e.g.

<setting name="PINS" serializeAs="String">
      <value>On</value>
</setting>


Disable PINs internally

If you would like to disable PINs for a certain range of IP addresses, find the setting called "PIN_Exclude_IPs". Enter each IP address or range of IP addresses into the value, separated by semi colons.

You can specify a range of IP addresses using a subnet mask. The subnet mask must not be in 'classless' format e.g. 192.169.1.0/24 is not acceptable; you should use 192.169.1.0/255.255.255.0 instead.

The value field in the web.config file must not include line breaks.

Correct

<setting name="PIN_Exclude_IPs" serializeAs="String">
      <value>192.168.0.0/255.255.0.0</value>      
</setting>

Incorrect

<setting name="PIN_Exclude_IPs" serializeAs="String">
      <value>192.168.0.0/16</value>      
</setting>

Incorrect

<setting name="PIN_Exclude_IPs" serializeAs="String">
      <value>192.168.0.0/255.255.0.0
      </value>      
</setting>

You may enter multiple IP address ranges or single IP addresses by separating with a semi colon e.g.

<setting name="PIN_Exclude_IPs" serializeAs="String">
      <value>192.168.0.0/255.255.0.0;172.16.0.0/255.240.0.0</value>      
</setting>


PINs by TOTP

TOTP kep.png

The default method for delivering PINs to users is to send an email and a password containing their temporary PIN. PARS will use the user's mobile telephone number and work email address from SIMS.

The alternative is for users to download an authentication app. Users can request a key from the PARS login page which will be sent to them via email and SIMS. Once they have entered this key into their authentication app, they will be able to generate PINs using the authentication app without the need to receive emails and SMS messages.

To enable PINs in PARS, find the setting called "PINS" and change the value to "On" e.g.

<setting name="PINSBYTOTP" serializeAs="String">
      <value>On</value>
</setting>

Once TOTP PINs have been enabled, users will be able to collect a key for use in their authenticator app. To receive a key the user first needs to attempt to log in to PARS. They will then be prompted to enter a PIN and will also see a cog button. Clicking the cog button will sent a key to the user via email and SMS.

Troubleshooting

If you are experiencing trouble in disabling PINs for internal IP address ranges then enter "*log*" as the first item in the list of excluded IP address ranges e.g.

<setting name="PIN_Exclude_IPs" serializeAs="String">
      <value>*log*;192.168.0.0/255.255.0.0</value>      
</setting>

PARS will then log information in the Application Log of the IIS server on which PARS is installed. These logs will show which IP address was used during a login attempt and whether it matches any of the ranges that have been excluded.