Resolve a missing page definition in UI Builder

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture
  • Fix UI Builder page render errors by linking a page definition in the variant record.

    Avant de commencer

    Role required: ui_builder_admin

    Pourquoi et quand exécuter cette tâche

    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.

    Procédure

    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.

    Que faire ensuite

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