> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/administrative-settings-5/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/administrative-settings-5/admin-panel-options/git-migration/migrating-a-dashboard.md).

# Migrating a Dashboard

The users can import an exported Dashboard using this feature.

* Navigate to the ***Admin Module.***
* Click the ***GIT Migration*** icon from the side navigation bar. ​
* Click the ***Import File*** option that appears.&#x20;

  <figure><img src="https://4090376733-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuMgCAr8LDezd8gVX68JP%2Fuploads%2FHosRpSfRWt5uqOohYQLH%2Fimage.png?alt=media&amp;token=49c784d2-896e-4916-8175-399b1a231c52" alt=""><figcaption></figcaption></figure>
* Click the ***Import*** option that appears on the next page.​

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/YOxCXwyTHsd4Yul0vMX9/image.png" alt=""><figcaption></figcaption></figure>

* The ***Migration-Document Import*** screen appears.
* Select the ***New VCS*** for the ***Version Control Configuration***.
* The ***Select a Module*** drop-down menu bar appears at the top-right side of the screen.

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/F4Bmk5ArrtXmlUow6C50/image.png" alt=""><figcaption></figcaption></figure>

* Select the ***Dashboard*** module.
* A list of the exported dashboards appears on the left side of the page.

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/GTsNpcmrat6PYEkUwpdH/image.png" alt=""><figcaption></figcaption></figure>

* Use the search bar to search for a dashboard. (Ex. vtestdasdboard)
* The customized list appears based on the searched term.
* Select a dashboard and click to open the details.
* The various versions (if available in the GIT) of the selected dashboard appear.

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/xEG9nVx8Y0bQ7zBda3y0/image.png" alt=""><figcaption></figcaption></figure>

* Select a version using the checkbox.
* Some more information about the selected dashboard gets displayed.
* Click the ***Migrate*** option.

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/2cb40VXoYvap1AmsDDT2/image.png" alt=""><figcaption></figcaption></figure>

* The ***Data Connector Details*** dialog window appears to configure a data connector.
* The user gets two choices to configure the data connector:

&#x20;    ![](https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/oMCS7bYx5gUYrsXGaLUv/image.png)

### **Use Existing Connector**

* Let the checkmark be in the given checkbox to use an existing connector.
* Select a data connector from the drop-down menu.
* Click the ***Save*** option to save the configured data connector details.​

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/7vohQ5MVX8weuYF3wDrk/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note</mark>:* *When the selected Dashboard displays multiple connectors, the user must select them all with the **Use Existing Connector** option to load all the charts under the selected Dashboard.*&#x200B;
{% endhint %}

### **Create a New Data Connector**&#x20;

* Select the ***Create New Connector*** option.
* Provide the required details: Username, Password, PI/Host, Database Name
* Click the ***Save*** option.

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/MeI5MFUYj1h2LfdRrmUJ/image.png" alt=""><figcaption></figcaption></figure>

* A notification message appears, and the selected dashboard gets migrated to the Designer module.​&#x20;

  <figure><img src="https://4090376733-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuMgCAr8LDezd8gVX68JP%2Fuploads%2FsYCozIHfOPVVUOhmHCUP%2Fimage.png?alt=media&amp;token=60642efd-2ac7-4c49-b9bc-7ee446c35f23" alt=""><figcaption></figcaption></figure>
* Navigate to the ***Designer*** module.
* The migrated dashboard gets added to the ***Manage*** section.&#x20;

<figure><img src="https://content.gitbook.com/content/uMgCAr8LDezd8gVX68JP/blobs/R8PFcdgzNa2dvqiM5ctF/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note</mark>:* *Click the **GIT Export** icon to export the selected dashboard to GIT. All the exported Dashboards can be imported using the Import File option of the GIT Migration.*
{% endhint %}
