Troubleshooting issues while adding custom fields

After you add custom fields to BMC Helix ITSM forms in Developer Studio, sometimes the metadata is not refreshed in BMC Helix ITSM. As a result, the custom fields are unavailable to add by selection, or the custom field menu does not load in  BMC Helix ITSM. Use the information in this section to understand and resolve the problem or to create a BMC Support case.


Issue symptoms

  • The Asset selection menu under Screen Configuration does not load.
  • The database table has corrupt or duplicate records.
  • Some fields are missing from Screen Configuration.
  • The field data is inaccurate.


Issue scope

  • One or more users experience these issues.
  • In a server group environment, these issues could affect one or more servers.


Resolution

Perform the following steps to clear the metadata if you're unable to add a custom field:

Task

Action

Steps

Reference

1

Verify if the custom field is added correctly in Developer Studio.

To verify if the custom fields are added correctly to Asset View and Incident View, see the following videos:


icon_play.pnghttps://youtu.be/thmK-hMY_QA



icon_play.pnghttps://youtu.be/BPO61OFV20w

2

Check for common mistakes in the custom fields.

Perform the following checks:

  • The custom field must not include " _c" in its label on the Developer Studio forms.
  • The custom field has the same database ID across all forms in Developer Studio.

3

Recreate the field metadata on the associated BMC Helix ITSM forms.

  1. Log in to Mid Tier.
  2. Open the SMT:Administration: Customized Application Data Source Attributes form (fields added to the BMC Helix ITSM applications) or the SMT:Administration: Asset Customized Data Source Attributes form (for fields added to the Asset View).
  3. Find the required field by searching for the associated Field ID, Attribute Name, Field name, or use the Data Source ID list to narrow results.
    Capture.PNG
  4. Verify if you have selected the correct record by referencing the Data Source ID on the SMT:Administration: Application Data Sources form.
    The Data Source ID must match the custom field name.
  5. Delete the record on the SMT:Administration: Customized Application Data Source Attributes form related to your custom field.
  6. Restart the BMC Helix ITSM service.
  7. Log in to BMC Helix ITSM and navigate to Screen Configuration.
  8. Refresh the metadata.
  9. Check if you can see the custom field.



4

Clean up the form data and the database table if the Asset selection menu is not displayed.


  • Delete all the records from the SMT:Administration: Asset Customized Data Source Attributes form.
  • Delete all the data from the SmartIT_Business.CUSTOMIZATION_CELL_EXTENSION table by using the following command:
    DELETE FROM SmartIT_Business.CUSTOMIZATION_CELL_EXTENSION
  • Delete all the data from the SmartIT_Business.CUSTOMIZATION_AREA_CELL table where AREA_PK is set to 27 or 28 by using the following query:
    DELETE FROM SmartIT_Business.CUSTOMIZATION_AREA_CELL WHERE AREA_PK=27 OR AREA_PK=28
  • Restart the BMC Helix ITSM Tomcat service.


5

Create a BMC Support case.

Collect and send all available BMC Helix ITSM logs with detailed information when creating a case with BMC Support.

Provide the following information as part of your case:

  •  Any error messages received or observed.
  •  Attach the zip file containing all logs to your case (up to 2 GB).

For more information, see SFT - Steps to send logs, files, screenshots to BMC Support for a Remedy Product related case.


After you determine a specific symptom or error message, use the following table to identify the solution:

Symptom

Action

Reference

A field value in Incident View is not displayed when you refresh the incident or edit the ticket in BMC Helix ITSM.

Verify the form data.


Knowledge Article 000138669

You are unable to access Type Specific Area in Screen Configuration > Asset View.

Depending on the browser version, when you try to access this area, the Asset View > Type-Specific Area blade is not displayed, or it takes a long time to display.

Clear the metadata.

Knowledge Article 000144546


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*