Resolve a missing page definition in UI Builder

Fix UI Builder page render errors by linking a page definition in the variant record.

Before you begin

Role required: ui_builder_admin

About this task

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.

Procedure

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.

What to do next

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