Skip to main content

Recipe Parameters

Recipe parameters are phase-specific setpoint overrides. They connect the recipe to the procedure's operation phases and define the exact values to use for each phase parameter during production of this specific product.

Parameters tab in recipe edit dialog

Concept​

In the ISA-88 model, a procedure defines the steps (operations and phases), and each phase can have parameters (e.g., temperature, speed, duration). These parameters have generic definitions at the procedure level. The recipe then provides the concrete values for each parameter:

Accessing parameters​

  1. Navigate to the Recipe List
  2. Click the edit button on a Draft recipe
  3. Switch to the Parameters tab

:::info Procedure Required The Parameters tab requires that the recipe has a batch procedure assigned. If no procedure is linked, an info message is displayed: "Select a procedure first." Go to the General tab and assign a batch procedure, then return to the Parameters tab. :::

Parameters grid​

The parameters DataGrid displays the following columns:

ColumnDescription
Operation PhaseThe name of the phase within the operation
Phase ParameterThe parameter being overridden (shows code as a chip)
Target ValueThe desired setpoint value
Min ValueMinimum acceptable value (or -- if not set)
Max ValueMaximum acceptable value (or -- if not set)
ActionsDelete button (only visible for Draft recipes)

Items are sorted by phase name by default.

Adding a Parameter​

The add dialog uses cascading dropdowns that progressively narrow the selection:

  1. Click Add Item above the parameters grid
  2. Select an Operation -- lists all operations from the linked procedure
  3. Select an Operation Phase -- lists phases within the selected operation
  4. Select a Phase Parameter -- lists parameters defined on the selected phase
  5. Enter the Target Value (required)
  6. Optionally enter Min Value and Max Value to define the acceptable range
  7. Click Add Item to save

Add phase parameter dialog

Cascading selection flow​

Each dropdown is disabled until the previous selection is made. Changing a higher-level selection resets the lower-level selections.

Target, Min, and Max Values​

FieldPurposeRequired
TargetThe desired setpoint valueYes
MinLower boundary of the acceptable rangeNo
MaxUpper boundary of the acceptable rangeNo

When min and max values are provided, they define a tolerance window around the target. This information can be used during production monitoring to raise alerts when actual values fall outside the acceptable range.

tip

Even when min/max are not required, it is good practice to define them. They provide valuable boundaries for process monitoring and quality control.

Removing a Parameter​

  1. Click the delete button (red trash icon) on the parameter row
  2. Confirm the removal in the dialog (shows the phase name and parameter name)
  3. The parameter override is removed
info

Only Draft recipes allow parameter modifications. For non-draft recipes, the action buttons are hidden. To change parameters on an approved recipe, create a new version.

Example parameters​

For an "Orange Juice" recipe using the "Juice Production" procedure:

Operation PhaseParameterTargetMinMax
Set TemperatureTemperature85 C80 C90 C
AgitateSpeed120 RPM100 RPM140 RPM
AgitateDuration300 s----
PasteurizeTemperature72 C70 C75 C
PasteurizeHold Time15 s15 s20 s

Prerequisites​

Next steps​