Adding custom fields to the Asset View

As an administrator, you can add custom fields to the Asset View in BMC Helix ITSM by adding a field to the data model in BMC Helix CMDB or AR System forms. The recommended process is to add a field to the data model in BMC Helix CMDB. If the custom fields are not a part of the CMDB data model, but are managed by Asset Management, you can use the AR System forms.

To add fields to an existing asset UI for a Progressive Web Application

For Asset Management in Progressive Web views, a single form displays all asset classes. However, in classic mid-tier views there is one form per class. In Progressive Web views, a specific section of the form can display class-specific attributes. These are stored for each class in a simple additional form which is displayed seamlessly within the Asset form. The additional form is not needed if there are no class-specific attributes to be displayed.

Out-of-the-box, these additional forms are provided for the Computer System, Processor, and Applications asset classes. For any other class, you can display the additional attributes by creating the following additional form.

Open Developer Studio in the Best Practice Customization mode (the default).
In AR System Navigator, expand All Objects, double-click Forms.
In the Filtering Options, enter the item name. For example, AST:Application.
From the Form menu, click Create New View.
If Create New View is disabled, perform the following steps:
1. From the Form menu, click Create View Overlay.
2. In the Developer Studio dialog box, click Yes.
3. From the Form menu, click Create New View.
To open the view for which you want to add fields, click the required view at the bottom of the form.

For computer system, processor, and application, the following views are available:
Purpose
View name
To create asset types
SV_Attribute_Create
To view asset types
SV_Attribute_View
To edit asset types
SV_Attribute_Edit
If you want to add an existing field from the Mid Tier asset form, from the Form menu, click Add/Remove fields in View.
Select the fields from the Fields not in View: list, and click >> to move fields to the Fields in View: list.
Click OK.
Click File, and then click Save.
The new fields are added to the progressive view and are displayed on the existing asset form.

Purpose	View name
To create asset types	SV_Attribute_Create
To view asset types	SV_Attribute_View
To edit asset types	SV_Attribute_Edit

To create custom form views for a Progressive Web Application

Based on the requirements of your organization, you can create new form views for use in a Progressive Web Application. Out-of-the-box forms for the following asset types are available:

Computer system
Processor
Application

If you want to create a UI for other asset types, you must perform the following tasks:

Task No.	Task
1.	To create a new Progressive Web Application view
2.	To configure the customized view in a progressive web application form

To create a new Progressive Web Application view

Open Developer Studio in Best Practice Customization mode (the default).
In AR System Navigator, expand All Objects, and double-click Forms.
In the Filtering Options, enter the item name. For example, AST:Printer, and then click enter.
From the Form menu, click Create View Overlay.
In the Developer Studio dialog box, click Yes.
From the Form menu, click Create New View.
From View Type, select Progressive.
In the confirmation dialog box, click OK.
(Optional) Add panels to the form as required. For more information about panels, see Developing Progressive Web Applications.
To add an existing field from the Mid Tier asset form, from the Form menu, click Add/Remove fields in View.
Select the fields from the Fields not in View: list, and click >> to move fields to the Fields in View: list.
Click OK.
Click File, and then click Save.
Depending on the purpose of the view, make sure you save the view with the following view names:
For more information about renaming views, see Modifying form views
Purpose
View name
To create asset types
SV_Attribute_Create
To view asset types
SV_Attribute_View
To edit asset types
SV_Attribute_Edit

Purpose	View name
To create asset types	SV_Attribute_Create
To view asset types	SV_Attribute_View
To edit asset types	SV_Attribute_Edit

To configure the customized view in a Progressive Web Application form

You need admin permission to open the SHR:SV_TicketConfig form.

Launch the browser and enter the URL: http://<hostName:portNumber>/arsys/forms/<serverName>/SHR:SV_TicketConfig.
Where hostName is the name of the web server where Mid Tier is running, and serverName where AR System server is running.
From Ticket Type, select Configuration Item.
Select CI type for which you have created the new view.
Click Search.
From the result pane, select the appropriate record.
Select the Asset Has Attributes check box.
In Attributes Create VUI Name, enter SV_Attribute_Create.
In Attributes View VUI Name, enter SV_Attribute_View.
In Attributes Edit VUI Name, enter SV_Attribute_Edit.
Click Save.
The customized view is configured for the asset type.
Do not change the values of any other fields in the SHR:SV_TicketConfig form, except for the values mentioned in the procedure. Any custom configuration on other fields is not supported.

To overlay an existing Progressive View Application form

You need admin permission to open the SHR:SV_TicketConfig form.

Create a new view as described in To create a new Progressive Web Application view.
Save the view name as different from SV_Attribute_Create, SV_Attribute_View, and SV_Attribute_Edit. For more information on renaming views, see Modifying form views
Launch your browser and enter a URL as follows: http://<hostName:portNumber>/arsys/forms/<serverName>/SHR:SV_TicketConfig.
Where hostName is the name of the web server where the Mid Tier is running, and serverName where AR System server is running.
From Ticket Type, select Configuration Item.
From CI type, select the CI type for which you want to create the overlay form. For example, Computer System.
Click Search to search for the record.
From the result pane, select the appropriate record.
In the Form Name field, enter the name of the form that you want to overlay. For example, if in CI Type, the value selected is Computer System, select AST:ComputerSystem from Form Name.
Make sure Asset Has Attributes UI is selected.
Select the Has Asset has UI check box.
Click Save.
When the user opens the form for the CI type that you modified, the new configured form is displayed.
Do not change the values of any other fields in the SHR:SV_TicketConfig form, except for the values mentioned in the procedure. Any custom configuration on other fields is not supported.

To add custom fields to the data model in BMC CMDB

In BMC Helix CMDB, add the custom field to the data model. For more information, see Common Data Model concepts and Modification of your data model.
Perform the CMDB synchronization process, as described in Modifying views of forms in BMC Remedy IT Service Management applications
Make sure to set the Has Asset UI option to Yes.
Clear the Smart IT server cache.
Add the custom field in Smart IT.

Asset forms to add custom fields

For the Asset view, you can add custom fields to the specific asset type form:

Business service	Computer system	Equipment	Hardware	Network	Other	Software
AST:BusinessService	AST:ComputerSystem	AST:Equipment	AST:CDROMDrive	AST:AdminDomain	AST:Account	AST:Application
	AST:Mainframe		AST:Card	AST:Cluster	AST:Activity	AST:ApplicationInfrastructure
	AST:Printer		AST:Chassis	AST:CommunicationEndpoint	AST:BusinessProcess	AST:ApplicationService
			AST:DataBaseStorage	AST:ConnectivityCollection	AST:ConcreteCollection	AST:ApplicationSystem
			AST:DiskDrive	AST:ConnectivitySegment	AST:Document	AST:BIOSElement
			AST:FloppyDrive	AST:IPConnectivitySubnet	AST:LogicalSystemComponent	AST:DataBase
			AST:HardwarePackage	AST:IPEndpoint	AST:PhysicalLocation	AST:DiskPartition
			AST:HardwareSystemComponent	AST:IPXConnectivityNetwork	AST:Role	AST:FileSystem
			AST:Keyboard	AST:LANEndpoint	AST:ServiceOfferingInstance	AST:OperatingSystem
			AST:LocalFileSystem	AST:LNsCollection	AST:Transaction	AST:Package
			AST:Media	AST:LAN		AST:Patch
			AST:Memory	AST:NTDomain		AST:Product
			AST:Monitor	AST:NetworkPort		AST:ResourceAllocationSettingData
			AST:PointingDevice	AST:ProtocolEndpoint		AST:Share
			AST:Processor	AST:WAN		AST:SoftwareServer
			AST:Rack			AST:SystemSoftware
			AST:RemoteFileSystem			AST:VirtualSystemEnabler
			AST:ResourcePool			AST:VirtualSystemSettingData
			AST:SystemResource
			AST:TapeDrive
			AST:UPS

To add custom fields to Asset forms in Developer Studio

Each type of asset has a type-Specific area to which you can add custom fields that are relevant to that asset type. There is also a generic area into which you can add custom fields that apply to all assets. In Screen Configuration, you can add custom fields that are part of either the Generic Area or the Type-Specific Area of the Asset View of the AR System form.

Process overview for adding fields in Developer Studio

The following image provides an overview of the conditions for making the fields available for customization in the Asset View:

To add a custom field to the Generic Area of Asset View, perform the following tasks:

Add the field in the AST:Attributes form.
Add the field in the AST:BaseElement form.
Add the field to the related asset-specific form.
Add the custom field in Smart IT.

To add a custom field to the Type-Specific Area of Asset View, perform the following tasks:

Add the field in the AST:Attributes form.
Add the field to the related asset-specific form.
Add the custom field in Smart IT.

To add a custom field to the AST:Attributes form

Open Developer Studio in the Best Practice Customization mode (the default).
In AR System Navigator, double-click Forms under the All Objects option.
In the Filtering Options, select AST:Attribute for the form name.
Click the form name to open the form.
From the pallet appearing on the right side of the form, select the field type from the Data Fields group.
Note
Currently, you cannot add the Diary and the Currency field types in the Data Fields group. Additionally, you cannot add the fields types of Display Fields and Composite Fields groups.
Drag the field from the palette to the specific area of the form where you want to add the custom field.
Modify field parameters as per the field requirements. Check the Field Properties section to set field properties such as permission etc. For more information about creating fields, see Creating and managing fields.
Save the form.
The following message is displayed:
You have specified an id for following fields which is outside the BMC reserved range. Do you wish to continue?
<Field name>
Click OK.

Important

When the Sandbox Dataset is enabled in the Asset Management Settings, if there is an existing record for the CI in the Sandbox Dataset, the details that are populated in the custom attribute is populated on the AST<Class Form>/Smart IT. When there is no record for the CI in the Sandbox Dataset, the system creates a new record in the Sandbox Dataset, and the custom attribute is not populated. This is due to the fact that the filter "ASI:SHR:All_PushToAssetAttribute_SandboxOnCreate`!" has a Push field mapping to the AST:Attributes form where the custom attribute is not included. You must either modify the existing workflow with an additional mapping or use Match Id option in Push field action. Otherwise, create a similar workflow (custom) to push the custom attributes.

When Sandbox Dataset is disabled in Asset Management Settings, the custom field is populated without any customization issues.

To add custom fields to the AST:BaseElement form

In AR System Navigator, double-click Forms under the All Objects option.
In Filtering Options, enter AST:BaseElement as the form name, and click the form name to open the form.
1. Right-click the form.
2. Click the Add Fields from AST:Attributes option.
3. In the Add Fields dialog box, select the field that you added from the list, and then click OK.
4. Click Save.

Note

The custom fields added in the AST:BaseElement forms are not visible in the Type-Specific Area.

To add custom fields to the type-specific asset form

After you add a custom field in the AST:Attributes form, you must add it in the corresponding type-specific asset form of Action Request System. For example, to add a printer-related field, you must add the field to the AST:Printer form.

In AR System Navigator, double click on Forms under the All Object option.
In the Filtering Options, enter AST:Printer as the form name, and click the form name to open the form.
1. Right-click the form.
2. Click the Add Fields from AST:Attributes option.
  The field that you added in the AST:Attributes form, appears in the Add Fields dialog box.
3. Select the field and click OK.
4. Save the form.

For more information about the asset-specific forms, see Adding-custom-fields-to-your-views-using-Smart-IT.

Instructions for classic interfaces

View instructions for classic Smart IT

To add custom fields to classic Smart IT

After you add a custom field in the Action Request System forms, you must add the field in Smart IT. The following steps are only applicable if you are using classic Smart IT screens.

As an administrator user, log on to the Smart IT universal client with a fresh session.
From the Configuration menu, choose Screen Configuration.
In Asset View, click Refresh Metadata.
In Asset View options, click Type-Specific Area, to add a field in Type-Specific Area or click Generic Area to add a field in Generic Area.
For Type-Specific Area, from the Select Asset Type list, select the asset type; for example, Printer.
Note
You must select the specific asset type that corresponds to your custom field. For example, if you have added a custom field related to printers in the AST:Printer form, you need to select Printer from the Select Asset Type list. The added field does not appear if you select another asset type, such as Mainframe, from the Select Asset Type list.
From the asset type list, type your custom field name in the Available Fields box, and Search.
To move the field to the Selected Fields section, click the + sign next to the custom field name.
Click Save.
The field configuration is updated successfully. Now the custom field becomes available for the related asset.

Troubleshooting the changes that are not reflected in classic Smart IT

In BMC.Core:BMC_Application Class, create a custom attribute that has selection values, and refresh the Asset Sync UI so that the custom attribute is reflected in the AST forms. In Smart IT, refresh the metadata for Asset View, and add the custom field. In the backend form, if you remove one of the selection values, you can notice that the changes are not reflected in Smart IT. You can still see the removed value even after you refresh the metadata. In Smart IT, to reflect the changes made in the backend form, you must remove the specific custom field, add it again, and then refresh the metadata. Sometimes you might need to refresh the Smart IT server cache.