---
alias: user-guide-create-automation-business-scenario
description: "Create a new automation business scenario with configurable scopes and conditions"
---

# Create Automation Business Scenario

:lock: AutomationBusinessScenario.**Create**

## Overview

This operation allows creating a new **Automation Business Scenario** in the system.

## Sequence of Steps

### Step 1: General Data

1. Enter a unique **Name**.
1. Provide a **Description**.
1. Specify if you want the scenario to be **Enabled**. If so, the scenario will be an option in the [[user-guide-cortex]] chatbot.
1. **Scopes** will specify from where the scenario is available, for example if the user opens the chat from the page of `<URL>/Entity/AutomationManager`, the scenario will only be showed if it has a scope `Entity/AutomationManager`. The user can define multiple scopes, separated by a comma.
1. The **Condition Type** (currently only JSONata is supported) and the **Condition** allow for further specification of when to show the scenario. For example, the user can specify that a scenario is to be shown in the scope 'AutomationController' but only if the **Condition** `entityInstance.UniversalState = 0` is met. In this case the entity is in the state `Created`.
1. Select **Next** to continue the operation.

![Screenshot showing a form with fields for creating an automation business scenario, with "Next" button selected to continue.](images/create_businessscenario_general_data.png)

### Step 2: Metadata

The metadata definition contained in the **Automation Business Scenario** will be displayed. This is shown as a text box with JSON-formatted content. The metadata field will inform all steps and actions declared in the business scenario.

![Screenshot showing the "Create a UIOMANION Business Scenario" dialog box with fields for metadata entry.](images/create_businessscenario_metadata.png)

!!! info
    A Visual Studio Code extension for language formatting and for creating a visual rendering for Automation Business Scenarios is available at [Automation Business Scenarios Renderer](https://marketplace.visualstudio.com/items?itemName=CriticalManufacturing.automation-business-scenarios-vscode).

Select **Create** to complete the operation.