# List Pipelines

The ***List Pipelines*** option opens the available Pipeline List for the logged-in user. All the saved pipelines by a user get listed on this page. The ***Details*** tab on the right side of the page displays the basic details of the selected pipeline.

{% hint style="info" %}
*<mark style="color:green;">Please Note</mark>*<mark style="color:green;">:</mark> The ***Push to VCS*** and ***Pull Pipeline from GIT*** features are present on the ***List Pipeline*** page and as well as on the ***Pipeline Editor*** page.
{% endhint %}

## Pushing a Pipeline into VCS <a href="#pushing-a-pipeline-into-vcs" id="pushing-a-pipeline-into-vcs"></a>

* Navigate to the ***Pipeline List*** page.
* Select a data pipeline from the displayed list.
* Click the ***Push Pipeline*** icon for the selected data pipeline.

<figure><img src="/files/jYyoyXFoCyXA3o7coGJX" alt=""><figcaption><p>Pushing a Pipeline to VCS</p></figcaption></figure>

* The ***Push into Version Controlling System*** dialog box appears.
* Provide a ***Commit Message*** (required) for the data pipeline version.
* Select a ***Push Type*** out of the below-given choices to push the pipeline:
  1. 1.***Version Control:*** For versioning of the pipeline in the same environment.
  2. 2.***GIT Export*** (Migration): This is for pipeline migration. The pushed pipeline can be migrated to the destination environment from the migration window in Admin Module.
* Click the ***Ok*** option.

​​

<figure><img src="/files/7gfRswUWqPWxkLdhB4kx" alt=""><figcaption></figcaption></figure>

* A notification message appears to confirm the completion of the action.

<figure><img src="/files/Jz2rtT4aLnI5EBh6lTgf" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*Check out the below-given illustrations on how to attempt **Version Control** and **Pipeline Migration**.*
{% endhint %}

***Version Control:***

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FgpisZtyQwIgrIuK5rRPD%2Fvcs_push_AdobeExpress.mp4?alt=media&token=7c2d0c33-8dac-4d4e-980e-23bd66495e52>" %}
Push For Pipeline Versioning
{% endembed %}

***Pipeline Migration:***

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2F14IMaxbFLXl2TuzuUnFL%2Fpipeline_migration_AdobeExpress.mp4?alt=media&token=3d8c939a-b018-4b52-9186-2d40c73a26db>" %}

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark>*

* *The* *pipeline pushed to the VCS using the Version Control option, can be pulled directly from the **Pull Pipeline from GIT***![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FYfm0P0Q254pAz6i7ktXy%2Fimage.png?alt=media\&token=9a4ee1ce-da05-4a74-b50a-a560b606eb7d)*icon.*
* *The user also gets an option to **Push the pipeline to GIT**. **This action will be considered as Pipeline Migration.***
  {% endhint %}

## Pulling a Pipeline from GIT <a href="#pulling-a-pipeline-from-git" id="pulling-a-pipeline-from-git"></a>

This feature is for pulling the previously moved versions of a pipeline that are committed by the user. This can help a user significantly to recover the lost pipelines or avoid unwanted modifications made to the pipeline.

{% hint style="info" %}
*Check out the walk-through on how to pull a pipeline version from the GIT.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FFvKFBJ0xu30Vn93eN9i7%2FPull%20pipeline%20from%20VCS%20(online-video-cutter.com).mp4?alt=media&token=6742edca-26c0-4145-bab3-288717703ab6>" %}
Pulling a pipeline version committed earlier
{% endembed %}

* Navigate to the ***Pipeline List*** page.
* Select a data pipeline from the displayed list.
* Click the ***Pull from GIT*** icon for the selected data pipeline.

<figure><img src="/files/qcjTHZkrXnePGIsrvVEm" alt=""><figcaption><p>Pulling a Pipeline version from the GIT</p></figcaption></figure>

* The ***Pull from GIT*** dialog box appears.
* Select the data pipeline version by marking the given checkbox.
* Click the ***Ok*** option.

<figure><img src="/files/WFmSLPKR57h4axc571AU" alt=""><figcaption></figcaption></figure>

* A confirmation message appears to assure the users that the concerned pipeline workflow has been imported.

<figure><img src="/files/YryZdSJ1cNdMceCAYb8H" alt=""><figcaption></figcaption></figure>

* Another confirmation message appears to assure the user that the concerned pipeline workflow has been pulled.

<figure><img src="/files/2oZKyKlforWjd7bRmEM8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> The pipeline that you pull will be changed to the selected version. Please make sure to manage the versions of the pipeline properly.*
{% endhint %}

## View Pipeline <a href="#view-pipeline" id="view-pipeline"></a>

Clicking on the ***View*** icon will direct the user to the pipeline workflow editor page.

* Navigate to the ***Pipeline List*** page.
* Select a Pipeline from the list.
* Click the ***View*** icon.

<figure><img src="/files/qGjPr26jr7o0PCY2Zxf3" alt=""><figcaption><p>View icon for a Pipeline</p></figcaption></figure>

* The ***Pipeline Editor*** page opens for that pipeline.

<figure><img src="/files/6wiJAxD9iciVJ7ez38jX" alt=""><figcaption><p>Pipeline Editor page for the selected Pipeline</p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note</mark><mark style="color:green;">:</mark>* *The user can open the Pipeline Editor for the selected pipeline from the list by clicking the **View** icon or the **Pipeline Workflow Editor** icon on the Pipeline List page.*
{% endhint %}

### Searching a Pipeline

*The user can search for a specific pipeline by using the **Search bar** on the Pipeline List. By typing a common name all the existing pipelines having that word will list. E.g., By typing the **sample** all the existing pipelines with the words that contain '**Sam' like sample** in it get listed in the following image:*&#x200B;​

<figure><img src="/files/yBz21cmxQgsw2JIsxSyO" alt=""><figcaption></figcaption></figure>

### **View Pipeline details from the list Pipeline page**

Click on the pipeline to view the information of the pipeline on the list pipeline page. Once clicked on the pipeline name, a menu will open in the right side of the screen showing all the details of the selected pipeline. Please go through the below demonstration:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FxEL7R1sM2ZFZt7IkEbBX%2F2023-03-27-17-50-58%20(online-video-cutter.com).mp4?alt=media&token=fd4d2ce7-eff2-4dae-ad97-e10b334e358f>" %}

* By clicking on the pipeline name, the following details of that pipeline will be shown in the right side of the screen:
  1. **Components:** Number of components used in the pipeline.
  2. **Created By:** Owner name of the pipeline.
  3. **Created Date:** Pipeline created date.
  4. **Updated By:** Name of the person who has updated the pipeline recently.
  5. **Updated Date:** Date when the pipeline is updated.

## Monitor Pipeline <a href="#monitor-pipeline" id="monitor-pipeline"></a>

Clicking on the monitor pipeline icon will direct the user to the pipeline monitoring page.

* Navigate to the ***Pipeline List*** page.
* Select a Pipeline from the list.
* Click the ***Monitor*** icon.

<figure><img src="/files/rcldaXMFeHKt31Dn2V6n" alt=""><figcaption><p>Monitor icon provided on the Pipeline List page</p></figcaption></figure>

* The user gets redirected to the Pipeline Monitoring page of the selected Pipeline.
* The Monitor tab opens by default.
* The user can click the ***Data Metrics*** tab if wants to see depiction of the component specific data metrics.

<figure><img src="/files/V1HBarnAS5PYT8Un8AQz" alt=""><figcaption><p>Monitor tab for a Data Pipeline</p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note</mark>: Check out the* [***Monitoring Pipeline***](https://docs.bdb.ai/7.6/data-pipeline/getting-started/monitoring-pipeline) *page for the more details on this topic.*
{% endhint %}

## Failure Analysis <a href="#test-pipeline" id="test-pipeline"></a>

Failure analysis is a central failure mechanism. Here, the user can identify the failure reason. Failures of any pipeline stored at a particular location(collection). From there you can query your failed data in the Failure Analysis UI. It displays the failed records along with cause, event time, and pipeline Id.

* Navigate to the ***Pipeline List*** page.
* Select a Pipeline from the list.
* Click on the ***Failure Analysis*** icon as highlighted in the below image to get redirected to the ***Failure Analysis*** page.

<figure><img src="/files/Z3QNxm6vM3rbb80zl9RQ" alt=""><figcaption><p>Failure Analysis</p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> Refer to the* [***Failure Analysis***](https://docs.bdb.ai/data-pipeline/~/changes/hPXwcPgG9oW1n2fHDeOk/getting-started/pipeline-workflow-editor/pipeline-toolbar/failure-analysis) *for more details on this.*
{% endhint %}

## Sharing a Pipeline <a href="#sharing-a-pipeline" id="sharing-a-pipeline"></a>

The user can share a pipeline with one or multiple users and user Groups using the ***Share Pipeline*** option.

* Navigate to the ***Pipeline List*** pag&#x65;**.**
* Select a Pipeline from the pipeline list.
* Click on the ***Share Pipeline*** icon.

<figure><img src="/files/fEqj65W5AUK0iAEaQNX5" alt=""><figcaption><p><em><strong>Accessing the Share icon from the List Pipeline page</strong></em></p></figcaption></figure>

* The ***Share Pipeline*** window opens.
* Select an option out of the given choices: ***User*** (default tab) and ***User Group*** or ***Exclude User*** (the **Exclude User** option can be chosen, if the pipeline is already shared with a user/user group and you wish to exclude them from the privilege).
* Select a user or user(s) from the displayed list of users (In case of the User Group(s) tab, it displays the names of the User Groups.
* Click the arrow to move the selected User(s)/ User Group(s).

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FhG6cp01kGtfEoYCw2ZnZ%2Fimage.png?alt=media\&token=aa1c1233-c7f3-407f-ab75-3aa08a19234d)​

* The selected user(s)/user group(s) get moved to the box given on the right (In case of the ***Exclude User*** option the selected user/ the user moved to the right-side box looses the access of the shared pipeline).
* Click the ***Save*** option.

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FHegVrEWaQ8gTxYe5UtX3%2Fimage.png?alt=media\&token=1af9992b-e67a-4368-a7b4-ec07f34f4555)​

* Privilege for the selected pipeline gets updated and the same gets communicated through a message.

<figure><img src="/files/aLEcLshuqRi32gZFz8p6" alt=""><figcaption><p><em><strong>Confirmation message after a Pipeline gets shared</strong></em></p></figcaption></figure>

* By completing the steps mentioned above, the concerned pipeline gets successfully shared with the selected user/user group or the selected users can also be excluded from their privileges for the concerned pipeline.

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark>* *A non-admin user can **Edit/Modify** and **View** a pipeline but cannot **Share** it or **Delete** a shared pipeline.*
{% endhint %}

## Activate/Deactivate Pipeline <a href="#activate-deactivate-pipeline" id="activate-deactivate-pipeline"></a>

The user can activate/deactivate the pipeline by clicking on the Activate/ Deactivate icon.

* Click the ***List Pipelines*** icon to open the Pipeline list.
* Select a Pipeline from the pipeline list.
* Click on the ***Activate Pipeline*** icon.

<figure><img src="/files/KpGqYWgyBZfeayfGcoX3" alt=""><figcaption></figcaption></figure>

* The ***Confirmation*** dialog box opens to get the confirmation for the action.
* Click the ***YES*** option.

&#x20;      ![](/files/3Qy7HSHSRm20ZHhTGpg4)​

* A confirmation message appears.
* The pipeline gets activated. The ***Activate Pipeline*** icon turns into Deactivate Pipeline.
* the same gets communicated through the ***Status*** icon color.

<figure><img src="/files/RB6DnCiRTo9PbYiW4QrE" alt=""><figcaption></figcaption></figure>

* Click the ***Deactivate Pipeline*** icon.

<figure><img src="/files/6tCRFOGW2CilyiXRRmY6" alt=""><figcaption><p>Accessing the Deactivate icon</p></figcaption></figure>

* The ***Confirmation*** dialog box opens to get the confirmation for the action.
* Click the ***YES*** option.

&#x20;     ![](/files/LF3CEmdyVPyhfjqsNCIR)​

* A confirmation message appears.
* The pipeline gets deactivated. The same gets communicated through the color of the ***Status*** icon.

<figure><img src="/files/3Yg3fVq1zHZxVniEI0cd" alt=""><figcaption><p>Deactivating a Pipeline from the Pipeline List</p></figcaption></figure>


---

# 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.bdb.ai/data-pipeline/getting-started/homepage/list-pipelines.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.