Forefront

Descriptor Editor

Configuring one graded category on a report card: its standards, scoring options, and the window of data it grades.

A descriptor is one graded category on a report card: the row a family reads as “Number Word Sequences: Meets Standard.” The Descriptor Editor is where a district administrator decides what that category is graded from: which standards feed it, which marks a teacher can choose between, and how far back in time the evidence is allowed to come from.

You reach it from the Report Card Editor by clicking a descriptor’s name, or from Add Descriptor when you create one.

The report card descriptor editor
  1. What the mark is computed from
  2. How far back evidence may come from
Standards decide what is graded; Data Start Date decides when.

Renaming the descriptor

The descriptor’s name is shown in the top bar. Open the actions menu (⋮) and choose Rename Descriptor to change it. The back arrow returns you to the report card, whose name appears as a breadcrumb.

Description

The Description box holds optional explanatory text for the category. Teachers can see it on the class Report Cards page, and it can be included as a row when a report card is exported to CSV.

Standards

The Standards list is what the descriptor is graded from. Use Add Standard to open the standard picker and choose one or more; the list stays sorted by path, and each row has a delete action to remove it.

Every standard you add contributes a score, and the descriptor’s mark is computed from all of them together. See How Report Card Marks Are Calculated for exactly how they combine.

A descriptor with no standards computes nothing. Paired with no options, it becomes a notes-only category (below).

Tip: Adding a standard to a descriptor that has no options yet creates a full set of options for you (one per proficiency level), so the category is immediately gradeable. Each option starts with your district’s default display name, document name, and color for its level. Rename or delete them from there.

Options

Options are the marks a teacher can pick from, such as the “M / P / N” of a standards-based report card. Each option is a row in the table:

  • Display Name: how the mark reads to teachers and families in the app.
  • Document Name: how it’s labeled in printed documents. This is usually the short form (M, P, N) where the display name is spelled out.
  • Proficiency: the proficiency level this option represents. Forefront computes a proficiency from the student’s evidence, then pre-fills the option whose proficiency matches.
  • Background Color: used for this mark in printed documents and the family portal.
  • Export IDs: the identifier an external system (PowerSchool, Infinite Campus, etc.) uses for this mark when a report card is exported to a SIS.

When you change an option’s Proficiency, Forefront offers to fill in your district’s default names and color for that level. Choose Use District Defaults to accept them or Keep What I Have to keep your own. A brand-new option that hasn’t been edited yet takes the defaults without asking.

To apply the district defaults to many descriptors at once, use Apply Defaults to Descriptors in the Report Card Editor.

Drag the handle to reorder options. The order here is the order teachers see in the dropdown. Each row’s menu (⋮) has Delete.

The two icon buttons above the table copy and paste a whole set of options. Most descriptors on a report card share the same mark scale, so set up one and paste it into the rest. It’s faster than retyping, and the scales are sure to match.

Changing an option that already has scores

When teachers have already used an option, Forefront tells you how many student scores use it before your change goes through. It also lists any handouts that use this descriptor. Click one to open it.

There are two ways to change an option like this:

  • Edit Option changes the option itself. Every report card that uses it shows the new name, color, or proficiency, including finalized report cards from past terms.
  • Add New Option puts your changes on a new option, right below the original. Past report cards keep the original exactly as it was. Delete the original afterwards so teachers can’t pick it for new scores.

Choose Add New Option when last year’s report cards should keep reading the way families first saw them. Cancel undoes your change. Once you choose Edit Option, further changes to that option save without asking again until you reload the page.

Deleting options

Deleting an option is safe for report cards you’ve already graded. No marks are removed, and report cards from past terms aren’t changed. Every student who was scored with the option keeps that mark. Their report cards show the same name, color, and proficiency as before, and reports still count those scores under it. The only thing that changes is that teachers can’t choose the option for new scores.

Deleting an option that no student has been scored with removes it right away. If students have been scored with it, Forefront shows how many scores use it and asks you to confirm. Choose Delete Option to go ahead.

Pasting a set of options replaces every option in the descriptor, and it’s just as safe. If any of the current options have scores, Forefront asks before Replace Options. Report cards already scored keep their marks, and only the pasted options can be chosen for new scores.

Notes-only descriptors

A descriptor with no options shows “This descriptor has no options and will function as a notes-only descriptor.” Use one for a comments box that carries no grade.

Data Start Date

Data Start Date is the setting that decides how far back the computed mark may reach. It matters most for standards a student is assessed against in more than one school year.

SettingEvidence used
Beginning of Due Date (default)only scores dated inside that grading period’s window
Beginning of Termscores from the first day of the school year through the end of the grading period
All Timeevery score the student has ever had, through the end of the grading period

The default is the narrowest of the three, so out of the box a report card mark reflects the grading period it belongs to and nothing earlier. Choose Beginning of Term when a category is meant to reflect the whole year’s progress rather than one grading period. Choose All Time only when carrying prior years forward is intended, such as for a multi-year graduation requirement.

Note: If a category’s standards repeat from year to year (library, technology, or social-emotional standards, which often have no grade-level split), leave this on one of the first two settings. All Time would let last year’s scores weigh on this year’s mark.

Note Presets

Note Presets are ready-made comments a teacher can add to a student’s note with one click. The section appears only when the descriptor has no options. Add one with Add Preset, edit one with the pencil button beside it, and use the row’s menu to reorder or delete it.

A notes-only descriptor with two note presets
  1. No options, so no mark
  2. Comments a teacher can insert
With no options, the descriptor becomes a comments box and Note Presets appears.

See Report Card Note Presets for writing presets, using dynamic text in them, and how teachers add them.

Export IDs

The Export IDs section near the top of the page names the descriptor itself in an external system. It’s how your SIS refers to this descriptor when a report card is exported to it. Add one per ID type. Each has a delete action. These are distinct from the per-option export IDs in the options table: this one identifies the descriptor, those identify the option.

Saving

Every field on this page saves as you change it. There is no save button.

If a change can’t be saved, you’ll see a message saying so (Unable to save descriptor, Unable to save option or Unable to paste options), and the page reloads the descriptor as it was last saved. Make the change again.

Deleting a descriptor doesn’t change the document fragments that print it. Any field or cell color that reads it prints blank, and the fragment’s Issues chip shows an error for it. See Checking a Handout for Issues.

If the page can’t load

If the descriptor can’t be loaded, the editor is replaced by an error message. Reload, or go back to the report card and reopen it.