# Testlink: importer tool for migrating test cases to aqua

Follow these steps to set up the TestLinkImporter tool and successfully migrate your test cases from TestLink to Aqua:

### Download and extract the zip file

First, you need **to** **download** the `TestLinkImporter.zip` file. Please find the file below.

{% file src="<https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FGaK0NLjnFLl4WDtIQ4oz%2FTestLinkImporter.zip?alt=media&token=84e3c3f7-9785-4673-8180-fc7de76e13f5>" %}

Then **extract** the contents of the zip file to your desired location.

### Prepare the import folder

**Open** the extracted folder. You should see several files.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FIa75ZDkb4pc8RHNlkoty%2Fimage.png?alt=media&#x26;token=013b5713-71e8-4ceb-a37f-68b6cfdb13fa" alt=""><figcaption></figcaption></figure>

**Place** the file you want to import into the `toImport` folder.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FknIL9iAN62Btdxj5DikI%2Fimage.png?alt=media&#x26;token=c07cbb7d-c530-414f-85f8-a06649be8c84" alt=""><figcaption></figcaption></figure>

### Configure the importer

Open the `TestLinkImporter.exe.config` file with a text editor.

**Provide the following values:**

* **Endpoint address:** In the `<client>` section, set the endpoint address. Ensure it ends with `aquaAPI/Mainservice.asmx`.
* **Username:** Your aqua username.
* **Password:** Your aqua password.
* **apiUrl:** This should also end with `aquaAPI/Mainservice.asmx`.
* **ProjectName:** The name of your project in aqua.
* **FolderName:** The name of the folder where the test cases will be imported.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FslMqly4FcijIiExrzXOW%2FGroup%201.png?alt=media&#x26;token=bea27be7-9234-4ed3-9201-4522b1e63562" alt=""><figcaption></figcaption></figure>

**Save** and **close** the config file after making the changes.

{% hint style="info" %}
Please note that you should pre-create projects and folders in aqua in advance.
{% endhint %}

### Run the importer

**Open** the `TestLinkImporter.exe` file.

**Press** the Enter key twice.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FK7sIi5sbfjTEE8rgsGA4%2Fimage.png?alt=media&#x26;token=c19c101a-9235-4f20-9735-b6deb9973a07" alt=""><figcaption></figcaption></figure>

You will see a modal indicating that the file is being imported. Once the test cases  are migrated, the modal automatically closes.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FRrRob6XBfKNq2fsFjvH2%2Fimage.png?alt=media&#x26;token=13291c7c-dead-42e1-9b22-8930e37a3c00" alt=""><figcaption></figcaption></figure>

### Verify the import in aqua

**Switch** to aqua app and **reload** the browser or click on the **Refresh** button. The imported items should now be listed in the navigation grid under the project/folder you provided during configuration of the import.

By following these steps, you should be able to migrate your test cases from TestLink to aqua quickly.