# Astera's Project Explorer

The purpose of creating a project is to organize your Astera work items in files and folders. This is particularly helpful when one is dealing with a large project which consists of numerous flows. It also helps in implementing a use case in a more effective way and makes the process of deployment easier.

In this article, we will learn how to create a new *Integration Project* and use some of the options available in the *Project Explorer* panel.

## **Creating a New Project**

1. To create a new project, go to the menu bar and click on the following options: *Project > New > Integration Project.*

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FeplgWyjLBdr8fOdUntA0%2F0.png?alt=media)

There are 3 different kinds of projects you can create by either clicking on its name or pressing the given shortcut keys to the right.

* *Integration* *Project:* Creates an empty project that does not contain any pre-defined folders. It is ideal to use when you want to develop an integration project from scratch.
* *Data Warehousing Project:* Allows users to create a data warehousing project.
* *REST Client Project:* Creates a project with two dedicated folders for importing REST APIs and adding shared connections.

2. Next, navigate to the folder where you want to save your project, name your project, and click *Save*. In this example, we are saving our project with the name *SampleProject.cprj*.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FYpyusQuiZAPoCDWinpWf%2F1.png?alt=media)

3. You can view your project in the Project Explorer panel, as shown below.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FR5RiBv6vboIJVENLfcrX%2F2.png?alt=media)

## **Project Explorer Options**

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FPOkHEDJx2NwG4e7UmNeA%2F3.png?alt=media)

There are several options in the Project Explorer panel such as:

* *Close Project:* Closes a currently open project.
* *Build Archive (.Car) for the Project:* Creates an archive (.Car) file.
* *Verify Project:* Verifies design time errors of the project (such as missing fields, syntax errors in the expressions, etc.).

{% hint style="info" %}
**Note:** It does not verify the runtime errors.
{% endhint %}

* *Refresh Project:* Refreshes and synchronizes changes within the project.
* *Replace parameter values for all the distinct parameters:* Replace all the distinct directory paths and the database connection information used in the project with new values provided.
* *Replace parameters info for all distinct and consolidated parameters:* Replace all the distinct and consolidated directory paths and the database connection information used in the project with new values provided (this option removes the repeats and shows consolidated parameters).
* *Add Project to Source Control:* This enables Source Control to keep track of new changes and save all previous commits in case the user wants to revert to the last saved version.
* *Automatically re-build lineage when project is loaded or modified:* Represents connections among different files such as dataflows, subflows, etc. in the project graphically.

## **Adding New Items or New Folders to a Project**

1. Right-click on the project name inside the *Project Explorer*, and from the context menu, select *Add New Item*.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FRri5WdbnPNoNzbVK0HIg%2F4.png?alt=media)

2. Choose the type of item from the available options, provide an appropriate name for the item, and click *Add*. In this example, we are adding a new dataflow with the name *SampleDataflow\.Df.*

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FLNWQTiOnNbwfs2J5v7kZ%2F5.png?alt=media)

3. The new item, *SampleDataflow\.Df* is now a part of your project.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FmC4atWTKmgxmT64B1pmP%2F6.png?alt=media)

4. Similarly, to add a new folder, right-click on the project name inside the *Project Explorer and* click *Add New Folder.*

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2F6LU0rSohl7eFJ7u1owpM%2F7.png?alt=media)

5. The new folder is now a part of your project. You can rename the folder by right-clicking on *Folder* and selecting *Rename.*

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FV9uXV9yz75gTyG0sLAaf%2F8.png?alt=media)

## **Adding Existing Items or Existing Folders to a Project**

1. Right-click on the project name in the *Project Explorer* and click *Add Existing Items or Add Existing Folder*, depending on what you want to add. We will see how to *Add Existing Items* first.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2Fx317N26IoD7u1HLq9nIy%2F9.png?alt=media)

2. Locate the item/folder you want to add to the project in the local directory, select it, and click *Open.* In this case, we are adding *Sample\_Dataflow2.Df* to our project.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2FSRdl8ZLGY0eJ6fVuWRFI%2F10.png?alt=media)

3. The item, *SampleDataflow2.Df* is now a part of your project.

![](https://750977703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqHxyVNGb7tSdIWecl6Ru%2Fuploads%2F2Hif3n0UPglIMiMU6olJ%2F11.png?alt=media)

4. You can try the *Add Existing Folder* option by following the same steps mentioned above if you wish to add an existing folder instead of an existing item to the Project.

To conclude, this is how you can create and manage a project in Astera using the tools provided in the *Project Explorer* panel.