eSchoolPLUS Integration: Admin Provisioning App (Enterprise)

Follow

Overview

Schoology has developed a Student Information System (SIS) integration platform that enables Schoology to integrate with any SIS that provides a web services API. The integration provides a seamless method for keeping Schoology populated with users, courses, school, and enrollment data. It also provides the ability for Schoology to transfer grade and assignment data into eSchoolPLUS, with the ability to configure grade settings to ensure grade calculations match between both systems. The integration app can be installed to School Admins accounts (for use in provisioning user, course, school, and enrollment data) and also installed into Courses (for use in allowing teachers to sync grades).

eSchoolPLUS version 3.0 or higher is required in order to use the Schoology eSchoolPLUS app to provision your users, courses and enrollments.

The eSchoolPLUS app, when installed for School Admins, will be used to map and customize how the integration will work. This app will need to be set up for Schools/Districts before data syncing can begin.

Click here for a visual representation of the data flow between Schoology and eSchoolPLUS.

Note: Before getting started with the Schoology-eSchoolPLUS integration, you will need to reach out to your eSchoolPLUS rep to receive access to the eSchoolPLUS API. This installation is required and managed by eSchoolPLUS who typically charge an API access fee. 

Configuration

Admins will first need to obtain their API credentials from eSchoolPLUS before they can begin the setup process. This includes information on eSchoolPLUS Domain, Site Code, Login Name, and Password.

When you launch the Admin App, you will be brought to the configuration area where you can enter your API credentials to connect to eSchoolPLUS, and also to adjust data syncing options between eSchoolPLUS and Schoology.

eSchoolPLUS Sync Timing Options

Use eSchoolPLUS Sync Timing Options to:

  1. Choose whether the sync between eSchoolPLUS and Schoology is manual or scheduled, and set the frequency of the sync. 
    • Manual: The Acting User must manually sync the eSchoolPLUS app in Schoology.
    • Scheduled: If you select Scheduled,  select Daily as the frequency of the scheduled sync. This setting automatically provisions users, courses, sections, and enrollment from eSchoolPLUS into Schoology at the designated time. You may also navigate to the respective tabs in the app and manually sync users, courses, or sections and enrollment at any time.
      Note: The date and time scheduled for the eSchoolPLUS sync is the time your data will be added to the queue, not the time the sync will be completed. For example, if you select 12am -3am, that job will be queued at 12am, and then will execute once the jobs get to the top of the queue.
  2. Live Sync Schoology Grades with eSchoolPLUS: Sends graded items and grades from Schoology to eSchoolPLUS. This feature is a live update from Schoology to eSchoolPLUS. Graded items and grades created and/or updated in Schoology will be created and/or updated in the eSchoolPLUS Gradebook. 
    Note: When Live Sync Schoology Grades with eSchoolPLUS is enabled, deleting an assignment in Schoology also deletes the assignment in eSchoolPLUS. If this result is undesirable, disable the Live Sync option and use eSchoolPLUS course-level app to sync grades manually.
  3. Save Sync Options to save your settings. You can also change the settings at any time by re-saving the sync options.
    Note: Changing the time of your scheduled sync or initiating a manual sync resets the window of time until the next sync. For example, pushing a manual sync of Users at 2pm on Monday causes the scheduled sync to wait 24 hours after the manual sync plus the time to the configured scheduled sync (e.g. 12a-3a). Therefore, the next scheduled sync of all data would occur on Wednesday after 12am. This one day grace period prevents any issues with overlapping syncs of the same provisioning data.

Schoology Acting User

To make any changes to the eSchoolPLUS app, you must be the Acting User for the app and a Schoology System Administrator for your organization. The Acting User sees the following message displayed in the Schoology Acting User area:

If you don't see this message, click the button to make yourself the Acting User for your account.

Schools

In the Schools tab, you can map eSchoolPLUS Schools to the appropriate Schoology School/Building. This allows you to decide from which schools you want to sync data. 

 

Terms

In the Terms tab, you can map the eSchoolPLUS terms to the appropriate Schoology Grading Periods. If you do not have Grading Periods set up in Schoology, you can use the app to automatically create new ones.

Data Prep

It is highly recommended that you work with your Schoology representative on the data prep process. This step is used to sync eSchoolPLUS data with any existing users, courses, or sections in Schoology to ensure that no duplicates are created upon syncing for the first time.

Users

In the Users tab, you can select from which buildings to sync users. 

Note: Once users are created in Schoology by the sync, any updates to their account information must be made in eSchoolPLUS. However, user accounts cannot be deleted in Schoology by deleting the account in eSchoolPLUS. If a user leaves your organization, you will need to remove their account in both systems. Learn more about marking users inactive in bulk on Schoology.

Courses

In the Courses tab, you can select from which buildings to sync courses. 

Note: Once courses are created in Schoology by the sync, any updates to course information must be made in eSchoolPLUS. However, courses cannot be deleted in Schoology by deleting the course in eSchoolPLUS; you will need to delete the course in both systems. Learn more about bulk deleting Courses in Schoology.

Sections

In the Sections tab, you can select from which buildings to sync course sections.

Logs

In the Logs tab, you will have access to see a log of all of the sync activity that the app performs. This will let you check on the status of the syncs and help you troubleshoot any errors.

 


Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk