> This page is for Itential Platform On-Prem, version 2023.2.
> For other versions, use one of these documentation indexes:
> - 6 (default): https://docs-test.itntl.com/itential-platform/6/llms.txt
> - 2023.2: https://docs-test.itntl.com/itential-platform/2023-2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-test.itntl.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-test.itntl.com/_mcp/server.

# Add a Form Builder task to a workflow

> How to add a Form Builder ShowFormByName task to a workflow in legacy Itential Platform versions.

> **Info**
>
> This is a legacy functionality in earlier Itential Platform versions. See the [Platform 6.0.0 Breaking Change](/itential-platform/release-notes/breaking-changes/form-builder-removed) notice.

This page covers how to add a **Form Builder** task to a workflow. It does not describe the functionality of the Workflow Builder application.

> **Note**
>
> If you are not familiar with the Workflow Builder application, consult the relevant user guide before proceeding.

You can use Form Builder to add a form to a workflow, allowing users to enter information as part of the business process.

#### Open or create a workflow

Create a new workflow or open an existing one.

#### Add the ShowFormByName task

Select **FormBuilder** in the Source Application dropdown list. Select **ShowFormByName** and add it to the workflow.

![](/_fern-img/ed8a22605e7859846eb761462d44eda3fbde991a7db7de1fa15bed23971c34f0.webp)

#### Configure the manual task

Enter an appropriate summary and description, and assign it to the relevant User Group.

#### Configure the task variables

Configure the variables for the **ShowFormByName** task:

* **`form_name`** — The name of the form.
  * Set **Reference task** to `static`.
  * Enter the form name as the **Reference variable**.
* **`instance_data`** — If form values are entered by the user and are not populated by a previous task or external system:
  * Set **Reference task** to `static`.
  * Enter `{}` as the **Reference variable**.

![](/_fern-img/564cab75850e0655183a5a2042035b01fa209445e00d4c37c70eeceaf22f4f66.webp)

#### Save the workflow

Click **Update**, then **Save** the workflow.

#### Start the workflow and work the task

Click **Start workflow**. Navigate to the **Work queue** to view the task in the **Available Tasks** list. Click the task to initiate the work.

![](/_fern-img/d25cee8570ffe6849ba311d28c1dc574ea098c0180e959b460af903e29507235.webp)

**Outgoing data format example:**

```json
{
  "/ncs:services/itential_test_devices:cisco-ios": [
    {
      "device": [
        "csr01-atl"
      ]
    }
  ],
  "/ncs:services/aspan-vrf:aspan-vrf": [
    {
      "vpn-id": 1,
      "vrf-name": "vrfName",
      "route-target": [
        {
          "rt-export": [
            {
              "asn-ip": "1.1.1.2:33"
            }
          ]
        }
      ]
    }
  ]
}
```

> **Note**
>
> The internal reference to a form field retains the original value before the field was renamed.