Product model (form)

Article
05/05/2014

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Click Product information management > Common > Product builder > Product models. Select a product model. On the Action Pane, click Open.

Use this form to build the product model.

Note

This information applies only to Product builder.

Note

We recommend that you do not use this form, because it is being officially deprecated and may be removed, and may not be available in future versions of Microsoft Dynamics AX.

In the upper pane, define several types of variables. The variables are used in the product configuration user dialog, and they are also used for calculations in the modeling tree.
In the lower pane, create the modeling tree.

Tasks that use this form

Add modeling variables to a product model

Create calculation variables

Insert a node in the modeling tree

Navigating the form

The following tables provide descriptions for the controls in this form.

Tabs

Upper pane

Tab	Description
Modeling variables	Add modeling variables to a product model. Note The modeling variables must first be created in the Modeling variables form.
System	Create system variables. These variables are used to transfer data from the configured order line or from a parent product model.
Simple	Create simple variables. These variables are used in calculations and conditions.
Data type	Create variables for data types. These variables let you use all of the standard extended data types inMicrosoft Dynamics AX 2012.
Table	Create table variables. These variables let you access data from all of the standard tables in Microsoft Dynamics AX 2012.
Class	Create class variables. These variables let you use all of the standard classes in Microsoft Dynamics AX 2012.
Table constraints	The table constraint ID that is used in the product model.

Lower pane

Tab	Description
Tree	Create the modeling tree. Note The modeling tree is built after the user clicks OK in the Product Builder configuration form. The tree can contain nodes of the following types: Code node – Allows the user write X++ code. IF node – Used to inquire whether a certain condition is met. If the condition is met, the operations described under the attached THEN node of the IF node are performed. If the condition is not met, the operations described under the attached ELSE node of the IF node are performed. Switch node – Used to inquire whether the value of a variable is equal to one of several possible outcomes. The outcomes tested for are defined under the Switch node as a set of case nodes. If the switch value is equal to the value that is specified in a particular Case node, the subnodes of the Case node are run. FOR node – Used to repeat the same operation several times. The operation that is repeated is defined in the subnodes of the FOR node. BOM node – Used to insert a bill of materials (BOM) line in the product model's bill of materials. Route node – Used to insert a route operation in the product model's route. Insert default route – Used to insert a default route, a bill of materials, or a route. Default node – Used to insert all the route nodes from a previously inserted default route. Table node – Used to retrieve values from one or more fields in a table. Information – Used for calculations. Warning – Used to insert an informational message, a warning, or an error message.
Code	View the compiled product model. The product model is expressed as X++ code.

Tree

Create the modeling tree.

Note

The modeling tree is built after the user clicks OK in the Product Builder configuration form.

The tree can contain nodes of the following types:

Code node – Allows the user write X++ code.
IF node – Used to inquire whether a certain condition is met.
- If the condition is met, the operations described under the attached THEN node of the IF node are performed.
- If the condition is not met, the operations described under the attached ELSE node of the IF node are performed.
Switch node – Used to inquire whether the value of a variable is equal to one of several possible outcomes. The outcomes tested for are defined under the Switch node as a set of case nodes. If the switch value is equal to the value that is specified in a particular Case node, the subnodes of the Case node are run.
FOR node – Used to repeat the same operation several times. The operation that is repeated is defined in the subnodes of the FOR node.
BOM node – Used to insert a bill of materials (BOM) line in the product model's bill of materials.
Route node – Used to insert a route operation in the product model's route.
Insert default route – Used to insert a default route, a bill of materials, or a route.
Default node – Used to insert all the route nodes from a previously inserted default route.
Table node – Used to retrieve values from one or more fields in a table.
Information – Used for calculations.
Warning – Used to insert an informational message, a warning, or an error message.

Code

View the compiled product model. The product model is expressed as X++ code.

Buttons

Button	Description
Outcomes	Specify the list of outcomes for the Enumerated text calculation variables or view the list of outcomes for the Enumerated text calculation variables. This button is active only for modeling variables and calculation variables of the Enumerated text type.
Default value	Specify the default values for array variables. If a variable is not an array, or if all array elements have the same default value, you can use the Default field instead.
Validation	Attach validation rules to each modeling variable for the product model.
User profiles	Attach user profiles to one of the product model's modeling variables. If you attach user profiles, only users who belong to one of the selected user profiles can access the variable. Note The user profiles that you attach are enforced only in this product model. To enforce a set of user profiles for a modeling variable in all product models, open the Modeling variables form, and then click Product Builder > Setup.
Grouping	Create a hierarchy of variable groups that controls how the product model's modeling variables are displayed in the user dialog box.
Test model	Test the performance of a compiled product model. Even when no nodes have been added to the modeling tree, you can still use this button to test the user dialog that is generated by the product model's setup of modeling variables.

Fields

Field	Description
Variable group	Select the group that the current modeling variable belongs to. This field is useful for grouping modeling variables in the user dialog. A variable that does not belong to a group is unavailable to the user.
Print	Select if you want the variable group printed on the product model report or not.
Priority	Indicate how the variables will be sorted when they are presented in the user dialog.
Variable	The type designation for the variable. For modeling variables, the name is the name of one of the global modeling variables. To define global modeling variables, open the Modeling variables form, and then click Product Builder > Setup. For variables for data types, the name is the name of one of the data types in Microsoft Dynamics AX 2012. For Table variables, the name the name is the name of one of the tables in Microsoft Dynamics AX 2012. For Class variables, the name is the name of one of the classes in Microsoft Dynamics AX 2012.
Array	A selected check box indicates that the variable group is an array. An array is an indexed table that contains several values, or rows. For array variables, the Max. field specifies the number of array elements, or rows. You can set array properties for modeling variables only in the form that you open by clicking Grouping, and only for whole variable groups.
Max.	If the Array check box is selected, this field specifies the number of array elements, or rows. Array properties for modeling variables can be set only in the form that you open by clicking Grouping, and only for whole variable groups.
Default	Assign a default value to the variable. For modeling variables, you can assign item-related or customer-related default values by using the Default values form. Click Product information management > Setup > Product builder > Defaults > Default values. An item-related or customer-related default value overwrites any default value that you enter in this field. If the Array check box is selected, you can assign default values to each array element by clicking Default value.
Inherit	Select this check box if you want the variable's value to be inherited from a variable in the parent product model. The variable in the parent product model must have the same name as the variable that inherits the value.
Return value	Select this check box if you want the variable's value to be returned to a variable in the parent product model. The variable in the parent product model must have the same name as the variable that returns the value.
Field properties	Set the display properties of the field that contains the modeling variable. The following options are available: Hide – The field is not displayed in the user dialog box. Show only – The field is displayed in the user dialog box. However, the user cannot change the value of the field. Allow edit – The field is displayed in the user dialog box, and the user can select a value for the field. Mandatory – The field is displayed in the user dialog box, and the user must select a value for the field.
Include in reuse	Select this check box to include the variable when you search for configurations that you can use to build other product models.
System variable	Select the type of the system variable. System variables in product models provide information about the ongoing configuration of an item. A product model can contain a maximum of one system variable. The following types of system variables are available: Transfer variable – Used to transfer values between a parent product model and its dependent child model, or submodel. Typically, this type of system variable is the only type that you should write anything into. BOM identification – Contains a copy of the BOM field for the bill of materials that is being generated. Route identification – Contains a copy of the Route number field for the route that is being generated. Lot ID – Contains a copy of the Lot ID field for the order line that is being configured. Item number – Contains a copy of the Item number field for the order line that is being configured. Configuration – Contains a copy of the System variable field for the order line that is being configured. Quantity – Contains a copy of the Quantity field for the order line that is being configured.
Type	The data type of the variable. The following types are available: Text – Used for variables that contain any form of text, characters, words, and so on. Integer – Used for variables that contain whole numbers. Real – Used for decimal numbers. Enumerated text – Used for fixed text variables. You can assign fixed text outcomes to variables of this type by clicking Outcomes.
Variable	Type an unambiguous name for the variable. This name is used in the modeling tree.

Product model (form)

Tasks that use this form

Navigating the form

Tabs

Upper pane

Lower pane

Buttons

Fields

See also

Additional resources