> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/data-pipeline/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/data-pipeline/~/changes/BozVtU3tL5BwgOHeoMZt/getting-started/homepage/list-pipeline.md).

# List Pipeline

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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FyAUqHYfNw45HetuzoVn4%2Fimage.png?alt=media&amp;token=dc4fe2e8-ca49-4ce3-8c98-7c7ec667fd1b" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FVKnf51jMbslTUSqYpBH5%2FMicrosoftTeams-image%20(4).png?alt=media&amp;token=961249aa-cc82-477b-8a58-b07b160aede6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FGuvSb1TiuvDdMjvweqJH%2Fimage.png?alt=media&#x26;token=3e02a11b-9aad-4bed-b031-faa156432b66" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FOKhCicLALmtg2VcgeG2T%2FMicrosoftTeams-image%20(5).png?alt=media&amp;token=89b9dd06-7617-481b-91da-05255ea1460f" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FQwuqes2VtkaAWMrrFSyr%2Fimage.png?alt=media&amp;token=043e4aa1-80cb-46a5-a38c-bf20a71b79dd" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FLle0e6BcobDV8WVDdYhQ%2Fimage.png?alt=media&#x26;token=bed9a058-f6bf-4dac-a0c8-3ca57fa53532" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FGRTqMHAtADRdAw3wJzHV%2Fimage.png?alt=media&#x26;token=3d6ceabe-672f-4ca1-a9e4-3af1b97bcfac" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FwDi5g0fuIiutSWAp09B2%2FMicrosoftTeams-image%20(8).png?alt=media&amp;token=021247d4-44f3-41e6-b713-7de87ddd348e" alt=""><figcaption><p>View icon for a Pipeline</p></figcaption></figure>

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

<figure><img src="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FYoO2py62QsUnCd4Qkger%2Fpipeline_editor_UI_view.png?alt=media&amp;token=e8aad668-00e1-41c2-b858-ca58a8fc380b" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FAVWwqTdaZHzDRTZgM9Sy%2FMicrosoftTeams-image%20(9).png?alt=media&amp;token=93b7883c-c38c-4723-ba6c-5a775c3c6b3d" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FZS9ssKf8JhbF2yhWDMBK%2FMicrosoftTeams-image%20(10).png?alt=media&amp;token=a5b5cb8d-488d-407c-8736-7cf984a5c79f" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FxMBA6HWOob2DdpmfIcdr%2FMicrosoftTeams-image%20(11).png?alt=media&amp;token=4e8e64e5-2a95-4f45-b9d2-8d3240fcf810" 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FahjYu4icAmuL3WLeJk5O%2Fimage.png?alt=media&amp;token=d9acdaad-c56e-4db6-bbb1-137b23d7ab86" 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.

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

<figure><img src="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2F391AU876SSgKlIxOkO7X%2FMicrosoftTeams-image%20(12).png?alt=media&amp;token=6208fdb2-d06a-4ec9-bc5e-671d6d96b527" alt=""><figcaption><p>Accessing the Share icon from the List Pipeline page</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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FspuGjEupem0MhK93j1m5%2FMicrosoftTeams-image%20(13).png?alt=media&amp;token=f8bae05a-fdb6-4b4c-a999-2e4181823f7d" alt=""><figcaption><p>Confirmation message after a Pipeline gets shared.</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.

*Please Note:* *A non-admin user can **Edit/Modify** and **View** a pipeline but cannot **Share** it or **Delete** a shared pipeline.*

## 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FuEEHOzCsVEgozV9MP6ty%2FMicrosoftTeams-image%20(14).png?alt=media&amp;token=760c5eb6-0a97-4fa2-924d-50645116f3fb" alt=""><figcaption></figcaption></figure>

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

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FbY4nl9sIt2Yx8w0jbJEz%2Fimage.png?alt=media\&token=05b39c5f-45a2-4a45-a080-86114054609e)​

* 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="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2Ftf4gfKNdkSJhIL66Kpro%2FMicrosoftTeams-image%20(15).png?alt=media&amp;token=257a4260-0126-42fc-839c-3b883f4a0b27" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FWTtXHW9mRbdMNLpAV2p8%2FMicrosoftTeams-image%20(16).png?alt=media&amp;token=94fd5011-fbb6-4100-b86d-6cd9582d3a64" 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.

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FJNOKM2hePGbEY41M2zHq%2Fimage.png?alt=media\&token=268df33f-ba1f-44a9-95b5-393459ab36c5)​

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

<figure><img src="https://363587200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuq3RSHHup7fjHYaspk7y%2Fuploads%2FnbKC6gtFYP2QTHyKnUXP%2FMicrosoftTeams-image%20(17).png?alt=media&amp;token=5556ee52-6181-4cae-9458-8df5ca187989" alt=""><figcaption><p>Deactivating a Pipeline from the Pipeline List</p></figcaption></figure>