Process Templates¶
A process metric template defines the set of metrics that Enture captures and displays for a given manufacturing process. Once configured, the template is applied consistently to every batch that passes through that process.
What a template defines¶
Each template belongs to one process and contains one or more metric columns. A metric column specifies:
| Field | Description |
|---|---|
| Metric name | The label shown in the UI and reports (e.g. Average Temperature, Yield) |
| Metric key | A short identifier used in formulas (e.g. avg_temp, yield) |
| Unit | Optional unit label displayed alongside the value (e.g. °C, L, %) |
| Source | Where the value comes from — see Source types below |
| Aggregation | How values from parallel lines are combined — avg, sum, min, max, or last |
| Display order | Controls the left-to-right column order |
Source types¶
Each metric column pulls its value from one of four sources:
| Source | Meaning |
|---|---|
| Input param | A named parameter recorded when the line run started |
| Output param | A named parameter recorded when the line run ended |
| Line run field | A built-in field on the line run itself (e.g. total runtime, output quantity) |
| Formula | A calculated value derived from other metrics in the template — see Writing formulas |
For input param and output param sources, you must also configure a line param mapping for each line, because different production lines may log the same concept under different parameter names.
Creating a template¶
- Open the Digital Twin sidebar and navigate to Batch Tracking > Process Templates.
- Click New Template.
- Select the process this template applies to.
- Add one or more metric columns using the Add Column button.
- For each column, fill in the metric name, key, unit, source, and aggregation.
- Click Save.
The template takes effect immediately for any subsequent batch journey calculations. Existing batch data is recalculated on next view.
Note
Only one template can exist per process. If a template already exists for a process, the New Template button will offer to edit the existing one instead.
Editing a template¶
Click the process name in the template list to open it, then edit any column. Changes are applied immediately.
Warning
Renaming a metric key will break any formula that references the old key. Update formula expressions in the same edit session to avoid gaps in your data.
Deleting a column or template¶
- To remove a single metric column, click the delete icon on that column row. Deletion is blocked if another formula column in the same template references this column's metric key.
- To delete the entire template, click Delete Template at the bottom of the form and confirm. All metric columns and line param mappings for that process are removed.
Line param mappings¶
When a metric column uses the input param or output param source, Enture needs to know which parameter name to look up on each individual line — because the same measurement may be logged as tank_temp on one line and inlet_temperature on another.
A line param mapping links a specific production line to the exact parameter name it uses for a given metric column.
Adding a mapping¶
- Open the template and locate the metric column.
- Click Manage Mappings for that column.
- Click Add Mapping, select the line, and enter the parameter name as it appears in that line's recorded data.
- Click Save.
Repeat for each line that runs this process. Lines without a mapping will show a blank value for that metric.
Removing a mapping¶
Open Manage Mappings for the column, click the delete icon next to the line entry, and confirm.
Tip
After setting up mappings, run a test batch through the process and check the Batch Journey view to confirm each line's values are being picked up correctly.
Writing formulas¶
Formula columns let you compute a derived metric from other columns in the same template, or from metrics in an earlier process.
Syntax¶
Use curly braces to reference another metric by its key:
- Same-process metric —
{metric_key}(e.g.{total_volume}) - Metric from an earlier process —
{process_key.metric_key}(e.g.{fermentation.avg_temp})
Combine references with standard arithmetic: +, -, *, /, and parentheses ().
Examples¶
| Formula | What it computes |
|---|---|
{output_vol} / {input_vol} * 100 |
Yield percentage |
{end_temp} - {start_temp} |
Temperature rise |
{total_vol} - {fermentation.loss_vol} |
Volume after upstream loss |
({a} + {b}) / 2 |
Simple average of two metrics |
Rules¶
- A formula may only reference metrics that appear earlier in the column list, or metrics from prior processes. Forward references (referencing a column defined further down the list) are not allowed and will be rejected on save.
- Division by zero produces a blank value rather than an error.
- If any referenced metric resolves to a blank, the formula result is also blank.
Note
Formula columns do not require a line param mapping. The formula is evaluated on the already-aggregated process-level values, not on raw line data.