Validating Projects

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 2 Managing Projects and Resources : Validating Projects

Validating Projects

After you have created a project, you add resources to it and supply configuration information for your resources.

Before you prepare a project for deployment, it is critical that you validate it. TIBCO Designer includes reference-checking and other validation facilities that allow you to make sure a project is internally consistent. This is essential if you intend to run the project, or hand it to another user.

During validation, each resource always checks for broken references. Many resources have other resource-specific validation behavior. See Validate Project for Deployment for some additional information on the behavior of resources included with TIBCO Designer by default.

On UNIX platform, the builder utility requires configuration of X Server Manager (X11)or XVFB (X Virtual FrameBuffer). The builder utility fails when X server or XVFB is not running or when the DISPLAY environment variable is not set properly.

Validateproject Utility

The validateproject utility allows you to validate all project resources on the command line. The validateproject online help shows the command line syntax and describes each command option. To use the online help, change directory to TIBCO_HOME/designer/version/bin and type validateproject. The online help is as follows:

usage: ValidateProject [-h] [-u] [-a pathToAliases] project

-h: display this message

-u: show warnings for unused global variables

-a: path to a properties file mapping alias names to library paths (aliasName=/path/to/library/file)

project: the designer project to use.

To Validate a Resource

•

Select the resource to be validated, then choose Resources > Validate Resource from the menu bar.

•

With the resource selected, choose the Validate Resource icon.

To Validate All Resources

You can validate all resources either from the Project menu or using validateproject utility on the command line.

•

To validate all Resources from the Project menu

−

Choose Project > Validate Project for deployment.

−

Click the Validate Project for Deployment icon.

•

To validate all Resources using validateproject utility on the command line, change directory to TIBCO_HOME/designer/version/bin and start the validateproject utility. For example:

ValidateProject c:\myproject

Note that TIBCO Designer handles references to resources as strings. TIBCO Designer will help keep these references up to date, for example, when you move a resource to a different location. It is, however, possible to have "broken" references, for example, if you delete a resource and ignore the warnings displayed by TIBCO Designer. You can use the validation commands to find broken references.

By default, TIBCO Designer prompts whether you wish to perform reference checking each time you perform an activity that might result in a broken reference (move, rename, and so forth). You can change the default behavior using the Edit > Preferences > References tab.