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.
Packages and integrations
This topic explains the concepts of Rational® ClearQuest® packages and integrations.
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.
    - Precautions when applying packages
      Follow these guidelines when you apply a package to a schema.
    - Packages available
      This topic lists the Rational® ClearQuest® packages that are currently available, grouped by category.
    - Overview of package application process
      This topic explains the general steps involved in applying a package to a schema.
    - Examples: The Notes, Attachments, and Email packages
      The most commonly used packages are Notes, Attachments, and Email.
    - Checking which packages have been applied to a schema
      Before you apply new packages or package versions, you can check which package versions have already been applied to a schema.
    - Upgrading packages
      This topic explains the concept of upgrading packages in Rational® ClearQuest®.
    - The AuditTrail and eSignature packages
    - EmailPlus package
      - EmailPlus record types
      - Working with EmailPlus templates
      - Creating EmailPlus rules
      - Customizing an enabled record type
      - Mail relay
        Use the Rational® ClearQuest® EmailRelay service to implement a private relay service to forward email requests to a server that is registered for Simple Mail Transfer Protocol (SMTP) server access.
      - Performance
      - Notifications
        The Rational® ClearQuest® Notifications feature is available in EmailPlus package 2.5 and higher and can be used in the Modern Web user interface offered by Rational ClearQuest.
      - Email attachments
      - Debugging EmailPlus
      - Administration of EmailPlus
    - Attachments package
      The Attachments package stores record attachments on an external server instead of in the Rational® ClearQuest® database.
  - 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.
  - 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.