# Forms

## Introduction

DBSync Forms streamline data capture and connect it to backend operations seamlessly. These Forms can be customized with various fields (for example, text boxes, variables, and tables) to suit the specific data collection needs of your organization. These Forms can be used to build workflows, integrate with other systems (like Salesforce, QuickBooks, or databases), and automate processes such as creating records, updating fields, or generating reports.

## Purpose

The forms simplify the process of changing the object for synchronization. Without the form, a user would have to go inside the flow, into the query configuration, and write an entire query for the new object. If a form is present, changing from a customer to an account on the form is reflected in the query.

## Customize Forms

To access Forms, follow the steps given below;

1. In the **Automated task** page, click **Configure** next to an automated task.
2. Once the **Flow** screen is open, navigate to **Forms**.
3. Click **+ Form** in the top right to create a form if there are no forms created.

   <figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2F2ARFklQC5MWdRlZWmgzO%2Funknown.png?alt=media&#x26;token=33ab95e7-56dc-4ec4-a137-6ec882f7d81c" alt=""><figcaption></figcaption></figure>
4. Add a suitable name for the form.
5. Click **More (...)** in the Actions column and select Edit Action.
6. The **Setup Designer** window opens for you to customize the Forms.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FBbxoB97NOYI46qOECMRx%2Funknown.png?alt=media&#x26;token=92f63b8e-bb48-44ee-9889-7e8b703cd672" alt=""><figcaption></figcaption></figure>

The **Setup Designer** consists of two perspective views namely, the *Developer View* and the *Customer View*.

When creating forms, there are two distinct views that cater to different user roles and perspectives: Developer View and Customer View. Here's a description of each:

#### Developer View

This view is designed for the technical users, like developers or administrators, who build, configure, and maintain forms within the workflow. This window presents a canvas to create questionnaires or forms with the help of a tool panel that can be used to obtain relevant information regarding the specifics of the integration. The information that is obtained serves as a tool to customize a template for the end user to use to integrate any two applications.

Depending on the requirement, drag and drop the components (Text<img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2Fe54rnlfIukbrwoAeJjFa%2Fimage.png?alt=media&#x26;token=6e78e5c8-9c79-4c9b-98c4-6d49efa66241" alt="" data-size="line">, Variable<img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2Fspgj2ipFI5IPKwcx4pC6%2Fimage.png?alt=media&#x26;token=3a9bb29b-c37e-47c7-9b7d-bee60ee1b183" alt="" data-size="line">, and Table<img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2F8i14V18zc88UXQCKCtV4%2Fimage.png?alt=media&#x26;token=a38ea019-7fd5-4f0f-a9a4-6cae8100862d" alt="" data-size="line">) and configure them.

The configuration process involves selecting the application (for example, monday.com) and choosing the object (for example, customer ID customer).

* **Text**<img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FuwWY0MfQuvQsnWoc7GrB%2Fimage.png?alt=media&#x26;token=9ac7f34c-8e3c-4aee-aacf-7938e863e28f" alt="" data-size="line">: Click the pencil icon to enter the required header text and to edit it.
* **Variable**<img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FNDKVUOc5X4ZqU0UkxluE%2Fimage.png?alt=media&#x26;token=7f6840c1-8d7f-4e75-b600-ad6d34c19971" alt="" data-size="line">: Click the dropped variable to open the Variable configuration panel on the right side and enter the required details for the variable.
* **Table**<img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FQ6JUT1Hc7tOrZcnNhc21%2Fimage.png?alt=media&#x26;token=98fbef75-a8e8-4f9d-95bf-9cd17e28cb36" alt="" data-size="line">: Click the dropped table to open the Table configuration panel on the right side and enter the required details for the variable.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FEBX2qz4HoakKmCkdtena%2Funknown.png?alt=media&#x26;token=9fb704d9-e56a-434a-99aa-f13759514f21" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FPkc2BxVhchrhaMRqz53T%2Funknown.png?alt=media&#x26;token=767516ed-dc7c-47db-ac24-dc63da5f4ec8" alt=""><figcaption></figcaption></figure>

#### Features

* Access advanced settings to configure the form's behavior, logic, and data flow.
* Define field types, validation rules, and business logic for integration of CRM applications or databases (if required).
* Build forms using the tool panel that has **Text**, **Variable**, and **Table**.&#x20;
* Set permissions, visibility, and conditions for the form based on business rules.
* Key Users: Developers, IT administrators, and advanced users familiar with the technical side of DBSync workflows.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FHnVW74rAExpIhtMvAAqO%2Funknown.jpeg?alt=media&#x26;token=2e451849-f2a2-4ef6-af5b-4c9de84dd290" alt=""><figcaption></figcaption></figure>

#### **Customer View**

The Customer view provides a simplified, user-friendly interface that illustrates how end-users or customers will interact with the form.&#x20;

Users can access the forms by clicking **Setup** for each Automated task in the Automation tab. Each Automated task will have its own forms attached to it.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2Fbn8aV5y3GZBROk23Jh5p%2Funknown.jpeg?alt=media&#x26;token=05c06cfa-cccf-4615-ada3-cb35ef5537cc" alt=""><figcaption></figcaption></figure>

#### Forms in Templates and Customer Use:

For customers using a predefined template, the customer view is often already filled out during the implementation time.

* Pre-built templates include all standard flows, not necessarily specific to a customer's needs.
* Customers can use the forms to easily disable specific flows (for example, opting not to sync customers but only transactions). To disable a specific flow,  choose *No* in the corresponding drop-down, without manually turning off the flow or writing a rule.

#### **Features**

* Easy to use, with minimal technical details.
* Clean and intuitive interface that only displays relevant fields and options based on user roles and form logic.
* Simple validation messages and user inputs for smoother form submission.
* Hidden technical aspects such as data flow or complex logic.
* Customizable: Meets the specific needs of the customer and end-user without exposing unnecessary details.
* Key Users: Customers, employees, or any non-technical users interacting with the form.

In essence, the Developer View provides full control over the form's design and functionality, while the Customer View ensures a streamlined and intuitive experience for end-users.


---

# 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.mydbsync.com/cloud-workflow/2026_create-your-workflow/flow-management/forms.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.
