# Manual execution

## Prerequisites

To execute a pipeline you need to have the following items ready:

* a valid pipeline in `bitbucket-pipeline.yml`&#x20;
* a valid `pipeline-forms.yml`&#x20;
  * with at least one form in it
    * should have at least one field on it
      * the form must be connected to a pipeline

<figure><img src="https://2614715257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR41wZlyQDaFKYgHnadh%2Fuploads%2Fm9zUj6NdrQOD3HIU5vS5%2Fimage.png?alt=media&#x26;token=6f7bf390-1391-4e0a-94d6-99205cab73f0" alt=""><figcaption></figcaption></figure>

## Execution

There are 3 main selectors during execution:

### Branch / tag

Branch name & tag name can be searched for:

<figure><img src="https://2614715257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR41wZlyQDaFKYgHnadh%2Fuploads%2FtRneAOACg0NukJO6fEGE%2Fimage.png?alt=media&#x26;token=62cfcc37-1abc-4c6e-a377-04f56c04bcb6" alt=""><figcaption><p>Search and select branches and tags</p></figcaption></figure>

### Commits

The latest commit is automatically selected.

The committee, commit hash and commit messages can be searched from the selected branch:

<figure><img src="https://2614715257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR41wZlyQDaFKYgHnadh%2Fuploads%2FP4R5v67ONkV2UI7lWK9o%2Fimage.png?alt=media&#x26;token=e6bacd72-3d0e-4146-9268-c2a3f4b5d7a8" alt=""><figcaption><p>Search and select for commit details</p></figcaption></figure>

### Forms

Every form that is available for the commit can be searched. Forms can be grouped to support variations, which can be greatly useful if used as presets:

<figure><img src="https://2614715257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR41wZlyQDaFKYgHnadh%2Fuploads%2Fbiaw88ZalzijIzs27OgV%2Fimage.png?alt=media&#x26;token=9d233609-a22f-41ec-9a79-4c5383c70f06" alt=""><figcaption><p>Search and select available forms</p></figcaption></figure>

After selecting the form, the configured input fields will present:

<figure><img src="https://2614715257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR41wZlyQDaFKYgHnadh%2Fuploads%2F73uOxBreeZMDPBtTkNbi%2Fimage.png?alt=media&#x26;token=0a65d9f7-aad5-4f07-9986-488bd1dfd88f" alt=""><figcaption><p>Fields loaded from pipeline-forms.yml</p></figcaption></figure>

{% hint style="info" %}
To discover all the possibilities with forms:

* visit [syntax-for-the-pipeline-forms.yml-file](https://docs.meta-inf.hu/pipeline-forms/user-guides/user-guide/create-forms/syntax-for-the-pipeline-forms.yml-file "mention")&#x20;
* check out the [showcase-an-example-with-every-feature-used-in-the-form](https://docs.meta-inf.hu/pipeline-forms/additional-information/examples/showcase-an-example-with-every-feature-used-in-the-form "mention")
  {% endhint %}

Fill in the fields and press **Run Pipeline** for manual execution.

<figure><img src="https://2614715257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR41wZlyQDaFKYgHnadh%2Fuploads%2Fn68jy2UlN033FRqG8jrN%2Fimage.png?alt=media&#x26;token=b6901e10-8e4d-40ac-abec-3538a30c8a54" alt=""><figcaption><p>Pipeline #13 is triggered</p></figcaption></figure>

Visit the Pipelines menu in the left sidebar, and check for the pipeline's number to see the results.

{% hint style="success" %}
Every manual execution with Forms will add a record to the Execution logs on the right side.
{% endhint %}
