# Committing Elements and Relationships

Creating Future State Elements and Relationships in ServiceNow via Designer.

{% hint style="danger" %}
**Designer Commit Role Required**
{% endhint %}

Designer provides a seamless feature to combine current and future state data within one Diagram. Future state data can be "committed" into the ServiceNow repository.

{% hint style="info" %}
**Designer Commit role required**

Committing Elements & Relationships are restricted to the role *x\_inpgh\_des.commit* by default. Please assign the appropriate right to users to provide them the rights to commit elements.
{% endhint %}

## Prerequisites

Committing Elements & Relationships require the following configuration in place (to be performed by ServiceNow and Designer Admin):

1. Having [Class Definitions and Cross Scope Privileges](https://github.com/ins-pi-GmbH/designer-app/blob/v5.9.3/Documentation/key-features/future-state-planning/class-definitions-and-cross-scope-privileges.md) in place for the target tables.
2. Associating a shape with a table with activated CREATE Cross-Scope Privileges.
3. Setting [Application Settings on Target Table](https://github.com/ins-pi-GmbH/designer-app/blob/v5.9.3/Documentation/key-features/future-state-planning/class-fields.md) to allow scoped applications with "Can Create" option.

## Auto commit after final approval

The proposed approach is to activate the "**Auto commit after final approval**" within the [Global Settings](https://github.com/ins-pi-GmbH/designer-app/blob/v5.9.3/Documentation/key-features/future-state-planning/global-settings.md) page. This will ensure, that all Future State Elements & Relationships will be automatically committed with the final approval step automatically.

![](/files/TH9IDTm9oh6kgYix3oaR)

## Committing through the Diagrams Form

In some cases, it makes sense to allow a selected group of key users to commit manually Elements & Relationships without an approval of the Diagram.

Navigate to the Diagram Form through the Diagrams application menu and select the Diagram:

![](/files/SpvU8cV09hpDh5CQvKlY)

**A** — The Commit button is only visible for users being part of the Designer Commit Group. Clicking this button will commit all the selected items.

**B** — Click to select all committable Elements & Relationships. Current State items will be ignored.

**C** — You can select/unselect individual items on demand.

**D** — Click on the columns to change sorting.

**E** — Search option within the Content area.

**F** — Designer distinguishes between Future & Current State, and Duplicate items. Committing duplicate Elements & Relationships is possible and to be configured in the [Global Settings](https://github.com/ins-pi-GmbH/designer-app/blob/v5.9.3/Documentation/key-features/future-state-planning/global-settings.md).

## Commit Result Popup

After clicking the "Commit" button a popup window will show the results, if the commit process was successfully. For Elements & Relationships where the CREATE option on the table is not allowed error messages can appear.

## Editing the Diagram

Once the Element(s)/Relationship(s) are committed, click on the Edit button to open the Diagram in the Designer.

During the loading process Designer will compare the changes happened to the Diagram and will highlight newly committed Elements & Relationships, and if any Current State Elements & Relationships have been deleted. All changes are highlighted with the red dotted lines.

{% hint style="warning" %}
**Confirming Changes**

The popup information with the changes will appear every time until the Diagram is saved (CTRL+S).
{% endhint %}

{% hint style="info" %}
**Duplicate Handling**

Please note, that Duplicate Elements have been updated and connected to the real Element automatically! They will disappear from the list as duplicates, as Designer has recognized them and related the shape to the real Element.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ins-pi.com/designer/work-in-the-app/future-state-planning/committing-elements-and-relationships.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.