Overview
This section provides guidance on how to set up and manage field mappings on a field-by-field basis.
Table of Contents
Types of Field Mappings
Inputs
Inputs prepopulate a field with data from a specified map source when the form is generated. This reduces the need for users to have to fill out the same information every time.
Outputs
Outputs send the submitted data from a form to a designated map source upon writeback.
Send Values
A fixed output value that will be sent to the specified map source during writeback.
Note: It is possible to have multiple outputs and send values on a single form field.
Mapping Settings
Ignore on Writeback If Empty
By default, SchoolEngage will send empty values on writeback. This means if a field is not filled out, it could potentially wipe out existing data in PowerSchool. To prevent this, you can enable this map setting to stop empty data from being sent.
Note: If the field is left empty and this setting is enabled, all send values associated with this field will not be sent.
Limitations
Inputs
Only one input mapping is allowed per field.
Fields are only pre-populated at the time of form creation.
The incoming data must conform to the format expected by the form field.
Example: Sending "True" to a dropdown list that does not recognize "True" as a valid option will result in the field displaying as blank.
Outputs & Send Values
The outgoing data must match the format that the map source expects.
Example: Sending a letter where a number is expected will cause errors during the writeback process.
For more information on writeback errors, please visit our guide on Writeback Errors
How to Create Mappings
Begin by editing a form field.
Scroll to the "Data Mapping" section within the field settings.
Click "Add Input", "Add Output" or “Add Value” to create a new mapping.
Choose your desired map source followed by the specific field to link.
For a send value, please enter the desired value in the provided text box.
Standard Map Sources
SchoolEngage includes several predefined map sources:
AB PowerSchool Writeback ver.2: Main map source for writing back student information to PowerSchool.
Unlimited Contacts: Main map source for writing back contact information to PowerSchool.
SE - Parent: Connects to the user who created the form.
SE - Student: Connects to the user to whom the form is assigned.
Custom PowerSchool Map Sources
Custom map sources from PowerSchool can also be integrated. For detailed instructions on this process, please visit our guide on Importing Customizations into SchoolEngage.