Add custom properties to BOM columns in the rich client

You can add custom properties to the BOM columns in the Structure Manager or other applications where BOM lines are displayed.

Typical circumstances that require this:

• You have added custom business objects to the Business Modeler IDE that are subclassed under the ItemRevision business object, with custom properties added to those custom business objects.
• You have decided instances of these custom business objects should be organized into structures, and want the custom properties visible when looking at the structures.
• You have decided on an application to display the structure, such as Structure Manager, Systems Engineering, and Manufacturing Process Planner, among others.

A simpler way is to use the Fnd0BOMLineRevConfigProps global constant in the Business Modeler IDE to add the custom properties from the custom item revision business object. You can also define compound properties directly on the BOMLine business object and add them to the columns — but you cannot define compound properties directly on the ImanItemLine business object.

The Fnd0BOMLineRevConfigProps global constant behaves similarly to other global constants that control derived BOM line properties. For each, add your custom business object type to the constant, and the properties on the custom type are added as bl_ properties on the BOMLine business object.

Property	Description
BOMLineFormConfiguredProperties	Adds properties from item master types.
BOMLineRevConfiguredProperties	Adds properties from item revision master types.
Fnd0BOMLineItemConfigProps	Adds properties from item types.
Fnd0BOMLineRevConfigProps	Adds properties from item revision types.

Procedure

1. If you have not already done so, create a custom template project to hold your data model changes.

2. On the menu bar, choose BMIDE→Editors→Global Constants Editor.

3. Select the Fnd0BOMLineRevConfigProps global constant and click the Edit button.

4. In the Modify Global Constant dialog box, click Add, add a custom item revision business object, and click Finish.

5. Right-click the project in the BMIDE view and choose Reload Data Model.

6. In the Business Objects folder, open the BOMLine business object and click the Properties tab.

   The properties from the custom business object are added with the naming convention: bl_business-object-name_property-name.

7. Select a new bl_ property, click Edit, and in the Display Name box, type the name you want to use for this property when it appears as a BOM column heading in the user interface (for example, "My Property").

   Tip: If you do not perform this step, the property appears in the user interface with the internal property name. To avoid confusion and make it clear they are the same property, match this display name with the display name of the source custom property.

8. Choose BMIDE→Save Data Model.

9. Deploy the template to a test server by choosing BMIDE→Deploy Template.

10. Verify the new properties in the user interface:

    • Run the rich client on the test server.
    • Send an item revision to an application that has a BOM table, such as Structure Manager.
    • Right-click a column heading in the BOM table and choose Insert Column(s).
    • In the Available Columns box, scroll down until you see your custom property.
    • Select the custom property and click + to add it to the Displayed Columns list, then click Apply.

    The new property displays as a BOM table column.

Note: You can use the BOM_Properties_For_Column_Selection preference to restrict the properties displayed on a column by group or role.