Resolve a missing page definition in UI Builder

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • Fix UI Builder page render errors by linking a page definition in the variant record.

    始める前に

    Role required: ui_builder_admin

    このタスクについて

    Pages in UI Builder are backed by a screen record (sys_ux_screen) that references a page definition. The page definition is a macroponent record that UI Builder renders. If the reference is removed or was not set, for example, after a partial import, a manual database edit, or data corruption, UI Builder cannot render the page.

    手順

    1. Navigate to All > Now Experience Framework > UI Builder.
    2. Open the experience containing the page displaying the error.
    3. Select the page displaying the error.
    4. Select Open variant record.
    5. Right-click the page with the error.
    6. Select Copy sys_id.
    7. Locate the macroponent by navigating to All > sys_ux_macroponent.list.
    8. Filter the list by the application scope associated with the affected experience.
    9. Find the macroponent record that matches the page you want to restore.
    10. Copy the macroponent's name from the list.
    11. Return to the experience containing the page displaying the error.
    12. Select the page displaying the error.
    13. Select Open variant record.
    14. Select the UX Screens tab.
    15. Open the screen record by selecting the variant screen name.
    16. Enter the macroponent from the previous step in the Page Definition field.
    17. Select Update.

    次のタスク

    Open the experience containing the page with the error to verify that the error has been resolved.