Home Search

DriveWorks Pro 21
Release Documents

Send Feedback

Release Document(s)

The Release Documents task will release any or all of the required Document outputs as defined in the Stage 4: Output Rules > Documents - Files.

Document Outputs that will be released by this task include:

  • Export Form
  • Word Document (See *Word Document and Excel Workbook Documents caution below)
  • Excel Workbook (See *Word Document and Excel Workbook Documents caution below)
  • Export To Calculation Table
  • ODBC Data Export
  • Export Group Table
  • DriveWorks 3D File
  • Text Document
  • XML Document (Simple)
  • XML Document (Advanced)
  • Referenced File
  • SQL Server Data Export
  • Export Simple Table
  • Copied File (No Rules)

*Word Document and Excel Workbook Documents

Ensure Microsoft Office is installed on all DriveWorks machines that will process this Task.

Microsoft Office and DriveWorks Live running as a service through IIS

Services (IIS) do not have access to many applications, especially COM programs such as Microsoft Word and Excel.

When using DriveWorks Live and IIS please read the following articles for information on where to place this Task.

The Email Output Document type has a separate task and therefore is not processed by this task.

The Triggered Action Document is processed as a result of the trigger applied to the settings in the Document type.

An example of this in use can be seen in the Default Specification Flow. It is available on the Enter State event on both the Pending and Completed States. The task in the Default Specification Flow also incorporates a Condition that checks the Setting: Document Generation Behavior

Properties

Property NameDescription
DocumentsThe names of the Documents to release. Delimit multiple Document names with a pipe bar '|' or use a '*' to release all Documents.

This defaults to * when the Task is added.

TitleChanges the Title (not the name) of the task.

Example Data

Documents
  • Quote
  • Cutting List
  • Covering Letter

Examples

Property NameExample RuleExample ResultMeaning
Documents"Quote"QuoteThe Name of the Document to released.
Documents"*"*This will release all the Document in the Project.
Documents"Quote|Covering Letter"Quote|Covering LetterThe Names of the Documents to be released separated using a pipebar (|) delimited list. E.g the Quote and Covering Letter.

The Output results for the examples would be:

Output NameOutput Value
Released DocumentsQuote
Released DocumentsQuote|Cutting List|Covering Letter
Released DocumentsQuote|Covering Letter

Using the Task in a Specification Macro

This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.

Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.

Data Outputs

Output NameDescription
Released DocumentsThis returns a pipebar delimited list (|) of all Documents that were successfully released.

Status Outputs

This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.

The status output navigation is as follows:

Success

  • All documents specified successfully released.

Success with Warnings

  • Some documents specified successfully released, but some failed.

Failed (one of the following occurred)

  • All documents specified failed to release.
  • No documents specified.
  • General error - see Specification report for more information.