> For the complete documentation index, see [llms.txt](https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/bds-portal/creating-my-first-project/5.-code/3.-upload-my-source-code.md).

# 3. Upload my source code

The upload source code option is available for conversion and assessment projects. This step changes according to your repository selection:

#### A. Convert from BDS repository:&#x20;

1. You will be asked to upload a Zip Folder. Please [avoid using these folder names](https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/bds-portal/creating-my-first-project/5.-code/3.-upload-my-source-code/folder-names-not-allowed.md) because they will not be uploaded. They will be ignored by the BlackDiamond Studio repository.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FwSpA3L0kOLnG5hJqZmD8%2Fupload-source-code-BDS.png?alt=media\&token=f52edff0-6bd7-40a1-a54c-0f410f30a93d)

2\. Upload your code and convert it using [SnowConvert](https://docs.mobilize.net/snowconvert/) in the cloud or convert it later. To convert your code do the following:

&#x20;    2.1. Choose your source platform between Oracle, Teradata, SQL Server, or Scala.

<figure><img src="https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FsGK7MLv33w2VdtQZhIRE%2Fselect-source-code.png?alt=media&amp;token=ce473cfe-1200-4fde-8792-4835c4ab1085" alt=""><figcaption></figcaption></figure>

&#x20;    2.2. A trial license will be automatically created. It will allow converting 5000 lines of code for the next 7 days.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2Fn6Liluy9E1Lani7UAp7u%2Flicense.png?alt=media\&token=238d773e-e454-4e8a-89c5-82f8b327a508)

&#x20;    2.3. As an **Optional Step** you can configure the conversion settings.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FlmfAuQFl8YMSg72kOO5w%2Fconversion-settings.png?alt=media\&token=fb6e3655-cf56-46f7-b22d-714beac0aa70)

&#x20;    2.4. Click on the **Start Conversion** button. This process might take several minutes or hours depending on the size of your code.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FKV2gyyuKfcZjqerU8dyU%2Fstart-conversion.png?alt=media\&token=6d5fa648-03a0-41af-87aa-4fd55663b6d6)

&#x20;    2.5. Then the conversion will be executed.&#x20;

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2F20TpCAYHVbprsh6JbG4v%2Fconversion-in-progress.png?alt=media\&token=34912f67-a095-409a-81b8-95b32aed6475)

&#x20;    2.6. Once the conversion is completed, the project home page will be displayed containing a project summary and the buttons: Open IDE, Open Repository, and Share.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2F1EyWbKTqpk5HkzPvjxoi%2FOpen-IDE.jpg?alt=media\&token=a00f34a8-083d-4a46-ac25-728639d2baa5)

2.7. The conversion results can be reviewed in the IDE by clicking **Open IDE**. Check the [compare source code ](https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/code-conversions/converting-sql-code-to-snowflake.md)feature to compare your source and target code.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2F8Gutu30QfC7M4k4BVaAH%2FOpen-IDE_1.jpg?alt=media\&token=527fa800-5d6d-4619-bbff-d7e084e4bd33)

2.8. To review the assessment reports open the **Reports** folder in the IDE explorer or in the repository.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FbNpShgGu8gMkam0JyUBC%2FReports.png?alt=media\&token=71780067-e297-444a-9155-8ee64f01abdc)

2.9. Continue working with your converted source code in the IDE to get the best out of BlackDiamond Studio. Your code can be found in the IDE explorer in the **Target** folder.

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FM4LCBwemd9RoD022VW9x%2FTarget%20folder.png?alt=media\&token=4d093e66-3ecc-41f3-9aaa-24a84b12c11e)

2.10. You can also share your project. Check the [Sharing Project section](https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/bds-portal/sharing-a-project.md).&#x20;

![](https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FBWKtHGoB7D2kA1DgFwZi%2FSHARE.jpg?alt=media\&token=96a15ce6-01f6-424e-bde4-d95bcb04c764)

#### B. Convert from an external repository:&#x20;

In this case, you are able to upload your code to your repository or convert your code directly from your external repository.

<figure><img src="https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FciNXZOTU7nTtQGOdkRRn%2Fgit-external-select-conversion-option.png?alt=media&amp;token=2f2a226b-3d6d-44c1-8305-55070cde1c3e" alt=""><figcaption></figcaption></figure>

1. If you select **Upload source code to convert,** the steps are going to be the same as the [previous flow](#a.-convert-from-bds-repository) where you uploaded the source code.<br>

<figure><img src="https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2FRBnP8zfG3ADjYJsUrpP6%2Fexternal-upload.png?alt=media&amp;token=0f56e4f2-7752-44ee-91e1-dac71b3ecaed" alt=""><figcaption></figcaption></figure>

2\. In case you selected **Convert Code from my external repository**, you need to name the folder you want to convert **Sources**. The following steps are like the [previous flow](#a.-convert-from-bds-repository), where you select the source platform, activate the conversion license and you will also have the option of edit the conversion settings. Then the conversion can be executed.

<figure><img src="https://3318121499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FltqydcnGV3BWCCC3QkYO%2Fuploads%2Fs9tFKbJa2XiURwDJMebE%2Fconvert-from-external-git.png?alt=media&amp;token=5e712680-31e1-4c3f-ba2c-c7f75d628776" alt=""><figcaption></figcaption></figure>
