Difference between revisions of "Synchronisation rules"

From InsightWiki
Jump to navigation Jump to search
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
 +
Synchronisation rules are used by Insight to determine which parents and/or students should be given Insight accounts and which Role (set of permissions) should be applied to their account. The roles themselves are configured via the '''[[Roles]]''' page. <br> <br>
  
Synchronisation rules are used by Insight to determine which role a parent/student should be placed in. Students may require different roles because of the year group they are in. Parents may require different roles because of their Priority level, whether or not they have Parental Responsibility, whether or not there is a Court Order against them, etc. <br> <br>
+
=Students=
  
The Synchronisation Rules page is used to configure the rules that tell Insight which role(s) should be applied to each user. The roles themselves are configured via the [[Roles]] page. <br> <br>
+
In order for students to log in to Insight, you must have purchased the '''[[AD links|AD Links]]''' additional module for Insight. This allows students to log in using their Active Directory details. <br> <br>
  
==The Synchronisation Rules page==
+
You can create multiple Synchronisation Rules if required. This allows you to assign different roles to students, depending on which year group they are in. If you want all students to use the same Role then you only need one Synchronisation Rule, otherwise you need one Synchronisation Rule per Role you want to use. <br> <br>
  
The page is split across two tabs, one for parents and another for students. The rules for parents are more complex than those for students. <br> <br>
+
Select a Synchronisation Rule then click the '''Edit''' button to edit that rule, or click '''Add''' to create a new rule. This will take you to a new page. Select the year groups that this rule should apply to, then at the bottom of the page select the Role to be given to the students. Click '''Save''' once done. <br> <br>
  
<div>[[Image:sync_rules.jpg]]</div> <br> <br>
+
=Parents=
  
==How the Rules Work==
+
[[Image:parental_sync_rules_list.png|thumb|A list of Synchronisation Rules for parental accounts]]
  
Each parent/contact in the SIMS database could be linked to one or more pupils e.g. a Dad has a son and a daughter at school. This represents two contact-pupil links; Dad-Son and Dad-Daughter. Each contact will have a maximum of one account which can be linked to multiple pupils. <br> <br>
+
Parents may need to be given different roles depending on the year group that their child is in e.g. a parent of a Year 13 student may need to see more options (such as exam data) in Insight than a parent of a Year 7 student. <br> <br>
  
The process Insight uses to create users is called a Sync. The Sync will check each contact-pupil link to see what role (if any) should be applied. A role is a set of permissions that determines what information/menu items the contact can see when viewing that particular pupil. This means a contact's account could have multiple roles applied to it i.e. Dad is given a Full Access role when he is viewing his daughter and a Limited Access role when viewing his son. <br> <br>
+
Parents may also need to be given different Roles because of their relationship to students. For example, a contact who has Parental Responsibility but also has a Court Order against them may need a limited access Role. <br> <br>  
  
Each of the Synchronisation rules has criteria and a Role. If a contact-pupil link meets the criteria for the rule, then the Role is applied to the contact-pupil link. <br> <br>
+
Click the '''Edit''' button or '''Add''' button to edit or create a rule. <br> <br>
  
===Example===
+
If a parent has more than one child at school then more than rule may apply to them, one rule per child. This means that a parent may have a different Role for each of their children. See the '''[[#Example|example]]''' below for more information. <br> <br>
 +
 
 +
===Parental Options===
  
The Ordinal value of the rule is shown in red, the criteria in green and the role in blue. <br> <br>
+
When editing/creating a rule, you must select the '''Highest priority''' and '''Lowest priority'''. A parent's Priority number from SIMS must fall between this range in order for the rule to apply to them. <br> <br>
  
<div>[[Image:sync_example.jpg]]</div> <br> <br>
+
For the following three options you can choose '''Yes''' (parents must have this attribute), '''No''' (parents must not have this attribute) or '''na''' (it does not matter whether parents have this attribute): <br>
 +
'''Parental Responsibility''' <br>
 +
'''Court Order''' <br>
 +
'''Cohabitation''' <br> <br>
  
Dad's relationship with children
+
===Example===
{|
+
 
 +
Imagine a parent has two children at school with the following details in SIMS:
 +
{| class="wikitable"
 
!Relationship!!Priority!!Parental Responsibility!!Court Order!!Cohabiting
 
!Relationship!!Priority!!Parental Responsibility!!Court Order!!Cohabiting
 
|-
 
|-
 
|Daughter||1||Yes||No||Yes
 
|Daughter||1||Yes||No||Yes
 
|-
 
|-
|Son||2||Yes||No||No
+
|Son||9||Yes||Yes||No
 
|} <br>
 
|} <br>
  
Each contact's relationship with a pupil will be checked against the rules when a Sync is run. If there is a parent at school
+
And you have the following rules configured in Insight: <br>
 +
[[Image:parental_sync_rule_example.png]] <br> <br>
 +
 
 +
The parent's relationship with the daughter meets all the criteria of the first rule; the parent is the Priority 1 contact and does not have a Court Order. Therefore the parent will have the "Full Access" role when viewing the daughter. <br> <br>
  
==Creating and Editing rules==
+
The parent's relationship with the son does not meet the criteria for the first rule. The parent does not have the sufficient Priority level and also has a Court Order. The parent's relationship with the son does meet the criteria for the second rule though, so the parent will have the "Limited Access" role when viewing the son. <br> <br>
  
[[Category:Configuration]]
+
The rules at the top of the list take priority over those lower down, so if a parent meets the criteria for multiple rules for one of their children, they will always be given a role by the highest rule on the list that applies to them. <br> <br>

Latest revision as of 11:31, 24 May 2018

Synchronisation rules are used by Insight to determine which parents and/or students should be given Insight accounts and which Role (set of permissions) should be applied to their account. The roles themselves are configured via the Roles page.

Students

In order for students to log in to Insight, you must have purchased the AD Links additional module for Insight. This allows students to log in using their Active Directory details.

You can create multiple Synchronisation Rules if required. This allows you to assign different roles to students, depending on which year group they are in. If you want all students to use the same Role then you only need one Synchronisation Rule, otherwise you need one Synchronisation Rule per Role you want to use.

Select a Synchronisation Rule then click the Edit button to edit that rule, or click Add to create a new rule. This will take you to a new page. Select the year groups that this rule should apply to, then at the bottom of the page select the Role to be given to the students. Click Save once done.

Parents

A list of Synchronisation Rules for parental accounts

Parents may need to be given different roles depending on the year group that their child is in e.g. a parent of a Year 13 student may need to see more options (such as exam data) in Insight than a parent of a Year 7 student.

Parents may also need to be given different Roles because of their relationship to students. For example, a contact who has Parental Responsibility but also has a Court Order against them may need a limited access Role.

Click the Edit button or Add button to edit or create a rule.

If a parent has more than one child at school then more than rule may apply to them, one rule per child. This means that a parent may have a different Role for each of their children. See the example below for more information.

Parental Options

When editing/creating a rule, you must select the Highest priority and Lowest priority. A parent's Priority number from SIMS must fall between this range in order for the rule to apply to them.

For the following three options you can choose Yes (parents must have this attribute), No (parents must not have this attribute) or na (it does not matter whether parents have this attribute):
Parental Responsibility
Court Order
Cohabitation

Example

Imagine a parent has two children at school with the following details in SIMS:

Relationship Priority Parental Responsibility Court Order Cohabiting
Daughter 1 Yes No Yes
Son 9 Yes Yes No


And you have the following rules configured in Insight:
Parental sync rule example.png

The parent's relationship with the daughter meets all the criteria of the first rule; the parent is the Priority 1 contact and does not have a Court Order. Therefore the parent will have the "Full Access" role when viewing the daughter.

The parent's relationship with the son does not meet the criteria for the first rule. The parent does not have the sufficient Priority level and also has a Court Order. The parent's relationship with the son does meet the criteria for the second rule though, so the parent will have the "Limited Access" role when viewing the son.

The rules at the top of the list take priority over those lower down, so if a parent meets the criteria for multiple rules for one of their children, they will always be given a role by the highest rule on the list that applies to them.