Information
This documentation supports the 25.1 version of BMC Helix ITSM: Knowledge Management.To view an earlier version, select the version from the Product version menu.

Customizing the search results


By default, all searchable articles are opened with form name and request ID. The form name and request ID are taken from the search results.

Related topics

Before you begin

When you register AR System forms as searchable articles, you can customize the way that these articles are opened from search results. You can provide a Knowledge Management workflow with customized form view or opening mode by setting the following parameters:

  • Set the form view in the z1D_viewToOpen (id = 302258834) field of the RKM:SearchDialog form.
  • Set the open mode in the z1D_openMode (id = 302258831) field of the RKM:SearchDialog form.
    Select either of the following modes to open the window in Modify Directly mode.
    • Display — Opens the window in Modify Directly mode.
    • Modify — Opens the window in Modify Directly mode.

Currently, both modes open the same window type.

To customize the open mode and view of the knowledge articles

To customize the open mode and view of the knowledge articles:

  1. Create a new active link for the RKM:SearchDialog form.
    1. In Run If Qualification, enter the string:

      ('z1D_viewArticleForm' = "FormName")

      Where "FormName" is the name of the form that you want to customize.
      Example

      ('z1D_viewArticleForm' = "ABC:My form"
    2. Under If Actions, set values to the fields:
      • z1D_openMode — Select the mode that the form will open with (Display or Modify).
        To add other modes, open the form in Development Studio, select the WorkingAreaView, select the z2PF_RKM_SearchResults tab, and add other modes as you want.

        Success

        If you only want to change the view to open, you can change it in the registration wizard.

      • z1D_viewToOpen — Select the form's view.
  2. Add a goto guide label action to guide label OpenForm.
  3. Add a reference to your active link(s) in the active link guide.

    RKM:KBI:ViewOpenSearchResult_ALG

    before the OpenForm label.

To open a different form than the returned form

To open a different form than the returned form:

  1. Create an active link for RKM:SearchDialog.
  2. Set the Run if qualification to:

    ('z1D_viewArticleForm' = "FormName")

    where "FormName" is the name of the form where the search hit was found.

  3. Write your own workflow to determine the form, view and display type, and set these values in the variables z1D_viewToOpen, z1D_openMode, and z1D_viewArticleForm respectively.
  4. Add a goto guide label action to guide label OpenForm.
  5. Add a reference to your active link(s) in the active link guide.

    RKM:KBI:ViewOpenSearchResult_ALG

    before the OpenForm label.

 

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

BMC Helix ITSM: Knowledge Management 25.1