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

Twig: Rostering with Clever

 

In this guide we will look at how to roster and onboard your district using Clever:

Connecting Clever with Twig Science

The Twig Science platform supports integration with Clever for both:

  • Instant Login (SSO)
  • Secure Sync (Rostering)

 Note

Before we begin, you should be either piloting or have an active subscription for Twig Science, and be set up on Clever. For information on how to set up Clever, before adding Twig Science as an application, please go to: Clever Support: Setting up Clever

Set up the Twig Science app in Clever

Adding the Twig Science App to your dashboard:

  1. Log in to Clever.
  2. Visit this URL to connect to Twig Science: https://schools.clever.com/applications/add/twig-science
  3. Select Already purchased and click the Request button.
  4. At the next step, select Request and share later.
  5. Use the following link to add Twig Science as an application: https://schools.clever.com/applications/add/twig-science or navigate to Applications, click on Twig Science then Edit sharing under the Shared Data panel.

Setting up sharing rules

  1. Setup an appropriate data sharing rule to only share the students who require access to Twig Science.
  2. Watch this video from Clever for details on how to setup sharing rules.

     Recommendation

    Keep in mind that sharing all district data may push you over your license limit. The number of students shared will need to be less than or equal to the number purchased.

Initiating the sync

  1. Once you have set up sharing rules we will receive notification of your request to connect. It may take us up to 24hrs to process your request.
  2. On connection, we will run an initial sync (unless you request otherwise), and will let you know when this is completed. Subsequently, automatic syncs will take place every night. 

Testing the sync

Use the Clever data browser to test the sync has been successful. Use Clever data browser to log in as a teacher and a student. 

Clever Instant Login (SSO)

Clever Instant Login allows your users to use their Clever login (or badge) to sign into the Twig Science platform. You can do this via your Clever dashboard, or from the Twig Science login page.

We support the following roles:

Students, Teachers and Administrators

Students, teachers and administrators will be able to access the Twig Science application from their Clever dashboard, by pressing on the Twig Science application icon. As a result they will be automatically logged in the Twig Science application.

District Account Owner

Twig Science will provide the district with a single non-Clever user account: District Account Owner. This account will be able to trigger on-demand Clever syncs. Please contact Twig Science if you have not been provided with a District Account Owner login. 

Clever Secure Sync (Rostering)

Twig Science supports Clever Secure Sync to create and manage user records in the platform. This section outlines the data sharing requirements and synchronization options.

Data Access & Sharing Permissions

Twig Science will request access and will sync the following data via Clever:

Students Teachers Sections/classes Schools

Mandatory fields:

  • clever_id
  • name_first
  • name_last

Optional fields:

  • sis_id
  • state_id
  • student_number
  • name_middle
  • email

Synchronization

There are two ways to sync with Twig Science:

  • Automated Nightly Sync: Twig Science will sync with Clever every night at approximately 12:00 AM PT. Any new records that are not found in Twig Science will be added. Updates will be done for existing records. 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 Clever-Twig Science sync. Use your District Admin user account to trigger a sync.

Step by step guide to managing and triggering on-demand syncs

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

Discover how to trigger a sync with our interactive step by step guide below.

14 STEPS

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

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

Click on 'Begin' to start the guide.

Step 1 image

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

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 log in with Clever or Classlink.

Step 4 image

5. Click 'Log in'.

Step 5 image

6. This is your Admin Dashboard.

You can see the latest sync status displayed here.

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/2166497/Twig-Science---Clever-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

Articles in this section