> For the complete documentation index, see [llms.txt](https://docs.didge.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.didge.io/home/foodcore-sensors/admin/alerts-and-actions/corrective-actions.md).

# Corrective Actions

### Overview

The Corrective Actions module enables automated workflows to ensure prompt response and traceability when temperature thresholds are breached by sensor devices. This system integrates deeply with the platform-as-a-service structure to allow dynamic, customized forms and operations triggered by sensor data.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2Fqdg4s010E5moiSGVDc6p%2FScreenshot%202025-04-19%20at%202.50.06%E2%80%AFpm.png?alt=media&amp;token=44772826-fa8d-4ac0-9a0d-877212428129" alt=""><figcaption></figcaption></figure>

***

### Step 1: Creating the Corrective Action Form

#### 1.1 Purpose

This form is used to capture actions taken in response to sensor alerts. It combines telemetry data with predefined workflows to guide the user.

#### 1.2 Using the Form Builder

* Start with the **Form Builder**.
* Use prebuilt templates where possible (e.g., *Sensor Corrective Actions V2 PROD*), or create a new form from scratch.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FOlOyLiH7avaYFJsORqih%2FScreenshot%202025-04-19%20at%202.50.36%E2%80%AFpm.png?alt=media&amp;token=2154bff7-7b43-4826-8564-f3c68c79db98" alt=""><figcaption></figcaption></figure>

#### 1.3 Include Sensor Data via API Tags

Add fields for:

* Device name, tag, label, and source
* Current temperature (`iot.value`, `iot.valueprobe`, `iot.valueambient`)
* Timestamps (`iot.now`)
* Recent historical readings (`iot.prevhistories`)
* Alert message (`iot.message`)

Use the `iot.*` tags in **Field Tags** under the API tab. Fields should be **disabled** for editing.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FXakdqNMYc0BkdHNET02x%2FScreenshot%202025-04-19%20at%203.14.30%E2%80%AFpm.png?alt=media&amp;token=892f82ff-a904-4d1d-96a1-295f5c5fdc83" alt=""><figcaption></figcaption></figure>

#### 1.4 Corrective Action Inputs

Include components for:

* Predefined checklists (e.g., transfer food, close door, inform engineer)
* Alarm snooze selection (3h, 6h, 12h, 24h)
* Maintenance mode toggle
* Comments or remarks
* Optional image upload for evidence
* Optional digital signature

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FSiJ0cgwRibxp2aF0QdGa%2FScreenshot%202025-04-19%20at%203.14.18%E2%80%AFpm.png?alt=media&amp;token=7ca34b79-15da-4867-8ab8-61ed46b17836" alt=""><figcaption></figcaption></figure>

#### 1.5 Navigation Link

Add a **"Go to Device"** button using `iot.dashboardlink` to let users access live sensor dashboards.

***

### Step 2: Configuring the Operation

#### 2.1 Add to Work Area

* Navigate to the appropriate **Work Area**.
* Create a new operation (e.g., *Sensors - Alerts & Actions*).
* Assign the Corrective Action Form to this operation.

#### 2.2 Required Settings

* **Operation Mode**: Must be set to `Multiple` instance.
* **Manual Trigger**: Disable (the system auto-triggers based on alerts).
* **Expire**: Define expiry (e.g., 24 hours). After this period, instances auto-close.
* **Report View**: Recommend `Active Instances` as default.
* **Submission Table**: Enable for review.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FFvJFSeVbAZZ3MK9XVKUW%2FScreenshot%202025-04-19%20at%202.51.57%E2%80%AFpm.png?alt=media&amp;token=cc55b1de-8485-4e51-8887-4179c66fd0e2" alt=""><figcaption></figcaption></figure>

#### 2.3 Public Access

To simplify submission:

* Enable **Allow Public Submission**.
* Disable login requirement via **Public Settings** tab.
* Share the provided public URL via email or WhatsApp.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FY8X2jl6wS35UXMdW4d1w%2FScreenshot%202025-04-19%20at%202.50.51%E2%80%AFpm.png?alt=media&amp;token=e6908fba-8633-4e9f-b470-f01f71416f21" alt=""><figcaption></figcaption></figure>

#### 2.4 UI Enhancements

* Configure **Card Builder** to display Device Name, Timestamp, Alert Message for a clear user dashboard.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2Fwoq5qYdQWOyeb9EKw6HA%2FScreenshot%202025-04-19%20at%203.14.46%E2%80%AFpm.png?alt=media&amp;token=25c972fc-68d7-4556-89fa-db0f79786ef9" alt=""><figcaption></figcaption></figure>

***

### Step 3: Linking to Sensor Dashboard

#### 3.1 Assigning the Operation

* As an Admin, go to the **Sensor Dashboard**.
* Open the **Corrective Actions** tab.
* Select the operation previously configured.
* Click **Save** to complete the assignment.

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FfdnfpjxPdkZ14zmEzSLu%2FScreenshot%202025-04-19%20at%203.23.00%E2%80%AFpm.png?alt=media&amp;token=a405c8d6-6d4e-4ebc-9f75-d14167a65b28" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2675140142-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPnSdrHOYeIaTHbt8Z0Qc%2Fuploads%2FclV13lLbCgWWIDj7MB9N%2FScreenshot%202025-04-19%20at%203.23.32%E2%80%AFpm.png?alt=media&amp;token=06f5ad7e-f7b9-4961-b829-73ac88108e1a" alt=""><figcaption></figcaption></figure>

***

### Step 4: Runtime Behavior

#### 4.1 Triggering Events

* Triggered automatically when threshold and delay are exceeded.
* Instance created with live data from the sensor.

#### 4.2 User Interaction

* Users complete the form directly via notification link.
* On submission, the corrective action is closed.

#### 4.3 Data Management

* All corrective actions are logged in the operation table.
* Exportable as Web Report, PDF, or CSV for audit and compliance.

***

### Summary

Corrective Actions is a powerful automation tool for managing sensor anomalies. With modular configuration, API data tagging, and real-time integration, it supports fast response, traceability, and compliance.

Always test form behavior and user permissions in a staging environment before full deployment to ensure a smooth and compliant rollout.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.didge.io/home/foodcore-sensors/admin/alerts-and-actions/corrective-actions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.