Synchronize a shape to the database

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read

    • Add a shape to a diagram. Synchronize the shape to the database by mapping the shape to an existing CI or adding a CI.

    Before you begin

    Role required: sn_apm.apm_user

    Note:
    You must have the Owner or Editor access to the artifact or diagram and must have read access to the shape entity.

    Procedure

    1. Navigate to Workspaces > Enterprise Architecture Workspace.
    2. Open the Modeling page by selecting the Modeling icon (Modeling).
    3. Select an existing diagram from the Diagrams page.
    4. Add a shape to an existing or new diagram.
      You can observe that the unsynced icon (unsynced shape) is displayed in the shape. It means, the shape hasn’t yet synced with the ServiceNow database.
    5. Open the side panel with details for the selected shape by selecting the Open the side panel icon (Open side panel).
      Note:
      The width of the side panel is saved to your user preferences. If you resize the panel, it opens at the same width the next time you open a diagram.
    6. Select and map an existing CI or create a CI for the shape.
      • To map an existing CI, select the Choose Existing button and select a CI from the drop-down list.
      • To create a CI, select the Create New button and enter the details.
    7. Send the shape or diagram for approval.
      After receiving the approval, you can see the Commit button to synchronize a shape or diagram, or a relationship to the database.
    8. Select Update.
    9. Select Commit to synchronize the object to the database and save the diagram.

    Result

    The shape gets synced to the database.