To work on your applications, you must first load the instances
on which you must work into your local workspace. The Rational Programming
Patterns workspace is represented by 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.
You can populate your local workspace from the content
of a Rational Team Concert server. To do so, you must open the
Team
Artifacts view of the
Work Items perspective.
You must create a repository connection to the Rational Team Concert
server and connect to the project area managed by your team. When
you are connected, you can load your local workspace in various ways:
- To limit the number of the loaded artifacts, you can load only
the artifacts or the projects that are required by one or more artifacts
that you select.
- 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 the required artifacts
With
this method, you load the artifacts that are required by one or more
artifacts. The artifacts are loaded from the Rational Team Concert
server into your local workspace, where they constitute a consistent
set of data.
Loading the required artifacts comprises the following
global steps:
- Searching for the artifacts in the indexes, performed by a server
design search, a server artifact search, or a server reference search,
- Collecting the referenced artifacts, indicated by the progress
bar of the number of analyzed artifacts,
- Selecting the artifacts to be loaded, displayed in a specific
loading wizard,
- Validating the selection,
- Loading the artifacts in the local workspace, performed by Rational
Team Concert,
- Indexing, performed by Rational Programming Pattern.
To use this method, you must start a design,
an artifact, or a reference search on the Rational Team Concert server.
In
the result view, you must then select the artifacts on which you must
work. Right-click and select
Load required artifacts.
You can select this choice from one of the following artifacts:
- One or more design files. A specific loading wizard opens and
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.
Note: The number of the artifacts to be loaded is displayed for
information.
The local workspace that is loaded in this
way can be used immediately from the Design Explorer view
of the Pattern Driven Programming perspective.
Limitations: The folder structure that is
loaded with the specific loading wizard does not have a shared status.
The
following limitations then apply to the files loaded in this way:
- Moving, deleting, or renaming a file is impossible.
- Moving a project to another component is impossible.
- Renaming a folder that contains files loaded with the specific
loading wizard is ineffective.
- Deleting a folder that contains files 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
loaded with the specific loading wizard, you must first delete the
project to be overwritten.
To perform all these actions, you must fully load the projects
that are involved.
If you create or generate instances in projects
loaded with the specific loading wizard, you must share them explicitly.
In the
Design Explorer view, select the instances
or the COBOL files to be shared, right-click, and select . A sharing wizard opens. It shares the newly created
files that belong to the same project and folder. If a new file is
in a new folder, you must create this folder explicitly in the sharing
wizard. This wizard automatically selects the correct project and
folder to be shared. If you generated an instance, the wizard automatically
selects the files that are associated with the source file (map file
for Screens and metadata files). When the files are shared, they are
displayed in the
Pending changes view. You
can then check them in a repository workspace and deliver them to
the server.
Note: You can also open the file sharing wizard from the Project
Explorer view of the Resource perspective
if you generated the source in a zComponent project for example.
The
following limitations apply when unloading components loaded with
the specific loading wizard.
- 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 that are contained in the projects
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.
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.