Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
maxLevelexclude
maxLevel6
minLevel16
include
outlinefalse
indent
excludeOverview
stylenone
Overviewtypelist
classprintabletrue
class

...

Types of Field Mappings

Inputs

Inputs are used to prepopulate a given field with information data from a data specified 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 to the specified data source when a form is writtenbackfrom a form to a designated data source upon writeback.

Info

Note: It is possible to have multiple outputs on a single form field.

...

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/createdat 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

  • The outgoing data must match the format that the data source expects.

    Example: Sending a letter where a number is expected will cause errors during the writeback process.

...

How to Use Mappings

Standard Mappings

SchoolEngage comes with a standard map sources available out of the box.

...

Map Source

...

  1. Begin by editing a form field.

  2. Scroll to the "Data Mapping" section within the field settings.

  3. Click "Add Input" or "Add Output" to create a new mapping.

  4. Choose your desired map source and the specific field to link.

...

Standard Mappings

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 Mappings

Custom map sources from PowerSchool can also be integrated. For detailed instructions on this process, please visit our guide on Importing Customizations into SchoolEngage.