Skip to main content
A proposed correction is a data correction a substitute rule has worked out but not written: the data point keeps its measured value until a person approves it. A substitute rule normally writes its corrections as soon as a method produces a value. Turn on Hold for approval on the rule’s Then step and it proposes them instead, and someone on your team approves or rejects each proposal. A rule that corrects many data points raises as many proposals. This page covers finding the proposals, deciding them, and what a waiting proposal blocks in the meantime. Substitutions, and approval with them, are enabled per account.

Where proposed corrections appear

The same proposals show in five places:

Approve or reject a proposed correction

1

Open the data point

From the Events table or the rule’s Review button, click the row to open the Event Detail drawer. The proposal card shows the measured value, the value the rule proposes, the method that produced it, and how it arrived at the number.
2

Approve or reject

Two choices:
  • Use the proposed value, which approves it. The correction is written exactly as proposed, and the value a batch calculation reads changes. The data point shows an Approved badge, with who approved it and when behind Approval details.
  • Keep the measured value, which rejects it. Give a reason. The proposal is closed and recorded with your reason, and the value stays as measured.
Either decision is final for that proposal.
Deciding a proposal needs write access on the account, in the app and over the API.

What a waiting proposal blocks

A data point with an undecided proposal cannot go into a new batch. The batch generation form flags those inputs before you press anything, and Generate stops with a message naming how many inputs are waiting until each is approved or rejected. Batches already generated are not affected. See Generate batches. If you need to generate before deciding them, switch Hold for approval off on the rule, which withdraws them (below).

Switching approval off

Turning Hold for approval off on a rule withdraws every proposal still waiting on it. Nobody approved them, so those data points keep their measured values and are not corrected unless you evaluate the period again from the rule’s Runs tab. Data points the rule matches from then on are corrected automatically. The confirmation counts the proposals it will withdraw before you save.

Approving corrections over the API

Proposals appear in the rule’s results with approval_state set to pending and a proposed_correction object carrying the value, the method, and its derivation. Decide them with approve and reject, which take the result’s ID. Both need a token with Data Rules write permission. See deciding proposals over the API for the flow end to end.