Adding dynamic menu fields to Smart IT views
In Smart IT, if you are an administrator, you can add one or more dynamic menu fields that have menus associated with them in BMC Helix ITSM. You can configure menu fields on the universal client , using the Screen Configuration option. At run time, these menus will be available on all clients. These menu fields are dependent menus such as, Owner Support Company, Owner Support Organization, Owner Group, and Owner. Dependent fields are part of the BMC Helix ITSM menu qualification. The Smart IT server requires these fields to expand a menu and fetch menu items. Therefore, you must ensure that these fields are available in Smart IT.
Using the Populate value with different field option, you can configure a menu that has a different label and value from one another (as part of the BMC Helix ITSM menu definition), where the value is stored in another field. You select this option only when a field has a menu associated with it in BMC Helix ITSM.
Note
Before adding dynamic menu fields to Smart IT, review the prerequisites for adding custom fields to your views using Smart IT. See Adding custom fields to your views using Smart IT.
The procedure to add menu fields in the Type-specific area of the Asset view slightly differs from the way menu fields are added in other Smart IT views. To add fields in the type-specific area, you must select the asset type and subtype, and then add fields. The fields are added only to the selected asset subtype.
Click the following video to view how to add a Owner Group, which is a dynamic menu field, within Smart IT views.
Click the following video to view how to add a Vendor Group, which is a dynamic menu field, within Smart IT views.
To add a single menu field
- From the Configuration menu, select Screen Configuration.
- In the Configuration window, select an area in a Smart IT view. For example, select Record Summary in the Incident view.
- Under Available Fields, click the Add (+) icon for a menu field you want to add.
The menu field is then displayed under Selected Fields. Expand the CI list to display options and dependent menu fields.
To add the CI field, all dependent fields must be available in Smart IT. In this example, the z1D_Local_DataSetID and Person ID fields are not available in Smart IT. The following table provides more information about dependent menu fields marked with and icons.Icon Meaning The field is missing from Action Request System forms and hence not configured in Smart IT. Hover over the name of the form from which the field is missing. You must add the missing field to the form and make it available in Smart IT. For more information, see Adding dynamic menu fields to Smart IT views.
icon to view theA field available in AR System forms, and also configured in Smart IT.
The CI menu field has a menu associated with it in BMC Helix ITSM. To know which field to select in the text box under Populate value with different field, you must look for the menu definition in the Developer Studio. On the HPD:HelpDesk form, the HPD:CustomerCIwithoutBusinessService menu is associated with the CI menu field. In the HPD:CustomerCIwithoutBusinessService menu, the value field for the CI menu field is ReconciliationIdentity . In BMC Helix ITSM, the value of the CI menu field in active link is set to HPD_CI_ReconID menu field.
- In Smart IT, select the Populate value with different field check box and type HPD_CI_ReconID in the text box.
- Add the z1D_Local_DataSetID and Person ID fields to the forms from which they are missing, and make them available in Smart IT.
For more information, see Adding dynamic menu fields to Smart IT views. - Click Save.
Open an incident ticket to view the CI menu field.
To add multiple menu fields to a group
In Smart IT, some menu fields depend on other menu fields to get their value; for example, the Owner Group and Owner menu fields depend on the Owner Support Company and Owner Support Organization menu fields.
Best practice
- From the Configuration menu, select Screen Configuration.
- In the Configuration window, select an area in the Smart IT view. For example, select Record Summary in the Incident view.
- Under Available Fields, click the Add (+) icon for menu fields you want to add.
The added menu fields are displayed under Selected Fields. To add the Owner Group and Owner menu fields in Smart IT, the Owner Support Company and Owner Support Organization menu fields must be available in Smart IT. For example, in the following image the Owner Support Company, Owner Support Organization, Owner Group, and Owner menu fields have been added. The Owner Support Company is not dependent on other menu fields in this group. However, the remaining three menu fields are dependent in the following way:- The Owner Support Organization menu field depends on the Owner Support Company menu field.
- The Owner Group menu field depends on the Owner Support Organization menu field.
- The Owner menu field depends on the Owner Group menu field.
- Click Create Group.
- Drag and place menu fields in their hierarchical order in the Drop Fields Here placeholder.
- The Owner Group menu field has a menu with different label and value field associated with it in BMC Helix ITSM.
To find the associated menu, see To add a single menu field section in Adding dynamic menu fields to Smart IT views. In BMC Helix ITSM, the value of the Owner Group menu field in the active link is set to Owner Group ID menu field. - In the Owner Group menu field, select the Populate value with different field check box and enter Owner Group ID in the text box.
- The Owner field also requires a menu with different label and value field associated with it. See the To add a single menu field section in Adding dynamic menu fields to Smart IT views topic to find out the associated menu. The value of Owner menu field in the active link is set to Owner Login ID menu field.
- In the Owner menu field, select the Populate value with different field check box and enter Owner Login ID in the text box.
- Click Save.
- (Optional) Open an incident ticket to view the group.
To add menu fields to an asset subtype
As an administrator, you want to add the Domain field to the computer system subtype of assets. To do so, follow these instructions:
- From the Configuration menu, select Screen Configuration.
- In the Configuration window, click Type-Specific Area in the Asset view.
- From the list of asset types, select Computer System subtype.
A list of available fields is displayed. - Under Available Fields, click the Add (+) icon for the Domain field.
- The Domain field is displayed under Selected Fields.
- (Optional) Expand the Domain list to select additional options such as, Required, Hide Label, and Populate value with different field.
- Click Save.
A confirmation message is displayed.
Open an asset with computer system as the subtype to verify that the Domain field is added to the Asset view.
Examples of customizing the default menu fields
Smart IT does not support active links. In such cases, you might need to import workflow (filters, active links) to support menu fields. If there are any active link interactions on these menu fields, you need to replace them using an equivalent filter. If you have customized out-of-the-box menu fields as part of your business needs, then you must create filters using the following examples. Details about such menu fields and filters are available in BMC Communities.
The following is an example of customizing the Vendor Group menu.
BMC Helix ITSM version | 18.05 and later |
Menu Name | CTM:SGP:VendorSupportGroup-Q |
Dependent fields | Vendor Name Vendor Organization |
Note
To edit this group of fields, you must import the !!!HPD:INC:VendorFieldSetForSmartIT filter available in SampleWorkflowQueryMenuFields.zip in BMC Communities. Extract the files and navigate to: Workflows > 81 > Incident > VendorGroup > VendorGroup-Filter.def.
Follow these steps to customize the Vendor Group menu field:
Add dependent fields to the incident interface forms.
Note
By default, Vendor Organization is a "Not in view" in BMC Helix ITSM. To make it available for customization in Smart IT, you must add it an "In view" field in the HPD:Help Desk form.
- On the Configuration window, click Refresh metadata for the Incident view.
- Use the Configuration option to add dependent fields as custom fields in the appropriate panel.
- To create or update the Vendor Group menu field, import the .def file that contains the necessary backend filters from the sample workflow document in BMC Communities.
Click Save .
Comments
Log in or register to comment.