Knowledge Base - Cloud Connect

Set up BOM Route Generator

The traditional Experlogix database setup includes Series, databases, Categories, Options, and Properties. While this setup allows complete control over the Configurator and the information created in Dynamics 365, it requires changes to be applied and moved across development stages(Test, Stage, Production) which can be cumbersome for larger organizations. The new BOM Route Generator for Cloud Connect Microsoft Dynamics 365 F&O addresses this by:

  • Defining variables within Microsoft Dynamics 365 F&O.

  • Using the Experlogix database and Cloud Connect to assign variables and values to configurations.

Linking these variables to active BOM/Route lines in Microsoft Dynamics 365 F&O, and creates an ‘over-complete’ or ‘super’ BOM/Route that filters options based on the set variables and values. These changes streamline the process by reducing the need for frequent Configurator publications, facilitating better collaboration.

BOM & Route Generation Parameters

To ensure the proper functionality of the Experlogix BOM and Route Generator, it is crucial to complete the parameter setup for each company where the generator will be used. Since BOMs and Routes are stored by company in Microsoft Dynamics 365 F&O, you must define a BOM/Route number sequence in the Parameters form for each entity.

Follow these steps to update the parameters for your organization and save the configuration for the BOM/Route Generator.

You must complete this setup process for every Microsoft Dynamics 365 F&O company for which you wish to use the Configurator and the BOM Route Generator.

  1. In Microsoft Dynamics 365 F&O, in the search box, search for Parameters and select > Experlogix Integrator > Parameters.

    Search Finance Operations Parameters FNO.png
  2. Update the Parameters for your organization.

    CompanySpecificParametersForm.png

Sections

Parameter

Definition

SETUP

BOM value type

Specifies the type by which the link between the BOM line and the BOM values will be defined. Options include:

  • Item

  • Line number

  • Position

BOM value type is the key which links the BOM lines from your configuration to the Microsoft Dynamics 365 F&O BRG BOM Values. When changing BOM value types, you must migrate all your existing BOMs to the new type. Search for and select the Migrate BOM Values action (Experlogix Integrator > BOM & Route Generation > Periodic). If the type is unchanged and no BOM migration is needed, you will receive the following notification in Microsoft Dynamics 365 F&O's Action Center: "Bom value has not change: migration is not needed." Otherwise, the Action Center notification informs you when the migration has been completed successfully.

Step size increment

Specifies the value by which the new lines on the BOM and/or Route value form will increment.

RUNTIME

Employee for approval

Specifies the user that serves as an approver for BOMs and routes.

BOM Number Sequence

Specifies the number sequence used when the BOM Route Generator creates new BOMs.

Route Number Sequence

Specifies the number sequence used when the BOM Route Generator creates new routes.

Activate BOM Version

Allows the administrators to control whether the BOM Route Generator automatically activates newly created BOM Versions during generation. The default value is No.

Activate Route Version

Allows the administrators to control whether the BOM Route Generator automatically activates newly created Route Versions during generation. The default value is No.

Allow auto processing this company

If Yes, on a successful save and close of the Configurator, the BOM Route Generator triggers automatically.

Allow intercompany auto-processing

If Yes, triggers the BOM Route Generator when an intercompany sales order is created in this company.

For intercompany auto-processing to work, the Allow automated processing parameter must be set to Yes in the Global BOM Route Generator Parameters.

For a detailed list and explanation of all Experlogix parameters present in your Microsoft Dynamics 365 F&O environment, see Experlogix Parameters.

  1. Select the Save button.

Save Experlogix Intergrator Parameters.png

You've successfully setup the parameters for the BOM Route in this company. Next we'll set up the processing entities for this company for interacting with the BOM and Route Generator, continue to Processing entity setup.

Data Migration

As part of the BOM Route generator , Experlogix supplies the following data entities to support easy import and export of data:

Technical Name

Functional Description

XplBrgConfigValueEntity

Experlogix config values

XplBrgBomTableValuesEntity

Experlogix bom table values

XplBrgBomValueEntity

Experlogix bom table values

XplBrgRouteValueEntity

Experlogix route table values

XplBrgItemConfigEntity

Experlogix item config values

XplBrgVariablesEntity

Experlogix variables entity

Processing Entity Setup

This section provides a step-by-step guide for setting up processing entities within the Experlogix Integrator. You will be guided through the selection of data entities and the configuration of the Connector handler.

  1. In Microsoft Dynamics 365 F&O, in the search box, search for Experlogix Processing and select Experlogix Integrator > Experlogix Processing Entities.

    FO_Search for Experlogix Entities.png
  2. Select Actions.

    FO_Experlogix Processing entity.png
  3. Select Entity wizard.

  4. In the Enter Data entity or Table ID field, search and select XplBrgItemConfigEntity.

    FO_search_and_selectbrgconfig.png
  5. Select Next.

    FO_FinishBRGCongfigValue.png
  6. Select Finish.

  7. Repeat steps 2 through Step 6 for XplBrgItemConfigEntity.

  8. In the List view, select Experlogix processing entity XplBrgItemConfigEntity.

    FO_Set Connector Handler.png

If you do not see the Connector handler field, you must personalize your view to display it on the form. For more information, see the Personalization toolbar.

Personalize Form.png
  1. Set the Connector handler to XplBrgConnectorHandler.

You've successfully set up the processing entities for the BOM and Route in this company. Next, we’ll focus on Experlogix Variables, which are crucial for streamlining the BOM and Route generation processes across companies in an intercompany set up. Continue to the Experlogix Variables section to learn how to setup Experlogix global variables for flexible operations.

Experlogix Variables

Experlogix variables streamline the BOM and Route generation processes by providing a global list of variables you can assign to configurations across companies. You manage these variables in the Experlogix Integrator module under BOM & Route Generation > Variables. Since they are stored globally, they are not tied to a specific company, making them more flexible and efficient for intercompany operations.

Due to the diverse requirements across industries, we recommend reviewing the specific examples below that illustrate how to create and manage variables in the BOM and Route Generation process. This enhances flexibility, enabling you to customize the system's capabilities to meet your specific needs, instead of applying a universal approach to all implementations.

Accessing the Microsoft Dynamics 365 F&O Global Experlogix Variables

In Microsoft Dynamics 365 F&O, in the search box, search for Variables and select > Experlogix Integrator > Variables.

FNO Search for Global Variables.png

You can create and manage Experlogix variables using the actions in the form ribbon.

FNO BOM and Route Generation Varibles Form.png

Microsoft Dynamics 365 F&O Experlogix Integrator BOM & Route Generation Variables Parameters

Field

Description

Variable

Display the ID of the variable.

Description

(Optional)Provides a user-friendly description of the variable.

Data type BOM Route Generator

Sets the data type of the variable with the following options: Text, Integer, Real, Enumerated text, and Boolean

Type of variable

Sets the behavior of the variable with the following options.

  • Selection: Used to include or exclude a line.

  • Quantity/Time: Used to replace a value on a record.

Values

If the Data type Bom Route Generator parameters are enumerated text, the Values button in the ribbon can be accessed. The Values table opens as a new table.

FNO Enumerated Text Type Values View.png

Field

Description

Value

Defines the value for the variable. The Configurator usually defines this value unless the Data type Bom Route Generator value is Enumerated text.

Description

(Optional)Provides a user-friendly description of the variable.

Variables General Tab

The Variables General tab displays additional information based on the selected variable in the Overview tab. Once you select a variable, the General tab auto-populates with relevant data, offering an at-a-glance summary of key variable attributes.

FNO Variables General Tab .png

Microsoft Dynamics 365 F&O Experlogix Integrator BOM & Route Generation Variables General Tab Parameters

Field

Description

Variable

Display the ID of the variable.

Description

(Optional)Provides a user-friendly description of the variable.

Data type Bom Route Generator

Sets the data type of the variable with the following options: Text, Integer, Real, Enumerated text, and Boolean

Type of variable

Sets the behavior of the variable with the following options.

  • Selection: Used to include or exclude a line.

  • Quantity/Time: Used to replace a value on a record.

Table name

Sets the Table name for the variable with the following options: BOM, BOMTable, Route, RouteOpr(Route Operations), and InventDim(Inventory Dimension). The Table name parameter is only applicable if the Type of variable is Quantity/Time.

Field name

The Field name parameter is only applicable if the Type of variable is Quantity/Time. The selection for Field name is based on the selected Table Name. Field name states what field will get a new value from the variables and values.

Create product variant

When set to Yes while running the BOM Route Generator, a new product variant (for a product master) will be created if it does not exist. If a product variant exists, the process will be an existing one.

The Create product variant is only used and can be enabled if the following is true:

  • The type of variable = Quantity/Time

  • The Table name= InventDim

Setting up the Process Designer for BOM and Route

When using the above setup, you must create a Number Series for the BOM Route Generator in Microsoft Dynamics 365 F&O. There are several methods to achieve this, but each configuration must have a unique identifier for each Microsoft Dynamics 365 F&O company. Creating the unique Number Series is crucial for using the BOM Route generator.

BRG Example Number Sequence.png
  1. Create the default processing maps for Microsoft Dynamics 365 F&O in Process Designer, see Process Designer Examples

  2. In Process Maps in Process Designer, add the following entities for BOM and Route.

XplBrgItemConfigEntity Header Details

Field

Value

Name

Item config

Process integration

Name of Microsoft Dynamics 365 F&O Process integration

Entity

XplBrgItemConfigEntity

Template

 

Option Link Property

 

XplBrgItemConfigEntity Lines - Mapping

Name

Field

Data type

Mapping type

Value

Option Attribute

Source

Destination

ConfigId

Configuration ID

String

Property

Any text property present on Option

 

 

ConfigMas

Description

Description

String

Property

Description

 

 

 

ItemConfigId

Item config id

String

NumberSeries*

Prerequisites

When using the above setup, you must create a Number Series for the BOM Route Generator in Microsoft Dynamics 365 F&O. There are several methods to achieve this, but each configuration must have a unique identifier for each Microsoft Dynamics 365 F&O company. Creating the unique Number Series is crucial for using the BOM Route geneator.

BRG Example Number Sequence.png

BRG

 

 

 

XplBrgConfigValueEntity Header Details

Field

Value

Name

Config value.

Process integration

Name of Microsoft Dynamics 365 F&O Process integration.

Entity

XplBrgConfigValueEntity

Template

 

Option link property

 

XplBrgConfigValueEntity Lines - Mapping

Field

Description

Employee for approval

The dropdown menu allows you to select the user who completes the approvals.

BOM Number Sequence

Number series to use when creating BOMs; see Number Sequences in Set up Cloud Connect for Microsoft Dynamics 365 F&O.

Route Number Sequence

Number series to use when creating routes; see Number Sequences in Set up Cloud Connect for Microsoft Dynamics 365 F&O.

BOM Value type

This dropdown allows you to select the type of value associated with each item in the Bill of Materials (BOM). The options include:

  • Item: Refers to the specific component or part listed in the BOM.

  • Line Number: The sequential number assigned to each item in the BOM helps to identify and organize the items.

  • Position: The exact location or placement of an item within the BOM.

Step size increment

This setting determines the numerical increment for new records on the Experlogix BOM/Route values form.

Example Step Size: If you set the step size increment to 5, the first record will be 5, the second 10, and the third 15.

  1. Test your setup to see if the setup has been done correctly. If set up is done correctly when you save and close on one of the supported entities, the BOM and Route will generate automatically.

Example Process Structure for BOM and Route

This process structure is derived from our Anne's Aquariums sample database.

Process Structure for BOM and Route.png

The ConfigVar Category is used to write the 1:N variable to the item config table in Experlogix and provides the following data in our example process designer data: Data Example File.

FNO Example Config Category in Experlogix.png

In Microsoft Dynamics 365 F&O, Experlogix integrates with the Bill of Materials (BOM). Linking Experlogix variables to a BOM enables users to dynamically adjust production details based on defined variables such as quantity, time, or product attributes (e.g., Color).

Alex Turner, the Senior CPQ Solutions Architect at Anne's Aquariums, is responsible for configuring BOMs for custom manufacturing orders. For a new product, she must ensure that the BOM dynamically adjusts based on customer-specified attributes. Specifically, she needs the system to create a copy of the BOM Line if one of the items is blue and she wants to replace BOM Quantity with a value from the Experlogix configuration when this occurs.

  1. In Microsoft Dynamics 365 F&O, in the search box, search for Bills of Materials and select Product information management> Bills of materials and formulas.

    FNO_SearchandSelectBillsofMaterials.png
  2. Select a BOM from the list.

    FNO_SelectExampleBOM.png
  3. Select a BOM line

    FO_Select BOM Values.png
  4. Select the BOM Values button.

BOM Values Button

The BOM Values button, part of the Experlogix BOM Route Generator in Microsoft Dynamics 365 F&O, is located within the Bill of Materials (BOM) form and allows users to apply dynamic, variable-driven configurations to specific BOM lines. It directly integrates variables such as product attributes (e.g., color, quantity, time) into the BOM, enabling adjustments to components based on real-time data. To access it, navigate to Modules > Product Information Management > Bills of Materials and Formulas > Bills of Materials, select a BOM and BOM line, and the BOM Values button will appear on the BOM line form. This form also supports advanced logic, including the use of operators like "And," "Or," and "Not."

  1. Select the +New button.

    FO_Create condition on BOMVALU Form.png
  2. Create a BOM Line copy rule.

    1. In the And Or selection dropdown, define whether to use advanced logic.

    2. (Optional) Set your Not selection value if you want to invert the statement's logic so that the value does not equal the value.

    3. In the Variable dropdown, select the variables for the condition. The Type of Variable is automatically populated based on your selected variable.

    4. In the Operator dropdown, select the Operator for the rule.

    5. In the Value dropdown, select the value for the variable when evaluating the rule.

Example BOM Condition on Variable Color

In this process, if the client selects "Blue" as the item color, the system will create a copy of the BOM line. Additionally, the BomQty field, which has a Type of variable value of Quantity/Time, will be dynamically replaced with the value provided by the Experlogix configuration during this action.

BOM Value Example Image.png

Not Color = Red would run when the variable Color is not equal to Red.

BOM Values Form Advanced Logic Overview

The BOM Values form allows for using advanced logic through the "And/Or" selection and Not selection dropdowns, along with various operators. Here’s how each option works:

None: This operator inverts the condition of a single line. If you need to apply the inversion across multiple lines, you must apply the "Not" operator to each line individually.

And: The "And" operator takes precedence over "Or" when generating a logical statement. This means that "And" will group conditions more tightly, requiring both conditions to be true, before evaluating any "Or" conditions.

Or: The "Or" operator is evaluated after any "And" operators, meaning that if any condition connected by the "Or" is true, the entire statement is evaluated as true, but only after all "And" conditions have been evaluated.

  1. Select Save.

Once you've set up the condition in the BOM Values form, be sure to approve and activate the BOM. Experlogix relies on the Microsoft Dynamics 365 F&O active BOM concept to locate the Overcomplete/Super BOM. For more detailed guidance on activating BOMs in Microsoft Dynamics 365 F&O, refer to the official Microsoft documentation.

View BOM Table Values

The BOM table values option under e‑Con BOM Route generator on the Bills of materials page allows users to view BOM-related values generated by the Experlogix BOM Route Generator for a selected BOM. This feature provides read-only visibility into generated data to support validation and troubleshooting.

  1. In Microsoft Dynamics 365 Finance & Operations, navigate to Modules > Production information management > Bills of materials.

  2. Select the required BOM.

    BOMTablevalues.png
  3. On the action pane, expand BOM Route generator, and select e-Con BOM table values.

    BOM-Table.png

The Experlogix – BOM Route Generator – BOM table values page opens. Quantity/time variables can be added here.

BOM-TableResult.png

In Microsoft Dynamics 365 F&O, Experlogix integrates with the Route functionality to enable dynamic adjustments to production processes based on defined variables. This allows businesses to streamline operations by configuring routes based on specific attributes, similar to the process for BOMs.

  1. In Microsoft Dynamics 365 F&O, in the search box, search for All routes and select Product information management> Bills of materials and formulas.

    FO_SearchandSelectAllRoutes.png
  2. Select a route.

    FO_SelectaRouteNumber.png
  3. Select Route

    FO_RouteDetails.png
  4. Select Route Details.

  5. From the Route Details page, select Route.

    FO_RouteValuesForm.png
  6. Select the Route Values button.

Route Values button

The Route Values button, similar to the BOM Values button, allows users to directly integrate variables such as Size or Process Time into the route. Clients can leverage flexible, real-time adjustments to operations based on Experlogix configurations. You can access the button from the Route Details screen in Microsoft Dynamics 365 F&O.

  1. Select the +New button.

    FO_Create new Condition on Route.png
  2. Set up a Route Operation Copy Rule:

    1. In the And/Or selection dropdown, define whether to use advanced logic.

    2. Set your Not selection value, if needed, to invert the condition.

    3. In the Variable dropdown, select the variable for the condition.

    4. In the Operator dropdown, choose the operator to apply.

    5. In the Value dropdown, select the value for the variable when evaluating the rule.

BOM Values Form Advanced Logic Overview

The BOM Values form allows for using advanced logic through the "And/Or" selection and Not selection dropdowns, along with various operators. Here’s how each option works:

None: This operator inverts the condition of a single line. If you need to apply the inversion across multiple lines, you must apply the "Not" operator to each line individually.

And: The "And" operator takes precedence over "Or" when generating a logical statement. This means that "And" will group conditions more tightly, requiring both conditions to be true, before evaluating any "Or" conditions.

Or: The "Or" operator is evaluated after any "And" operators, meaning that if any condition connected by the "Or" is true, the entire statement is evaluated as true, but only after all "And" conditions have been evaluated.

Example Route Condition on Variable Size

In this example, if the client selects 1000 as the value for the Size variable, the system will create a copy of the route operation. Additionally, the RunTime field, which has a Type of variable value of Quantity/Time, will be dynamically replaced with the value provided by the Experlogix configuration during this action.

FO_Route Values Form Example.png
  1. Select Save.

Once you have set up the condition in the Route Values form, you must approve and activate the route to finalize the configuration. Like the BOM process, Experlogix relies on the active route concept in Microsoft Dynamics 365 F&O. For more details on activating routes, please refer to the official Microsoft documentation.