How Do I Connect to Kimono with the PowerSchool SIF Agent?

Document created by Mike Cotterman Employee on May 10, 2017Last modified by Erin Hallmark on Sep 13, 2017
Version 14Show Document
  • View in full screen mode

If you are here you are most likely trying to figure out how to connect your PowerSchool SIF agent to Kimono, so you can import that data into Canvas. Right? If so, then you are in the right place. If not then...well...you are not in the right place. Please try searching again!

 

You might be asking yourself "What exactly is SIF?" The short answer is that SIF is a standard developed by Access 4 Learning (A4L) to help learning and education tools have a common language, so they can share information. Different education tool vendors support various levels and versions of SIF. We support SIF version 2 via our partnership with Kimono. Still want more information? Check out some of the introductory resources on the A4L SIF site (you might want to check out the SIF 101 video in the Videos section for a basic introduction).

 

Confused? Don't be! You don't really need to know how SIF works to get PowerSchool connected to Canvas with SIF. You just need to know the stuff in this guide and perhaps some of the links to PowerSchool resources.

 

Step 1

 

The first thing you need to do is get the ZIS connection information from your CSM or IC if you do not already have it. You need the ZIS URL and the Zone ID to get started. Don't have this information? Just ask your CSM or IC for it. I'll wait...

 

BTW: If you are already connected to Kimono for other reasons you can skip straight to Step 5 if you are locally hosted and if you are hosted by PowerSchool you only need to let support know about the changes to the configuration that are needed.

 

Step 2

 

You now need to know if you are hosting PowerSchool on your own servers (virtual or physical) or if you are hosted by PowerSchool.

(Hint: If your PowerSchool URL ends with powerschool.com then you are hosted by PowerSchool)

 

Click the relevant link below to continue

 


 

 

 

 

 

Self Hosted PowerSchool

 

Step 3 (Local)

 

The next part of the install requires that you install the PowerSchool SIF agent if you do not already have it installed.

 

You can download the most recent PowerSchool SIF agent from the PowerSource web site if you have proper access. The links below link directly to the SIF agent area of PowerSource at the time this guide was last updated (May 10, 2017). However, it is possible that there is a more recent version or different location that has been released since this article was last updated. You should install the most up to date version of the SIF agent unless you are required to use an older version for some reason.

 

 

If you need assitance installing or updating the PowerSchool SIF agent please contact PowerSchool support. You can find contact information for the PowerSchool Data Solutions team on the documentation link for the SIF agent when you click the link above.

 

If the links are not working for you please contact PowerSchool support for assitance. It is possible the link has changed or your PowerSource account does not have access to the SIF agent and documentation.

 

Step 4 (Local)

 

You now need to connect the SIF agent to the ZIS. This may be part of the installation process if you have just installed the SIF agent or you may need to refer to the PowerSchool SIF agent documentation for assitance on how to add the connection to an existing ZIS server.

 

Either way, here is the information you will need:

  • ZIS URL (from Step 1)
  • Zone ID (from Step 1)
  • Mode: Pull
    • Very important. Push mode will not work!
  • Method: HTTP
    • Use HTTP method if this is your only ZIS connection. The https:// in your ZIS URL will still connect your agent to the ZIS using HTTPS.
    • If you must use the HTTPS method then you will need to add the Kimono certificate to your Java trusted certificates or you will receive an error when you attempt to connect. The necessary SSL certificate is the same certificate used to secure Kimono's website.

 

Step 5 (Local)

 

Modify your agent.cfg to add a couple of extra fields to the data you are sending via SIF. A document containing information on these changes can be found in the Attachments section of this article.

 

After you have made the needed changes please restart your SIF agent for them to take effect.

 

Step 6 (Local)

 

When you have gotten to this point please let your IC or CSM know that you should be all set and we can test out the connection.

 

That is it for setting up the SIF agent! If there are any issues your IC or CSM will let you know and we can troubleshoot from there.

 

Click here for information on setting up grade pass back.

 


 

 

 

 

 

PowerSchool Hosted

 

Step 3 (Hosted)

 

To get the SIF agent setup and configured you will need to open a ticket with PowerSchool hosting support requesting that they setup your SIF agent and connect it to Kimono. Please send then the following information in your ticket:

 

  • ZIS URL (from Step 1)
  • Zone ID (from Step 1)
  • Mode: Pull
    • Very important. Push mode will not work!
  • Method: HTTP
    • Use HTTP method if this is your only ZIS connection. The https:// in your ZIS URL will still connect your agent to the ZIS using HTTPS.
    • If you must use the HTTPS method then you will need to add the Kimono certificate to your Java trusted certificates or you will receive an error when you attempt to connect.
  • The SIF mappings document in the Attachments section of this article.
    • This document contains some changes that need to be applied to your SIF agent config.

 

Step 4 (Hosted)

 

Once you receive confirmation from PowerSchool that your SIF agent is ready to go please let your IC or CSM know and we can test out the connection.

 

That is it for setting up the SIF agent! If there are any issues your IC or CSM will let you know and we can troubleshoot from there.

 

Click here for information on setting up grade pass back.

 


 

 

 

 

 

Grade Pass Back Information

 

We provide the option to setup teacher initiated grade pass back for PowerTeacher. Please click the relevant link below for information on the next steps for setting up the connect for grade pass back.

 

  • PowerTeacher Gradebook (legacy)
    • To get started you will need to install the PowerSchool plugin, then work with your CSM or IC to finish setting up the connection.
  • PowerTeacher Pro [Not currently available. This option is in development and testing]
  • Both - Possible, but not recommended. Please talk to your CSM or IC for information.

 


 

 

 

 

Outcomes