Skip to main content

Review Mode Flow

diagram

Review Mode Toggle

PropertyDescription
ActivationReview mode button appears automatically when any row is modified or added
Toggle behaviorNon-destructive toggle — other filters are preserved when review mode is turned on/off
Return to normalDisabling review mode restores the previous view state

Review Filter Menu

The review mode dropdown menu provides granular filtering by change type:
FilterDescription
ModifiedShows only rows with changes to existing entities
AddedShows only newly created rows that have not been saved
DeletedShows rows marked for deletion
ProblemsShows rows with validation errors
Each filter category displays a count in the menu:
Menu LabelFormat
Changed rowsChanged rows: N
Problem rowsProblems rows: N

Entity State Indicators

Row-Level Indicators

StateCSS ClassVisual
Modifiedltc-entity--isModifiedRow header shows modified indicator
Addedltc-entity--isAddedRow header shows added indicator
Errorltc-entity--isErrorRow header shows error indicator (combined with isModified)

Cell-Level Indicators

Individual cells that have been changed display the isModified class. Both the directly edited cell and related cells (e.g., foreign key and navigation property cells) are marked as modified.

Review Mode Row Count

When review mode is active, the filtered row count is displayed:
N/M rows
  • N = visible rows matching the review filter
  • M = total rows in the sheet

Review Filter Checks

The review mode applies predicate functions to determine which rows to display:
CheckCondition
AddedEntity state is isAdded and the item is not empty (has at least one entity)
ModifiedEntity state is isModified
DeletedEntity state is isDeleted
ProblemsEntity has validation errors
Phantom/placeholder rows are excluded from the Added filter. Only rows with actual entity data are shown.

Review Mode with Save Errors

ScenarioBehavior
Save succeedsReview mode can be disabled; all change indicators clear
Save failsReview mode persists so users can identify and fix problem rows
Validation errorsProblem rows are flagged with both isModified and isError states
After a failed save, review mode stays active to guide you through fixing validation problems. Use the Problems filter to quickly navigate to rows with errors.

Integration with Other Features

Search in Review Mode

Search works within the review-filtered row set:
  1. Review mode filter reduces rows to changed items
  2. Search further narrows within those rows
  3. Row count reflects the combined result

Workflow Transitions

Workflow transitions are tracked in review mode. Changed workflow states appear in the Modified rows filter.

Column Filters

Review mode is compatible with existing column sort and filter settings. The filterItemsForReview command toggles between the review filter and the standard column-based filter.
Source: Review mode test specifications, filter-items-for-review command, search integration tests
KB ArticlesSource Code
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/cypress/e2e/Sheet/review-mode.spec.ts
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/cypress/e2e/Sheet/reference.spec.ts
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/sheet/commands/filter-items-for-review.ts
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/cypress/e2e/Sheet/workflows.spec.ts
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/cypress/e2e/Sheet/search.spec.ts