Recipe Parameter Tag

A Recipe Parameter tag is not counted towards your tag license limit, but each will be the parent of an I/O tag that may be counted if it contains a read or write address. I/O tags that are memory tags (without read or write addresses) are not counted.

If you are building your first recipe, start by reading Batch & Recipe Management before creating recipe-related tags and widgets.

A Recipe Parameter reads, writes and holds one of the values that makes up a recipe. Recipe Parameter tags must be descendents of a Recipe Book, and should be descendents of the Parameter tag within the Recipe Book structure.

Each Recipe Parameter tag has a child tag named Parameter Value. Do not edit or otherwise work directly with the Parameter Value tags.

A Recipe Book can contain multiple recipes. Each Recipe Parameter tag will hold only the value for the recipe currently selected in the Recipe & Batch Management Page. If an parameter is not used in a given recipe or recipe version, the value for that tag is zero or Invalid. Values for use with each recipe in the Recipe Book are stored in a comma-separated values (CSV) file, and loaded into the parameter tag when you select each recipe or version within the Recipe Book.

Recipe Parameter tags can be created automatically from information stored within an Access™ database file or an Excel™ spreadsheet. Look in the Recipe & Batch Management Page for the import tool.

Each Recipe Parameter tag has as a child I/O tag named Parameter Value, which may be a memory tag, or may be used to read or write the value from or to the PLC. These I/O tags are configured using expressions and (in general) should not be edited directly. You cannot change the name of an Parameter Value tag.

To change the name of a recipe parameter, change the Parameter Name property in the I/O tab or the properties dialog. The tag name is not the parameter name, although it is easier to manage parameters if they match.

The built-in Recipe & Batch Management Page will display all Recipe Parameters for a Recipe Book automatically except for the three that are created automatically: The Recipe Name, Recipe Version and Batch Number.

A Recipe Parameter tag can be drawn on any page using a control widget. This might be done if building a custom page for defining or viewing the recipes of a Recipe Book.

Every Recipe Book will contain an parameter tag named "Recipe Name". If versioning is permitted, there will also be an parameter tag named "Recipe Version".

Recipe Parameter tag properties, I/O tab

Parameter Name

Holds the name used to identify the parameter in the Recipe Book's CSV file and in an Access® or Excel® file (for imports and exports). Parameter names must be unique within a Recipe Book.

Changing this parameter will automatically update the CSV file.

The Parameter Name parameter is also used as the column name in an Access or Excel table. If you want to read from or write to a file, your Parameter Names must match the column names.

Address

I/O address on the PLC for this parameter.

Data Type

Identifies the type of data required by the parameter. May be any of Analog, Discrete, Digital (1-bit), or String.

Equipment Type

If an equipment type has been defined for this parameter in the SystemStyle tag, it can be selected here. On the Recipe & Batch Management Page, users will be able to pick from a drop-down list of the labels defined in that equipment type for the value they want to configure.

Actual values for these labels are 0.25, 0.5, 0.75 ...

All equipment types for use with recipe parameters must be defined in the default SystemStyle tag. There is no option to choose an alternate style tag.

Engineering Units

Provide the units of measure that the value represents.

Digits After Decimal

Limits the number of digits shown after the decimal point wherever this tag is displayed.

Min

Minimum value that may be written.

Max

Maximum value that may be written.

Proportions Tag

Optional. Link to a Recipe Proportions Tag. Doing so allows you to set a multiplier applied at run time, or specifies that this parameter is one of several that must make up a predefined total.