Add or edit an architectural decision record (ADR)

Create or update an artifact of the type architectural decision record (ADR) to align it with your business requirements.

Before you begin

The ADR feature in Enterprise Architecture Workspace uses the ServiceNow Docs component (sn_docs) to create pages in the Artifacts section. Docs component v6.0.0 is automatically installed with Enterprise Architecture Workspace v3.4.0.

If you’re using an older version of Enterprise Architecture Workspace with Docs component v6.0.0, upgrade the workspace to v3.4.0 to fully use the ADR functionality. For more information, see KB2017926.

The permission set at the artifact level determines if you can edit the artifact.

Role required: sn_apm.apm_user to add an architectural decision record (ADR).

Procedure

1. Navigate to Workspaces > Enterprise Architecture Workspace.

2. Open the Portfolio List view by selecting the Portfolio icon

1. Select the expand row icon (

1. Select Architectural Decision Records (ADR).

2. Add or edit an architectural decision record.

   • To add an architectural decision record, select New.
   • To update details of an existing architectural decision record, select the architectural decision record.
   • In the New architectural artifact pop-up window, fill in the form fields.

   For field information, see Architectural artifact form.

3. Select Create.

Result

The architectural decision record is created and added to the artifacts list. You’re also redirected to the newly created architectural decision record page.

Parent Topic:Manage architectural decision records (ADR)

Related topics

[eaw-add-an-architectural-artifact-version]

Request approval for an architectural artifact

Add a related entity to an architectural artifact

Create and manage pages and subpages for ADRs

Tag users or records in Architectural Decision Records

Reference additional records in decision records

Add an architectural decision record version

Request approval for an ADR version