> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fentufsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Readout Templates

> Creating templates for recording equipment readings and measurements

<img src="https://mintcdn.com/fentu/C3pzkSBx7BqIrzJP/images/fentu-fsm/inventory/readout-templates-list.png?fit=max&auto=format&n=C3pzkSBx7BqIrzJP&q=85&s=2f0690ea4f5b6d8e5279473c847d6326" alt="Readout Templates List View" width="1280" height="720" data-path="images/fentu-fsm/inventory/readout-templates-list.png" />

## Overview

Readout Templates define the measurements, readings, and data points that technicians need to capture during service visits. These templates standardize data collection, ensuring consistent and complete information is recorded for every piece of equipment.

<Note>
  Readout Templates are essential for preventive maintenance programs. They ensure technicians capture the right data points every time, enabling trend analysis and predictive maintenance.
</Note>

## When to Use Readout Templates

Create readout templates when:

* **Preventive Maintenance** - Standardizing readings collected during routine maintenance
* **Equipment Inspections** - Capturing operational parameters for analysis
* **Commissioning** - Recording baseline measurements for new installations
* **Compliance Requirements** - Meeting regulatory documentation requirements
* **Performance Monitoring** - Tracking equipment efficiency over time

<Tip>
  Design readout templates around the specific data points that indicate equipment health. Include both current readings and acceptable ranges to help technicians identify problems.
</Tip>

***

## Readout Template Information

Each readout template includes:

| Field              | Description                                      |
| ------------------ | ------------------------------------------------ |
| **Template Name**  | Descriptive name for the template                |
| **Description**    | Explanation of when and how to use this template |
| **Equipment Type** | Type of equipment this template applies to       |
| **Fields**         | The specific data points to be captured          |
| **Status**         | Active or inactive                               |

### Field Types

Readout templates can include various field types:

| Field Type    | Description                 | Example Use               |
| ------------- | --------------------------- | ------------------------- |
| **Numeric**   | Numbers with optional units | Temperature: 72 F         |
| **Text**      | Free-form text entry        | Serial number, notes      |
| **Selection** | Dropdown choices            | Pass/Fail, Good/Fair/Poor |
| **Checkbox**  | Yes/No options              | Filter replaced: Yes      |
| **Date**      | Date picker                 | Last calibration date     |
| **Photo**     | Image attachment            | Condition photo           |

***

## Creating Readout Templates

<Steps>
  <Step title="Navigate to Readout Templates">
    Go to Products & Inventory > Readout Templates
  </Step>

  <Step title="Click Create">
    Start a new readout template
  </Step>

  <Step title="Enter Template Details">
    Provide name, description, and equipment type
  </Step>

  <Step title="Add Fields">
    Define each data point to capture
  </Step>

  <Step title="Configure Field Properties">
    Set field types, units, ranges, and requirements
  </Step>

  <Step title="Save Template">
    Save and activate the template
  </Step>
</Steps>

### Field Configuration

For each field, you can configure:

| Setting           | Description                                 |
| ----------------- | ------------------------------------------- |
| **Field Label**   | Display name for the field                  |
| **Field Type**    | Type of data to capture                     |
| **Required**      | Whether the field must be completed         |
| **Default Value** | Pre-filled value (optional)                 |
| **Units**         | Measurement units (for numeric fields)      |
| **Min/Max Range** | Acceptable value range (for numeric fields) |
| **Help Text**     | Instructions for technicians                |

### Edit Measured Variable

When adding or editing an individual variable inside a readout template, the following fields are available:

| Field                | Description                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Label**            | Display name shown to the technician (e.g., "Supply Air Temperature")                                                     |
| **Position**         | Order (sequence number) in which this variable appears on the form                                                        |
| **Axis**             | Groups variables into rows/columns on a matrix-style readout sheet (e.g., Row A, Row B)                                   |
| **Unit**             | Measurement unit displayed alongside the value (e.g., °C, PSI, V, A)                                                      |
| **Type**             | Data type for the input: `Number`, `Text`, `Selection`, `Checkbox`, `Date`, `Photo`                                       |
| **Field 1**          | Primary input field. For `Number` types, captures the measured value; for `Selection` types, captures the selected option |
| **Calculation Type** | Optional. Defines an automatic calculation to apply: `Sum`, `Difference`, `Average`, `Min`, `Max`, `Formula`              |
| **Calculation Way**  | Determines whether the calculation is applied `Per Row`, `Per Column`, or `Across All` values                             |
| **Label Before**     | Optional text displayed to the left of the input field (e.g., a lower bound indicator or units label)                     |
| **Label After**      | Optional text displayed to the right of the input field (e.g., an upper bound indicator or pass/fail tag)                 |
| **Field 2**          | Secondary input field available for variables that capture two related values (e.g., min and max pressure)                |

<Tip>
  Use **Label Before** and **Label After** to show acceptable ranges directly on the form (e.g., Label Before: "≥ 60 PSI", Label After: "≤ 80 PSI"). This gives technicians instant pass/fail feedback without needing to look up specifications.
</Tip>

<Warning>
  Consider the technician's experience when designing templates. Include clear labels and help text to ensure accurate data collection.
</Warning>

***

## Using Readout Templates

### Linking to Assets

Readout templates can be linked to:

* **Asset Types** - Applied to all assets of a specific type
* **Individual Assets** - Applied to specific equipment
* **Service Contracts** - Required for contract maintenance visits

### Field Completion

When technicians perform service:

1. Template fields appear on the work order or task
2. Technician enters current readings
3. System validates entries against defined ranges
4. Out-of-range values are flagged for attention
5. Data is stored with the asset history

<Info>
  Historical readout data enables trend analysis. Over time, you can identify patterns that indicate developing problems before failures occur.
</Info>

***

## Template Examples

### Machine System Template

| Field                       | Type      | Units | Range                     |
| --------------------------- | --------- | ----- | ------------------------- |
| Supply Air Temperature      | Numeric   | F     | 50-65                     |
| Return Air Temperature      | Numeric   | F     | 68-78                     |
| Refrigerant Pressure (High) | Numeric   | PSI   | 200-400                   |
| Refrigerant Pressure (Low)  | Numeric   | PSI   | 60-80                     |
| Filter Condition            | Selection | -     | Good/Fair/Replace         |
| Compressor Amperage         | Numeric   | Amps  | 0-30                      |
| Overall System Condition    | Selection | -     | Pass/Needs Attention/Fail |

### Elevator Inspection Template

| Field                | Type      | Units   | Range                |
| -------------------- | --------- | ------- | -------------------- |
| Door Opening Time    | Numeric   | Seconds | 2-5                  |
| Door Closing Time    | Numeric   | Seconds | 3-8                  |
| Car Level Accuracy   | Numeric   | Inches  | 0-0.5                |
| Emergency Phone Test | Checkbox  | -       | -                    |
| Safety Edge Test     | Selection | -       | Pass/Fail            |
| Pit Condition        | Selection | -       | Clean/Needs Cleaning |
| Notes                | Text      | -       | -                    |

***

## Best Practices

<AccordionGroup>
  <Accordion title="Keep Templates Focused" icon="bullseye">
    Include only essential data points. Too many fields slow down technicians and may lead to incomplete data.
  </Accordion>

  <Accordion title="Use Appropriate Ranges" icon="sliders">
    Set realistic min/max ranges based on manufacturer specifications and actual operating conditions.
  </Accordion>

  <Accordion title="Include Reference Values" icon="info-circle">
    Provide expected values or acceptable ranges in field help text to guide technicians.
  </Accordion>

  <Accordion title="Group Related Fields" icon="layer-group">
    Organize fields logically (e.g., all temperature readings together) to improve data entry flow.
  </Accordion>

  <Accordion title="Review and Update Regularly" icon="sync">
    Periodically review templates based on technician feedback and equipment changes.
  </Accordion>

  <Accordion title="Train Technicians" icon="graduation-cap">
    Ensure technicians understand what each reading means and how to capture it accurately.
  </Accordion>
</AccordionGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="Can I modify a template after it's been used?" icon="question">
    Yes, but be careful. Changes affect future data collection but not historical records. Consider creating a new version for significant changes to maintain data consistency.
  </Accordion>

  <Accordion title="How do I handle different equipment models?" icon="question">
    Create separate templates for models with different data requirements, or use conditional fields that appear based on equipment attributes.
  </Accordion>

  <Accordion title="Can technicians add notes beyond template fields?" icon="question">
    Yes, work orders and tasks have notes sections for additional observations. Templates capture structured data, notes capture context.
  </Accordion>

  <Accordion title="How are out-of-range readings handled?" icon="question">
    The system can be configured to flag out-of-range values. This alerts technicians immediately and can trigger follow-up actions.
  </Accordion>

  <Accordion title="Can I export readout data for analysis?" icon="question">
    Yes, readout data can be exported through the Export function or accessed via API for integration with analysis tools.
  </Accordion>

  <Accordion title="Do readout templates work offline?" icon="question">
    Yes, mobile apps cache templates for offline use. Data syncs when connectivity is restored.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Checklists" icon="list-check" href="/inventory/checklists">
    Inspection and maintenance checklists
  </Card>

  <Card title="Assets" icon="barcode" href="/customers/assets">
    Managing customer equipment
  </Card>

  <Card title="Scheduled Maintenances" icon="calendar" href="/service-management/scheduled-maintenances">
    Preventive maintenance scheduling
  </Card>

  <Card title="Tasks" icon="tasks" href="/work-orders/tasks">
    Work order task execution
  </Card>
</CardGroup>
