Difference between revisions of "Test"

From PARS
Jump to navigationJump to search
Line 1: Line 1:
PARS can be used to contact parents for a variety of different reasons. Messages can be sent to parents as Emails, Letters or SMS messages. You can also type the details of telephone calls or meetings into PARS. All of this information is automatically stored in the PARS contact log for each student, and can also be written back to the SIMS Communication Log if desired. <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 which they will receive by email and SMS (where available).  
  
=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.
  
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>
+
PINs are enabled via the web.config file:  
 
+
There is a setting called PINS - this must be set to On
The following '''[[permissions]]''' are required to access the External Contact page: <br>
+
There is a setting called PIN_Exclude_IPs - this can include single IP addresses or IP address subnet masks. Each separated by a semi colon, and there must not a line break. You can enter *log* as the first item in the list to force PARS to write information back to the Application Log on the PARS server.
''Contact management > Access notices management screen'' (On) <br>
+
There is a setting called PINSBYTOTP - wtf does this do?
''Contact management > Manage and review external communications'' (On) <br> <br>
 
 
 
==For General Messages==
 
 
 
The page is simply accessed via: <br>
 
'''Main Menu > Contact Management > External contact''' <br> <br>
 
 
 
You can also click the External Contact button on the Quick Launch Bar at the top of PARS. <br>
 
[[Image:quick_launch_external_contact.jpg]] <br> <br>
 
 
 
The External Contact page can also be accessed via the '''Contacts''' tab of the '''[[Pupil information]]''' page. When using this method you will only be able to type the details of a conversation or meeting you have had with a parent. The Pupil Information page is accessed via the PARS quick launch bar: <br>
 
[[Image:quick_launch_pupil_information.jpg]] <br> <br>
 
 
 
==For Absence==
 
 
 
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>
 
 
 
==For Behaviour Incidents==
 
 
 
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 '''[[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>
 
 
 
==For Detentions==
 
 
 
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>
 
 
 
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>
 
 
 
==For Assignments (Homework)==
 
 
 
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>
 
 
 
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>
 
 
 
==For Low Attendance==
 
 
 
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>
 
 
 
Attendance Reports are accessed via: <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>
 
 
 
=Using the External Contact Screen=
 
 
 
==Batch send messages / batch generate letters==
 
 
 
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:'' <br>
 
*''There are some settings that will affect the options shown on this tab. If some options appear to be different or missing, see the [[#Frequently Asked Questions|Frequently Asked Questions section of this page]].''
 
*''If a parent has multiple email addresses, only their '''Main''' email address will be used.'' <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 [[#Message Banks|Message Bank section of 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>
 
 
 
==Sending single messages and recording phone calls==
 
 
 
[[Image:external_contact_page.jpg|thumb|The External Contact page]]
 
 
 
The External Contact screen has two 'modes'; the normal External Contact screen and the Batch Sending screen. If you can see three tabs labelled "Stage 1", "Stage 2" and "Stage 3 you are on the Batch Sending screen. Click '''Close''' at the top right to access the normal External Contact screen. <br> <br>
 
 
 
You will see a list of students on the left side of the page. The External Contact page shows the details of one student (and their parents) at a time. Click on a student's name on the left to view that student's details. <br> <br>
 
 
 
The student's own details are listed on the left side of the page, such as the student's email address and the student's mobile telephone number. These details are taken from Section 3 and Section 4 of the Student Details page in SIMS. On the right the student's parents' details are displayed. This information is taken from Section 5 of the Student Details page in SIMS. <br> <br>
 
 
 
===Send single message===
 
 
 
To send a message, find the email address or mobile telephone number you want to use and click the '''Email''' or '''SMS''' button next to it. This will open a window where you can compose your message. You can access the message bank by clicking '''Insert > Template'''. Click '''Send''' when finished. <br> <br>
 
 
 
===Record meetings or phone calls===
 
 
 
For telephone calls, find the telephone number that was used then click the '''Call''' button next to it. A window will appear in which you can type the details of your phone call. There is a '''Contact type''' dropdown near the top of the window. This is used to record whether the call was successful, or whether there was no answer, a voicemail was left, etc. <br> <br>
 
 
 
For meetings click the '''Ad-Hoc''' button next to the contact's name. A window will appear where you can type the details of the meeting. <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==
 
 
 
All emails, SMS messages and letters sent by PARS are automatically recorded on the student's contact log. Any telephone calls and meetings are also recorded on the contact log. <br> <br>
 
 
 
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 is the button that looks like a sheet of paper). 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, using the pencil and cross buttons. <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>
 
 
 
There are two other methods for accessing the contact log outside of the External Contact page. Contact Reports are available via: <br>
 
'''Main menu > Contact management > [[Contact reports]]''' <br> <br>
 
''Note the '''[[permissions]]''' needed to access Contact Reports are:'' <br>
 
''Contact management > Access notices management screen'' (On) <br>
 
''Contact management > Report on contacts made'' (On) <br> <br>
 
 
 
An individual student's contact log can also be viewed in the '''[[Pupil information|Pupil Information]]''' screen. This is accessed by clicking the '''Pupil Information''' button on the PARS quick launch bar. <br>
 
 
 
[[Image:quick_launch_pupil_information.jpg]] <br> <br>
 
 
 
=Configuration=
 
 
 
==Emails==
 
 
 
===SMTP details===
 
 
 
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>
 
'''Main menu > 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>
 
 
 
===Email replies===
 
 
 
By default email replies will be sent to the From Address listed in the email preferences (Main menu > System management > Preferences > Email). If you would like users to receive email replies to their own email address instead, each user will need the following '''[[permissions|permission]]''' enabled: <br> <br>
 
 
 
''Contact management > Use own email address as email reply address if available'' (On) <br> <br>
 
 
 
==SMS==
 
 
 
===SMS Account===
 
 
 
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 not be able to select SMS as a method of contact. <br> <br>
 
 
 
The details of your TextAnywhere account are entered into PARS via: <br>
 
'''Main menu > Contact management > Configure > Configure SMS''' <br> <br>
 
 
 
Clicking the '''here''' link on the Configure SMS page will take you to TextAnywhere's website. <br> <br>
 
 
 
===SMS replies===
 
 
 
Replies to SMS messages will be sent as emails. The reply emails can be sent to a central email address, to the person that sent the SMS, or both. To decide where the replies will be sent, go to: <br>
 
 
 
'''Main menu > System management > System > Automation''' <br>
 
''Note - to access this screen you need the following permissions:'' <br>
 
''Automation > Access automation control'' (On) <br>
 
''Automation > Setup automation jobs'' (On) <br>
 
''System management > Access PARS management options'' (On) <br> <br>
 
 
 
Click on the '''Jobs''' tab at the top of the page. You will see a list of the automatic tasks that PARS performs. Look for a row on this page called '''Check for, and send outstanding batch SMS messages'''. Click the Magnifying Glass next to this row. <br> <br>
 
 
 
Enable the '''Email originator''' option for the sender of the SMS messages to receive replies to their own email inbox. <br>
 
Enable the '''Email this address''' option for email replies to be sent to a central email address. You will also need to enter the email address you want  to use. <br> <br>
 
 
 
The '''Add details of SMS's''' option should be enabled. Also make sure that every day of the week is ticked. Once done, click '''OK'''. <br> <br>
 
 
 
==Message Banks==
 
 
 
PARS allows the use of Message Banks so that you can pre-configure message templates to be used on the External Contact page. <br> <br>
 
 
 
The Message Banks are accessed via: <br>
 
'''Main menu > Contact management > Configure > Email / SMS / Letter message bank''' <br>
 
''Note to access these screens you need the following permissions:'' <br>
 
''Contact management > Access notices management screen'' (On) <br>
 
''Contact management > Allow access to contact management comment bank'' (On) <br> <br>
 
 
 
All existing message templates will appear on the screen. Click the '''Add''' button to create a new message template. <br> <br>
 
 
 
A Compose Message window will open in which you can type your message. You can add merge fields to your message by clicking '''Insert > Field > ...'''. Images can be added to Email or Letter templates by clicking '''Insert > Image'''. <br> <br>
 
 
 
=Frequently Asked Questions=
 
 
 
==One or more of my templates is not available when composing a message==
 
 
 
This will happen if your template contains merge fields that are not valid for the type of message you are sending. For example, your template may contain the merge field <nowiki>{{TYPE}}</nowiki>. This field refers to the type of detention that a pupil has been given. Therefore it does not make sense to use this template message unless you are sending a message about detentions. <br> <br>
 
 
 
So if your template is not available, it is for one of the two following reasons: <br>
 
*You have an incorrect merge field in your template. Edit the template and remove the offending merge field(s). See the [[#Message Banks|Message Banks section of this page]] for information regarding the configuration of Message Bank templates.
 
*You are accessing the External Contact page using the wrong method. See the [[#Accessing the External Contact screen|Accessing the External Contact screen section of this page]] for further instructions. <br> <br>
 
 
 
==Some options are missing from the Stage 1 tab when sending a batch message==
 
 
 
You may find that some options are missing from either the Recipients section or from the Method section. <br> <br>
 
 
 
<span style="font-size:120%">'''Recipients'''</span> <br>
 
[[Image:external_contact_batch_contacts.jpg|thumb|The Recipient options when sending a batch message]]
 
 
 
Up to four options can be shown in this section. Your permissions define which options are shown here. "Students" will always be visible in the Recipients section. This option is used to contact the students themselves. The additional three options are controlled by permissions. <br> <br>
 
 
 
'''Priority 1 contact with Parental responsibility''' <br>
 
The '''[[permission]]''' needed to access this option is: <br>
 
''Contact management > User can contact highest priority parent'' (On) <br> <br>
 
 
 
'''Priority 1 contact regardless of Parental responsibility''' <br>
 
The '''[[permission]]''' needed to access this option is: <br>
 
''Contact management > User can contact highest priority contacts'' (On) <br> <br>
 
 
 
'''All contacts with Parental responsibility''' <br>
 
The '''[[permission]]''' needed to access this option is: <br>
 
''Contact management > User can contact all parents'' (On) <br> <br>
 
 
 
<span style="font-size:120%">'''Method'''</span> <br>
 
[[Image:external_contact_batch_method.jpg|thumb|The Method options when sending a batch message]]
 
 
 
The Letter option will always be available. Any of the options involving Email or SMS may be hidden for the following reasons. <br> <br>
 
 
 
'''Email''' - The user does not have sufficient permissions <br>
 
The '''[[permission]]''' needed to access this option is: <br>
 
''Contact management > Prevents user from sending emails'' (Off) <br> <br>
 
 
 
'''SMS''' - The user does not have sufficient permissions <br>
 
The '''[[permission]]''' needed to access this option is: <br>
 
''Contact management > Prevents user from sending SMS messages'' (Off) <br> <br>
 
 
 
'''SMS''' - PARS has not been given the details of your TextAnywhere account, used to send emails <br>
 
You need to create an account with TextAnywhere and enter the account details into PARS in order to send SMS messages. See the [[#SMS Account|SMS Account section of this page]] for more information. <br> <br>
 

Revision as of 10:26, 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 which they will receive by email and SMS (where available).

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.

PINs are enabled via the web.config file: There is a setting called PINS - this must be set to On There is a setting called PIN_Exclude_IPs - this can include single IP addresses or IP address subnet masks. Each separated by a semi colon, and there must not a line break. You can enter *log* as the first item in the list to force PARS to write information back to the Application Log on the PARS server. There is a setting called PINSBYTOTP - wtf does this do?