Welcome
Developing
Learn how to develop schemas by using the Rational® ClearQuest® Designer.
Developing Schemas
You can develop or modify schemas with the Rational® ClearQuest® Designer.
Rational® ClearQuest® email
This topic provides a description of the supported Rational® ClearQuest® Web client email features.
EmailPlus package

IBM ClearQuest 10.0.9
Overview
Learn general information about the product.
Installing
Learn how to install the product.
Upgrading and migrating
Learn how to upgrade and migrate data for the product.
Administering
Learn how to administer the product.
Reporting
Learn how to generate reports for the product.
Developing
Learn how to develop schemas by using the Rational® ClearQuest® Designer.
- Developing Schemas
  You can develop or modify schemas with the Rational® ClearQuest® Designer.
  - Understanding the functions of the Rational® ClearQuest® schema developer
    This topic provides an overview of the tasks typically performed by a schema developer.
  - Overview of the Rational® ClearQuest® Designer interface
    The Rational® ClearQuest® Designer includes several different windows, or views, that you will use to perform your schema development tasks.
  - Rational® ClearQuest® schemas
    This topic explains the concept of a Rational® ClearQuest® schema.
  - Customizing a schema
    To modify how change requests are handled, you need to use the Designer to customize the records and fields of a schema.
  - Schemas and packages
    This topic explains the concept of using schemas and packages in Rational® ClearQuest®.
  - Packages and integrations
    This topic explains the concepts of Rational® ClearQuest® packages and integrations.
  - Test Management and Requests
    You can use the ClearQuest® TestManagement and Requests feature to create and track test plans and add approval processes to the record.
  - Working with Forms
    You must create a record form for each record type in your schema. You can also define a submit form for each record type.
  - Creating a security model
    This topic provides an overview of the process to create a security model.
  - Using hooks to customize your workflow
    This topic provides guidelines for using hooks to implement your workflow.
  - Record locking
    When multiple users attempt to simultaneously update a record, the database locking model ensures that the update from each user succeeds as a unit, but each update overwrites the previous update.
  - Customizing the Web
    The Designer provides many ways to customize the underlying schema and functionality that the Rational® ClearQuest® Web client accesses.
  - Rational® ClearQuest® email
    This topic provides a description of the supported Rational® ClearQuest® Web client email features.
    - Automatic e-mail notification
      E-mail messages can be sent to users or user groups when a record meets criteria that you define in a schema.
    - Round-trip e-mail
      Your team can use e-mail notification with e-mail submission to update records. This process is called round-trip e-mail.
    - EmailPlus package
    - Using action hooks to send e-mail
      You can use an action notification hook to send e-mail messages when a user completes a specific action. In your hook code, you use the Rational® ClearQuest® API to create the message and send it.
  - Importing and exporting data
    This topic describes how to import and export data between Rational® ClearQuest® databases, and how to import data into a Rational ClearQuest database from another defect tracking system.
Managing change and releases
Learn how to manage change and release in the product.
Integrating
You can integrate Rational® ClearQuest® with other software by adding packages to existing schema.
Extending product function
Learn how to extend the product.
Reference
Review reference information for the product.
Tutorials

EmailPlus package

The Rational® ClearQuest® EmailPlus package provides enhanced email notification functions. EmailPlus includes the following support:

Customizing the content of the message subject and body with boilerplate text
Including dynamic content in emails in addition to field old or new values
Including rich content (HTML)
Providing access to SMTP restricted servers
Attaching files to email
Allowing enhanced conditions to construct the rules
Allowing the self-subscription of users to rule or record notifications
Enabling enterprise-wide configuration of email notifications, which can be enabled or disabled by users
Providing performance improvements through queries
Extending the rules and data displayed through customer-provided extensions

The EmailPlus package is implemented in Perl.

Note: To configure the EmailPlus in Perl:

Login to Rational® ClearQuest® Designer and add EmailPlus package to schema.
Edit the global Perl Script EMP_Customisable and add to the start of the code:
```
$MAX_FIELDPATH_RECURSE_DEPTH = 2;;

$FIELDPATH_INCLUDE_STRINGS = 1;;
```
Configure EmailPlus to use SMTP Direct5 and create Email Rule that sends an email through the descriptionfield.

If you enter one (1) userid the EmailPlus works. If you enter, a newline or comma, the EmailPlus does not send the email.

Although the package is implemented in Perl, it can be used to enable VBScript-based schemas because packages have their own scripting language defined.

The package can be added to any Rational® ClearQuest® schema. You can deploy the package in mixed environments to Rational® ClearQuest® Web or to Rational® ClearQuest® clients that run on Microsoft™ Windows™, UNIX™, or Linux™.

The possibility of name conflicts are minimized by prefixing routine names with EMP_ and by prefixing session name values with EMP::. Avoid using names like these to ensure that the package can coexist with other packages in your schema.

Note: The EmailPlus package is installed into the packages directory where it is available for the schema developer to incorporate into your schema.

Attention: If you are using the ALM 1.1 package, and you plan to upgrade to the latest EmailPlus package, references to EmailPlus 2.0 apply to you.