Substitute Attributes and Status

(Available with Order Execution Mgt.)


Substitute Attributes and Status exchanges all attributes and status bits of the current product item, including its sales order association (its ASSOCIATE extended attribute value), with the attributes and status bits of a product item in a specified region/location.

For substitution to work, the selected item must have an extended attribute named ASSOCIATE that identifies the Item Type of its associated item.


A PRT model is set up to track a BODY Item Type assembly.

The BODY Item Type has an extended attribute ASSOCIATE.

The ASSOCIATE extended attribute value is, literally, the value of another Item Type, ORDER.

ORDER  may be defined in the same, or another model.

ASSOCIATE attribute values are as follows.

ASSOCIATE attribute of the:

Is the Value Assigned to the:

Currently selected body item

ORDER item's attribute in the specified region\location.

ORDER item in the specified region\location

Currently selected body.

All other attributes and status bits are similarly swapped between the currently selected body and the body at the specified region location.

While the example above shows substitution of orders for different bodies, it is also possible to substitute bodies for different orders. You can only substitute the Item Type that is associated with the Item Type you have currently selected.


Both sales orders and products are items.

You can use this function block if:

Product items exist at some region defined in the current project's RCO database and

Order items exist in either the current project or another running project to which you have access.

You can search for the specified region across multiple projects. Enter a comma-delimited list of project names where the region may be found into the Project ID field and recompile.

Where all item eliminations (by any and all methods) have been completed.

  1. Insert another function block such as

Select Lowest Weight

Select Source By Age

before Substitute Attributes and Status to insure that the most appropriate item(s) are selected.

If you have criteria to determine which item should be selected in case of a tie, specify that criteria in an RSA function block inserted before the Select block.

  1. Insert Substitute Attributes and Status.

Caution: Attributes and status bits can be used for a wide variety of purposes. Use this function block with care and only after investigating the application of all attributes and status bits that belong to current item and its associate item.


This function block has the following parameters:



Region ID

ID of Region where the item is located.

Region Location

Location of the item in the Region.

Note: The reserved names PRT_FIRST and PRT_LAST can be entered in Region Location to specify the first  or last location, respectively, within the region.

Item Class

Class of the item whose sales order will be exchanged.

Project ID

(Optional) Names of one or more projects in which the selected region may be found.

Note: Leave this field blank to limit the search for regions to the local project only.

Project Point ID

(Optional) Text point.

Stores a list of project(s).

Supercedes Project ID.

More information

Substitute Order.

Item Associations: ASSOCIATE extended attribute.

About Order Substitution.

RSA function blocks list.