Loading the local workspace
To work on your applications, you must first load the instances you need into your local workspace. The Rational® Programming Patterns workspace is managed in the Design Explorer view of the Pattern Driven Programming perspective. When you open this view for the first time, it is empty. Your first task is then to populate it.
- To limit the number of the loaded artifacts, you can load some selected artifacts only. You can also load the artifacts or the projects that are required by one or more selected artifacts.
- To import all the artifacts that are contained in selected projects, you can load your local workspace from a Rational Team Concert stream.
You can also load your local workspace by importing the instances that are contained in an import file.
Loading artifacts
With this method, you load some selected artifacts only. It is adapted if you must bring minor changes to an artifact. You can use it, for example, to add a keyword to a Program without loading all the instances that are required by this Program.
To use this method, you must start a design, an artifact, or a reference search on the Rational Team Concert server. The search runs in an asynchronous mode. You can then keep on working while it runs in the background.
In the result view, you must then select the artifacts on which you must work. Right-click and select Load artifacts. The artifacts are displayed with an error in the Design Explorer view because you did not load their required artifacts. However, you can modify the artifacts and upload them afterwards.
Loading the required artifacts
With this method, you load the artifacts that are required by one or more artifacts. The subreference links are explored recursively. All the artifacts that are referenced in the initial artifact are then loaded, even if they are not used, to get no erroneous artifact when loading. For example, if a Program references a Data Structure, all the Segments that are referenced by this Data Structure are loaded. Then, all the Data Elements that are referenced by these Segments are loaded.
The artifacts are loaded from the Rational Team Concert server into your local workspace, where they constitute a consistent set of data.
- Searching for the artifacts in the indexes. It is completed through a server design search, a server artifact search, or a server reference search,
- Collecting the referenced artifacts. A progress bar indicates of the number of analyzed artifacts,
- Selecting the artifacts to be loaded. They are displayed in a specific loading wizard,
- Validating the selection,
- Loading the artifacts in the local workspace. It is completed by Rational Team Concert,
- Indexing, It is completed by Rational Programming Patterns.
To use this method, you must start a design, an artifact, or a reference search on the Rational Team Concert server. The search runs in an asynchronous mode. You can then keep on working while it runs in the background.
- One or more design files. If the design file is a Program, Screen,
or Server instance, a dialog box asks you whether you want to load
the associated generated source file. This file is not required but
its loading makes the product easier to use.
A specific loading wizard opens. It displays the selected design files and the artifacts that are required by them, following the subreference links. All these artifacts will be loaded into the local workspace.
- One or more files that contain the source of an instance (Program, Screen, Server, Dialog, or Server Dialog), or a Screen map. The specific loading wizard opens and displays the files that will actually be loaded. The generation links are automatically explored and all the artifacts that are required for the generation are automatically selected.
The local workspace that is loaded in this way can be used immediately from the Design Explorer view of the Pattern Driven Programming perspective.
- Moving, deleting, or renaming a file is impossible.
- Moving a project to another component is impossible.
- Renaming a folder that contains files that were loaded with the specific loading wizard is ineffective.
- Deleting a folder that contains files that were loaded with the specific loading wizard has no effect on the folder. Only the files are deleted.
- To load a full project that overwrites the same project with files that were loaded with the specific loading wizard, you must first delete the project to be overwritten.
- Deleting projects disconnects the shared files and deletes the complete folder structure.
- Unloading a component from the Pending changes view unloads all the shared files, but the folder structure in the project remains as a skeleton. You must delete them explicitly.
Loading the required projects
With this method, you load the artifacts from the projects that are required by instances or generated files. The artifacts are directly loaded from the Rational Team Concert server into your local workspace, where they constitute a consistent set of data.
To use this method, you must start a design, an artifact, or a reference search on the Rational Team Concert server. The search runs in an asynchronous mode. You can then keep on working while it runs in the background.
In the result view, you must select instances or generated files, right-click, and select Load required projects.
The selected artifacts and the projects that contain the artifacts required to maintain them are then loaded into your local workspace.
Loading from a Rational Team Concert stream
With this method, you load all the artifacts that are stored in some projects of a Rational Team Concert stream.
In the Team Artifacts view of the Work Items perspective, you must create a repository workspace from a stream of your team project area. This repository workspace is a private development workspace in which you can work alone or combine your work with the members of your team.
You must then select the projects to be loaded into your repository workspace.
All the selected projects are automatically displayed in your repository workspace and in the Design Explorer view of the Pattern Driven Programming perspective.
Loading from an import file
With this method, you load instances from a file that you must import. You import the file from the Design Explorer view or from the corresponding command line.
The file that contains the instances was exported with the export function of the Design Explorer view or created by the batch migration procedures.
When the file is imported, its instances automatically populate the location that is selected in the Design Explorer view of the Pattern Driven Programming perspective.