Overview
This section outlines provides guidance on how to set up and manage field mappings on a field-by-field basis.
...
Table of Contents
| Table of Contents | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Types of Field Mappings
Inputs
Inputs are used to prepopulate a given field with information data from a data 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 are used for sending 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 data source when a form is writtenbackmap source during writeback.
| Info |
|---|
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.
| Info |
|---|
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 can be used on a is allowed per field.
Fields are only pre-populated when the form is generated/created.
...
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.
How to Use Mappings
Standard Mappings
SchoolEngage comes with a standard map sources available out of the box.
...
Map Source
...
Example: Sending a letter where a number is expected will cause errors during the writeback process.
| Info |
|---|
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
...
A variety of PowerSchool student fields,
...
: 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.