Importing into Studio

This topic describes how to import projects, files, or schemas into StreamBase Studio.

Importing an individual file brings it into Studio in a controlled way. If you fail to import a file, but instead simply copy it into your workspace, StreamBase cannot operate on it as a resource of your project. The same is true if you open an EventFlow module file from a non-workspace file system location directly in StreamBase Studio.

Import Existing Projects or Import Maven Projects?

In StreamBase 10, Studio provides two ways to import existing projects into Studio:

  • Import>General>Existing Projects into Workspace

  • Import>Maven>Existing Maven Projects

The difference between these methods is clear. Both methods have valid uses.

Import>General>Existing Projects Import>Maven>Existing Maven Projects
Allows you to copy the project into your current workspace. Does not provide a copy option. You can only work on existing projects in their current location outside the Studio workspace.
Imports based on the Eclipse metadata in the incoming project, which preserves the StreamBase-enhanced Maven project format. Driven entirely by the POM file in the directory.
Allows you to import from either an archive file or a directory. Can only import from a directory. You have to unzip the project archive files given to you.
Use when ...
You want to transfer projects from a previous StreamBase Studio workspace into the current release. If you have a large, Maven-based non-StreamBase project outside of Studio, from which you want to import elements into a new Studio project.
You are given an archive file created with Export>General>Archive File. In this case, you must use Import>General to preserve StreamBase project metadata. If your external Maven project is multilayered, with project folders within project folders.

Importing Archived Projects

You can import a StreamBase project into the current Studio workspace if that project that was exported from Studio as described on Exporting Studio Projects. To do this, follow these steps:

  1. Select File>Import from Studio's top-level menu, or right-click in an empty space in the Project Explorer view and select Import.

  2. In the Import dialog, select General>Existing Projects into Workspace and click Next.

  3. In the Import Projects dialog:

    1. Select the Select archive file button, then enter the path to the archive file or click Browse to navigate to the archive file.

    2. The project or projects in the selected archive file appear in the Projects area of the dialog, with all projects in the archive selected by default. Clear the checkbox for any projects that you do not want to import.

    3. Click Finish.

  4. Studio imports the selected project folders from the archive file and copies their contents into your current workspace.

Note

You cannot overwrite a Studio project name that exists in your current workspace. If you select a project archive file that contains a project with the same name as an existing project, the Import Projects wizard forces you to make another selection.

If the imported project does not have a Studio-standard folder such as src/main/java, Studio creates it.

Importing Existing Projects from Another Workspace

You can import an existing StreamBase project into the current Studio workspace from another workspace folder. To do this, follow these steps:

  1. Select File>Import from Studio's top-level menu, or right-click in an empty space in the Project Explorer view and select Import.

  2. In the Import dialog, select General>Existing Projects into Workspace and click Next.

  3. In the Import Projects dialog:

    1. Select the Select root directory button, then enter the path to the other workspace directory or click Browse to navigate to that directory.

    2. The Projects area of the dialog now shows all project directories in the selected workspace, with each project preselected. Any projects with the same name as a project in your current workspace are dimmed and cannot be selected.

    3. Click Deselect All, then individually select the project or projects you want to import.

    4. Important! Make sure that the Copy projects into workspace checkbox is selected.

    5. Click Finish.

  4. Studio imports the selected project folders and copies their contents into your current workspace.

Importing Resource Files

To import resource files (such as CSV data files or authentication keys) from your local file system to the current Studio project, follow these steps:

  1. In the Project Explorer, select the project folder that you want to contain the resource files of interest.

  2. Right-click and select Import from the context menu.

  3. In the Import dialog, select General>File System and click Next.

  4. In the File System dialog, use the Browse button to navigate to the directory of interest.

  5. With a resource directory selected on the left, navigate among its subfolders and files on the right.

    1. Select the checkboxes next to any of that folder's files that you want to import.

    2. In the Into folder field, confirm that the Studio project folder you selected in step 1 is shown, or use the Browse button to navigate to a different location.

    3. Select among the Options checkboxes as required.

  6. Click Finish.

  7. Studio imports the selected files into the specified project folder in your current workspace.

Back to Top ^