You should subscribe to our blog! RSS feed Email

New Feature: Data Table Approval & Locking

One of the features our clients appreciate most is the submission, approval, and locking workflow we have for direct entry indicator data. Many of you have requested a similar process for data stored within data tables. This is much trickier, since each data table might feed dozens of indicators, with multiple date columns, etc. But never fear! The lovely and talented engineers here at DevResults put their heads together and came up with a data table row locking process tied to the existing submission/approval workflow for activity reporting periods. Here's what you need to know to start using it.

1 What Does It Do?

Locking a row prevents most users from:

  • Adding new rows into an already-locked Activity Reporting Period
  • Editing existing rows in an already-locked Activity Reporting Period
  • Deleting existing rows from an already-locked Activity Reporting Period

It helps prevent things like someone uploading a spreadsheet with only this quarter's worth of data in it, but choosing the "Replace All" option during upload and wiping out the last three years' worth of data. In short: your data table data now has all the protections of your direct entry data.

2 How Does It Work?

By default, we have kept data table approval and locking disabled, so you'll need to enable it to begin using it. Once you enable it, it works on logic similar to the regular Activity Reporting Period workflow for locking data. First, let's quickly review how that process already works for Activity Reporting Periods:

  1. All Activity Reporting Periods are locked until the submission window start date for the system-wide reporting period is open. At this time, individual Activity Reporting Periods are considered to be in a No Data status.
  2. Once the submission window start date passes, anyone with the ability to Edit Indicator Results enters or uploads indicator performance data. This flips the Activity Reporting Period to In Progress status.
  3. Users with the Submit Indicator Results role (typically a manager of some kind) Submit the data. This locks all data for this Activity Reporting Period from editing and changes its status to Submitted.
  4. Someone with Results Data Approver role reviews the data. They may Return it or Approve it.
  5. Once the Activity Reporting Period is Approved, all data is locked for editing to all users except Owners, who can manually override data to correct typos, etc.
  6. Even without approval, data in an Activity Reporting Period in any status will automatically become locked for editing when the overall Reporting Period's submission window has closed.

The data table approval and locking process works on these same principles:

  1. Data is entered into the data table.
  2. As the data table's indicators are recalculated, the system checks the Activity Reporting Period status for all rows of data using the table's Activity column and each indicator's designated date column. Rows that fall within a specific reporting period for a specific activity will be assigned the same status as the overall Activity Reporting Period (e.g. In Progress, etc.).
  3. Once that Activity Reporting Period is Approved or locked due to the closure of a submission window, the related rows in the data table are locked for editing.
  4. Locked rows cannot be edited or deleted except by those with advanced permissions. Users are also prevented from creating new rows that would fall into locked Activity Reporting Periods.

For a more detailed breakdown of both submission and approval processes, see this help page.

3 What Does It Look Like?

Once data table row locking is enabled, the most immediate change you should see is for existing data tables. If you have data already entered in data tables for now locked Activity Reporting Periods, you'll notice a lock icon appear next to those rows:
These rows are currently locked. If you're curious which reporting period is locking the row, you can click on the lock to get more information:
And if you have the data entry form for an individual row open, you'll see a banner across the top notifying you of the lock:

More Info

Learn more about the data submission and approval process and how to enable data table row locking on your site.

Please email us or leave a comment below if you have any questions or feedback on this new feature!

devresults forum