---
sourceDocument: Yokohama Enterprise Architecture (formerly Application Portfolio Management)
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/application-portfolio-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Enterprise Architecture (formerly Application Portfolio Management)

ft:clusterId :

    - appportman

bundleId :

    - appportman

workflow :

    - Technology


---

# Enterprise Modeling and Visualization in the EA Workspace

# Enterprise Modeling and Visualization in the EA Workspace {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Enterprise Modeling and Visualization in the EA Workspace

The Enterprise Modeling and Visualization functionality in the EA Workspace provides powerful diagramming and modeling capabilities to visualize IT applications and their relationships within the broader business landscape.
This enables ServiceNow customers to create visual representations of complex enterprise architectures, fostering better communication, decision-making, and alignment between IT and business goals.
Show full answer Show less  

## Key Features

* **Diagram Creation:** Build diagrams for application hierarchies and architectural artifacts using various shape types including General, Enterprise Architecture, and ArchiMate® shapes.
* **Shape and Connector Management:** Add, resize, label, and connect shapes to depict relationships and processes clearly. Connector labels enhance clarity by describing relationships or data flows.
* **Version Control:** Manage multiple versions of diagrams with version-specific details, enabling robust change management and compliance tracking.
* **Sharing and Collaboration:** Share diagrams with peers and control access levels, facilitating collaboration across teams and stakeholders.
* **Approval Workflow:** Submit diagrams for approval (typically routed to the Enterprise Architect group) before committing changes to the database, ensuring governance and quality control.
* **Custom Shapes and ArchiMate Support:** Utilize industry-standard ArchiMate shapes or create custom shapes tailored to organizational needs for richer, more meaningful diagrams.
* **Integration with ServiceNow Configuration Items (CIs):** Synchronize shapes and diagrams with the ServiceNow database by linking to existing CIs or adding new ones.
* **Diagram Types Supported:** Create and update business capability maps, business application hierarchy maps, and business process models (BPMN diagrams) to represent various enterprise structures and workflows.
* **Diagram Management:** Duplicate, delete, and maintain diagrams from a centralized location to ensure only relevant, up-to-date diagrams are retained.

## Benefits for ServiceNow Customers

* **Improved Stakeholder Understanding:** Visual models aid both technical and non-technical stakeholders in grasping complex enterprise architectures and IT-business relationships.
* **Enhanced Decision-Making:** Decision makers can evaluate change impacts, assess risks, and explore scenarios before implementation, leading to informed strategic decisions.
* **Better Alignment with Business Goals:** Ensures IT initiatives are strategically aligned with business objectives through holistic visualizations.
* **Efficient Change Management:** Illustrates how changes affect the enterprise, supporting smoother transformations with minimized disruption.
* **Regulatory Compliance and Governance:** Provides structured documentation and architectural frameworks to support adherence to regulatory standards and governance policies.
* **Operational Efficiency and Cost Reduction:** Identifies redundancies and optimization opportunities, helping to streamline processes and reduce costs.

## Practical Usage Guidance

To leverage this functionality, ServiceNow customers can activate the Enterprise Modeling and Visualization application from the ServiceNow Store. Users can then create new diagrams or update existing ones, making use of available shapes and connectors to depict enterprise artifacts. Diagrams can be shared for collaboration, submitted for approval, and committed to the database to maintain up-to-date architectural documentation. Version control and detailed metadata support effective governance and change tracking throughout the enterprise modeling lifecycle.  
The Enterprise Modeling and Visualization functionality in EA Workspace helps you with diagramming and modeling capabilities, and enable you to model the future state of your IT and its relationship to the business
landscape.
You
can use the Enterprise Modeling and Visualization \[com.snc.apm_modelling_tool\] functionality in EA Workspace to create diagrams for your applications hierarchy and associate them with architectural artifacts. These diagrams enable decision makers to make informed decisions.  
Creating diagrams for your applications hierarchy helps you in the following:

* Visual representation: The diagrams and models provide a visual representation of complex enterprise structures, processes, and relationships. This visual representation helps your stakeholders, including executives and IT to understand the complexities of the organization.
* Effective communication: Diagrams serve as a common language that bridges the gap between technical and non-technical stakeholders. They enable effective communication and collaboration between different teams and departments within an organization.
* Improved decision making: The diagramming and modeling capabilities enable decision makers to make informed decisions. They can assess the impact of proposed changes, evaluate different scenarios, and identify potential risks before implementing strategies or projects.
* Alignment with business goals: Diagrams and models help you align your IT initiatives with overall business goals. They provide a holistic view of the business and confirm that IT 's investments are strategically aligned with business goals.
* Change management: The modeling capabilities facilitate change management by illustrating how changes impact the entire enterprise. This helps plan and execute transformations that run smoothly and with minimal disruption.
* Regulatory and governance compliance: Many regulatory agencies and standards organizations require documentation and adherence to architectural guidelines. Modeling helps you verify compliance and governance by providing a structured framework for managing architectural artifacts.
* Efficiency and cost reduction: By identifying redundancies, optimizing processes, and streamlining operations, modeling and diagramming can lead to cost reductions and improvements in operational efficiency.
{#eaw-modeling__ul_sqj_k1j_bbc}

## Installing the Enterprise Modeling and Visualization application {#eaw-modeling__section_df2_33n_1bc}

You can activate the Enterprise Modeling and Visualization \[com.snc.apm_modelling_tool\] from the ServiceNow Store.

## Working with diagrams {#eaw-modeling__section_g4j_w4n_1bc}

* Shapes: This section enables you to use different kinds of shapes to create a diagram. Available shapes are:
  * General shapes
  * Enterprise Architecture shapes
  * ArchiMate® shapes (ArchiMate is a registered trademark of The Open Group)

  {#eaw-modeling__ul_ddr_jlc_fdc}

  You can add a shape to the canvas by either selecting the shape or by dragging the shape from the Shapes palette to the canvas.{#eaw-modeling__patch-rn-yp6-1}

  You can also adjust the size of shapes by selecting a shape and then drag any of its edges or corner handles. Pulling outward increases the shape's dimensions, while dragging inward reduces its size.
  {#eaw-modeling__patch-rn-yp6-2}
* Labels connector lines: Select a connector line between shapes in a diagram to add a label for the connector line by selecting the Select to add text icon.

* Version: This field enables you to view and open a different version of the diagram.

* View details: Use this option to view version-specific details of your diagram such as version label, description, and planned rollout day.

* Undo and Redo: Use this option to revert or reinstate recent changes made to a diagram. You can also use the keyboard shortcuts to perform the undo and redo action.

* Version: This field enables you to view and open a different version of the diagram.

* Share: Use this option to share the diagram with your peers.
* Commit changes: Use this option to synchronize the diagram to the repository. This option is available only when the diagram is approved.
* Save as new version: Use this option to create a new version of the diagram within the same artifact.
* Duplicate: Use this option to duplicate an existing diagram and save it as a new artifact.

* Open side panel: Select a shape in the diagram to see this option. Use this option to open the selected object details in a side panel. If the shape is connected to an existing ServiceNow element, the details are fetched from the database and shown in the side panel. Update the details as required. You can select the Full details link to open the full form.

* Add related records- Select a shape in the diagram to see this option. Use this option to fetch and add the objects and their relationships with reference to the selected object.

* More actions- Select the three dots menu to see the following options:

  * Delete shape from canvas to remove the selected shape from the canvas.
  * Add relation to add relationships with reference to the selected object.
  {#eaw-modeling__ul_wbc_y2y_dcc}
{#eaw-modeling__ul_gtx_qkw_bbc}
* **[Shapes to create a modeling diagram](https://www.servicenow.com/docs/I3bMyKe16p6k28FhLNJZHA)**   
  The shapes available in Enterprise Modeling and Visualization help you create diagrams. You can add a shape to the canvas by either selecting the shape or by dragging the shape from the Shapes palette to the canvas.
* **[Search shapes in a diagram](https://www.servicenow.com/docs/v1HU7wp8Kn28w1F3ahJDQA)**   
  Search for a shape in the Shapes palette of a diagram.
* **[Add related records in the modeling diagram](https://www.servicenow.com/docs/U4LA62cX32L4rPG3umb_aA)**   
  Fetch and add a related record to the selected shape in a diagram.
* **[Create a blank diagram using modeling in the EA Workspace](https://www.servicenow.com/docs/6st9rXxXicD28LBvrCOOtw)**   
  Create a diagram and synchronize it to the ServiceNow database.
* **[Create a diagram for a business capability map](https://www.servicenow.com/docs/Mjp8y2QJf61_Oq3VMzoeIw)**   
  Create and model your business capability map using the Enterprise Modeling and Visualization.
* **[Update a business capability map](https://www.servicenow.com/docs/ORH33GPFkM8y2xaVGh4GsQ)**   
  Modify an existing business capability map by adding new capabilities, business applications, or changing the hierarchy of the existing capabilities.
* **[Add capabilities or applications to a capability map](https://www.servicenow.com/docs/k0GGOfWQzgCW2edLq7jjBw)**   
  Add a new or existing business capability or business application to the capability map using the Enterprise Modeling and Visualization.
* **[Create diagram for a business hierarchy map](https://www.servicenow.com/docs/pYIp9cXtQkyiAsJmsgVXuA)**   
  Create and model your business application hierarchy map using the Enterprise Modeling and Visualization.
* **[Update a business application hierarchy map](https://www.servicenow.com/docs/ReItkAj2qbccsP1bJPqKWQ)**   
  Modify an existing business application hierarchy map by adding or removing shapes and relationships.
* **[Business process modeling](https://www.servicenow.com/docs/5rvws7rWbKnI91okhOUlOQ)**   
  Business processes are a structured sequence of tasks that are grouped, helping to accomplish specific business outcomes. A business process modeling diagram or a BPMN (Business Process Model and Notation) diagram is a visual representation of a business process.
* **[Add labels to connector lines between shapes in a diagram](https://www.servicenow.com/docs/uC_JEOa7zFdEe0FflTvFtQ)**   
  You can enhance diagram clarity in Enterprise Modeling and Visualization by adding a descriptive text on the connector line between shapes. Connector line labels clarify the nature of the relationship between shapes, annotate the data flow direction, and provide contextual information.
* **[ArchiMate shapes support in the Enterprise Modeling and Visualization](https://www.servicenow.com/docs/wokR3H4l4bgx2HvE6LfO9w)**   
  ArchiMate® shapes are the industry standard shapes used by the Enterprise Architects to create diagrams with relationships among with different domains in the enterprise. ArchiMate is a registered trademark of The Open Group. Enterprise Modeling and Visualization supports ArchiMate shapes along with General and Enterprise Architecture shapes.
* **[Custom shapes support in the Enterprise Modeling and Visualization](https://www.servicenow.com/docs/eFw2Xy5NsaPe8VEYxAOkfA)**   
  Custom shapes are the user-defined graphical elements that can be used to represent specific concepts, processes, systems, or roles in your diagrams. These shapes can be tailored to fit the unique needs of your organization, making your diagrams more meaningful and easier to understand.
* **[Share a modeling diagram](https://www.servicenow.com/docs/GstOil0mjJVpgEXiiFE_NA)**   
  Share your draft diagrams with individuals and groups and define access levels for them to view and modify the diagram.
* **[Commit diagram changes](https://www.servicenow.com/docs/8eFI2_toIhQTgOfrN7K3bQ)**   
  Synchronize an approved diagram and all its elements to the database.
* **[Save as a new version](https://www.servicenow.com/docs/oWVAutcprKxfKMvewd3UeQ)**   
  Copy an existing diagram and create a version for it within the selected architectural artifact. You can update the new version as required.
* **[Add or edit diagram version details](https://www.servicenow.com/docs/q~D5q4~fuF~BlVFA9ikB_w)**   
  You can add or edit version-specific details for a diagram to improve change management and compliance. Adding diagram version details ensures better clarity between all stakeholders in the context of the diagram and timelines.
* **[Duplicate a modeling diagram](https://www.servicenow.com/docs/agsVxBYKtJoog1k_c3byDQ)**   
  You can make a copy of an existing diagram that you created and modify the duplicate diagram according to your requirement.
* **[Submit a modeling diagram for approval](https://www.servicenow.com/docs/payKV_IEn6OUR~VDZkNfUg)**   
  Send your draft modeling diagrams for approval. After receiving the approval, you can commit the diagram to the database. The approval process can be done through a configured workflow. By default, the approval request is submitted to the Enterprise Architect group.
* **[Synchronize a shape to the database](https://www.servicenow.com/docs/c_MOnPCjis4fMw20dtv3yg)**   
  Add a shape to a diagram. Synchronize the shape to the database by mapping the shape to an existing CI or adding a CI.
* **[Delete a shape](https://www.servicenow.com/docs/sIEHQdvIrwdjmfgQ0XNuhg)**   
  Delete a shape and all of its relationships from a diagram.
* **[Delete Enterprise Modeling and Visualization diagrams](https://www.servicenow.com/docs/0iGAO7pL8sYJgqhzaWz6_w)**   
  You can delete diagrams from the Enterprise Modeling and Visualization All Diagrams page, confirming only the relevant and current diagrams are available.

