SIF Configuration Setup (Virginia)

Tool Search: Configuration

This article describes the steps you should take to properly set up a new SIF Configuration for Virginia.

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.

 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.

1. Set up a new SIF Configuration

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.
    FieldDescriptionValue
    NameThe unique name of the configuration.Enter a name for the configuration.
    OAuth URLThe OAuth URL for the configuration.https://va-slf.sifworks.com
    Base URLThe Base URL for the configuration.https://va-slf.sifworks.com/token
    Client IDThe Client ID for the configuration. Please contact your vendor for the appropriate value.
    Client SecretThe Client Secret for the configuration. Please contact your vendor for the appropriate value.
    Test ConnectionSelecting this button initiates a check to see if the values entered in the configuration fields are valid and if a proper connection has been made. If a connection is made, a message saying "Connection is Valid" displays.N/A
  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.

2. Set Up 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
School
(Required)
Data 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.

3. Set up 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.
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.


4. Set 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.