Contents
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.
In StreamBase 10, Studio provides two ways to import existing projects into Studio:
-
>>
-
>>
The difference between these methods is clear. Both methods have valid uses.
| >> | >> |
|---|---|
| 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 must unzip 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 >>. In this case, you must use > to preserve StreamBase project metadata. | If your external Maven project is multilayered, with project folders within project folders. |
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:
-
Select > from Studio's top-level menu, or right-click in empty space in the Project Explorer view and select Import.
-
In the Import dialog, select > and click .
-
In the Import Projects dialog:
-
Select the Select archive file button, then enter the path to the archive file or click to navigate to the archive file.
-
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 check box for any projects you do not want to import.
-
Click .
-
-
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 already 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 make another selection.
If the imported project does not have a Studio-standard folder such as src/main/java, Studio creates it.
You can import an existing StreamBase project into the current Studio workspace from another workspace folder. To do this, follow these steps:
-
Select > from Studio's top-level menu, or right-click in empty space in the Project Explorer view and select Import.
-
In the Import dialog, select > and click .
-
In the Import Projects dialog:
-
Select the Select root directory button, then enter the path to the other workspace directory or click to navigate to that directory.
-
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.
-
Click , then individually select the project or projects you want to import.
-
Important! Make sure the Copy projects into workspace check box is selected.
-
Click
-
-
Studio imports the selected project folders and copies their contents into your current workspace.
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:
-
In the Project Explorer, select the project folder that you want to contain the resource files of interest.
-
Right-click and select Import from the context menu.
-
In the Import dialog, select > and click .
-
In the File System dialog, use the button to navigate to the directory of interest.
-
With a resource directory selected on the left, navigate among its subfolders and files on the right.
-
Select the check boxes next to any of that folder's files that you want to import.
-
In the Into folder field, confirm that the Studio project folder you selected in step 1 is shown, or use the button to navigate to a different location.
-
Select among the Options check boxes as required.
-
-
Click
-
Studio imports the selected files into the specified project folder in your current workspace.