DriveWorks Pro 22

What's New Data Export

Introduction

Two new document types have been added to DriveWorks 10. These allow you to export to the following table types:

• Group Table
• Simple Table

Group Tables, new in DriveWorks 10, allow data to be stored , at Group level, that is accessible to all projects within it.

Simple Tables are project level data storage tables.

The ability to export to these tables allows new records to be inserted or existing records to be updated.

Export to Group Table

Group Tables can have new records inserted or existing records updated by creating an Export to Group Table document.

Export to Simple Table

Tables, using the Simple Table template in the Define Tables task, can have new records inserted or existing records updated by creating an Export to Simple Table document.

Create an Export to Group Table or Export to Simple Table Document

With your project open in DriveWorks Administrator go to Stage 4. Output Rules> Documents.

1. Click Add to open the Create Document wizard.
2. Select either Export to Group Table or Export to Simple Table from the Documents list and enter a name to identify the export.



3. Click Next.
4. Select the Table that the data is to be exported to, from the Table drop down field.



5. The export must include at least 1 control field. From the Fields list, in the Field Type column, select the Field that is to be the control field.
Control Fields
Control fields determine if a row is inserted, updated, or ignored.
• If the values in the control fields of a row do not match an existing row in the table then DriveWorks will insert a new row.
• If the values in the control fields of a row match an existing row in the table then DriveWorks will update the existing row.
• If any of the values in the control fields of a row are blank, then DriveWorks will ignore the row.
Common Fields

Common Fields can make it easier to export to multiple rows where certain columns always have the same value in each row.

For these columns, you may only want to build one rule, instead of a separate rule for each row. To do this, mark the column as a Common Field, and DriveWorks will automatically use the same rule for the column in all rows.

6. Click Finish.

The wizard will close and the Data Export Rows table will open in the Documents window.

Add the Rows to be Exported into the Document

With the Data Export Rows table open in the Documents window:

1. Click the Add Row button from the command bar. Row 1 will be inserted if no other rows have been added before.
2. From Row 1 click in the cell that is required to have a rule built. Click the Build Rule button from the command bar to launch the Rule Builder.
3. Build the rule in the usual way in the rule builder and click Ok when done.
4. Repeat steps 2 and 3 for all other cells that are required to be exported as a row.



5. Click OK when done.

When will the Export Happen?

As with all documents the automatic release is covered by the Release Documents task. When using the default specification flow this task is applied to the Completed state on the Enter State Event.

A manual release can be applied by having a macro button on the user form and assigning the Release Documents task to a specification macro.