> For the complete documentation index, see [llms.txt](https://docs.meta-inf.hu/pipeline-forms/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meta-inf.hu/pipeline-forms/general-product-information/concept-and-goals.md).

# Concept & Goals

{% hint style="danger" %}
:white\_check\_mark: **IMPORTANT - PLEASE READ IT** :white\_check\_mark:

**While the app is available at the** [**Atlassian Marketplace**](https://marketplace.atlassian.com/apps/1234290/pipeline-forms-schedule-with-parameters-advanced-fields?hosting=cloud\&tab=overview)**, it can be installed only from this** [**install link**](https://developer.atlassian.com/console/install/969025b6-9d62-4f5c-ab1b-c141fd1c41fe?signature=069a192f2c144997e0f53c1c04841b3f9160cd83823404b64984f8b2f528bcc2a8d7511b42c10b8765b3938ab35e1dfe567e8ba356ffefb8c2109ad2d9d4adb4\&product=bitbucket)**.** Since Forge on Bitbucket is so new (it just left EAP and became GA), it is impossible to install Bitbucket Forge apps directly from the Atlassian marketplace. It is **Safe to install** from here and will be available on Marketplace when Atlassian makes it possible. See more details at [Installation](/pipeline-forms/user-guides/administration-guide/installation.md).

By installing the app, you automatically accept our [Terms of Use](https://www.meta-inf.hu/legal-documents/terms-of-use).
{% endhint %}

## Goals & Purpose

Building apps within the Atlassian ecosystem usually involves tools like Jira, Confluence and Bitbucket.

In **Confluence** you can write documentation, in **Jira** you can manage issues and in **Bitbucket** you can manage your software's source code.

Bitbucket is great in terms of **integration** with other tools, but lacks some **features** as a CI tool.

> **Pipeline Forms (PFO) is created to improve the experience using Pipelines in Bitbucket.**

## Problems we solve

* Lack of **flexible customization of** **pipelines**, especially in terms of custom input values
* Huge `bitbucket-pipelines.yml`since pipelines need to be **copy-pasted** for different variations
* Lack of dynamic field values (they have to be static or freetext)
* Inability to **overwrite default values** while scheduling
* Inability to **edit** and **view scheduled** pipelines

## What we add

* **Forms** - extend pipelines attributes with many supported field types and several attributes
  * select, remote, text, textarea, number, checkbox, checbox group, radio, date fields are made available
  * mandatory, secure, read-only, hidden, remote, regex fields can be created
  * remote fields can be pre-populeted through public API
  * with forms added, `bitbucket-pipelines.yml`file complexity can be reduced
* **Scheduled** pipeline executions - run form-extended pipelines when needed
  * manage schedules, view, edit, inactivate, and delete them
* **Audit** history - track changes and view execution history
* **Pretty UI** where users can self-serve with well-configured pipelines

## Getting started

{% content-ref url="/pages/cMuf2ZbMtCFCZEplxuYb" %}
[Features](/pipeline-forms/general-product-information/features.md)
{% endcontent-ref %}

{% content-ref url="/pages/YMTYha1tQnY9Q9DXqq2n" %}
[How PFO works securely](/pipeline-forms/general-product-information/how-pfo-works-securely.md)
{% endcontent-ref %}

{% content-ref url="/pages/5hM64efDjjjeP348Ivgg" %}
[Installation](/pipeline-forms/user-guides/administration-guide/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/6hIGG0e9CAk7GMxwdF7e" %}
[User Guide](/pipeline-forms/user-guides/user-guide.md)
{% endcontent-ref %}

## Deep dive

{% content-ref url="/pages/cj8qzpiNF3FyL795Qm9O" %}
[Create Forms](/pipeline-forms/user-guides/user-guide/create-forms.md)
{% endcontent-ref %}

{% content-ref url="/pages/aL05L1kG2ZnxziBYGHhX" %}
[Schedule a Form](/pipeline-forms/user-guides/user-guide/run-pipelines/schedule-a-form.md)
{% endcontent-ref %}

{% content-ref url="/pages/0frvrxm94OGQTxttEpNu" %}
[Showcase an example with every feature used in the form](/pipeline-forms/additional-information/examples/showcase-an-example-with-every-feature-used-in-the-form.md)
{% endcontent-ref %}

{% content-ref url="/pages/92Fwh5qAcLACKcYe5sBN" %}
[Audit logs](/pipeline-forms/user-guides/user-guide/audit-logs.md)
{% endcontent-ref %}