The Action Builder is a guided, click-based interface that helps you construct action expressions without manually typing formulas. It is used to populate the Success Action and Fail Action fields in Algorithm Design.
:gear: Overview
An action expression defines what the system should do when a process step succeeds or fails. In a pharmaceutical context, actions typically capture instrument readings, record operator inputs, or set values that drive downstream process behavior.
An action expression follows the pattern:
Variable(s) = Instrument/Value
For example: RecordedTemp = TIT_01 or Volume1, Volume2 = FI_01
Pharma example: During a CIP (Clean-in-Place) cycle, the success action for a supply valve step might be:
CIP_SupplyValveOpen = XV_CIP_01
This records the confirmed position of the CIP supply valve into a variable for traceability, ensuring the valve opened before chemical flow begins.
:desktop_computer: Window Layout
The Action Builder window is divided into five areas:
|
Area |
Purpose |
|---|---|
|
Selection Area |
Click to select Variables and an Instrument |
|
Edit Area |
Two text boxes showing current selections — editable for custom values |
|
Logical Operators |
AND button to combine multiple atomic assignments |
|
Final Formula |
Live preview of the complete expression being built |
|
Commit Area |
"Insert Action" to apply, or "Cancel" to abort |
:footprints: How to Use
Building a Simple Action
|
Step |
Action |
Result |
|---|---|---|
|
1 |
Click one or more Variables in the Selection Area |
Variables appear in the first Edit box (e.g., |
|
2 |
Click an Instrument in the Selection Area |
Instrument appears in the second Edit box (e.g., |
|
3 |
Review the Final Formula at the bottom |
Shows the complete expression (e.g., |
|
4 |
Click "Insert Action" |
The expression is inserted into the action field |
Using Custom Values
Instead of clicking an Instrument, you can type directly in the Edit Area. This is useful for:
-
Capturing operator input: type
operator inputin the second box -
Setting a static value: type
34lor100°Cin the second box -
Using calculations: type any custom text
Example: Volume1 = operator input
Building Complex Actions
To combine multiple assignments:
|
Step |
Action |
|---|---|
|
1 |
Build your first assignment (e.g., |
|
2 |
Click AND in the Logical Operators area |
|
3 |
The first formula is saved, and the Selection/Edit Areas reset |
|
4 |
Build your second assignment (e.g., |
|
5 |
The Final Formula shows: |
Tip: Parentheses are added automatically. Uncheck the parentheses checkbox to disable them.
:test_tube: Pharma Example Walkthrough
Scenario: You are configuring a CIP supply step. When the step succeeds, you want to record the CIP supply valve position and the supply-side temperature for batch documentation.
-
Select variable
CIP_SupplyValvePos -
Select instrument
XV_CIP_01(the CIP supply valve) -
Click AND
-
Select variable
CIP_SupplyTemp -
Select instrument
TIT_CIP_01(the CIP supply temperature transmitter) -
Final formula reads:
(CIP_SupplyValvePos = XV_CIP_01) AND (CIP_SupplyTemp = TIT_CIP_01) -
Click "Insert Action"
This ensures that every time the CIP supply step completes, both the valve confirmation and the supply temperature are captured for the batch record.
:bulb: Tips
-
The Final Formula area is directly editable for manual adjustments
-
Multiple variables can be assigned the same instrument reading at once
-
Use custom text in the Edit Area for values that are not in the Selection lists
-
Actions are part of the Algorithm Design workflow — they appear in each step of the SFC Editor as well
:link: Related Pages
-
Algorithm Design — Where actions are used within process step definitions
-
SFC Editor — The Sequential Function Chart editor where actions appear in step detail
-
Build Condition Field — Similar builder for condition expressions
-
Variable — Named storage values used in actions
-
Instrument — P&ID measurement devices