Home Search

DriveWorks Pro 23
Test Mode

Send Feedback

Test Mode

Test Mode allows project rules to be analyzed within a running specification.

  1. From the Specification Explorer, in DriveWorks Administrator, start a new Specification.
  2. At any point while the Specification is running click the Test Mode button on the Command Bar.

Hosted and Child Specifications

Specifications hosted within the current specification (using the Specification Host control) can enter Test Mode.

Specifications added to a Child Specification List can also enter Test Mode.

Select the drop down on the Test mode button and select the specification to test.

Once in Test Mode, test each DriveWorks task that can be analyzed from the tab strip under the Command Bar.

DriveWorks Tasks that can be analyzed are:

Form

  1. Click the Form tab.
  2. Select any control on the form.
  3. Double click any property which contains a rule.
Values cannot be entered in the controls when in Test Mode.

When the user form property Show Task List (See User Form Properties) is set to True, the Task List will be displayed during Test Mode. Any active Form Messages will be displayed.

See Analyze Rule below, for more information.

The Navigation tab shows the current form navigation.

Constants

  1. Click the Constants tab.
  2. Double click the value of a Constant to edit.

Variables

  1. Click the Variable tab.
  2. Select a Variable from either the category tree or the variable list and click the Analyze button.

See Analyze Rule below, for more information.

Documents

  1. Click the Documents tab.
  2. Select a Document from the list.
  3. Select a tagged element from the document information list and click the Analyze button.

See Analyze Rule below, for more information.

Tables

  1. Click the Tables tab.
  2. Select a Table from the list.

    The data from the selected table is displayed on the right.

All table types as defined in Tables can be viewed here.

Group Tables cannot be viewed in Test Mode.

Calculation Tables

  1. Click the Calculation Tables tab.
  2. Select a Calculation Table from the list.

    The data from the selected table is displayed on the right.

  3. Select a cell in the Calculation Table to analyze.

See Analyze Rule below, for more information.

Model Rules

  1. Click the Model Rules tab.
  2. Select a Model from the list.
  3. Select a rule and click the Analyze button.

See Analyze Rule below, for more information.

Models List

The Models pane displays all models and drawings that are affected by the current Specification.

The resulting name is displayed for each model and drawing.

Each name will also be suffixed with the following:

  • [New] - when a new model or drawing will be created.
  • [Existing] - when the model or drawing already exists.

    Any models replaced (using the <Replace>.. function) will also show as [Existing].

    Specification Test Mode determines a component to be [Existing] when a physical file exists on disk.

    This will ocurr when:

    • A component that uses an intelligent file naming convention has previously been generated.
    • A component captured as a Replacement Model is to be swapped into an assembly (using the <Replace> function).
    • A component not created or captured by DriveWorks is to be swapped into an assembly (using the <ReplaceFile> function).

  • [Deleted] - when the model will be deleted from the resulting assembly.
  • [Suppressed] - when the model or drawing will be suppressed.

Generating Models

Any model where the file name rule equates to a new file to be created can be generated directly from Test Mode.

This will create a temporary file in a temporary location, the final file name and location will not be applied until the specification enters a state, in the specification flow, that triggers the full model generation.

  1. Locate the model to be generated in the tree view of the Model Rules tab in Specification Test Mode
  2. Right click on the file and select either:

3D Previews

  1. Click the 3D Previews tab.
  2. Select a 3D Preview control from the list on the left.

    A 3D Preview control must be either Active or Inactive to view the 3D Document being displayed.

    A 3D preview control shown under the Not Loaded heading cannot be analyzed.

    To load a 3D Preview, exit Test Mode and navigate to the form that contains the control to be loaded.

  3. A read only version of the 3D Document editor will load in the main window.

3D Preview Control List

All 3D Preview controls that exist in the running Specification are listed.

Only 3D Preview controls running in Document Mode (displaying a DriveWorks 3D Document) are supported in Test Mode.

3D Preview controls running in File Mode will display the message File Mode previews are not currently supported in this mode when selected.

3D Preview controls running in Autopilot Mode will display the message Autopilot previews are not currently supported in this mode when selected.

A 3D preview control can be in one of the following states:

  • Active - The preview has been loaded and is currently in-use in this specification
  • Inactive - The preview has been loaded during this specification but is not currently in-use (therefore a cached version of it exists that can be inspected)
  • Not Loaded - The preview has not yet been loaded during this specification (therefore it cannot be inspected)

    Selecting a Not Loaded preview will display the message The contents of this 3D preview has not yet been loaded

    .

The 3D Preview control list gives the following information for each control:

  • Name - The Name of the 3D Preview control
  • Form - The name of the form that the 3D Preview control is present on
  • Mode - Whether the 3D Preview control's 3D has been loaded in File Mode (File), a Document Mode (Document), or Autopilot Mode (Autopilot)

    See 3D Preview Box for more information.

Analyzing 3D Document Rules

When a 3D Preview is selected the 3D view shown is the server's most recent version of the 3D Document.

This means any rule updates or macro executions that alter the scene will be reflected in the 3D view.

This also means that if there is an animation in the scene, the actual animation will not be seen, but the position, rotation and scale will be updated when the animation ends.

From the Test Mode view of the 3D Document editor:

  1. Locate the element (Environment, Asset or Node), that contains the rule to be analyzed and select it in the Feature Panel.
  2. Locate the parameter in the Parameter Panel and either:
    • Double click the parameter to launch the Analyze Rule dialog.
    • Click the Analyze button from the command bar.

See Analyze Rule below, for more information.

Analyze Rule

The Analyze Rule dialog is launched by:

  • Double clicking a property, variable, cell or captured parameter from one of the Test Mode tabs.

    Some tabs (for example Constants) do not have rules applied to any values, so the Analyze Rule function will not be available.

  • Clicking the Analyze button (when available) from the command bar.

The Analyze Rule dialog displays the name of the property, variable, cell or captured parameter being analyzed in the header.

The current rule is displayed in the Rule Editor.

The current rule can be modified, while in Test Mode, and this will update in the current Test Mode session, but will not affect the current running Specification.

If the outcome of a rule modified in Test Mode is satisfactory the rule can be copied and applied to the same parameter in the Project.

This will then take effect once the Project is saved and a new Specification is started.

Below the Rule Editor are the following diagnostic tools:

  1. Values and Steps shows each step of the calculations and the value returned from those steps.

    This displays the same information as the Steps Tab in the Rule Builder.

  2. Rule Drill Down shows an in depth analysis of the rule showing the returned value of input.

    This displays the same information as the Drill Down Tab in the Rule Builder.