Copyright © TIBCO Software Inc. All Rights Reserved

Overview of Projects

A project is a collection of resources, including, for example, adapter resources and process definitions. Together, these resources define the configuration of your integration project. In the TIBCO Designer window, a project is represented by the top-level (root) folder in the project panel. The top-level folder is initially named Untitled and is renamed to the name of the project when you save the project for the first time.

Each TIBCO Designer window contains only one project. If you open a second project, TIBCO Designer opens a new window.

When you close a project, the startup panel remains available for project maintenance or for opening a different project unless you selected the Show this panel only on startup checkbox on that window.

Project Structure

When you save a project, TIBCO Designer creates a hierarchy of folders and files in the location you choose for the project.

When you supply a project location, be sure no other files reside in that folder. TIBCO Designer removes any existing files before placing the project files into the folder.

When you create a multi-file project:

•	There is one file per top-level resource. For TIBCO ActiveMatrix BusinessWorks, that may mean one file per process. For adapters, more resources may be considered part of a top-level resource.

•	The project root directory identifies the project. The project root can be located anywhere in the file system and is determined when you first save the project. All components of a project are located under this common project root.

•	Directories in the file system become folders in TIBCO Designer. However, not all folders in TIBCO Designer are directories in the file system:

−	Folders created from a Folder resource in the General Palette (displays a multi-folder icon) become folders in the file system.

−

Other folders, such as the Adapter Services folder inside an adapter configuration are logical folders. These folders only exist in memory in the resource that holds them. The actual data for these elements is stored in the file of the top-level resource. For example, the Adapter Services data are stored in the Adapter Configuration file.

•

TIBCO Designer creates a file named vcrepo.dat in the project root directory when you first save the project. This file is used to store properties such as display name, TIBCO Rendezvous encoding, and description. This file can be used for identification in place of the project root directory and can be used as the repository locator string (repoUrl).

This file cannot be used for identification or as the repoURL for TIBCO Adapters (including custom adapters based on TIBCO Adapter SDK). Note that for ActiveEnterprise 5.2, the preferred method of deployment is to generate an EAR file and upload it into TIBCO Designer, not to run the adapter using a properties file. See Chapter 6, Creating an Archive for Deployment.

Using a Version Control System

Multi-file projects support the use of different version control systems because they consist of separate files for each versionable component.

Once the root directory is defined under the control of a version control system, standard version control system tools can be used. The following version control systems are supported and discussed separately:

•	File Sharing

•	Microsoft Visual SourceSafe

•	Perforce Fast Software Configuration Management System

•

XML Canon

•

ClearCase

•

CVS

•	PVCS Version Manager

Project Templates

A project template is a pre-built project. It can contain folders for organization, configured resources, and partially configured resources. You can use a project template as the foundation for other projects similar in nature. Using a template, you can leverage your work when performing similar configurations.

Copyright © TIBCO Software Inc. All Rights Reserved