DriveWorks Pro 15: Covering Letter Template Document [send feedback...]

Introduction

DriveWorks contains a Cover Letter document template in XML format. This enables the user to quickly set up a customizable covering letter. DriveWorks will place a copy of the document in the location of the project files. This is the file that DriveWorks will use to create the document.

This document will create a number of variables which link in to the document. Rules can be built for the variables to customize the document.

The Covering Letter document template will create a HTML file which is viewable in a web browser.

To Add a Covering Letter Document Template:

In DriveWorks Administrator open the project the document is to be applied and go to Stage4: Output Rules> Documents

  1. Click the "Add" button on the command bar.
  2. Choose the Covering Letter Document from the Document Templates list on the Add Document wizard.
  3. Give the new document a name and click "Finish".

To Edit Covering Letter Document Template:

  1. The Master File Path is the location of the XML document. If the location of the document changes then it will need re-browsing to using the "Browse..." button.
  2. The Output File Name is the name given to the newly created document. Click the "Build..." button to give the document a name.
  3. The Output File Path is the location where the driven document will be stored. Click the "Build..." button to set the document path.
  4. The document can also be hidden from the document list in the Specification Explorer by checking the Hide from Document list General Setting.
  5. To build a rule for a Tagged Element (Placeholder) select an element from the list and click the "Build..." button.
The Document can be Deleted if it is not required by making the result of the document name return Delete.

Document Variables:

Along with this document DriveWorks will create a set of variables which link to the document. It is recommended that these are used and rules are not created in the Tagged Elements section of the document editor.

The variables can be edited the in the Define Variables section. DriveWorks will have created 2 new variable categories, the common category and also a category with the name given to the document.

The DriveWorks Logo which appears on the document can also be changed by replacing the Logo.png image in the location of the document with the a new image with the same name and format.
The Output File Name will need to be unique if the document is created in the same location for each specification, otherwise existing documents will be overwritten.
If the Output Path is not set then the file will be created in the specification folder.

The  Covering Letter document is triggered in the specification flow by the Release Documents task.

Modifying Images and XML

The images used in the document can be modified by replacing the existing images with your own.

A folder will be created in the Project location with the name:

<Document Name> Covering Letter

This folder will contain an image Logo.png and the file Covering.xml and a sub folder named Content.

The Content folder contains the file CoveringTransform.xslt

More advanced customizations can be done if you are familiar with XML and XSLT by modifying the corresponding files in the locations described above.

Table of Contents