1. Imagine Classroom
  2. Twig Science
  3. Administration & Rostering
  4. Rostering Management

Twig: Rostering with Classlink

In this guide we will look at how to roster and onboard your district using Classlink.

The Twig Science platform supports integration with Classlink for both:

  • ClassLink OneClick (SSO)
  • ClassLink Roster Server / OneRoster API (Rostering)

 Permission

Before we begin, you should be either piloting or have an active subscription for Twig Science, and be set up on Classlink.

For information on how to set up Classlink, before adding Twig Science as an application, please go to: Classlink: Getting Started

Before you can connect to Twig Science, please:

  1. Setup our application in Roster Server (OneRoster API)
  2. Setup our Classlink OneClick application (i.e. Adding app to Launchpad)
  3. Sync and test the integration

Roster server set up

  1. Log in as a Classlink Administrator to https://launchpad.classlink.com/DISTRICTNAME
  2. Select Classlink Roster Server.
  3. Log in to ClassLink Roster Server.
  4. Select Apps from the left-hand navigation bar.
  5. From the Applications screen, select Add a new app in top right hand corner.
  6. Search for Twig Science and click Add.
  7. Setup  your data sharing rule. You should only share students who require access to Twig Science. 
  8. We will  then be notified you wish to connect to us. It may take us a day or so to accept your invitation. 
  9. On connection, we will run an initial sync (unless you request otherwise) and will let you know when this is completed. Once we've ran the initial sync, data will be synced on a nightly basis. 

 Note

We do not require access to Unenrolled Users or Demographics. See this help article Applications: Adding Applications & Modifying Permissions from Classlink for more information. Sharing all district data may push you over your license limit.

OneClick SSO set up

 Recommendation

Please sync data with Twig Science and test a student and teacher login before making the OneClick app available to all users.

  1. Log in as a ClassLink Administrator to LaunchPad and navigate to: ClassLink Management Console.Picture 4.png
  2. Go to Applications - Add & Assign Apps - App Library.Picture 6.png
  3. Search for Twig Science and click Add.Picture 7.png
  4. The app will now appear in the Add & Assign Applications screen.
  5. Search for Twig Science again.Picture 8.png
  6. Use the Assign button to make the app available to the relevant teachers/students/classes who should have access to Twig Science. This Classlink help video explains this step in more detail.

Sync & test the integration

Once you connect your Roster Server app with us, we’ll run an initial sync. If your data changes significantly between the rostering setup and implementing the Launchpad App, we recommend you run an on-demand sync beforehand to ensure the rostering data is fresh.

When setting up your OneClick Launchpad App, we recommend that you use the Impersonate user function for a selection of teachers and students who should have access to Twig Science to confirm they can log in successfully.

Synchronization

There are two different ways to sync data with Twig Science:

  • Automated Nightly Sync: Once connected, Twig Science will sync with Roster Server every night at approximately 01:00 AM PT. Any new records that are not found in Twig Science will be added. Missing records will be deactivated in Twig Science.
  • On-Demand Sync: The District Account Owner can trigger an on-demand sync if an update is needed sooner than the automatic nightly sync.

Manually sync data on-demand

You can manually sync data at any time using your district admin credentials.

  1. Log in to Twig Science using the following:
  2. Go the the left hand menu and select Manage then Integrations.Screenshot 2022-11-09 at 11.36.png
  3. Now click Sync now. Screenshot 2022-11-09 at 11.37.png
  4. The sync will start to run, please note it may take up to 30 minutes.Screenshot 2022-11-09 at 11.37.24.png

A Beginner's Guide to Managing and Triggering Syncs

If your district is rostered via Classlink, you can manage and trigger syncs from your district admin dashboard. Discover how to trigger a sync with our interactive step by step guide below.

14 STEPS

1. Welcome to our Classlink Rostering Self-Service Sync Guide!

Follow these simple steps to start and monitor a Classlink on-demand sync.

Click on 'Begin' to start the guide.

Step 1 image

2. Navigate to https://app.twigscience.com/login and click 'District ID'.

Enter your District ID. In this example we are using SELFSERV. Please check with your Customer Success Manager if you're unsure what your District's ID is.

Step 2 image

3. Type in your District ID and click 'Next'.

Step 3 image

4. Type in your District Admin Username and Password.

Note: District Admins cannot login with Clever or Classlink.

Log in with Google is supported.

Step 4 image

5. Click 'Log in'.

Step 5 image

6. This is your Admin Dashboard.

Here you can see the status of your district’s last sync.

You can also access Assessment Reports and Integrations.

Step 6 image

7. To start an on-demand sync, click on the Integrations button.

Step 7 image

8. This is the Integrations page. It will display a list of all recent syncs, scheduled or on-demand, the sync date, started by, and the status.

Note: Scheduled syncs are ran on a automatic nightly basis.

Step 8 image

9. To start an on-demand sync click 'Sync Now'.

Step 9 image

10. The sync will now run and may take up to 30 minutes to complete.

Click Okay to dismiss this notification.

Step 10 image

11. Your sync will now display the status of 'processing' .

The status of your sync will display in real-time, you do not need to refresh your page.

Once complete, you will normally receive a 'Successful' message.

Step 11 image

12. If a sync should fail, you'll see the error message 'Failed' as displayed here.

Should this happen, please reach out to your Customer Success Manager for further support.

Step 12 image

13. Your sync is now complete. Any new users or amendments will be added to your Twig Science Roster.

Step 13 image

14. Guide complete!

Thank you for using our Support Center resources.

Step 14 image

** Best experienced in Full Screen (click the icon in the top right corner before you begin) **

https://www.iorad.com/player/2167960/Twig-Science---Classlink-Rostering-Self-Service-Sync-Guide

Enabling Google Classroom Single Sign On

You can allow users to log in using Google credentials simply by using Google email addresses in your users.csv file. In the users.csv file  simply add google email addresses to the "email" column.

This will allow users to log in here.
rtaImage.jpeg

 Note

Google Workspace for Education

If your district uses Google Workspace for Education, you will need approve the Twig Science app on your Google Console first. Please read Google's guide: Control which third-party & internal apps access Google Workspace data

User roles

Twig Science has the following user roles, but only certain ones are supported for rostering and OneClick integration:

Students
Students can access the Twig Science application from their LaunchPad, by pressing on the Twig Science application icon.
Teachers and Administrators
Teachers and administrators are supported for rostering and can access the Twig Science application from their LaunchPad, by pressing on the Twig Science application icon.
District Account Owner
We will provide your district with a District Account Owner account which is not supported by rostering or OneClick integration. You will be supplied with credentials during onboarding. This account will be able to trigger on-demand Roster Server syncs.

Articles in this section