> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Form Execution

> Execute connector tools individually using forms

## What is Form Execution

The Form Execution screen allows you to execute each tool provided by a connector individually using a form interface. This is convenient when you want to directly operate specific tools without using chat.

<img src="https://mintcdn.com/carnot/twCYe3dtbHpRCzif/en/pages/jinba_app/images/connectors-detail.png?fit=max&auto=format&n=twCYe3dtbHpRCzif&q=85&s=b8b1fec563bd979e424ca7282271a941" alt="Form Execution screen overview" style={{ width: '100%', borderRadius: '8px', margin: '32px 0' }} width="1280" height="800" data-path="en/pages/jinba_app/images/connectors-detail.png" />

## Accessing Form Execution

<Steps>
  <Step title="Open Connector Management Screen">
    Select "Connectors" from the side menu.
  </Step>

  <Step title="Select a Connector">
    Click the connector you want to use from the My Connectors list.
  </Step>

  <Step title="Select Form Execution">
    Click the "Form Execution" tab or button on the connector details screen.
  </Step>
</Steps>

## Tool List

A list of tools provided by the connector is displayed.

Each tool displays the following information:

* **Tool Name**: Identifier name of the tool
* **Description**: Explanation of the tool's function
* **Parameters**: Input fields required for tool execution

## Searching Tools

When there are many tools, you can use the search function to quickly find the one you need.

<Steps>
  <Step title="Enter in Search Box">
    Enter keywords in the search box at the top of the tool list.
  </Step>

  <Step title="Review Results">
    Only tools matching the tool name or description will be displayed.
  </Step>
</Steps>

## Executing Tools

Execute the selected tool using a form interface.

<Steps>
  <Step title="Select a Tool">
    Click the tool you want to execute from the tool list.
  </Step>

  <Step title="Enter Parameters">
    Enter the required parameters in the form. Required fields are marked with "\*".

    {/* TODO: Screenshot - Parameter input form */}
  </Step>

  <Step title="Click Execute Button">
    Click the "Execute" button to run the tool.
  </Step>

  <Step title="Review Results">
    The execution results will be displayed on screen.

    {/* TODO: Screenshot - Execution results */}
  </Step>
</Steps>

## Execution Result Summary

After tool execution, a summary of the results is displayed.

The summary includes:

* **Execution Status**: Success/Failure
* **Execution Time**: Date and time the tool was executed
* **Retrieved/Processed Data**: Result data from execution
* **Error Information**: Error details if execution failed

## Execution History

You can view the history of previously executed tools.

<Steps>
  <Step title="Select History Tab">
    Click the "History" tab on the Form Execution screen.
  </Step>

  <Step title="Review History">
    Past execution history is displayed in a list. You can check date/time, tool name, and status.
  </Step>

  <Step title="View Details">
    Click a history item to view the execution details (input parameters, execution results).
  </Step>
</Steps>

### Re-executing from History

You can re-execute a tool with the same parameters from past execution history.

<Steps>
  <Step title="Select History Item">
    Click the history item you want to re-execute.
  </Step>

  <Step title="Click 'Re-execute'">
    Click the "Re-execute" button on the details screen.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tool execution fails">
    Please check the following:

    * Are all required parameters filled in?
    * Are the parameter values in the correct format?
    * Is the connector connection valid?
  </Accordion>

  <Accordion title="Execution results are empty">
    * There may be no data matching the search criteria
    * Try changing the parameter values and re-executing
  </Accordion>
</AccordionGroup>