Displaying ETS Score Reports in the Reader
- 28 Nov 2023
- 7 minute read
- Print
- DarkLight
- PDF
Displaying ETS Score Reports in the Reader
- Updated 28 Nov 2023
- 7 minute read
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
ETS has embeddable score reports available for their GRE® and TOEFL® tests that can be configured to appear as a tab in the Slate Reader. In addition to the scores, the ETS TOEFL score report provides access to hear speaking samples and view writing samples, and the GRE score report provides access to test taker photos and analytical writing essays.
GRE Configurations
Custom Fields
The custom field stores the GRE appointment number that is used to display the score report in a Reader Tab. Refer to the "Reader Tab Group" section of this article for instructions on configuring the Reader Tab.
To create the custom field:
Select Database on the top navigation bar and select Fields.
Select Insert.
Create a person-scoped custom field "GRE Appointment Number" with the following specifications:
Select Save.
(Optional) If your institution receives GRE score reports associated with multiple DI Codes, create an additional person-scoped field to store the DI Code associated with the GRE Appointment Number.
Source Format
Add the GRE Score Data File.
Note: If your institution is already importing GRE scores using one of these source formats, disregard this step.
Add the GRE Score Data File (Fixed Width 2017) or GRE Score Data File (PGP 2017) source format from the Source Format Library. These source formats are identical, except that the PGP version allows you to upload encrypted files, and it will decrypt them using the PGP key that you provide.
To add the key for the PGP version of the source format:
Edit the source format.
Select the Format Definition tab.
Enter the PGP Private Key and PGP Password that Slate will use to decrypt the file.
Configure the Remap settings for this source format. Many standard fields are pre-mapped, including the test score data and biographical information.
Create a mapping for the GRE Appointment Number field created in the previous section.
Go to the Field Fusions page of the Remap settings for the source format.
Create a new field fusion.
Select Registration Number as the first source field.
Select Test Date as the second source field.
Set the custom field that you created in the previous section to store the GRE Appointment Number as the destination.
Select Enable unsafe import to this destination to ensure that records with active applications will have the field set by the source format.
Select Save.
Note: To ensure that ETS is able to display the GRE Score Report in the Reader, Registration Number must be mapped as the first source field, with Test Date mapped as the second source field.
(Optional) If you also created a DI Code field, be sure to map the Institution Code source field to that field, using a standard mapping on the Fields page of the Remap settings.
Note: Use the Unsafe Override setting to ensure that records with active applications have the field value set by this source format.
If you are updating an existing source format, disregard this step and proceed to the next step.
If you are using a new source format, edit the source format to set the Remap Active flag to Active. This runs the import using the Remap settings configured above for all files uploaded on or after the Remap As Of Date value.
This step applies to updating an existing source format. If you are using a new format (as described in the previous step), disregard this step.
Since you are mapping additional fields that were not previously imported, your institution may wish to import the data for previously imported records.
To import the data:
Go to the Retroactive Refreshpage of the Remap settings for the source format.
Select just the GRE Appointment Number field (and DI Code field if you are using one) from the list of fields.
Select the sources to refresh from the list of sources under the field list.
Note: You may use the checkbox in the header row to select all applicable sources.
Select Retroactive Refresh at the bottom of the page to import the selected fields for the selected sources.
Reader Tab Group
The Reader Tab appears within the Reader. It allows readers to view the GRE score report while evaluating records.
Select Database on the top navigation bar and select Reader Tab Groups.
Select Insert.
Select Link as the Type.
Select ETS Score Report as the URL Type.
Select GRE as the Score Report Type.
Select the field (previously created in the Fields step) that contains the GRE Appointment Number in the Appointment Field list.
If your institution has just one DI Code, select Other in the DI Code list, and enter the DI Code in the text field. If you created a DI Code field in the previous step, select that instead.
Give the tab a Name (for example, "GRE Score Report").
Set the Order for the tab to appear in the Reader.
(Optional) If you want the tab to only appear if the applicant has a value in the GRE Appointment Number field, select your Applications base, and then use the Field Value Exists filter with the GRE Appointment Number field selected.
With the configurations above, all applicants that have the GRE Appointment Number field will have a Reader Tab with the GRE Score Report appearing in the Reader.
TOEFL Configurations
Custom Fields
The custom field will store the TOEFL appointment number that will be used to display the score report in a Reader Tab (See instructions below to configure the Reader Tab ).
Select Database on the top navigation bar and select Fields.
Select Insert.
Create a person-scoped custom field.
Select Save.
(Optional) If your institution receives TOEFL score reports associated with multiple DI Codes, create an additional person-scoped field to store the DI Code associated with the TOEFL Appointment Number as well.
Source Format
Add the TOEFL Score Data File.
Note: If your institution is already importing TOEFL scores using one of these source formats, disregard this step.
Add the TOEFL Score Data File (Fixed Width >10/2017) or TOEFL Score Data File (PGP >10/2017) source format from the Source Format Library. These source formats are identical, except that the PGP version allows you to upload encrypted files, and it will decrypt them using the PGP key that you provide.
To add the key for the PGP version of the source format:
Edit the source format.
Select the Format Definition tab.
Enter the PGP Private Key and PGP Password that Slate will use to decrypt the file.
Configure the Remap settings for this source format. Many standard fields are pre-mapped, including the test score data and biographical information. Be sure to map the Registration or Appointment Number source field to the appointment number custom field that you created earlier. If you also created a DI Code field, be sure to map the Institution Code source field to that field.
Note: Use the Unsafe Override setting to ensure that records with active applications will have this field set by this source format.
If you are updating an existing source format, disregard this step and proceed to the next step. If you are using a new source format, edit the source format to set the Remap Active flag to Active. This runs the import using the Remap settings configured above for all files uploaded on or after the Remap As Of Date value.
This step applies to updating an existing source format. If you are using a new format (as described in the previous step), disregard this step.
Since you are mapping additional fields that were not previously imported, your institution may wish to import the data for previously imported records.
To import the data:
Go to the Retroactive Refresh page of the Remap settings for the source format.
Select just the TOEFL Appointment Number field (and DI Code field if you are using one) from the list of fields.
Select the sources to refresh from the list of sources under the field list.
Note: You can select the box in the header row to select all applicable sources.
Select Retroactive Refresh at the bottom of the page to import the selected fields for the selected sources.
Reader Tab Group
The Reader Tab appears within the Reader. It allows readers to view the TOEFL score report while evaluating records.
Select Database on the top navigation bar and select Reader Tab Groups.
Select Insert.
Select Link as the Type.
Select ETS Score Report as the URL Type.
Select TOEFL as the Score Report Type.
Select the field (created previously in the Fields step) that contains the TOEFL Appointment Number in the Appointment Field list.
If your institution has just one DI Code, select Other in the DI Code list, and enter the DI Code in the text field. If you created a DI Code field in the previous step, select that instead.
Give the tab a Name (for example, "TOEFL Score Report").
Set the Order for the tab to appear in the Reader.
(Optional) If you want the tab to only appear if the applicant has a value in the TOEFL Appointment Number field, select your Applications base, and then use the Field Value Exists filter with the TOEFL Appointment Number field selected.
With the configurations above, all applicants that have the TOEFL Appointment Number field will have a Reader Tab with the TOEFL Score Report appearing in the Reader.
Was this article helpful?
