Discover how you can create a FACTS integration access with School Passport.
In this article
Important:
RenWeb/FACTS charges schools an annual fee of $500 for API connection. Alternatively, GG4L can access roster data from FACTS in CSV format via a remote SFTP server. If you prefer to use SFTP, please follow the instructions for Setting Up SFTP Import App.
School Passport supports Secure Data Sync with a wide range of the district's student information systems (SIS). One of them is FACTS SIS. FACTS is administrative software that should be a helpful tool. FACTS provides tools and solutions to private K-12 schools that elevate the education experience for administrators, teachers, and families.
To configure data sync with Synergy, perform the following steps:
Get FACTS API credentials
To obtain API (OAuth) credentials:
- Sign in to your FACTS account.
- Navigate to System > Configuration > Integrations > OneRoster > API Export.
- Complete the form and submit it.
Once your request is submitted, the FACTS Support Team will contact you with your API credentials.
Setup FACTS app on School Passport
To integrate FACTS SIS with School Passport, add the FACTS app from the gallery and configure it.
Add the FACTS app from the gallery
- Sign in to your School Passport.
- Go to Connect > Application Gallery.
- Type "FACTS" in the search box.
- Select FACTS from the results panel.
- Click Activate. Wait a few seconds while the app is added to your environment.
Configure FACTS app
- In the Delivery Config, enter your API credentials:
- Service URL:
https://cfapi.renweb.com
-
Client ID: Enter the Client ID that you received from the FACTS Team.
- Client Secret: Enter the Client Secret that you received from the FACTS Team.
- Service URL:
- (Optional) Click Advanced Settings:
- SIS ID prefix: If multiple data sources of the same type are used, add a prefix to avoid merging entities with equal SIS IDs.
- Bulk Upload Mode: Select to detect deleted records by comparing them with the previous upload.
- Data will be uploaded from multiple data sources: Select if uploading data from multiple sources (e.g., SIS and Active Directory). Leave clear if it uses a single source (e.g., SIS only).
- Compare records accordingly to the Domains of Uniqueness: Select to activate duplicate detection.
- Preview of data upload: Select to manually approve every data sync. New data won’t be available until you accept the changes.
- Sync hold threshold: Set a threshold for significant changes. Updated data won’t be exported until you approve these changes.
-
(Optional) Click Test Connection to verify the connection with FACTS SIS.
- Accept the Terms of Use and/or Privacy Policy. Click Next.
- In the Schools Mapping, choose schools you wish to sync with School Passport. Select specific schools by dragging the slider or choose all by clicking the Auto Mapping button. See Schools Mapping. Click Next.
- In the Attributes Mapping, specify which FACTS attributes will sync with School Passport. Click Next. Tip: You can finish the configuration of the FACTS app in this step.
- (Optional) In the Data Requirements, configure what actions should be taken if some data attributes are missed. Click Next.
- (Optional) In the Filter Rules step, set up data filtering by different entity types. Click Next.
- (Optional) In the Domains of Uniqueness, define parameters that are required to be unique to avoid duplicates in the system. See Domains of Uniqueness. Click Next.
- (Optional) In the Master Fields, define rules to prevent data duplication when synchronizing data from your app and an SIS to School Passport. See Master Fields. Click Next.
- (Optional) In the Schedule, set up how often you want to automatically sync data with FACTS SIS. Click Next.
- (Optional) In the Done, click Finish to complete the setup.
- Wait a few seconds for the app configuration to apply, after which you will be redirected to the FACTS application dashboard.
Sync data with FACTS SIS
Once the FACTS integration is set up, you can run sync with FACTS SIS at any time.
We recommend running a sync if you have new or updated data in FACTS for School Passport. Please note, that if a teacher or student is removed from the sync, their enrollments will also be deleted.
To run a sync with FACTS SIS, go to the FACTS app in School Passport and click Run Import.
If you have any questions about the FACTS app configuration, please reach out to GG4L Customer Support.