Configuration (SIF Unity)

Tool Search: Configuration

The SIF Configuration tool allows districts to set up SIF Configurations. These options include setting Zone Information, Zone Options, and Object Rights. A valid configuration must be set up in order to send records.

SIF Unity tools are only available for SIF v3.X or higher. Currently, SIF Unity is only available in Virginia.

SIF Unity


Read - User is allowed to view existing configuration data.
Write - User is allowed to update configuration data.
Add - User is allowed to create configurations.
Delete - User is allowed to delete configurations.

For more information about Tool Rights and how they function, see the Tool Rights article.

Configuration List
Description
NameIndicates the name of the SIF Configuration. Clicking on the name will take the user to details of Configuration.
Scope

Indicates the information on what the Zone is scoped at/for.

Helper Tools
A link to the SIF Unity tools.
NewCreate a new Configuration.
CancelTakes the user back to the SIF Unity landing page.
CertificatesAllows users to manage SIF Certificates. Please see the SIF Unity Certificates article for more information.


SIF Configuration Setup

A valid configuration is required to send data.

Screenshot of the SIF Unity ConfigurationSIF Unity Configuration


  1. Select New from the SIF Unity page.
  2. Complete the following fields for the SIF Configuration:
    Note: All fields in the SIF Configuration are required.
    FieldDescription
    NameThe unique name of the configuration.
    OAuth URLThe OAuth URL for the configuration.
    Base URLThe Base URL for the configuration.
    Client IDThe Client ID for the configuration. This value must be obtained from the vendor.
    Client SecretThe Client Secret for the configuration. This value must be obtained from the vendor.
    Test ConnectionSelecting this button initiates a check to see if the values entered in the configuration fields are valid and proper connection has been made. A message saying "Connection is Valid" displays if a connection is made.
  3. Select the Test Connection button to confirm a valid connection has been established.
  4. If a certificate needs to be imported, select the Import Certificate button and import a certificate. For more information on Certificates, please review the SIF Unity Certificates article.
  5. Click Save.

Zone Information

A zone is an area specifically configured for data exchange and message communication. The data exchanged for these purposes is "scoped" on the Zone by selecting parameters that prevent excessive data transfer. 

Screenshot of the ZOne Information editor.Zone Information

The following table defines the fields/settings of the Zone Information editor:

FieldDescription
SchoolData from schools selected in this field will be available for exchange.
YearData from years selected in this field will be available for exchange.
CalendarData from calendars selected in this field will be available for exchange.

Zone Options

Zone Options allow users to limit or specify certain data objects and parameters transferred for the zone. These options include the ability to exclude specific enrollments and include staff and student Social Security Numbers within messages. 

The Attendance Code Allowed List allows users to set which attendance codes will be included within SIF attendance objects. Attendance records marked with an Attendance Code other than the values set in this section are excluded from SIF attendance object messages.

Screenshot of the SIF Zone Options editor..Zone Options

The following table defines the fields/settings of the Zone Options editor:

FieldDescription
ExcludeAllows users to exclude information. Options are:
  • Secondary Enrollments: If selected, all data tied to non-primary student enrollment records will be excluded from the exchanged SIF message. This should be done when the external SIF application only requires primary student enrollment records.
  • No Show Enrollments: If selected, enrollment records with the No Show checkbox marked will not produce a student-based SIF object, and the student will be omitted from SIF batch requests and events.
  • State Exclude Enrollments: If selected, enrollment records where the State Exclude checkbox is marked will not produce a student-based SIF object, and the student will be omitted from SIF batch requests and events. This field also omits all enrollment records in calendars marked Exclude or Schools marked Exclude.
  • State Exclude District Assignments: If selected, district assignment records where the State Exclude checkbox is marked will not produce a staff-based SIF object, and the staff will be omitted from SIF batch requests and events. This field also omits all district assignment records in Schools marked Exclude.
  • Exclude Private Contact Email: If selected, private contact email records will not be sent.
PublishBy default, Social Security Numbers are not published in the StudentPersonal or StaffPersonel objects; however, users can include this information by marking the following checkboxes:
  • Social Security Numbers in StudentPersonal - If selected, Social Security Numbers will populate the <OtherID> of the StudentPersonal object in both events and batch requests.
  • Social Security Numbers in StaffPersonal - If selected, Social Security Numbers will populate the <OtherID> of the StaffPersonal object in both events and batch request
DemographicsAllows users to indicate what demographic information will be sent:
  • Use Legal Gender:  When this option is selected, and Legal Gender is populated on the person's current Identity, then the SIF Gender element is reported from the Legal Gender field. When this option is not selected, or Legal Gender is blank on the person's current Identity, the Gender element is reported from the Gender field.
  • Use Legal Name: When this option is selected, and Legal First and Last Name fields are populated in the person's current Identity, then reports from the legal name fields for all of the elements under the Name element in SIF.
    When this option is not selected, or Legal First or Last Name fields are blank on the person's current Identity, then reports from the regular name fields for all of the elements under the Name element.
Attendance Code Allowed ListAllows users to set which attendance codes will be included within SIF attendance objects. Attendance records marked with an Attendance Code other than the values set in this section are excluded from SIF attendance object messages.


Object Information

Object Information allows users to indicate which SIF objects will respond to requests and/or publish events

Screenshot of the Object Rights editor.Object Rights

The following table defines the fields/settings of the Object Information editor:

FieldDescription
Object Name
(Required)
Indicates the SIF object for which the Object Rights are for.
Respond to Requests

When marked, the selected SIF Object responds to Batch requests.

Note: For the StudentPersonal Object, responds to requests for StateID. 


Publish EventsWhen the checkbox is marked, the selected SIF Objects will Publish trigger events.
RemoveWhen this button is selected, the SIF Object access rights are removed.
AddAllows the users to add additional SIF Objects.