Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Synchronize a shape to the database

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 Enterprise Modeling and Visualization icon (

Image omitted: icon-modeling-logo.png
Enterprise Modeling and Visualization\).
  1. Select an existing diagram from the Diagrams page.

  2. Add a shape to an existing or new diagram.

    You can observe that the unsynced icon (

Image omitted: icon-unsynced.png
unsynced shape\) is displayed in the shape. It means, the shape hasn’t yet synced with the ServiceNow database.
  1. Open the side panel with details for the selected shape by selecting the Open the side panel icon (
Image omitted: icon-open-side-panel.png
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.
  1. 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.
    • 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.

  2. Select Update.

  3. Select Commit to synchronize the object to the database and save the diagram.

Result

The shape gets synced to the database.

Parent Topic:Working with Enterprise Modeling and Visualization

Related topics

Create a diagram for a business capability map

Update a business capability map

Add capabilities or applications to a capability map

Create diagram for a business hierarchy map

Update a business application hierarchy map

Share a modeling diagram

Commit diagram changes

Save as a version

Duplicate a modeling diagram

Submit a modeling diagram for approval

Add related records in the modeling diagram

Delete a shape