iSAMS: what to do when data is not being imported

NOTE: In addition to the information below, please note that there will be a delay between you changing the data in iSAMS and those changes being available to sync with SchoolCloud Parents Evening via the iSAMS API. The length of this delay depends on what you have set as the value for the API Key Cache Expiry. We recommend that you set it to 1 hour, rather than the default 24 hours.

Student

If students are not being brought across, please ensure that they have: 

  1. A class which has an assigned teacher.
  2. A date of birth
  3. A year group (eg Year 6)

Parent

If a parent is not being brought across, please ensure that they have:

  1. The contact shows in the iSAMS API. Depending on your API key's settings, the contact types shown may differ. This can be edited at a later date in the API key's methods.
  2. A title (eg Mr, Mrs, Dr), forename and surname. Full stops are removed from the title during the iSAMS sync.
  3. Either:
    • If the parent lives with the student, enable the "Student Home" option. This is indicated by a star icon next to the account in iSAMS. 
      As long as there is something in the parent's "RelationshipRaw" field, they will be pulled through regardless of their type of relationship. 
    • In cases where the parent doesn't live with the student, disable the "Student Home" option. 
      Parents will only be pulled through if their "RelationshipRaw" field starts "Mother", "Father", "Guardian" or "Step". This is so we match relationships like "Stepfather".
  4. (Optional) If you wish to pull in the email addresses for the contacts, please ensure that the email address field has been filled in on the parent's record.

Teacher

If the teacher is not being brought across, please ensure they have:

  1. A title (eg Mr,Mrs,Dr), forename and surname. Full stops are removed from the title during the iSAMS sync.
  2. At least one class assigned.
  3. (Optional) An email address - which will be used as the email of their record on SchoolCloud.

Class/Heads

We check for different kinds of classes in the iSAMS API and currently bring across the following (as long as they have assigned teachers):

  • Sets
  • Forms
  • Year Heads
  • House Heads
  • Boarding House Heads
  • Teaching Forms (both the Form Assistant and Secondary Assistant, if one is set, are brought across)
  • Personal Tutors

Groups

We check for the following groups in the iSAMS API. These groups just contain students and will only appear as part of the student filter when creating an evening or event:

  • House Groups
  • Boarding House Groups
  • Division Groups
  • Custom Pupil Group

Still need help? Contact Us Contact Us