Reclassify cloned or customized search widgets

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • Search widgets that you cloned or customized before a system upgrade may not be compatible with AI Search. You can resolve this issue by running a fix script that reclassifies search widget instances.

    시작하기 전에

    1. Enable and configure AI Search in Service Portal
    2. Run the Portal Analyzer to identify all cloned or customized search widgets. For more information, see Get a list of widgets per page.
    3. For each cloned or customized search widget, copy the sys_id value of each widget instance that is associated with the widget.
    4. For each cloned or customized search widget, ensure that the widget and its corresponding widget instances have the latest AI Search code from the base system search widget.
      경고:
      Run the fix script only after you've updated all cloned or customized search widgets. If you run the fix script without first updating the widget code, the widgets won't be able to uptake the AI Search code later.

    Role required: admin

    이 태스크 정보

    If you're unable to use AI Search in Service Portal, you may need to reclassify your cloned or customized search widgets. You can run the Reclassifying Search widgets fix script, which reclassifies widget instances to the sp_instance_ais class.

    프로시저

    1. Navigate to All > System Definition > Fix Scripts.
    2. On the list, find and open the record named Reclassifying Search widgets.
    3. On the form, update the script to define which widget instances to reclassify.
      Paste the sys_id value of each search widget instance in the array. For example, you would enter the sys_id values as follows:
      var instances = ["sys_id_1", "sys_id_2"];
    4. Save the form.
    5. Select Run Fix Script.