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 required by one or more artifacts that
you select.
- To import all the artifacts 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 contained in an import file.
Loading the required artifacts
With
this method, you load the artifacts 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 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
required for the generation are automatically selected.
Note: The number of the artifacts to be loaded is displayed for
information.
The local workspace loaded in this way can
be used immediately from the "Design Explorer"
view of the "Pattern Driven Programming" perspective.
Limitations: The folder structure 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 projet 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
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 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 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 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
selected in the "Design Explorer" view of the
"Pattern Driven Programming" perspective.