DriveWorks Pro 16: Documents [send feedback...]

Documents

DriveWorks has the ability to create Documents such as Microsoft Word, Microsoft Excel, or HTML Documents. The Documents Task provides you with the ability to add Documents to your Project.

The Documents list can be filtered by using the filter at the top of the list.

Please see the topic How To Use Filters for more advanced filtering information.

To Add a Document

In DriveWorks Administrator open the project and go to Stage4: Output Rules and select either Documents - Files or Documents - Data depending on which kind of Document you are wishing to add.

  1. Click the Add button on the command bar to launch the Create Document wizard
  2. Choose the required document type from the Documents list in the Create Document wizard.
  3. Enter a name for the Document in the field below the Documents list.

4. The next step depends on the Document type being created:

  • For some Document types this is all the information that is required, and the 'Finish' button will be available in the wizard to complete the set up process.
  • For other Document types a next step will be required and the 'Next' button will be available in the wizard to complete the set up process.

Please refer to the Document Types section below for information specific to the Document being added.

Once a Document has been added the properties of the Document that can be driven will be available in the Document editor.

To Edit a Document

In DriveWorks Administrator open the Project in which the Document is to be edited and go to Stage4: Output Rules and select either Documents - Files or Documents - Data depending on which kind of Document you are editing.

  1. Select the Document to be edited from the listed Documents.
  2. Click the Edit button on the command bar to open the Document Properties window.

Please refer to the Document Types section below for information specific to the Document being added.

Document Edit Notification

When performing a Task that saves the Project you are notified if an item within another Task is currently being edited.

Tasks that will cause the notification to appear include:

  • Creating a new Specification.
  • Opening, closing or creating a Project.
  • Opening, closing or creating a Group.

The message displays the name of the item under edit and the Task it can be found in.

  • Click Yes to save and close the open Document and proceed with the Specification.
  • Click No to continue with the Specification without saving and closing the open Document.
  • Click Cancel to abort the new Specification.

All items currently in edit mode will be listed.

To Rename a Document

In DriveWorks Administrator open the Project in which the Document is to be renamed and go to Stage4: Output Rules and select either Documents - Files or Documents - Data depending on which kind of Document you wish to rename.

  1. Select the Document to be renamed from the Documents listed.
  2. Click the Rename button on the command bar to rename the Document.

Alternatively, double click the Document name to begin editing.

To Delete a Document

In DriveWorks Administrator open the Project in which the Document is to be deleted and go to Stage4: Output Rules and select either Documents - Files or Documents - Data depending on which kind of Document you wish to delete.

  1. Select the Document to be deleted from the Documents listed.
  2. Click the Delete button on the command bar to delete the Document.
Deleting a Document will remove all rules. This action can be reversed by clicking the Undo button.

To Preview a Document

In DriveWorks Administrator open the Project to which the Document is to be previewed and go to Stage4: Output Rules and select either Documents - Files or Documents - Data depending on which kind of Document you wish to preview.

  1. Select the Document to be previewed from the Documents list.
  2. Click the Preview button on the command bar to delete the Document

The following Document types cannot be previewed from the Documents stage:

  • Copied File
  • ODBC Data Export
  • SQL Server Export
  • Referenced File
  • Email

Document Types

Documents are split into two sections. These sections are Document - Files and Document - Data.

Documents - Files

TypeDescription
Copied FileA Copied File is used to copy an existing file as-is into the same folder as the Specification. This Document type has no rules.
DriveWorks 3D FileA DriveWorks 3D File (*.drive3d) can be driven as a Document.
Email

DriveWorks Autopilot has the ability to send Emails, and optionally include attachments. Rules for the Email parameters (To, Cc, Bcc, Subject, Body, Attachments) are applied in DriveWorks Administrator.

Excel Workbook

This Document type is used to export data directly in to a Sheet in a Microsoft Excel Workbook from the DriveWorks project.

Export FormA snapshot image of a single user Form, along with the data entered onto it can be taken (*.png format) by using the Export Form Document.
Referenced FileA Referenced File is used to reference any file where you know the location and the name of that file.
Text DocumentThis Document type creates a text file.
Word Document

This Document type is used to export data directly in to a Microsoft Word Document from the DriveWorks project.

XML Document (Advanced)

This Document type is used to export data directly in to all nodes of a XML Document from the DriveWorks project.

XML Document (Simple)

This Document type is used to export data directly in to a XML Document from the DriveWorks project.

TemplateDescription
BOM Document

DriveWorks contains a BOM (Bill Of Materials) Document template in XML format. This enables the user to quickly set up a customizable BOM.

Covering Letter

DriveWorks contains a Cover Letter Document template in XML format. This enables the user to quickly set up a customizable covering letter.

HTML Email DocumentCreates an Email Document from a template.
HTML Quotation LetterCreates a customizable letter and quote.
Proposal DocumentCreates a proposal Document from a template.
Quote DocumentDriveWorks contains a Quote Document template in XML format. This enables the user to quickly set up a customizable quote.
Quote Document (Français)Creates a customizable quote Document in French.

Documents - Data

TypeDescription
Export to Calculation TableExports rows to an existing Calculation Table in the Project.
Export To Group TableExports data to a Group Table.
Export To Simple TableExports data to a Simple Table that will be available for the existing Specification only.
ODBC Data Export

DriveWorks has the ability to export data to an external database (using a Microsoft Windows ODBC connection) as part of running a DriveWorks Project.

SQL Server Data Export

DriveWorks has the ability to export data directly to a SQL Server database as part of running a DriveWorks Project.

Triggered ActionA Triggered Action allows a Specification to Transition to a State once a specified file has been created.

Document Creation Order

The order Documents are created for a new Specification can be controlled by modifying the Default Specification Flow, see example of this here How To: Change Document Generation Order

See How To: Modify Specification Flow for information on adding a Task sequence to a State. Multiple Documents are added to the Task sequence by using a pipebar delimited list (DocName1|DocName2|etc..). The order the Documents appear in the string is the order they will be generated. Alternatively the order each Task sequence appears in the list of Task sequences for a given State is the order that Task will be performed.

ODBC Data Export Document

DriveWorks treats any ODBC Data Export as a Document, but the timing of this taking place is set independently of the Document generation timing. The Time to Export setting applied in the ODBC Data Export wizard is the time the export is done.

Take care the Time to Export setting for the data export does not conflict with any settings applied to a customized Specification Flow.

Email Document

Emails are sent by Autopilot as soon as all information is available for the Email to be sent.

Take care the Email send timing does not conflict with the timing of the creation of any attachments to the Email applied to a customized Specification Flow.

Emails will be sent by Autopilot when as soon as all information is available for the Email to be sent.

The generation of all Documents in the Specification Flow is triggered by the Release Documents Task.

Table of Contents