Professional Documents
Culture Documents
DriveWorksProEssentials V20
DriveWorksProEssentials V20
Essential Training
PRO.V20
• Create DriveWorks Pro user forms and link them to the models.
Training Prerequisites
To complete this training, you must have both DriveWorks Pro Administrator 20 and
SOLIDWORKS installed. SOLIDWORKS 2020 SP0 or higher is required.
You must also have downloaded the Training Content from the DriveWorks
Community. This can be obtained by logging into the Community using the link below
and scroll to DriveWorks Pro Learning Resources, under DriveWorks Pro Essentials
Training click the Files button to download the training files.
https://my.driveworks.co.uk/learn/
User Live
DriveWorks Live
Showcasing your entire range of product options online enables your customers to
configure their product selection, get instant quotes, accurate delivery dates, and even
place their orders with little or no required input from sales.
Making your products easy to buy, as well as easy to sell, helps you to build closer
relationships with your customers, develop brand loyalty, and positively impact the
entire sales process and the way you deliver products to market.
DriveWorks Live gives you a true global presence, helping you to reach more
customers, faster than ever before.
The DriveWorks Pro online documentation also has various topics on IIS. Google
search DriveWorks Live Install IIS to find the topic ‘How To: Install Internet Information
Services (IIS)’.
It is also able to process and run batches of Specifications where the information has
been stored in a database, txt file or web service. DriveWorks Autopilot will actively
manage SOLIDWORKS and its performance. It will automatically restart
SOLIDWORKS to ensure that Model generation speeds are as quick as they can be. If
there are any issues, DriveWorks Autopilot will restart SOLIDWORKS and roll back to
the model it had an issue with.
You can also set up your Project in DriveWorks Administrator to export data from
DriveWorks using a Document. Data can be exported to databases, txt files or XML
files.
With these two features, you can have a two-way data exchange between DriveWorks
and other programs within your organization.
DriveWorks User
With DriveWorks User, your engineers, sales teams and other non-technical users
within your business can run your Design Automation Projects, configure custom
products, and create sales and manufacturing documentation automatically using an
installed Windows application.
All design automation and sales configurator projects are setup centrally using
DriveWorks Administrator and protected from unauthorized use and modification.
It can also be used to import Projects, import Specifications, reset the Specification ID,
and more. You will learn more about DriveWorks Data Management in this Training.
If you do have access to the internet, the DriveWorks online documentation is regularly
updated to ensure its information is up to date, as useful and easy to understand as possible
and covers every new feature that is added to DriveWorks. You can access the DriveWorks
online documentation by going to docs.driveworkspro.com.
Tip:
Because our online documentation is indexed by Google, the easiest and quickest way
to find your way to an article is to search ‘DriveWorks’ followed by the topic you require
extra information about.
For example, if you are looking for information about SOLIDWORKS best practices
you could Google search DriveWorks SOLIDWORKS best practices. The top result will
be a link to the relevant article.
Concepts
This covers the concepts of DriveWorks Administrator, including best practice advice
and tips.
Concept:
Notes:
Tips:
Exercise
There is an exercise for each lesson. The exercises all work on the same models.
This training will show you how. First, let’s look at the design.
As you can imagine, based on its function, a conveyor may have to change in length,
width, height, bed type etc.
We will create a set of Forms to fill in, which will provide guidance on the selections
available. That way we know, whatever values are entered, that particular conveyor
can actually be manufactured.
Basic Setup
Create a Group to store all the data that can change from customer to customer.
Form Creation
Create Forms so that data can be entered to specify a new conveyor.
This training will result in a user interface that allows the creation of new variations of a
straight conveyor automatically.
Rules
Add Rules to drive the models and drawings from the inputs on the Form.
Documents
Rules can also be used to create new documents based on your inputs. DriveWorks
Pro document types include (but are not limited to) Microsoft Excel, Word and XML
files.
This can include creating the databases, Office Documents or SOLIDWORKS Models
that DriveWorks can create. Once created, you must capture the parameters that
DriveWorks can alter. For a Document, this will be creating Bookmarks; for a
SOLIDWORKS Model, capturing a dimension or feature; and for a database, this will
be identifying the tables and columns that can change.
Once you have decided the output files and data, you can now design the user
interface for your configurator. This will be where the user of your Project will enter the
information you need. Let your creativity flow and design something that’s intuitive to
use for your target audience and matches your brand.
Finally, you need to link the user interface (the data coming into the Project) with the
output data (the data created by DriveWorks). You do this by writing Rules. Rules can
link Controls with the captured parameters.
You can write Rules in many places throughout your DriveWorks Project. A Rule could
exist within a specific Control property to determine certain behaviour or it could be in
a Document to determine who to send an email to, as well as many more places. To
write a Rule, you will use the DriveWorks Rule Builder, this will be explained in more
detail in this manual.
SOLIDWORKS
DriveWorks Pro appears in the task pane inside SOLIDWORKS, and is used here for
capturing models, as well as displaying the forms to create new models.
The add-in inside the SOLIDWORKS task pane shows helper links where appropriate.
When you first activate the task pane, you will see a helper link telling you that you
need to open a Group. Clicking this link opens the DriveWorks Group Wizard.
DriveWorks Administrator
DriveWorks Administrator is a standalone program where you will set up your Projects,
create your Forms and build your Rules.
DriveWorks Pro uses Groups to store multiple Projects, and Projects to drive one or
more SOLIDWORKS models.
Individual Groups only allow one user to access it at any one time. These are the
easiest form of Group to use, as they require no set up. An Individual Group is a file
which is saved on your machine. It has the file extension .drivegroup
Shared Groups are used when more than one user will work on the data in the Group
at any one time. This could mean more than one person setting up the Rules (on
different Projects) or it could mean having multiple users. A Shared Group is a
database stored in an instance of Microsoft SQL.
An Individual Group can be converted to a Shared Group at any time as long as SQL
Server (or SQL Server Express) is installed and available.
Or it can be created from the DriveWorks add-in on the SOLIDWORKS Task Pane.
Tip:
Help is available for any DriveWorks topic by pressing F1 or clicking the question mark
button in the top right-hand corner of the dialog.
DriveWorks Pro uses logins with passwords to make sure that only the appropriate
people have access to the Rules and Projects. When you first create a Group, you will
be asked to create an administrator user. This can be left as the defaults (‘Admin’ with
a blank password) or set to a username and password of your choosing.
DriveWorks Pro uses helper links to guide you through the setup of your Projects. The
links will either be a way to perform an action, or a link to the DriveWorks Pro Help File
covering the relevant topic. Either way, it’s a great idea to click on the links.
Once a Group is open, a helper link appears saying that you need to capture a model.
Clicking on this link captures the model in DriveWorks, and then gives further options
for capture.
Capturing is split into different sections that appear at the bottom of the DriveWorks
Pro task pane. The required section is activated by clicking on its section header.
Captured Models
To open any captured model, click on the Captured Models section header. This will
display a tree view of all captured models in the current Project. Double clicking a
model in the tree will open it in SOLIDWORKS.
Expand the tree and double click any file to open it in SOLIDWORKS. Once the
chosen file is the active model in SOLIDWORKS, you can capture its parameters.
Shown for assemblies only, this section allows you to decide which parts and sub-
assemblies are to be driven by DriveWorks.
Captured dimensions and features are given their own name in DriveWorks Pro, to
make it easier to build Rules for them later on. Each feature can also have its
advanced properties captured, depending on the feature type.
For instance, if you choose to drive a sheet metal feature, you can capture properties
such as its K factor or Bend Table.
Captured features can also include Feature Folders, which allow you to build one Rule
to control all of the features in the Feature Folder.
You do not need to capture dimensions and features for every component.
You will then be asked to enter a DriveWorks name for the selected feature or
dimension. You can only use each name once within a single model, but you can use
the same name across different models.
At this point, you need to understand the design intent that we have applied to the
Training models. We have mostly used planes in the models and then attached the
sketch geometry to the planes. Changing the plane offset therefore changes the size
of the model.
At the end of this tutorial is a section on good practice modeling for automation, so that
you can apply it to your models.
Custom Properties
Selecting an existing Custom Property in your model enables its value to be controlled
dynamically. New Custom Properties can be added and captured at the same time.
DriveWorks Pro has special names for some Custom Properties. These allow you to
control the color, material and texture of your models and are DWColor, DWMaterial
and DWTexture respectively. These are not case sensitive, and DWColour can be
used instead of DWColor based on your spelling preference.
As well as controlling individual parts and sub-assemblies, you can control a specific
Instance of a model within your assembly.
Controlling Instances allows you to either set the suppression state or configuration of
an Instance, as well as deleting individual instances based on Rules.
Building Rules for Instances also allows you to swap out each one for a different
model.
Drawings
For each new part or assembly that you create from your masters in DriveWorks Pro,
you can have one or more Drawings associated with it. These will also then be created
based on master drawings. The Drawings section of DriveWorks Pro then allows you
to control your Drawings further. This will be covered later in the training.
Replacement Models
Rather than overloading your master models with every permutation of model that you
would ever need, DriveWorks Pro allows you to browse for replacement models that
will be swapped into the assembly based on your Rules.
File Formats
When DriveWorks Pro creates new variations of your models, you can choose to
export these files to other file formats (eDrawings, IGES, Drive3D etc.)
C:\DriveWorksPro\Conveyor
If you do not have the DriveWorksProTrainingFiles.zip file, please see page 5 for
information on where to download it.
DriveWorks Pro resides on its own tab in the SOLIDWORKS Task Pane. To open
DriveWorks Pro, enable and expand the SOLIDWORKS Task Pane, and then click on
the DriveWorks Logo.
Creating a Group
DriveWorks Pro incorporates a wizard for creating and opening Groups. At this point,
we are only interested with creating an Individual Group.
2. Click on the helper link Click here to open a Group at the top of DriveWorks Pro to
activate the wizard or select the New Group icon .
6. Browse to the location where you extracted the Training Files to store your Group
and enter the name DriveWorksTraining.
For this training, browse to the same location as the Conveyor models folder, and call
the new Group DriveWorksTraining. If you do not have these files, you can download
them from the DriveWorks Community.
7. Click Save, then Finish to create the DriveWorks Group in the chosen location.
DriveWorks uses default login information. You will be asked to login each time you
open a Group. Change this information if you wish.
When you click Finish, you will be asked to login, using the information that you
entered in the New Group Wizard.
8. Enter the username and password to allow you to logon to the Group.
If you did not change these from the defaults, the username is Admin and there is no
password.
You will now have a Group open, and a link at the top of the task pane indicating the
next step.
If you do not have any models open in SOLIDWORKS, the helper link will ask you to:
Once captured, the Task Pane will show all the options for capturing model information
in the Capture Explorer.
Another helper link will now appear at the top of DriveWorks Pro stating that No
components are captured for this assembly. If clicked, the help file will open at the
relevant page.
If a part or sub-assembly will not change (i.e. it is a standard component), it does not
need to be captured.
An example of this are the Foot Plates in this conveyor assembly. They do not need to
be driven using DriveWorks, therefore we will not capture them.
If they are captured, DriveWorks will create new files from them every time a new
conveyor assembly is generated. For a large assembly, this can drastically increase
generation time for the whole assembly.
This step determines which of the models in the main assembly are controlled by
DriveWorks Pro. Remember that it is not always necessary to capture every
component or sub assembly.
If you check a part in a sub assembly, the sub assembly will automatically be checked
as well.
This section involves selecting each captured model in turn, and then capturing each
parameter to be controlled on that model.
13. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
14. Expand the RollerFrameAssembly and then the SideRailAssembly in the Captured
Models section and double click on the SideRail in the DriveWorks Task Pane to
open it in SOLIDWORKS.
This will also automatically change the Task Pane to the Dimensions and Features
Section.
For the Side Rail, we need DriveWorks to be able to change its length. In this model,
the length is determined by a dimension in the Base-Flange1 sketch.
Tip:
If you slowly double click the text of the plane or sketch, SOLIDWORKS will prompt
you to change its name. Don’t do this. Instead, double click on the icon for the
Feature/Sketch. If you do this, you will see the dimension appear in the model window.
15. Double click Sketch1 within Base-Flange1 and click on the length dimension
that appears. The SOLIDWORKS address for this dimension will appear in the
DriveWorks Pro Task Pane.
Tip:
If you are having problems selecting the dimension, you may have Instant3D switched
on in SOLIDWORKS. This will prevent you from selecting dimensions to capture in the
model window. If this is the case, a link will appear in the DriveWorks Pro Task Pane.
Turn Instant3D off to continue.
The Dimension will be added to the Dimensions folder at the top of the DriveWorks Pro
Task Pane.
17. Click Save on the DriveWorks Pro Task pane to save your DriveWorks Data
To save your DriveWorks Pro data click on the Save button on the DriveWorks Pro
Command Bar. This will save your data, but not the SOLIDWORKS files. Click the
SOLIDWORKS Save button to save your models.
Save your data regularly to ensure that you are not at risk of losing information.
18. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
19. Expand the assembly structure in the Captured Models section and double click
the model RollerFrameBeamLeft in the DriveWorks Task Pane.
This will open the Roller Frame Beam Left model in SOLIDWORKS and, because
this is a part, it will automatically select the Dimensions and Features section.
20. Double click on Sketch6 (the sketch for the Base-Flange2 Feature) to show all its
dimensions. Highlight the Frame Length Dimension (1500mm). Use the default
name FrameLength. Click Add.
21. In the SOLIDWORKS feature tree, double click the Linear Pattern Feature
LPattern1. Select the dimension that determines the quantity of the pattern (its
value is 22). Use the default name, SlotQty and click Add.
22. Orientate the view and select the dimension that determines the spacing of the
pattern (its value is 68). Use the default name, SlotSeparation and click Add.
As this feature has been renamed, the name field in DriveWorks will be automatically
populated.
25. Ensure that this has been added to the Feature folder. This will confirm you have
captured a Feature and not a Dimension.
To capture an existing Custom Property, check them in the list. You will then be able to
create a Rule for each captured Custom Property.
28. Click Save in the DriveWorks Pro Task Pane (do this regularly after capturing
information in each part/assembly)
Concept: DWColor
29. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
30. Expand the assembly structure in the Captured Models section and double click
the model RollerFrameBeamRight in the Task Pane Tree.
This will open the model Roller Frame Beam Right in SOLIDWORKS and, because
this is a part, it will automatically select the Dimensions and Features section.
32. In the SOLIDWORKS feature tree, double click the Linear Pattern Feature
LPattern1. Select the dimension that determines the quantity of the pattern (its
value is 22). Use the default name, SlotQty and click Add.
33. Orientate the view and select the dimension that determines the spacing of the
pattern (its value is 68). Use the default name, SlotSeparation and click Add.
As this feature has been renamed, the name field in DriveWorks will be automatically
populated.
36. Ensure that this has been added to the Feature folder. This will confirm you have
captured a Feature and not a Dimension.
To capture an existing Custom Property, check them in the list. You will then be able to
create a Rule for each captured custom property.
39. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
40. Expand the assembly structure in the Captured Models section and double click
the model RollerSingleGroove in the DriveWorks Task Pane.
41. Double click on the End Plane to show its dimensions. Select the dimension that
defines the Roller Width (418mm). Use the default name RollerWidth. Click Add.
42. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
43. Expand the assembly structure in the Captured Models section and double click
the model RollerDoubleGroove in the DriveWorks Task Pane.
44. Double click on the End Plane feature to show all its dimensions. Highlight the
Roller Width Dimension (418mm). Use the default name RollerWidth. Click Add.
45. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
46. Expand the assembly structure in the Captured Models section and double click
the model RollerEndPlate in the DriveWorks Task Pane.
47. Double click the feature Base-Flange1 and select the dimension for the width
(428mm). Use the default name EndPlateWidth and click Add.
Like the Frame Beams, we will also control the color of the Roller End Plate
52. Select the Captured Models tab and open the RollerFrameAssembly.
53. Select the Dimensions and Features tab in the DriveWorks Pro Task Pane
57. Double click the Plane called Width in the SOLIDWORKS Feature Tree.
This will display a dimension of 428mm which determines the distance between the
two Frame Beams.
59. Select the Instances tab and check the check box alongside SideRailAssembly
Instance 1 and SideRailAssembly Instance 2
60. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
61. Expand the assembly structure in the Captured Models section and double click
the model LowerLeg in the DriveWorks Task Pane.
62. Double click the feature Base-Flange1 and select the dimension for the height
(496mm). Type the name LowerLegHeight and click Add.
63. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
64. Expand the assembly structure in the Captured Models section and double click
the model UpperLeg in the DriveWorks Task Pane.
65. Double click the feature Base-Flange1 and select the dimension for the height
(500mm). Type the name UpperLegHeight and click Add.
67. Expand the assembly structure in the Captured Models section and double click
the model HorizontalSupport in the DriveWorks Task Pane.
68. Double click Sketch1 and select the dimension for the width (510mm). Type the
name HSupportWidth and click Add.
69. Select the Captured Models tab and open the LegAssembly.
70. Select the Dimensions and Features tab in the DriveWorks Pro Task Pane
71. Double click the Plane called Width in the SOLIDWORKS Feature Tree.
72. Select the dimension of 528mm and type LegWidth into DriveWorks, click Add to
capture it.
73. Expand the Mates Folder and double click the mate called UpperLegOffset
76. Activate the Captured Models section by clicking on its heading within the Capture
Explorer.
To capture existing custom properties, check them in the list. You will then be able to
create a Rule for each captured Custom Property.
79. Check the check box next to Date, DrawnBy and PartNumber.
All of the models that need controlling have now been captured. The next step is
to set up a user form for new information to be entered.
80. Save your DriveWorks Group by clicking the Save button at the top of the
DriveWorks task pane. This will save your data, but not the SOLIDWORKS files.
Click the SOLIDWORKS Save button to save your models.
It has a Command Bar at the top that will show you available actions depending on the
section you are on.
DriveWorks Administrator is split into sections in the Task Explorer. The number of
sections will depend on whether you have a Group open, and if you also have a
Project open.
Concept: Projects
Projects have Forms and Rules. Each Project can have multiple Forms that are linked
together to create a navigation.
Rules are then used in each Project to translate the data entered on the Forms, into
the values used to create new models.
Once a Group is open, you can either create or open a Project. The Project Wizard will
help you with this task.
User Forms
Forms can have controls on them for entering and viewing information.
Form Designer
Form Controls are items such as Labels, Text boxes, Drop Downs (Combo boxes),
Lists, Spin Buttons etc.
Adding inputs to each Form is done by clicking on the appropriate button on the
Command Bar above the Form Designer. A Text box then appears asking for a name.
You cannot use the same name twice, and try and use meaningful names. Names
cannot have spaces in them.
Control Properties
If you select the control on the Form, the properties pane on the right will show you all
the properties that can be set for the type of control that you have selected. Some
properties are static, which means that you set them and they stay that way until you
edit them again. Some are dynamic, which means you can build a Rule for the value.
Form Navigation
You can have as many forms as you wish, controlled by a Form navigation.
Dynamic Form navigation allows you to change the navigation based on Rules.
Concept: Navigation
Navigation requires a start point. This ensures that you always have a starting point
when you start using the forms to create your new models. It also requires a finish
point, which lets DriveWorks Pro know when to show the finish button so that you can
finalize your design and documents.
Whenever you create a new Project, DriveWorks Pro creates the first Form for you,
and creates the navigation from start to finish.
The Command Bar now has buttons specific to Form navigation, including alignment
tools to help tidy up your navigation, and buttons for adding and deleting Forms and
Decisions.
A Decision is a two-way splitter that allows you to show one of two Forms based on a
Rule.
Rule Builder
DriveWorks Pro Administrator uses a Rule Builder to assist in the creation of Rules.
The Rule Builder allows easy access to other information in your Project such as
Control Values.
It also includes a Help and Diagnostic area and a function helper to ensure that your
Rules can be validated.
The Rule is entered into the Rule Editor. You can use a combination of typing,
function wizards, or double clicking on Form Values, Constants and Variable entries
from the Project Data.
The Rule Builder has diagnostic tools built into it, to help you create accurate Rules
quickly. At the bottom of the Rule Builder you will see a Help and Diagnostics area. On
this there are 4 tabs:
Values
All of the individual elements that make up the Rule are displayed here, to help you
check your Rule. Also included here is the current result of the Rule.
Steps
Here, each Rule is broken down into sub Rules, so if you are not getting the result that
you expect you can quickly see the cause.
Drill Down
The drill down tab provides the information used in the values and steps to be
analyzed, you can expand the Rule at each stage to get to the result.
Comments
Note:
Tip:
You could also click the Open Group button on the Command Bar.
3. In the Group Wizard, select the option to Open an existing group and click Next.
Tip:
If you did not change these from the defaults, the username is Admin and the
password should be left blank.
With the Group now open, the next step is to create a Project.
8. Select the option for New DriveWorks Project and click Next.
As well as creating a new blank Project in DriveWorks, you can create Projects from
Templates. These templates help you get started with DriveWorks by pre-creating
content that you are likely going to need.
By default, DriveWorks will use the folder name as the new name for the Project. You
may change this name if you would like.
11. Click Finish to create the new Project. The newly created Project will now be open
in DriveWorks Administrator.
Form Design
12. Activate the Form Design by selecting the Form Design task in the Task Explorer.
The Form is empty. You can now start adding Form Controls.
Form Controls
There are many different types of Form Controls available in DriveWorks Pro, all of
which can be seen across the top of the Form Designer on the Command Bar.
Which Controls you use in your Projects is completely up to you. Some Controls are
better suited to some inputs than others. A good example of this would be that a
Numeric Text box is better suited to a numeric input than a Text box and a Check Box
Control for this input would be completely unsuitable.
Throughout this Training Manual, you will use several different Controls, but to begin
we will create three Slider Controls that determine the Height, Width and Length of the
conveyor.
Slider
13. Click on the Slider button on the Command Bar. A Text box will appear asking for
a name for the Slider. Call it ConveyorLength.
Note:
The name that you provide when you create the control is applied to the Name
Property and the Caption Property of the control.
A control’s Name Property cannot have any spaces in it as this is what DriveWorks
uses as an ID for that control
A control’s Caption Property can have spaces and is simply the displayed name of
the control.
If the name you provide when creating the control has capitalized words, such as
ConveyorLength, then DriveWorks Pro will recognize this and add in the space in the
caption.
Static properties are shown with a grey icon. Dynamic properties have a green icon.
Fixed properties have no icon.
15. Set the following Properties by typing in the box next to the property:
Maximum = 3000
Minimum = 1000
16. Create another Slider called ConveyorWidth
17. Set the following Properties by typing in the box next to the property:
Maximum = 1000
Minimum = 400
18. Create a third and final Slider called ConveyorHeight
19. Set the following Properties by typing in the box next to the property:
Maximum = 1200
Minimum = 600
Alignment Guides control alignment snapping in the Form Designer while dragging a
control (or Group of controls). To temporarily disable the snapping hold down the Ctrl
key whilst dragging the control.
Note:
A Combo box is a drop down list where any single value can be selected. The list in
the drop down can be static or it can dynamically change based on a Rule.
To populate the list of items in the Combo box, we need to enter a value for the Items
Property in the Property Grid.
Note:
Lists in DriveWorks Pro are represented by a single string, with each separate item in
the list separated with a pipe bar (|). So, for example, if you want a list with Monday,
Tuesday and Wednesday as static values, you would need to enter
"Monday|Tuesday|Wednesday".
Even though we need static values in the Items property, we are still going to use the
Rule Builder.
Tip:
You need to click in the Items property for the button to appear.
The Rule Builder is split into numerous sections, with its own Command Bar, a Rule
Editor, Help and Diagnostics and a browser to find your Project Variables and Form
Values.
In this case, because the list in the Combo box will be static, standard text can be
typed in the Rule Editor text area.
As this is static text, make sure that you include the quote marks.
24. Click OK on the Rule Builder. The Rule will appear in the Item property in the
Property List.
Combo box
Check Box
Note:
A Check Box can either be checked or unchecked. When checked, its value is TRUE.
When unchecked, its value is FALSE. They are therefore very useful for determining
whether something is required or not.
Controls can be grouped together to reposition. Select a control then hold down Shift
or Ctrl while selecting other controls. Right click and select Group Controls to Group
them together. To ungroup, select any control within the Group, right click and select
Ungroup Controls.
29. Click the Test button on the Command Bar to test your Form.
Clicking the Test button at the top of the Form Designer allows you to see
what the Form will look like and also test it and enter values into the controls.
Your Form is now ready to drive most of the features that you have captured so far.
We can therefore move on to the Model Rules that will link your Form values to the
information that you have captured in your models.
Have a go at changing some of the static properties for each control. Also experiment
with the align tools at the top of the Form Designer, as well as moving the control
around the Form and making them bigger or smaller.
Note:
Any values you enter into your controls in test mode will become the default values for
those controls.
From this picture, it is easy to see that to calculate the quantity of Rollers you need to
consider the input value for the Conveyor Length and the Roller Spacing.
Your Form already has an input for the Conveyor Length and the Roller Spacing is a
constant value of 68.
It would be very straight forward, knowing the static value, simply to type that in, so
that the Rule would be:
And there would be nothing wrong with that, but if the standard Roller Spacing was
ever to change, there would be more work to do. You would need to find every Rule
where it was used and re-type the value. The Project wouldn't be as flexible.
It is therefore better to break the Rule down into Variables and use a named Constant
for the Roller Spacing.
It also makes it easier to track and validate your Rules if you use a name that can be
understood easily.
Note:
The word Return after ConveyorLength indicates that the value is being returned from
the control called ConveyorLength.
The next thing to account for is a buffer at either end of the conveyor to ensure that the
rollers are not flush to the edge of the Frame Beam. Therefore, instead of just using
the Conveyor Length we will subtract an offset from each end of the Conveyor Length.
We will create this additional side calculation as a DriveWorks Variable. We will do this
for two reasons: First, the Conveyor Length minus the End Gap will be used in other
locations around this Project. Secondly, the Rule for Roller Quantity will be easier to
read if there are multiple levels to the Rule, rather than every calculation at the top
level.
DWVariableRemainingLength / DWConstantRollerSpacing
Where DWVariableRemainingLength =
ConveyorLengthReturn – (2*DWConstantEndGap)
And where:
DWConstantEndGap = 41
Finally, we can use the RoundDown function in DriveWorks to round the result down to
the nearest multiple.
Concept: Functions
A function is divided into multiple sections where each one is separated by a comma.
The Round Down function below has two sections. The first is the calculation to be
rounded and the second defines the number of digits to round down to.
Constants allow the storage of static values or text that may or may not change in the
future.
Constants are added, edited and deleted using the Command Bar within the Constants
section of DriveWorks.
Variables
DriveWorks can store calculated values that you can re-use in other Rules. Each
Variable can be a calculation or Rule which can be re-used multiple times.
ConveyorLengthReturn – (2*DWConstantEndGap)
Since Projects may have a lot of Variables, DriveWorks Pro allows you to categorize
them.
Variables are added, edited and deleted using the Command Bar when on the
Variables section of DriveWorks.
Model Rules
DriveWorks Pro has a separate section on the Task Explorer for building Model Rules.
Models are captured in the Group to enable them to be used across different Projects.
Captured Models are not automatically added to the Model Rules for each Project, this
is because you can choose to drive No Models, One Top Level Model or More than
One Top Level Model.
Models are added to the Project by clicking on the Add button on the Command Bar to
display a list of all models captured in the Group.
Checking a model and clicking Add will add it to the model list for this Project and to
enable Rules to be built for it.
Checking the Top Level Assembly will add all children that have been captured.
1. Select the Define Constants task in the Task Explorer on the left.
Note:
Creating Constants is similar to creating Form Controls; a Text box will appear asking
for a name for your new Constant. DriveWorks Pro applies validation to ensure your
name is valid, to prevent the use of invalid characters or the creation of two Constants
with the same name.
Note:
Double click in the Value Column to edit the Constant Value at any point.
Variables
Note:
You can change the name of a Variable at any time by double clicking on the name in
the list. You will be asked to confirm the action. This is because, when the name is
changed, DriveWorks Pro will need to search for every Rule in your Project to see
where that Variable has been used, and then update those Rules where it is found.
13. With the new Variable selected in the Variable List, click Build on the Command
Bar to launch the Rule Builder.
You can also open the Rule Builder by either double clicking the Variable, or by
pressing Ctrl + B when the Variable is selected.
14. In the Rule Builder, ensure that you have the Controls Tab active on the right, then
double click on the Form Control ConveyorHeight in the list of controls.
Note:
DriveWorks Pro adds the word Return as a suffix for Form Controls. This tells
DriveWorks that this is a Form Control.
16. Select the Constants tab on the right and double click FrameBeamHeight
This value will be added to the Rule Editor in the location of your cursor.
18. This time, instead of double clicking the next value, try typing leg.
As you start to type in the Rule Editor, a box will appear which attempts to predict the
item you are typing. Once the item you require appears in the list, you can select it and
press the space bar to have DriveWorks complete that input.
19. LegToBeamOffset will be top of the Rules Insight dialog, ensure it is selected and
press the space bar. The DriveWorks Rule Builder will complete the input for
DWConstantLegToBeamOffset.
Tip:
You can also press the Enter key to accept your name, as long as your name is valid.
This adds your category to the tree. Categorizing Variables makes maintenance and
development of your DriveWorks Projects easier.
To add new Variables to this Category, select the Category in the tree before clicking
Add Variable.
To add existing Variables to a Category, drag them onto the Category item in the tree.
We can now set Variables for the remaining Leg Sizes, Side Rail Height as well as the
Roller size.
26. Give the Variable the name UpperLegHeight and press Enter.
27. With the UpperLegHeight row selected, click Build on the Command Bar to
launch the Rule Builder.
The UpperLegHeight Variable is going to calculate the height of the upper section of
the Conveyor Leg assembly. This value needs to be three quarters of the existing
TotalLegHeight Variable.
RoundUp((DWVariableTotalLegHeight / 4) * 3 ,0)
This Rule uses a function to round up the result of the calculation to the nearest whole
number. This is because a high degree of accuracy is not needed to manufacture this
part. The steps below will walk you through creating this rule.
28. Select the Variables tab on the right and double click TotalLegHeight
29. Type /4
We now need to multiply this value by 3. Therefore, we must first wrap the existing part
of this calculation in parentheses.
32. Type * 3
33. Highlight the entire Rule and click the Functions button on the Rule Builder
Command bar.
34. Use the filter bar at the top of the Functions Dialog to filter for the word round.
35. Double click on the function RoundUp. This will open the RoundUp Function
Wizard in the Rule Builder and populate the first item with the Rule you highlighted.
36. Type 0 in the Digits text box to ensure the function rounds up to a whole number.
The Rule Builder has diagnostic tools built in. These help you create accurate Rules
quickly. At the bottom of the Rule Builder you will see a Diagnostics area. On this there
are 4 tabs:
Values
All the individual elements that make up the Rule are displayed here, to help you
check your Rule. Also included here is the current result of the Rule.
Steps
Here, each Rule is broken down into sub Rules, so you can quickly see the cause if
you are not getting the expected result.
Drill Down
This is very powerful and allows you to drill down into the values that contribute to the
Rule, including drilling into their Rules as well.
Comments
Next we need to calculate the offset from the bottom of the Leg Assembly to the
bottom of the Upper Leg Part. The Upper Leg Part’s height was calculated in the
UpperLegHeight Variable
40. Give the Variable the name UpperLegOffset and hit Enter.
41. With the UpperLegOffset row selected, click Build on the Command Bar to launch
the Rule Builder. Build the rule shown in the image below.
Tip:
When you find you have a lot of Constants, Variables or Controls, use the filter box to
limit what is displayed.
The LowerLegHeight Variable will store a rule which calculates the height of the Lower
Leg Part contained within the Leg Assembly.
The height of this Part is equal to the TotalLegHeight Variable minus the Bracket
Height Constant value. There is also a small offset at the top and bottom of the
Bracket, this offset is the same at the top and bottom, canceling itself out so we do not
need to add it into the Variable rule.
Note:
You can change the appearance of the Rule Editor by clicking on the Settings button
on the Command Bar.
This Rule will use an IF Function.The SideRailHeight Variable will later be used to
control which SOLIDWORKS configuration the Side Rail Assemblies are saved in.
Concept: IF Function
An IF Function allows you to determine an outcome when a condition is met. You can
also determine the outcome if that condition is not met.
In this example, the condition is that the Elevated Side Rails Check Box Control equals
true, aka, it has been checked. If this condition is met, the result of the Rule must be
the value “Tall”. If the condition is not met, the result of the Rule must be “Short”. In
this case, these values are the names of the configurations in the Side Rail Assembly
that we will be switching.
For an IF function, three text boxes allow you to enter the three arguments.
Value If Condition Is True If the condition is evaluated to be TRUE, use this value
Value If Condition Is False If the condition is evaluated to be FALSE, use this value
Tip:
You can use the Project Data pane on the right of the Rule Builder to reference values
from your Project in the Wizard. Simply place the cursor in the Wizard text box and
then double click the value you require in the Rule.
Two Variables will be created which will calculate the number of rollers needed on the
Conveyor (RollerQty), as well as the separation between them (RollerSeparation).
These rules are explained at the beginning of this lesson. Here is the image again for
your reference.
Before creating any more Variables, a new Variable Category will be created to
separate them from the other Variables that have already been added.
51. Select the Sizes Category and click the Add Category button on the Command
Bar.
53. Select the new category and click Add Variable to add a new Variable.
54. Give the Variable the name RemainingLength and hit Enter.
This Variable will calculate how much space is left for the rollers after an end gap has
been removed from the total conveyor length.
55. With the RemainingLength row selected, click Build on the Command Bar to
launch the Rule Builder.
The RollerGap Constant is the minimum distance that the rollers can be separated by.
Therefore, the Remaining Length divided by this value, then rounded down, will give
us the Roller Qty.
58. With the RollerQty row selected, click Build on the Command Bar to launch the
Rule Builder.
Tip:
Follow the process previously described when using the RoundUp function. Create the
calculation first, highlight the Rule and then use the RoundDown Function Wizard to
round it down to a whole number
This Variable is the actual separation that the Rollers need to be at so that the rollers
are spaced equally across the length of the conveyor, with approximately the same
gap at either end.
61. With the RollerSeparation row selected, click Build on the Command Bar to
launch the Rule Builder.
Note:
This function is rounding to one decimal place. This is determined by the value 1 at the
end of the function.
You should now see the following Variables in your list (depending on the values you
entered when testing your Form, you may have different results in the Value column
for your Variables).
Tip:
To see all Variables, select ‘Categories’ and click ‘Show Child Variables’ from the
Command Bar
The first step though is to tell your DriveWorks Pro Project which models to control.
Note:
Captured Models are not automatically added to the Model Rules, this is because you
can choose to drive No Models, One Top Level Model or More than One Top Level
Model.
65. Check the box next to Straight Conveyor Assembly and click OK.
You will now see the Straight Conveyor Assembly added into the Component Tree.
Note:
You only need to add the top level assembly. All of its Sub-Assemblies and Parts will
be added to the tree automatically.
This will show all the captured items for all the components.
Tip:
Clicking on a model within the tree inside Model Rules will show an image of the file as
well as the captured information about the file. This can be useful if you have many
similar files in your model tree that are not named descriptively.
You will notice that some Rules have already been filled in; these are the File Name
Rule and the Relative Path Rule.
Note:
The File Name Rule determines the file name for each component when you run your
Project.
The Relative Path Rule determines the location of the new file. This can be relative to
the DriveWorks Default Specification Folder or a complete path.
The default given for these is the name of the Project, followed by an incremental
number (shown as 9999 during the design of your Project).
We will be changing these Rules later in the training, but for now we will leave them as
they are.
Each Model has a Rule for Configuration. Only create a Rule for the configuration, if
you wish to change the configuration you want to use in your model.
Dimensions
Let's create Rules for the dimensions first.
Tip: Filtering
Rather than scroll up and down looking for the dimension Rules, you can type a filter in
the filter box at the top of the Rules List.
67. Type dim in the filter box to only show Rules with dim in any of its values.
Tip:
Hold down Ctrl and click the dimensions one by one to multi-select them.
ConveyorWidthReturn -2*DWConstantFrameBeamWidth
We will re-use this Rule in other parts of our Project throughout the training. Therefore,
it would be better suited as a Variable.
Having the foresight to create Variables at the start of your Project is something that is
often unrealistic. However, with the Extract Variable functionality, you can write the
Rule directly in Model Rules and later tidy up and make it more manageable by
replacing these Rules with a variable.
Extract Variable allows you to not only move that Rule to a Variable, but DriveWorks
will also search the rest of your Project for the same Rule and replace that.
71. Right click the highlighted area and select Extract Variable
74. Click OK
This will bring up a dialog that allows you to determine exactly which Rules throughout
your Project you wish to replace with the newly created Variable. If the exact same
Rule exists anywhere in the Project, it will appear in this dialog. You can then decide
whether to replace it with the Variable or ignore it.
76. Finally, click OK in the Rule Builder to confirm the new Rule.
78. Select each one in turn and click the Build button on the Command Bar.
These Rules are very simple. This is either because we have already created
Variables, or because we are directly linking some Rules to Form Controls.
Tip:
When building multiple rules at once, if one of the Rules already has a Rule, that Rule
will be displayed in the Rule Editor.
HSupportWidth –
Again, don't worry if the Values differ from yours as these will depend on the values
you entered on your Form in Test Mode. You may want to compare the Rule column
above with the rules you have built, however. Your rules may not be in the same order
as the image above.
Custom Properties
There are 4 Custom Properties captured.
Date
DrawnBy
PartNumber
DWColor (a special name that DriveWorks uses to control the color of the model)
79. Change the filter in Model Rules to be Cust to quickly show the Rules for the six
Custom Properties that we captured.
You are going to be driving the Date custom property to be the date on which the files
are created by DriveWorks. You will do this using the Today() function. The date
returned from the Date function will then be formatted using the Text Function.
81. In the Rule Builder, click on the Functions button on the Command Bar.
82. In the filter box on the Function dialog, type TODAY to filter the list to find this
function quickly. Double click on the single entry in the list.
Note
The result at the bottom in the Diagnostics pane shows you the result of this function.
Another Function can now be used to change the format of the date.
84. Click the Function Button again on the Command Bar and this time filter on the
word Text.
Tip:
All columns will be searched. If you wish to search in one particular column then you
can specify the name of that column (i.e. name:Text). Column names that contain
spaces to separate words should be enclosed within quotes to filter by that column;
"Column Name":Criteria
Note:
Since this is static text, make sure you use the quote marks at the start and end of the
text.
90. Type the word DriveWorks in quotations and the click OK.
The Rule for the Conveyor Part Number will be a text string built up from the three
major dimensions, the Side Rails and the Color. It will include static text and dynamic
values.
The following Rule for the Part Number Custom property will be built by concatenating
dynamic properties such as Form Controls and Variables with Static text. This is
achieved using the syntax shown below:
Note:
Rules can span more than one line. The Rule builder will wrap the text for you as you
type.
The result will be shown in the Diagnostics Pane, along with a list of the Dynamic
properties and their individual results.
The Left function gets a specified number of digits (3 in this case) from the left hand
side of a string.
So far, there are only 2 colors in the list, so an IF statement will allow us to build a Rule
for the Model Color based on either selection.
DriveWorks Pro recognizes the custom property DWColor (and DWColour) and uses
its value to drive the color of the model. The calculated value of the Rule needs to be
in the format "255|126|126" where the numbers represent the RGB (Red, Green, Blue)
color.
Red "255|0|0"
Blue "0|0|255"
94. Use the If Function mini wizard to build the following Rule.
In other words, if the Color selected in the drop down is red, then use "255|0|0" for the
custom property, otherwise use "0|0|255", which is the RGB value for blue.
You should now be ready to create some new models based on your Form and Rules.
There are two ways to create new models in DriveWorks Pro. You can fill out the Form
in DriveWorks Administrator or fill out your Form from inside SOLIDWORKS.
DriveWorks Administrator
To fill out your forms in DriveWorks Administrator, select the Specification Explorer
Task on the Task Explorer and click New on the Command Bar.
Select a Project from the list and click OK to run your Project.
Once the forms are loaded, a set of buttons appear at the bottom of the forms.
Cancel
Save
When the Specification reaches the last Form, two further buttons become active.
Finish
This will finish your Specification and add it to a Pending Queue. From here it can be
re-edited or released.
Once you have captured other documents to be driven (i.e. Excel and Word) these will
also be generated at this point.
Release
This will drive captured documents as well as calculate the model data for your new
models based on your Rules, adding the models to be generated to a queue.
Once a Specification has been released, the Models can be generated from the
Command Bar on the DriveWorks Pro Task Pane inside SOLIDWORKS.
You can fill out your Form many times (or have multiple people filling out Forms) and in
many places and then select to generate them all in one session.
The Specification Explorer shows a list of all Specifications, and the date it was
created as well as its current state (i.e. Saved, Pending, Completed).
When filling out your Forms in the Task Pane, you can preview your models in
SOLIDWORKS at any time.
In this mode, models can be previewed, the forms changed, and then previewed
again.
Clicking Finish will create the documents (if captured) and add the Specification to the
Specification Explorer List back in DriveWorks Administrator.
Clicking Release in the SOLIDWORKS Task Pane will finalize the models and create
any Drawings that have been captured.
This will start a new Specification and allow you to fill in your Form.
Note:
If you had multiple Projects in your Group, a dialog would appear allowing you to
select which Project you wanted to run. This is the same dialogue as shown on page
118.
4. Select the new Specification in the list and double click on the Specification Report
in the Reports list on the middle right.
Every time DriveWorks Pro processes a Specification it creates a report. These reports
will document each part of the process and are a valuable resource when
implementing DriveWorks and validating your process.
5. Switch to SOLIDWORKS (or open it if it is not already open) and close any open
models.
7. Click the Generate Models button on the DriveWorks Pro tab in the
SOLIDWORKS Task Pane.
If no models appear in the list, it is probably because the Specification has not been
released, in which case go back to the Specification Explorer in DriveWorks
Administrator and select the Specification before clicking Release from the Command
Bar.
Note:
The Models will now be generated one at a time, starting at the lowest level of the
assembly and working upwards.
We have not yet written the Rules to control the Side Rails. These will be in your
Assembly no matter what selections you have made on the Form.
Once DriveWorks has finished generating models, you will be presented with a list of
model generation reports. These show you each stage of the model generation for
each Part and Assembly.
They differ from the Specification Report because it details exactly what was
successful and what was not successful when passing the calculated values to
SOLIDWORKS.
Double clicking on a component in the list will show the values that were used to
generate it. The reports also show any errors that occur (for instance if you try driving
a dimension to a text value rather than a number, these will be shown in the report).
Click Close and then close the DriveWorks Model Generation dialog.
Your Form will appear on the Task Pane Tab, and the buttons on the Command Bar
will change to be appropriate for Specification.
Note:
When filling out your forms in the Task Pane, you can preview your models in
SOLIDWORKS at any time.
12. Click the Preview button on the DriveWorks Pro Command Bar to see your models
being created based on the inputs and the Rules that you created.
A copy of the top level assembly will now open in SOLIDWORKS, and all of the files
will have been given temporary file names.
13. Change the values in your Form and click Preview again to see the updated
model.
Note:
Once the models have been opened initially, the preview will work on the opened file.
14. Click Release to update all of the files with the correct names, and to save them
into the correct folder. At this point it will also create any drawings that have been
captured.
Note:
The files that DriveWorks Pro creates during the previews have temporary file names
and are stored in a temporary folder. Even if you save them, they will be deleted after
you click finish on your Form, as they will already have been saved to the final location
at that point
Before releasing your models for generation, you can use Test Mode to evaluate what
each Rule is resulting in.
Test Mode is split into multiple tabs to allow you to investigate different sections of
your Project one area at a time.
By selecting any component that has been marked for Generation, you can click the
Generate (Queued using Model Insight) button to enter Model Insight. This will allow
you to pause and inspect your Model Generation at any point throughout the process.
Model Insight is a fantastic way to really understand the procedure, step by step, that
DriveWorks takes to automate your Model.
19. Click Generate (Queued using Model Insight) on the Command Bar.
Other options include selecting a specific point to pause the Model Generation,
Continuing on Failure, Skip Drawings, Rebuild a Model when the Generation is paused
and automatically rebuild when the generation is paused.
20. Add a break point to the 11th Line of the Model Generation by clicking in the grey
column on the left of the row.
Watch how SOLIDWORKS will open and begin driving the Roller Frame Beam Left
Part. Also, notice in the Model Insight dialog how it is stepping through each action,
indicating whether it was a success and how long the action took to complete.
The generation will continue on to the Roller Frame Beam Right, then open the Roller
Single Groove part and eventually stop at the line which states ‘Create generation
context’.
This will process just a single action. Continuing to click Step Into will continue to move
the generation on, one line at a time.
Note:
If you are watching SOLIDWORKS whilst stepping through the generation, you will
notice that not much is changing for numerous lines of generation. This is because the
Model will not update until it has been rebuilt.
If you want to see what the model looks like right away, use the Rebuild Model button.
• Use both rules to create Project specific and intelligent file naming.
These Rules can be changed at any time to give more flexibility in the filename and
location of all generated models and drawings.
The default name for both uses the Project name and a unique sequential number,
which is created for each Specification. This value is appended to the end of the
original file name for each model generated.
This combination of the Project name and sequential number is stored in a special
Variable called DWSpecification.
Note also that because DWSpecification is a Variable it does not need quotes around
it whereas "Suppress" is static text, and therefore does need the quotes.
File Name
This is used to build a Rule for the file name of the new model.
DriveWorks appends the result of the Rule for File Name on to the original filename
with a space in between. So if your captured model is called Block and you have a
File Name Rule that results in a value of 123, then the new file will be called:
Block 123
Relative Path
This is used to build a Rule for the location that the new model will be saved to.
The Relative Path is a file path that will be added onto the Default Specification
Folder, which can be changed in the Settings. So if your Default Specification
Folder is set to be C:\DriveWorks\Projects\Results and your Relative Path Rule
results in a value of Acme\123 then the new file will be placed in a folder called:
C:\DriveWorks\Projects\Results\Acme\123\
Alternatively, you can build a Rule to an absolute path (Local, Mapped Drive or UNC)
and the new model will be placed in that folder.
This Property will not create new configurations in Parts and Assemblies. However,
DriveWorks can switch the used configuration based on this Rule, if the Part or
Assembly has more than one configuration. If you do not want to select a configuration
to use based on a Rule, you can leave this Rule blank.
If you require DriveWorks to create a new configuration, you can use a Generation
Task to do this.
Instance
An Instance Rule can be used to drive an instance of a component in an Assembly in
various different ways. They are often used when a part does not need to be captured
and driven (a standard Part such as the Side Rail Mounts in the Roller Frame
Assembly) but does need to be suppressed or have its configuration changed.
To see more examples of what can be driven using Instance rules, please see the
DriveWorks Help File.
We are going to use this order number to name files, so we need to make sure that
whatever is entered into the Text Box is valid for a file name. The first validation is to
make sure that something has been entered, i.e. the Order Number Control is not
blank.
We do this by building a Form Message using the Error Result dynamic property.
All controls have an Error Result Property. If a rule is built for this Property which
results in anything but a blank string (“”) a message will be displayed beneath your
Form when running a Specification. This is what is known as a Form Message. If you
are on a Form which has Form Messages, you cannot progress until all Form
Messages are removed (i.e. all Error Result rules are resulting in “”).
The Rule for the Error Result will either need to evaluate to be a meaningful error
message, in which case that text string is used as the Form Message, or it will need to
evaluate to be an empty text string which would mean that the entry is valid.
4. Click in the Error Result property for the Text box on the Property List.
5. Click on the button that appears, which will launch the Rule Builder.
This If statement means that if nothing is entered in the OrderNumber Text box, the
Form Message "Please enter an Order Number" will be shown when running your
forms. However, if there is a value, then no warning message will be shown (this is
represented by the blank string “”).
Because we are going to be using the Order Number return value in our File Name
rules, we can further enhance the Error result rule by adding the function
IsValidFileName, which will make sure that valid characters are entered for a file
name.
If the Order Number results in an invalid file name, we need to show a warning that
states ‘Illegal characters used in the Order Number’.
Because there are now three potential outcomes to this If statement, we need to nest
an additional If into our Rule.
8. For the second If statement we will type the Rule, instead of using the Function
Wizard
Note:
Nested If functions are created by placing a completed If function, with its three
arguments, inside either or both of the last two arguments of an existing IF function.
11. Click the Function button on the Rule Builder Command Bar to find the
ISVALIDFILENAME function
12. Enter OrderNumberReturn into the Function Wizard and click Finish
14. Type “Illegal characters used in the order number” followed by a comma
The above Rule has had carriage returns and spaces added to make it clearer to read.
While this is not necessary, it does help with readability if you need to re-visit the Rule
later.
You can create a nested IF statement by either typing it into the Rule Editor directly, or
by placing the cursor in the Rule Editor where you would like to insert the second IF
statement and using the IF function Wizard again. The resultant IF statement will be
placed at the location of the cursor in the Rule Editor.
Now, we can change our Project so that the files created are based on the order
number.
19. Click Select All on the Command Bar to select all models and their rules.
Tip:
To multi-select, click to select the first item you require, then Shift click the last Item.
Using Ctrl click allows you to toggle individual selections without losing the existing
selections.
For now, we are going to append the value typed in the OrderNumber field on our
Form, onto the end of the original file name.
So if we type QT123 into the OrderNumber field, the new version of this assembly will
be called:
StraightConveyorAssembly QT123
Note - DriveWorks automatically adds the space between the original file name and
the new suffix.
23. Click the Clear button on the Rule Builder Command Bar to clear the Rule Editor.
This will add a dash between the order number value and the next value of the Rule.
26. Click the arrow below the Quick Text button on the Command Bar and hover over
Special Variables.
These variables exist automatically in every DriveWorks Project; they allow you to
access certain data from your Project that would not otherwise be accessible. In many
cases throughout your use of DriveWorks you will find yourself using Special Variables
to complete your Rule(s).
With the Order Number being used this way, and assuming an OrderNumber of
QT543 is filled out in the Form and the Specification ID is 10, the following assembly
structure would be produced:
There are however, further things we could do at this stage with File Naming. We
could decide not to use the original file name in our new file name, or we could use a
different Rule so that the new file name includes the parameters that drive it..
Let’s create a file name that does not use the original name.
29. Select the StraightConveyorAssembly file name Rule in the list of Rules, with
nothing else selected.
Note:
Having the asterisk ("*") at the start of a file name Rule tells DriveWorks Pro to exclude
the original name when it calculates the new file name.
You can also add an asterisk at the end of the Rule, in addition to the start. This allows
you to prefix the Rule result before the original file name.
Going back to the original example, we would now get the following results based on
entering the order number QT543:
We can now take this one stage further by building up a text string for the new name
for the component Roller End Plate. We are going to base this name on the
parameters that drive the Roller End Plate. This is called Intelligent File Naming.
DriveWorks Pro will use existing files and create them if they do not exist. With this
knowledge, having the conveyor width and color in the file name means that if
DriveWorks Pro calculates that it has a requirement for the same file, it will not be
recreated.
35. Click on Clear and then build up a new Rule using the Conveyor Width control
value and the Frame Color control value with a dash between.
We will also change the Relative Path Rule for the Roller End Plate to place its files
in a folder called Models\Standards. These folders will be created by DriveWorks in
the Specifications folder when a specification is run.
This means that any models created from the Roller End Plate do not go in a
Specification specific folder enabling them to be used across Specifications as newly
created "Standard" files.
36. Change the filter in Model Rules from file name to type:relative
37. Select only the Rule for the Relative Path of the Roller End Plate.
"Models\Standards"
The folder structure inside a Relative Path Rule is created using the \ separator.
However, you should not have a \ at the start or end of the Relative Path Rule.
We will now change the Relative Path Rules for all other Models.
For these Models, we would like them to go in a Models folder, but not within the
Standards folder. Within the Models folder we will separate each set of Models into a
Specification specific folder.
41. Multi-select all Relative Path Rules, excluding the Roller End Plate, and click Build
Part of the functionality of this Project is that the Side Rails can be controlled in terms
of their height and whether they are included in the Assembly or not.
To do this we will build a Rule that determines the configuration of the Side Rail
Assembly and whether each individual instance is suppressed or unsuppressed. We
must also Suppress or Unsuppress the Side Rail Mount features that were captured in
Lesson 1.
44. Double click the Side Rail Mounts Feature for RollerFrameBeamRight
This If statement must say, if the side rails control equals Left or it equals None, then
the feature must be Suppressed. If the side rails control equals anything else, it must
be Unsuppressed.
46. Write the following into the three Text boxes of the If wizard:
Quick Text provides a ‘clipboard’ which can be used to save bits of rules that you
commonly use. Quick text is saved on your machine so that you can use it across
projects to simplify writing similar rules.
Quick Text also provides access to Special Variables by clicking the drop down at the
bottom.
This Rule will be used elsewhere in this Project, so we will extract it to a Variable
47. Highlight the entire Rule, right click and select Extract Variable
49. Double click the Side Rail Mounts Feature for RollerFrameBeamLeft
This If statement must say, if the side rails control equals Right or it equals None, then
the feature must be Suppressed. If the side rails control equals anything else, it must
be Unsuppressed.
51. Write the following into the three Text boxes of the If wizard:
52. Highlight the entire Rule, right click and select Extract Variable
Note:
We must now tell the Instance what configuration to use. The configuration command
must be separated from the suppression command using a Pipe Bar “|”
63. Click on the save button on the DriveWorks Pro Command Bar and run a new
Specification either in the Specification Explorer in DriveWorks Administrator, or
using the Task Pane inside SOLIDWORKS. When you click Release, note the file
names, their saved locations and the Side Rails.
DriveWorks Pro has the ability to either import external tabular data, or to link to it
dynamically. This data could come from Microsoft Excel, txt files or an external
database such as Microsoft Access, Microsoft SQL or other third party applications like
ERP or CRM.
If the data is coming from Microsoft Excel or txt files, then it is imported into
DriveWorks (linking it dynamically would affect performance and your user’s
experience). Database data can either be imported, or dynamically linked.
Databases are accessed via an ODBC connection. Most databases have ODBC
drivers that can normally be downloaded free from the internet.
Using data from external databases does require knowledge of its data structure, as
well as knowing any usernames and passwords required to access the data.
This section will take you through a few different options for importing or linking to
external data.
DriveWorks Pro has a wizard for configuring your external data, which then gives five
options.
Each table requires a name. This name is important when using each table in Rules.
Each table should have a meaningful name.
This option shows a data table, into which data can either be directly typed, or copied
and pasted from tabular data in txt files or spreadsheets.
When copying and pasting data, copy to the clipboard from your chosen application,
then select the top left most cell in the DriveWorks data table before clicking the
Paste button on the Command Bar.
This option gives the ability to browse for an external spreadsheet. Once browsed
for, another option is enabled to select the sheet that the data is on.
The reason for this will become obvious when we start to reference this table in our
Rules.
The headers are essential when building Rules based on this data.
This option gives the ability to import data from an external data source.
This option gives the ability to import data directly from a SQL Server database
without requiring an ODBC connection.
Group Tables
Group Tables provide access to tabular data relevant to all Projects within a Group.
The data held in a Group Table can be accessed through all the relevant table
functions in a Rule. For instance, DWVLookup, HLookup, ListAll etc.
A Rollup Data Table is used to retrieve data from any Child Specification Lists within
your Project.
Calculation Table
Calculation Tables allow real time calculations, in tabular Form, to be carried out
during a Specification. Data from Form Controls can be used in the table and results
can be returned to other Form Controls.
Simple Table
1. Open up DriveWorks Administrator and select the Define Tables task in the Task
Explorer.
2. Click the Add button on the Command Bar to add a new Table to your Project.
4. Assign a name for the table. Call it Colors and click Finish.
5. Open up the spreadsheet called Colors.xlsx in Excel (found in the Content folder
within the training files) and copy all of the data from Sheet1 onto the clipboard.
The table can now be used to populate the color drop down with all of the values in the
table.
10. Use the Clear button on the Rule Builder Command Bar to clear the current Rule.
11. In the Rule Builder, click on the arrow below the Functions Button on the
Command Bar. Select ListAll.
The Function Wizard will be shown at the bottom of the Rule Builder with two drop
downs. The first is a list of all the tables you have in your Project, at this stage only
one, once you have made a selection in the first drop down, the second will have the
column headers of that table.
This tells the function that you want to list all the values in the column with the header
Color, from the Color Table.
Tip:
14. Click Finish. DriveWorks Pro will build the Rule for you as shown below.
Note:
The actual arguments passed into the function are the name of the table, with a
DWLookup prefix to help DriveWorks Pro identify it as a table, and a number, which is
the column number in the table (the Color column is the 1st column in the table).
The result is the same format as the static value that we had before with the pipe bar
(|) as a separator.
16. Click OK to apply the Rule and close the Rule Builder.
17. Click on Test Mode in the Form Designer and click your Frame Color Combo Box
to see all the new colors that have been added using the ListAll() Function.
19. Click Select All on the Command Bar and filter for DWColor
20. Multi-select all three properties and click Build on the Command Bar.
Tip
The Rule builder can also be activated by double clicking on any item in the model list,
or single clicking and pressing Ctrl + B.
Rather than directly typing the RGB value for each color, it is easier to perform a
lookup into our table and find the corresponding RGB Value for the color selected in
the Combo box.
21. Click the Clear button on the Rule Builder Command Bar to clear the current Rule.
Lookup This will be the value from the Form that is used for the search
Match Type True if a nearest match is required, False if an exact match is required
Setting this to True is useful if you have numbers in your first column
Note – The VLookup function always uses the first column as the lookup column.
22. Click VLookup to activate the Function Wizard for the VLookup function.
23. Click in the Lookup text box to give it the focus. Use the Controls List on the right
and double click on the Control Name FrameColor. As usual, this will add the
control name with the Return suffix.
24. In the first combo box, select the table we want to find the value in. At this point,
you will only have one in there. Select Colors.
25. In the second combo box, select the column header that the result will come from.
Select RGB Value.
Nearest match would be used if you had a sequence of numbers, say 1, 2, 3 and 4,
and the value you had to search on was for instance 2.4 in which case the nearest
match is 2.
Selecting Exact Match will then add False to the function for this argument, whereas
selecting Nearest Match will use True.
Using this Rule, the value for RGB will be looked up in the table based on the color
selected on the Form.
Rules can then be applied to dynamically control the navigation between forms.
Using Form Navigation, the order Forms presented can be set and the decision to
display a Form can be controlled dynamically using rules. The advantage of this is that
Forms can be less cluttered, and not presented to users when they are not required.
Forms Navigation is made up of four types of Node: Forms, Decisions, Start Nodes
and Finish Nodes.
A Project can have as many Forms and Decisions as required, but must always begin
with the Start Node, and end at the Finish Node.
Each Form in a Project appears in the Form Navigation as a separate Node and
Decisions are added to dynamically guide a user to the required Forms.
Form Navigation is achieved by dragging the connection points from one Form or
Decision to another. The connection points are the colored circles that appear on each
Form Navigation Node. For a connected Node, they appear near the entry point to the
next Form or decision for an already connected item.
Decisions have green and red connection points. A Rule is built for each Decision that
must evaluate to True or False. When a Decision Rule evaluates to True, a user will
follow the green connection. When a Decision Rule evaluates to False, the red
connection will be followed.
Form Templates allow you to quickly create great looking forms from a template.
Templates can create Forms with Controls that are linked to Constants, Variables,
Specification Macros and many more.
There are two main types of Form Templates, Single Form and Multi Form (although
there are multiple variations of the Multi Form Template).
The main functional difference between the Multi Form and the Single Form is that the
Multi Form templates make use of Frame Controls to position and fill content on the
Main Form. The controls created are distributed across multiple forms which makes
them easier to manage. The Single Form Template has all of the controls on one
single form.
All templates that come shipped with DriveWorks are responsive in their height and
their width. This means that the content on the forms will resize based on the available
area.
The image below shows a ‘before and after’ of what your forms will look like at the end of
this lesson.
Forms can be enhanced by changing the static properties for each Form Control,
building Rules for the dynamic properties for each Form Control, or by adding different
types of Form Controls.
Each control has its own static property types. Some Control Properties are common
to all controls.
All Controls have size and positional properties. These allow you to position and size
the Form Controls accurately. They also give the ability to set the caption width on
controls that incorporate their own captions.
Static properties are set at the time of designing your Form. They can be made
dynamic by double clicking on the grey orb icon. Fonts and text color can also be
changed to enhance the usability and appearance of your forms.
Labels are a useful addition to a Form, they not only enhance usability, but can also be
used to give text-based feedback to the users.
Dynamic properties can each have a Rule built for them, so that the value can change
depending on other control values.
Using the Visible and Enabled states and controlling them based on other user
selections ensures that users only need to fill in required data.
Dynamic properties also allow Rules to be used for Minimum and Maximum values of
a Numeric Text Box.
Depending upon the width of your screen and the size of the Administrator dialog,
these controls are available from the overflow button on the Command Bar while in
Form Design.
Using Dialog Buttons on your Form allows single forms to be launched as a dialog
Form, rather than as part of the Form navigation sequence.
This then gives the option to display a Form and then return directly to the Form the
button is on.
Using this property, you can build a Rule for the name of the dialog Form that is to be
launched when the button is clicked.
Frame Control
The Frame Control allows a Form to be displayed within another Form. This control is
great for having a clutter free single Form layout.
In the example below the Project is designed to have a flow dictated by the selection
on the left hand side. Depending on what is selected, different controls are displayed in
the main section. To do this without a Frame Control would require many Rules
controlling their visibility. In addition to this, every control would be stacked on top of
each other, making the Form design process difficult.
To resolve this, Frame Controls are used to display information on other forms. One
Form Control can have a dynamic result as to what Form is displayed in the frame,
making the design process much easier and easier to maintain.
The upload control displays a button on the user Form that will launch a browser to
locate and upload a file.
The file can be uploaded to any directory, specified in the Default File Name Property.
Limits to what file can be uploaded (jpg, png, sldasm, etc.) and the maximum size of
that file can also be controlled.
As with other buttons in DriveWorks, pictures can be applied to the Upload Control.
The Web Frame control provides a frame that allows external web content (.pdf files
and static web pages) to be rendered into a user Form. When the DriveWorks Form
refreshes, the web browser may reload the web page.
Item List
Item Lists allow you to link a list to a Form. Extended lists can then be created where
each column refers to a control on a Form. In this way, the same Form can be filled out
many times in each Project. Each time it is filled in, a row is added to a list, which can
then be referenced in the same way as a table when building Rules.
Any one Item List can be linked to more than one Form. If this is the case, the column
headers in the list itself need to be common for each Form.
2. Click the arrow below Add Form and choose Add from template
When creating new Forms using a Form Template, a Form Name will need to be
defined. When a Multi Form Template is added, the new Forms that are created will be
named with the entered name suffixed Forms location. For example, the header Form
that will be created by the template will be named ‘<FormName> Header’.
4. Type the name Main into the Text box at the bottom of the dialog and click OK
This will have created seven forms, as well as some additional Constants and
Variables
5. Remove the Details Form from the Form Navigation by clicking the circles
alongside the Form navigation arrows.
Note:
The Details Form includes all the existing Form Controls that you have created. Not
deleting the Details Form will allow these Form Controls to be copied to the new Forms
created using the Template.
Now we will add the Main Form, that was created by the template, into the navigation
Note:
The Main Form is the only Form that needs to be added to the Form Navigation. It is
made up of several Frame Controls which display the other new Forms.
Now you have finished creating all the new Forms and adjusting the Form Navigations,
you need to make some changes to the Form Design.
You can quickly move to the Form Designer from the Form Navigation tab by double
clicking on one of the Forms.
Take a moment to navigate from one form to another using the Form Lists on the right
hand side above the Properties section. Take note of what Controls are located on
each Form and how they all look when shown together using Frame Controls on the
Main Form.
Many of the Forms are very simple and have just a few controls on them. However,
they form the basis to what your Form Design will look like by the end of this lesson.
The controls that have been created may not be relevant for our needs; however, they
contain Rules that can be used in the new controls that we create, saving valuable
time.
Main Form
10. On the Main Form select the first tab called Select1 and edit the Text Property
Instead of the tabs saying Select 1, Select 2 and Select 3, we are going to edit the text
to say Sizes, Options and Pricing.
When the tabs get too small, these words will not fit. Therefore, an If statement is used
to provide an alternative if the tab goes below 85 pixels wide.
13. Remove the rest of the Rule. You will be left with the following Rule:
Note:
14. Next, select the second tab called Select2. Edit the Text Property.
16. Now edit the third tab. Build a rule for its Text Property, creating a rule similar to
the 2 previous rules, but using 3 and Pricing.
You will now have three tabs that say Sizes, Options and Pricing.
There is currently a Picture Box and a Label on this form. These controls resize based
on the width of the Form. We will therefore continue to use these controls and simply
change their values.
20. Click the Picture Button on the Command Bar of the Rule Builder
21. Browse for and open the DriveWorksLogo.png image that came in the Training
files Content Folder.
This will place a file path into the Rule Builder. This file path is relative to the location
of the DriveWorks Project file.
22. Select the HeaderRightLabel control and edit its Text Property
Again, there is a Picture Box and a Label on this form. These controls resize based on
the width and the height of the Form. We have a use for the Picture Box, but we shall
delete the label.
26. Select the Picture Box Control and build the Rule for its File Name property.
28. Click the Picture Button on the Command Bar of the Rule Builder
29. Browse for and open the Conveyor.png image that came in the Training files
Content Folder.
The picture currently only takes up a portion of the full area. We will quickly change the
Rules so that it spans the full width and height of the Frame Control it is being
displayed in.
Note:
For more information on Frame Controls read the introduction to this lesson.
RightFrame.Height - 20
Note:
The above Rule is referencing the result of the Height Property for the Right Frame
control on the Main Form. As the height of that frame control changes, so will the result
of this Rule. This is another example of a Hierarchical Property.
34. Build a Rule for the Width Property of the Picture Box Control
36. After each change, go back to the Main Form. Click Test to view the changes.
We will now move the controls from the Details form onto the forms that are being
displayed below the tabs.
38. Select the Label Control and Edit the Width Property Rule.
41. Press Ctrl and A or box select all of the controls on this Form.
As was explained in the introduction to this lesson, Form Control Properties are either
Static or Dynamic. However, this can be changed for each control.
A static property is a single value that does not change. It is represented by a grey dot.
A static property can be changed to a dynamic property by double clicking the grey
dot.
44. Paste the Rule from your clipboard into the Rule Editor, change -10 to -20, and
Click OK
The Width of all of the selected controls will now be the correct width for the Frame
Control where they will be displayed.
45. Multi-select the Order Number, Conveyor Length, Conveyor Width and
Conveyor Height.
46. Cut and Paste them from the Details form to the Main Left 1 form.
47. Change the Left Property for all of these controls to be 10.
We will now change the appearance of the Slider Controls so that they have a custom
image for the slider thumb image.
50. Select the Thumb Image Property and build a Rule for this Property.
Sliders can be customized in terms of the slider image and the color of the track. Doing
this can take you away from a standard Windows style slider, to something that ties in
with your brand and the design of your configurator.
51. Click the Picture Button on the Command Bar of the Rule Builder and browse for
the Slider-Grey.png image in the Content folder.
53. You can also change the Track Color if you would like.
55. Select the three remaining controls (Frame Color, Side Rails and Elevated Side
Rails).
Instead of these two controls looking like Option Buttons, we will change the
appearance of the control so that they are clickable images. There are various
Properties we must change to do this.
Picture – The image file to show when the Option Button is not selected.
Picture (Selected) – The image file to show when the Option Button is selected.
Picture Style – Determines whether just a picture, text and a picture, or just text is
shown.
Show Option – Determines whether the default Option Button indicator is shown.
Picture Size Mode – Controls how the image is shown in the Option Button Control
61. Select the Picture Property and click the Rule Builder button.
62. Browse for the image called RollerBed.png. This is within the BedType folder in
the content folder that was shipped with the training material.
65. Browse for the image called RollerBedSelected.png. This is in the BedType folder
within the content folder that was shipped with the training material.
You should now have something that looks like the image below. You now need to set
the Picture properties for the BeltBed Control.
66. Select the BeltBed Control and set the Picture and Picture (Selected) properties
using the BeltBed.png and BeltBedSelected.png files.
Now we must change some of the other properties of the controls so that the images
display how we want them.
71. Resize the controls so they look something like the image below:
73. Change the appearance properties of the Elevated Side Rails Check Box so that it
also represents a clickable image. The images you require are in the same Content
Folder. Hint: When the Check Box is checked, the Side Rail are Elevated.
74. Create a Label Control called BedType like in the image above.
75. Finally, write a Rule for the Elevated Side Rails Check box so that it is only visible
when required. You will need to write a Rule for the Visible Property. The result of
the Rule should be False if “None” is selected in the Side Rails Combo box. The
result should be True if anything else is selected. Hint: In the Visible Property,
TRUE means the Control will be visible, FALSE will hide the Control
76. Test out you Form to see the effects your changes have made.
77. Go to the Main Footer form and expand its node in the tree so you can view what
Controls are on it.
78. Select the Footer Right Label. Change the Text Property so that it says "Price = "
Note:
This label will be edited in Lesson 10 when a price is determined for the product.
For the left label, we will display the Part Number as it is being created. As we have
already created a Rule for the Part Number we will repurpose it for this label. This
requires extracting a variable from the Rule created in Lesson 3.
79. Go to Model Rules and remove any filters that have been previously applied. Click
Deselect All from the Command Bar.
80. Check the check box next to Straight Conveyor Assembly, ensure that all other
models are unchecked.
81. Launch the Rule Builder for the PartNumber Custom Property.
82. Highlight the entire Rule, then right click and select Extract Variable.
83. Name the Variable PartNumber and click OK to confirm the Rule.
85. Edit the Footer Left Label. Launch the Rule Builder for the Text Property.
86. In the Rule Builder, select the Variables tab on the right-hand side and double click
the Part Number Variable.
87. Right click the Variable in the Rule Editor and select Edit Variable
In addition to the Rule that already exists we are going to use the LEFT() function to
return the first 4 letters of the selection made on the BedType Option Buttons.
Therefore, the returned value will be either Roll or Belt.
91. In the wizard, place your cursor in the Value Text box.
92. Go to the Controls tab and double click the BeltBed Control. This will add
BeltBedReturn to the Value Text box.
Note:
The RollerBed and BeltBed Option Button return value will be either RollerBed or
BeltBed depending on which one is selected. You could have used RollerBedReturn in
this rule and achieved the same result.
94. Click Finish. OK both the Variable Rule and the Rule for the Text Property.
This form will be edited in more detail in Lesson 10 when we configure the pricing for
the conveyor. For now, we will just delete the label that currently exists on this form.
95. Go to the Main Left 3 Form and delete the label named BodyLeftLabel3.
Finally, now that we have removed all of the controls from the Details form, this can be
deleted as it is no longer required.
97. Select the Details form and click Delete on the Command Bar
Test out your new forms by running through a few Specifications in the Specification
Explorer and the SOLIDWORKS Task Pane. Note how the forms look different when
running them via the SOLIDWORKS Task Pane. This is mainly down to the
Hierarchical Properties that are being used in the Form Template.
DriveWorks Pro also allows us to control the dimensions and features of the
replacement file once it has been swapped in.
An example of this is shown in the pictures below, where two different rear door types
exist. One can be swapped for the other, and once swapped, driven to be the correct
size.
This is achieved by first capturing the model to be replaced and driven in DriveWorks
Pro, and then by using the model Rules to indicate that a replacement is required.
The model is captured in the Group, and then attached to the Project before building a
file name Rule for the model that is to be replaced.
DriveWorks Pro allows you to have as many Component Sets as you want within a
Project (a component set is a top level Assembly or Part). You can then choose, based
on Rules, whether to create none, one, many or all of your component sets whenever
you fill out your forms.
You can also use any component set as a replacement for any model within your main
assembly
Models will be calculated (Released) by DriveWorks Pro in the order that they appear
in the tree. Therefore, any replacement models must be created (and have their rules
evaluated) before the model they are being replaced into. They can be ordered in the
tree using the Move Up/Move Down buttons on the Command Bar.
4. At the top of the DriveWorks task pane there will be a helper link that states
Open a model to capture it. Click this link
Tip:
Remember that if you have changed the name of a feature or dimension from the
original name that SOLIDWORKS assigns, then DriveWorks Pro will recognize that,
and use the changed name.
We must now capture the components that need driving for this assembly. They are
very similar to the components that required capturing and driving for the Roller Frame
Assembly.
Component Capture
Belt Frame Assembly Yes
Belt Frame Beam Left Yes
Belt Frame Beam Right Yes
Belt Roller Yes
Belt Roller Yes
Belt Rubber Band No
Belt End Plate Yes
Bracket No
Side Rail Assembly Yes
Rail Upright No
Side Rail Support No
Support Collar No
Support Rod No
Side Rail Yes
Belt Yes
10. Open the Belt Frame Beam Left component from the Captured Models Tab.
11. Capture the dimension that determines its length within the Base-Flange2 feature.
Use the default name that is populated in the Name Text box.
12. Select the SideRailMounts Feature and capture this in DriveWorks with the
default name.
14. Open the Belt Frame Beam Right component from the Captured Models Tab.
15. Capture the length dimension FrameLength@Sketch6 and use the default name,
Frame Length.
16. Select the SideRailMounts Feature and capture this in DriveWorks with the
default name.
17. Finally, capture the DWColor Custom Property so that the part color can be
controlled.
18. Open the Belt Roller Part (Not the Belt Roller Assembly).
19. Double click the End Plane and capture the dimension 428. Use the default name.
20. Open the Belt End Plate from the Captured Models tab.
21. Capture the dimension that determines the width EndPlateWidth@Sketch1. Its
value is 428. Use the default name provided when capturing.
Note: As the Side Rail part is a shared component between the Roller Frame and the
Belt Frame, there is no need to capture the length dimension. DriveWorks already
knows that this has been captured.
24. Open the Belt Part from the Captured Models tab.
25. Double click Boss-Extrude1 and capture the dimensions that determine the length
and the width of the belt.
29. Double click the Width plane and capture the dimension associated to it. Use the
default name provided.
30. Capture the two Side Rail Assemblies as Instances by checking the check box
alongside them after selecting the Instances tab.
31. Click Save on the DriveWorks Pro Task Pane within SOLIDWORKS.
32. Open DriveWorks Administrator and log into the DriveWorksTraining Group.
35. Check the check box alongside BeltFrameAssembly and click OK.
You will now have two Component sets in your Model Rules.
In the step above you have selected four blank Rules and one Rule that has already
been created. When you click the Rule Builder, DriveWorks will display the Rule that
has been created for RollerBedWidth. However, because you are building the same
Rule for all five selected items, when you click OK, that Rule will be applied to all
selected Rules.
40. There are two blank instances of Frame Length. Multi-select both of them as
well as an instance of Frame Length that already has a Rule.
41. Also add to this multi-selection by selecting SideRailLength and click Build.
43. Finally, double click BeltLength and write the following Rule:
Now that the BeltFrameAssembly Rules have been created so that it can be driven,
you need to write the Rules to allow it to be replaced with the RollerFrameAssembly
when required.
51. Deselect All and remove the filter that you have in your Model Rules.
52. Check the check box alongside BeltFrameAssembly and double click the File
Name Rule.
54. Click the Functions drop down button and select If to open the function wizard.
58. Deselect the BeltFrameAssembly and check the check box alongside
RollerFrameAssembly.
59. Double click the File Name Rule to begin editing it.
61. Like with the Belt Frame Assembly, in the Condition Text box type
BeltBedReturn = "BeltBed"
To replace one component for another a certain syntax is required. This can be
automatically created by double clicking the component that you require to be replaced
into the assembly. This can be done on the right-hand side of the Rule Builder.
62. Place your cursor in the Value If Condition is True Text box.
63. Browse to the Components tab in the Rule Builder and double click the
BeltFrameAssembly component.
Finally, we can reuse the Rule that is still existing in the Rule Editor for the final part of
the If Statement.
65. Click Finish in the function wizard. You will now have the Rule below:
69. Click OK in the Rule Builder to confirm that the Rule will be duplicated to all
Properties.
The final two sets of Rules to complete are the Relative Path Rules and the File Name
Rules for the newly captured components.
Tip:
71. Select one Rule that uses OrderNumberReturn & "-" & DWSpecificationId
72. In addition, multi-select all of the Rules that still use DWSpecification for their Rule.
Make sure that the first Rule selected is the one you would like to duplicate.
If Rules exist in all of the selected properties, the first one selected is the one that is
used.
77. In addition, multi-select all of the Rules that still use DWSpecification for their Rule.
80. Finally, save and test your Project by running a new Specification and Generating
the Models.
Doing this will generate your models without closing the Specification. It is great for
quickly testing additional functionality that you have added to your Project without
having to create many different specifications.
Tip:
If you do not get the results you expect, make sure you look in the Release Reports
and Model Generation Reports.
Try adding some of the other controls to your Form, such as Dynamic Labels. These
are handy when giving onscreen instructions. Building the dynamic Caption Property
based on a Rule allows you to give the instruction required dynamically.
Don’t forget about using Model Insight for Troubleshooting any issues.
Model Insight is launched from Specification Test Mode and provides an essential tool
for understanding how a model is generated by DriveWorks. Model Insight uses the
Queued method of model generation.
See the exact order in which dimensions, features, advanced features, custom
properties, etc. are processed
To open DriveWorks Data Management, search for it in the Windows Start Menu.
1. Open DriveWorks Data Management, Double click your Group, check the check
box to confirm your data is backed up and click Log-on.
Tip:
This check box must be checked to ensure that you have acknowledged that there is a
backup of your data. Without checking this, DriveWorks Data Management will not let
you log in.
DriveWorks Data Management provides you with the ability to delete all your
DriveWorks Group and Project Data. Anything done within Data Management is a
permanent change to the Group
Once you are logged in, additional tasks will appear in the Task Explorer.
DriveWorks Tasks
On this tab, you can import Projects, Specifications and Components into the current
Group. Each of these three buttons will take you through a wizard that will assist you in
adding these items to your Group.
This is great for merging Projects into one Group or simply bringing captured
components from one Group to another.
You can also Copy a Group into another Group, great for transferring data from a
development group to a production Group, and perform a Pack and Go to back up or
distribute your Project to another location.
You can re-reference individual items one at a time, or relocate an entire folder to a
different location to remap where DriveWorks is looking for multiple files.
Tip:
It is also possible to delete a reference all together. This will completely remove the
captured model (and all its captured design parameters such as Dimensions and
Custom Properties) from the Group, so be careful!
Just like in Captured Information, you can right click on an individual file (Project) or
you can relocate an entire folder structure.
Specification Information
Within the Specification Information tab will be a list of every Specification that has
been created and transitioned in the current Group.
Just like with Captured Information and Projects, you can relocate where DriveWorks
thinks a Specification is stored or the entire folder where it is looking.
The list of files shown here will be the Documents and the Specification files
(.drivespec) that have been created by each Specification.
If old Specification data is important to you, you can Import Specifications from other
Groups. This is important for moving from development to production to ensure that no
historical Specifications are lost.
Note:
You cannot import Specifications into a Group that currently contains Specifications.
The existing Specifications must first be deleted and the Specification ID reset.
On the Command Bar of this tab is a button that says Reset Specification Id Pool. As
the name suggests, this allows you to reset the count for the Special Variable
DWSpecificationID. This Special Variable is used throughout DriveWorks and in the
default file name Rules.
Next to each item is a colored circle that indicates whether a released file has been
generated (green circle), whether it is waiting to be generated (blue circle) or whether
its generation failed (red circle).
Tip:
If you are using Intelligent File Names (as taught for the Roller End Plate) and there is
an error with the Model DriveWorks created, you can use the Released Files tab to
delete the file that was created. Otherwise, DriveWorks will continue to use the file that
was created incorrectly.
Again, like with the three previous tabs, you can relocate an individual released file
and an entire folder.
The data shown in the list will likely be similar to the data shown in the Captured
Models tab. However, the Captured Models tab shows the current reference to where
the Master Models are stored. Whereas Released Master Models shows the reference
to where the captured information was at the time of Releasing a Model for generation.
If a Specification has been transitioned and Models have been released, but they are
yet to be generated, moving the master files will result in a failed Model Generation. In
this scenario, you can use DriveWorks Data Management to re-reference where the
Master Files are located.
This can be done just like in the previous tabs, by right clicking an individual file or by
relocating an entire folder.
DriveWorks Pro can create documents automatically based on Rules. There are 2
categories of Document, Files and Data Documents.
Documents - Files
These documents are based on master documents, much like the SOLIDWORKS data
we have been driving in the previous lessons. Documents-Files documents are used to
create a new version of the master document each time it is released.
There are also several template documents which we will be using in this lesson to
create a Quote.
Documents – Data
These documents do not create a physical file but are used to create data. An example
of this would be exporting data to a Database in Microsoft SQL, or a DriveWorks
Simple Table.
In this lesson we will be focusing on Documents – Files, however the document types
in Documents – Data are covered in the DriveWorks Pro Advanced Manual.
Each document requires a name, and will also have a file name Rule, and path Rule
as well as the Rules for the data or text to be driven into the document.
As with models, documents require a File Name Rule and a Relative Path Rule. Again,
as with models, default rules are created for you when you first create the document.
You can change them to your desired location if required.
XML Templates
DriveWorks uses ID Tags in the template to allow data to be driven into them.
Each of the ID entries will have a Rule built for them that will replace the text within the
tag.
These XML documents can also include transforms that will format the XML as a
document.
Excel has the ability to name cells. Once named, these cells can have Rules created
for each one to allow data to be passed from DriveWorks Pro to your new document.
Cells are named in Excel by selecting any cell, and typing a name in the drop down in
the top left corner of Microsoft Excel.
Cell names cannot have spaces and most non-alphanumeric characters are not
allowed. They should not start with a number.
To check your names, use the Name Manager inside Excel. This will also allow you to
change the cell that a name references.
Named ranges are specific to an Excel document and not to a particular sheet.
DriveWorks allows you to drive values into any named cell on any sheet.
In Word, you can highlight any text in a document, and create a bookmark around it.
DriveWorks then drives text into the position of the bookmark based on Rules. If the
bookmark spans words or characters, then these will be replaced with the result of the
Rule.
This could be useful, for example, if there is a need to copy specific data sheets into a
contact folder based on user selections, or if you need to copy picture files that would
be referenced by XML transform documents.
The only Rules that are built for copied documents are the new file name, and its path.
Referenced Files
Referenced files are simply a way of only showing specific documents to users, rather
than all documents created. An example of this would be if you have Distributors for
your products who access DriveWorks over the web using DriveWorks Live. In this
case, you might only want them to have access to a General Arrangement Drawing
and a Quote, and not an automatically created BOM or detailed Component Drawings.
The only Rule to build for a Referenced file is the complete file name.
Emails
DriveWorks Pro can send emails automatically, based on Rules.
When configuring an email in DriveWorks, Rules are built for sender and recipient
email addresses, the cc and bcc fields, as well as the Subject and Message Body.
Rules are also built for any attachments that are to be sent with the email.
If attachments are being created by DriveWorks, the emails will be held in a queue
until those attachments have been created.
Emails can only be sent by DriveWorks Autopilot, a separate DriveWorks Pro module
that is purchased separately.
When building a Rule for the Message Body, text is directly typed in the message
editor, and then tags (<< >>) applied for each area that require Rule driven data.
The templates also create Variables where required, making it easier to build your
Rules.
The templates are based on XML, but also have a transform file and images
associated with them, so that the XML is presented as a document in a browser.
The HTML document can be opened up in any browser, and saved as a single file,
which would include the images.
DriveWorks 3D File
The DriveWorks 3D File document type references a .drive3d file, which has been
exported from SOLIDWORKS.
The DriveWorks 3D File document is used to manipulate .drive3d files. It can be used
to change the appearance of the .drive3d file as well as swapping .drive3d files out for
other .drive3d files.
There is also the possibility to scale, rotate and translate models in 3D space, allowing
you to manipulate models instead of using replacements. This allows for a quicker 3D
experience, especially in a browser, as you do not need to wait for replacement
models to uploaded to the client’s machine. Scaling, rotation and translation of models
is all done client side, on the user’s machine.
There are also many other features of 3D documents that you can take advantage of,
such as On Click Macros, Scene Lighting and Panning.
If you want to learn more about the 3D capabilities of DriveWorks, check out the
Webinar Library in the DriveWorks Community.
1. Open DriveWorks Administrator, and make sure that the Straight Conveyor Project
is open.
3. Click the Add button on the Command Bar to add a document to your Project.
4. Select the Quote Document template and give the document a name. Use
Quotation.
The Document View will switch automatically to edit the details of the document. Here
you can build Rules to drive the document.
Note:
As with models, documents require a File Name Rule and a Relative Path Rule. Again,
as with models, these have been created for you, although you can change them if
required.
Documents then have other values that can be driven based on Rules.
6. Click the Preview button on the Command Bar. This will open the document in a
Browser.
7. Activate Variables by clicking on the Define Variables task on the Task Explorer.
You will see two new Variable Categories added to your Project, one called Common
and one with the same name as your document. These Variables are all used within
the Quotation Document that you just created.
In the Common Category you will see Variables for things like Company Name,
Company Address (3 lines), Quote Number as well as some dates, and a Customer
Contact and Address.
Another Variable Category has been created with the same name as your document
(Quotation). If you drill down into this category in the category tree, there is a sub
category called Line Items, which itself contains a Category for 50 line items. Each of
these sub categories has 4 Variables for Quantity, Description, Discount and Unit
Price.
If you build any of the Rules for these Variables, they will automatically be updated in
the document.
14. Build a Rule for the Description of Line Item 1 using Variable
QuotationItemDesc1.
The Rule will build up text using static text and dynamic text based on your Form
selections.
Tip:
Use the Values and Steps helpers at the bottom of the Rule Builder to assist you in
getting the syntax correct.
15. Next, build a Rule for the Line Item 1 Unit Price using the Variable
QuotationItemUnitPrice1. Clear the existing rule.
The Rule we build will take into account the dimensions selected for the conveyor
length, width and height. Each of these dimensions affect the total price in a different
way to account for the added complexity of the size increasing.
Do not use a currency symbol in this Rule; just use numbers. The currency symbol is
also a Variable, allowing you to change it based on Rules and is itself passed through
to the document from that Variable.
We are also going to format the result to always show two decimal places using the
text function.
17. Next, multiply the ConveyorWidth by a factor of 0.004. Surround this calculation in
parentheses and multiply it by the Conveyor length calculation.
18. Next, multiply the ConveyorHeight by a factor of 0.005. Surround this calculation
in parentheses and multiply it with the rest of the calculation.
19. Click Finish to add the text from the wizard into the Rule Editor.
The Quote Document Template uses a transform file (.xslt) to format currency values
to two decimal places.
This means that when the result of the rule, being passed into the Quote, is 96 for
example, it will be displayed as 96.00 (or 96,00 for comma separated environments).
Therefor currency rules being passed into the Quote document require no further
formatting.
22. Change the Description for Line Item 2 to show text based on the Bed Type
selected on the Form by building a Rule for the Variable QuotationItemDesc2 as
below.
24. Type *
25. Click the Functions button and launch the If Function wizard.
27. Click Finish. Your Rule will now look like this:
This Rule will either display a blank value if None is selected or a description on the
type of Side Rail selected if one is selected.
Note:
The Quotation template is designed so that if a Description value is blank, that row will
not be displayed in the document.
32. Click the Functions button on the Command Bar on the Rule Builder and select the
If function Wizard.
This If Statement will apply a price for the Side Rails if both sides are selected, then
apply half that price if only one side is selected.
SideRailsReturn = "None"
This means that if None is selected, then a price of zero will be applied.
38. Cut and paste the Rule from the Rule Editor into the Value If Condition Is False
text box.
39. Click Finish in the function Wizard, and then click OK in the Rules builder.
40. Select the Documents-Files task on the Task Explorer and preview your document.
Note:
Your Document Preview may look different and have different values based on the
selections you have made on your Form.
42. Go to the Form Design and select the Main Left 3 form.
43. Create six Label Controls with the Text Properties and the Names as in the Table
below:
Note:
The UnitPrice Variables, used in the Quotation, did not require formatting to two
decimal places as the document transform handled this.
Now these values are being displayed on the Form, we need to add formatting using
the Text() function.
This Rule will sum the Price Variables from the Quotation document. It will use the
Text function to format this to two decimal places. Finally, it will prefix this total price
calculation with a currency symbol.
50. Next, format this Rule to two decimal places using the Text Function.
51. Highlight this entire Rule and Extract it to a Variable called TotalPrice.
54. Finally, use the new Total Price and the CurrencySymbol Variable for the
FooterRightLabel Text Property on the Main Footer Form.
As well as creating new drawings for parts and assemblies, based on master
drawings, DriveWorks Pro can also control the detail on the drawing.
Drawings are captured using the DriveWorks Pro Task Pane inside SOLIDWORKS.
Drawing Rules are also built in the Model Rules section of DriveWorks Pro
Administrator to control the captured parameters when a new drawing is created.
Drawing Sheets
DriveWorks Pro can control the scale of each sheet in a drawing based on Rules.
Sheet state Rules also allow for sheet renaming and deletion.
Drawing Views
The scale of Drawing Views and their position on the sheet can also be controlled
based on Rules. Drawing View state Rules also allow for view deletions, as well as
giving the ability to control the model configuration in the view.
Breaklines
Controlling breaklines in views (including multiple breaklines per view) is included in
DriveWorks Pro. This is in case it is not possible to dimension up a breakline in a view
relative to dimensionally controlled geometry.
Breaklines are controlled as distances from the left and right of the view (top and
bottom in the case of horizontal breaklines)
Annotation Text
Any annotation can have its text updated based on Rules. This also includes driving all
of the detail in a weld symbol or geometric tolerance.
The Rule for the annotation text can also be used to delete the annotation using the
special word "Delete".
Custom Properties
As well as controlling part and assembly custom properties, DriveWorks Pro can also
control the values in drawing custom properties based on Rules.
Layers
Layers can be hidden and shown based on Rules. This is particularly useful if a lot of
drawing information needs to be hidden or shown at once.
File Formats
Like Parts and Assemblies, DriveWorks can create additional file formats from your
drawings, such as PDFs, edrawing files and DXFs.
1. Inside SOLIDWORKS, and with the DriveWorksTraining Group open, activate the
Captured Models section by clicking on its section header in the capture explorer. If
you have no models open in SOLIDWORKS, this will be the only section.
To begin with, the SOLIDWORKS Drawing must be captured against the component
that it uses.
2. Double click on the Straight Conveyor Assembly, which has already been
captured.
This Drawing has now been captured against the open Assembly.
5. Double click on the Drawing that you have captured to open it.
Once the drawing has opened, the Capture Explorer will change to be specific to
capturing drawings with different sections to parts and assemblies.
The first section is Sheets and Views, which is used to capture the sheets and views
that you wish to control.
Note:
If you capture a Sheet, you will be able to control its scale based on Rules, as well as
its state. Sheet state allows you to Delete a sheet, or rename it based on Rules.
If you capture a View, you will be able to control its position on the sheet, its state
(which controls the Configuration to show, and gives the ability to delete it) and its
scale, providing its scale is not linked to the sheet or its parent view.
You can also resize any of the panes in the Capture Explorer by dragging.
Information is also displayed about the current size and position of views and sheets,
as well as the Captured information that will be driven based on your Rules.
Capturing Annotation Text allows you to drive text on your Drawing based on Rules.
As with model dimensions, we capture Annotation Text by selecting it in the Drawing,
and assigning a meaningful name to it in DriveWorks Pro.
10. In the DriveWorks Pro Task Pane, enter a meaningful Name. Use OrderNumber.
12. Select the Note, which currently reads Total Price $1234.
13. In the DriveWorks Pro Task Pane, enter a meaningful Name. Use TotalPrice.
Capturing Layers
DriveWorks Pro allows you to control the visibility of Layers on your Drawing.
15. Activate the Layers section by clicking on its header in the Capture Explorer.
The list will then show the current Layers in your Drawing.
To Capture a Layer, check it in the list. For the purposes of this training we are going
to capture the Layer Notes. The annotations OrderNumber and TotalPrice are the only
items on this layer. Using a Rule a layer can be shown or hidden, therefore hiding or
showing these annotations.
DriveWorks Pro allows you to control Drawing Custom Properties so that you can drive
their text based on Rules.
17. Activate the Custom Properties section by clicking on its section header.
The Custom Properties Section will show you all of the Custom Properties that are
currently in your Drawing.
In this particular Drawing, the Custom Property PartNo is linked to the PARTNUMBER
field in the Drawings border.
Note:
As with Model Custom Properties, you can add new Custom Properties to your
Drawing by typing in a new Custom Property Name and clicking Create.
DriveWorks Pro allows you to export your driven drawing to different file formats.
21. Capture PDF as an additional file format. Select With Rules from the drop down in
the Captured column
The With Rules capture option will allow you to specify additional parameters for each
file format.
23. Open the Roller Frame Assembly from the Captured Models tab
24. Select the Drawings tab and browse for the RollerFrameAssembly.SLDDRW and
open it.
26. Check the check box alongside Sheet1, Drawing View1 and Drawing View2
You can also capture View Dimensions in the section, to enable you to control the text
to the left, top, right and bottom. Information on the Rules required to do this can be
found in the Help file.
27. Activate the Annotation Positions section by clicking on its section header.
When you capture annotation positions around a view, they are placed back in the
same relative position to their location during capture.
You can link the positions to the top or bottom and then either the left or the right.
28. In the Capture Explorer, on the Annotation Positions section, select Drawing View1
in the tree or click on the view in the layout picture.
29. In SOLIDWORKS, draw a fence around the balloons on top of the view.
The selected dimensions will be added to the tree. Without the need for Rules, these
dimensions will be placed back in these relative positions when a new drawing is
created, regardless of the size of the new model and view.
Tip:
When drawing the fence in SOLIDWORKS, if you draw from top-left to bottom-right, it
selects everything that is inside the fence. If you select from bottom-right to top-left, it
selects everything that is inside the fence AND everything that crosses the fence.
You can also deselect Captured annotations, by selecting them in SOLIDWORKS, and
checking the appropriate position check box until it is the state you require.
32. Capture the Annotation Positions for Drawing View2. There are two dimensions
that need to be Captured to the Top and to the Right.
38. Open the Belt Frame Assembly from the Captured Models Tab.
39. Select the Drawings Tab and Browse for the BeltFrameAssembly.SLDDRW and
Open it.
41. Check the check box alongside Sheet1, Drawing View1 and Drawing View2
42. Activate the Annotation Positions section by clicking on its section header.
43. In the Capture Explorer, on the Annotation Positions section, select Drawing View1
in the tree or click on the view in the layout picture.
The selected view will be highlighted in green in the preview, and the view will be
selected in SOLIDWORKS. If the Drawing is not showing the correct sheet, then this
will be activated automatically.
44. In SOLIDWORKS, draw a fence around the balloons on top of the view.
47. Capture the Annotation Positions for Drawing View2. There are two dimensions
that need to be Captured to the Top and to the Right.
52. Click Save, to save the Captured information to the DriveWorksTraining Group.
1. Open DriveWorks Pro Administrator and make sure that the StraightConveyor
Project is open.
Tip:
Note:
Note:
If you have any filters applied, make sure you remove them.
The Tree shows the captured models. Drill down to the appropriate model to see its
drawing.
Note:
Any additional properties captured for drawings, parts and assemblies require the
Refresh button in the Command Bar to be clicked before they will show up.
5. Select all three drawings that have just been captured. Drawings have a different
icon to the parts and assemblies.
The bottom section is for information only; it will allow you to see which view you are
working on using the preview, and to see the current information about each sheet and
view.
Notice that Rules have automatically been created for the File Name and Relative Path
just as they were for Parts and Assemblies.
6. Multi-select the File Name Rules for the Roller and the Belt Frame Assembly
Drawings.
Tip:
The Rule for these file names will be the same as the Rule for the majority of File
Names created for the Models. Why not copy and paste the Rule from there to speed
up this process.
9. This Rule will be the same as the File Name Rule for the Top Level Model. You
could copy and paste this Rule to save time.
10. Multi-select the three Relative Path Rules and build the following Rule:
This Rule will ensure that the Drawings are placed in a different folder to the Models,
however within this Drawings folder, the Drawings will be separated into Specification
specific folders.
This Rule will simply use the Part Number Variable that was created earlier in the
Training.
This Rule will make use of the three description Rules that were created for the
Quotation, however it will combine them into one Description.
19. Browse to QuotationItemDesc1 in the Variables tab within the Rule Builder.
22. Now add the Variable QuotationItemDesc2 to the Rule followed by an ampersand
(&)
We will now use the If Function to determine whether the word and is required.
23. Either use the Function Wizard or type the following If statement:
If(SideRailsReturn = "None", "", " and ")
Note:
Note that the text strings that are written sometimes include spaces at the start and/or
the end of the string. This is because without them, the sentence would be
grammatically incorrect and there would be no space between that word and the result
of the Variable.
Tip:
Refer to a previous lesson that walks through the process of extracting a Variable if
you need assistance.
26. Select the Rule for the Notes layer and click Build.
Note:
31. Select the Total Price Rule in the Model Rules List.
Note:
Having an Annotation Text Rule that results in the word "Delete" will delete the
Annotation from the drawing.
35. Expand the Straight Conveyor Assembly Drawing and check the check box
alongside Sheet1.
When a drawing is rescaled, the views can be moved to new locations. Building these
Rules ensures that the views are positioned exactly where we want them.
These Rules will control the Top Left position of each view measured in the Drawing
Units from the bottom left hand corner of the sheet.
You can drive your view positions to be exactly where you want them, although in this
case, we are going to build Rules to position them back to their original locations.
Tip:
The original locations can be found by clicking on each view in turn in the bottom panel
of the Model Rules List and noting the Top and Left positions in the Information Panel.
DriveWorks Pro allows you to build a Rule for both the Scale Numerator and the Scale
Denominator. If the Numerator is greater than the Denominator, then the scale will be
greater than 1:1 and vice versa.
The next Rule to build is the Denominator Rule. To help break this Rule up and make it
easier to understand, we will create it in sections using Variables.
(ConveyorLengthReturn+ConveyorWidthReturn
+ConveyorHeightReturn)/3
(1500+882+528)/3
Tip: You could create a new ‘Drawing’ Variable Category to organize these Variables
We now need to calculate the scale Denominator. The dimensions that influence the
required scale of the sheet are the Conveyor Height, Conveyor Width and
Conveyor Length.
New Scale = ( New Average Sizes / Master File Sizes) * Master File Scale
Then to make sure that we only get a whole number, we can add the roundup function
with an argument of Zero decimal places.
New Scale =
ROUNDUP( ( New Average Sizes / Master File Sizes) * Master File Scale , 0 )
Transferring this calculation into the DriveWorks Training Project the Rule will be:
Therefore:
DWVariableAverageDimensions / DWVariableAverageMasterDimensions) * 10
This will possibly result in a non-standard sheet scale. If you want to use standard
sheet scales, create a table of allowable sheet denominators, then use the VLOOKUP
function to find the nearest value, both looking up in, and returning from, the first
column.
46. Go back to Model Rules and build a Rule for the Sheet1-Scale Denominator
47. Following the calculations above, the Rule will now be:
51. Drag the Rescale And Position View task from the Toolbox into the Pre Drive
Tasks box.
Within Generation Tasks, on the middle of the view is the Generation Sequence.
Without the Pre Drive and the Post Drive boxes, the list of items in this Generation
Sequence area is exactly the tasks that DriveWorks performs every time it runs a
Model Generation.
Generation Tasks can be added to the Pre Drive and to the Post Drive areas to
customize the Generation Sequence to your needs.
A good example of when it is important to choose the correct Task box, would be if you
were using the Create Image Generation Task. Chances are you would want the
image to be of the new model, so you would need to add it to the Post Drive Tasks
box, so that DriveWorks has finished driving the model before the image is created.
Every Generation Task has several properties that determine how that Task
specifically functions.
For the Rescale and Position View task you must define the View Name to control and
the area in which that view can be located. Optionally we can also specify a list of
scales for the Generation Task to choose from.
53. Drag a second Rescale and Position View Task in the Pre Drive area.
54. Write the following values into the Properties for the Rescale and Position View
Task:
Every time this Drawing is generated, they will now be scaled to fit within the area that
has been defined.
Next, we will add the same tasks for the Roller Frame Assembly Drawing.
Note: Because the Tasks are the same, except on different drawings you could simply
copy and paste the two Generation Tasks, and change their (name) Property
57. Write the following values into the Properties for the Rescale and Position View
Task:
58. Drag a second Rescale and Position View Task in the Pre Drive area.
59. Write the following values into the Properties for the Rescale and Position View
Task:
The final feature to add to these Drawings is the ability to choose when a PDF and a
DXF are created.
62. Multi-select and build the following Rule for the three File Name Rules:
Note:
When an Additional File Format is captured, the file will be created unless the word
“Delete” is the result of the File Name.
If the Rule results in a blank string “”, it will be given the same name as the Model or
Drawing it has been captured against.
This is similar for the Relative Path. If the Rule is left blank, it will be saved in the same
location as the Model or Drawing.
Note:
These DXFs were captured in Lesson 1 and Lesson 8 against the End Plate part for
the Belt Bed Assembly and the Roller Bed Assembly.
65. Multi-select and build the following Rule for the two File Name Rules:
67. Save your Project and run it to test out the new drawing functionality.
Note:
In order for your Generation Task to run, you will need to create the Specification from
Administrator (releasing the models), then go into SOLIDWORKS and create the
Model and Drawings using the Model Generation cube. This is because Generation
Tasks will not be run when a Specification is created and the models are released via
the SOLIDWORKS Task Pane. This is because of the differences between On-
Demand and Queued Model Generation methods. You can read more about the
different methods of generation in the DriveWorks Help File.
There are several different States in the default flow, and three different State Types.
State Types
Running
Forms are displayed and information can be entered into the Controls
Paused
The forms are not displayed, the default Paused States are:
Saved
Pending
Completed
Automatic
When in each State, there are a number of actions that can be taken, which will move
the Specification from one State to another.
For instance, when in the Pending State, the Specification can be Deleted, Edited,
Copied or Released.
This is best explained by showing the default Specification Flow in graphical Form.
Each State can have Operations, Transitions and all States have an Enter and Leave
Event.
Operations
By default, each of the Paused and Automatic States has these operations.
The Transitions dictate which State can be transitioned into any other State.
An example of this is that the Specify (Running) State can be Transitioned into a
Saved (Paused) State by clicking a Save button.
Events
Events allow Tasks to occur on the exit and entry into any State.
You can create your own completely custom Specification Flow, or you can begin by
using one of the templates that comes shipped with DriveWorks Pro.
You can also create templates from your own custom Specification Flows. This is great
for reusing a Specification Flow in another Project.
We will change the flow to be simpler, containing just three States: Specify, Completed
and Saved.
Currently, when you run your Project, at the end of filling out the specification
information, there are a few options.
These options are Transitions. Clicking each one will move your Specification to a
State in the Specification Flow.
By the end of this exercise you will have a simpler Specification Flow and the options
at the bottom of your form (the Transitions) will be:
1. With the StraightConveyor Project open, select the Specification Flow task in the
Task Explorer.
This will show the default Specification Flow shipped with DriveWorks Pro
Administrator.
3. Click Clear
We are going to start with a blank Specification Flow so that we can simply make the
functionality that we want available.
By Default, the first State added to an empty Specification Flow will be a Running
State, which is also the Initial State. You can identify the Initial State of a Specification
Flow as it will say Initial in the bottom right corner.
Automatic States
An Automatic State indicates the Specification is controlled by DriveWorks Autopilot
Paused
A Paused State indicates the Specification is held in a queue, available for selection
from the Specification Explorer
Running
A Running State indicates that the user forms will be loaded into the Specification
window or browser for the users to enter data onto
Initial State
The Initial State is the first state entered when a Specification is first created. Your
Initial State must therefore be a Running State
You can change a States type by right clicking it and selecting which type of State you
need it to be.
6. Click Add State again and create a third State, name it Saved
Now that we have three States we can create a method of moving from one state to
another. This method is called a Transition.
7. Select the Specify State, a blue dotted line surrounding the State will indicate it
has been selected
The next step is to identify where the Transition will transition to.
12. Click and drag the Edit Transition from the Completed State to the Specify State.
15. Click and drag the Save Transition from the Specify State to the Saved State.
18. Click and drag the Edit Transition from the Saved State to the Specify State.
These Tasks are the same as the Tasks available from the Specifications Macros
section.
For this Project we need to add just two tasks to the Enter State event of the
Completed State.
The Release Document Task is used to send a Document for generation. You can use
the Task to generate different documents at different points in your Specification Flow.
This Task works in a similar way to the Release Document Task. It is used to release a
model into the Model Generation Queue.
25. In the properties grid, in the Models property type an asterisk (*)
Note:
The asterisk indicates that all items in that property will be actioned. In the case of the
Release Models task, all of the models in the Project will be released for creation. In
the case of Release Documents it indicates that all Documents in the Project will be
released for creation.
The task that we have just added (Increment Revision Number) increments the
Revision Number Special Variable in DriveWorks. We will now edit our Project to make
use of this Revision Number in the File Names.
Tip:
To reposition the transition arrows that connect the states, left click and hold down the
mouse button on any of the little black blocks .The rectangle will turn into a black
square that can now be dragged around the perimeter of the state.
35. Go to Model Rules and edit the File Name Rule for StraightConveyorAssembly.
Note:
If you have a filter in place, remove this so that you can view the File Name Rule.
38. In the dialog that appears, edit the Replacement Rule by adding
&”-“& DWRevisionNumber to the Rule.
Don’t forget that as you start typing RevisionNumber, Rules Insight will predict that this
is the variable you require. Press enter when it’s selected to complete the Rule.
This lists all of the locations throughout the Project that uses DWSpecificationID.
There is one rule called Specification Name that is shown in the list. Make sure this is
Unchecked.
41. Click OK. The Rule will now be updated to include the Revision Number. Check
through your Project, notice that DWSpecification has been updated for all File
Names.
Run through your Project a few times to test out the new Specification Flow that you have
just created. Notice that when you click Save, the Models and Document will not be
released, due to the necessary Tasks not being added to the Save State.
Note:
From this point in the manual, you will always need to use the blue Model Generation
cube in the SOLIDWORKS Task Pane to generate your models. Nothing will be
generated automatically if you only create the Specification from the SOLIDWORKS
Task Pane.
In DriveWorks, Macros can be created to perform a number of useful tasks and can be
set to run on the click of a button. These DriveWorks macros are called Specification
Macros. Specifications can also be run at various other points in a DriveWorks
Project, but for this training we will be focusing on Macro Buttons.
Specification Macros
Specification Macros allow you to easily create a macro that runs any number of tasks
you choose.
Specification Tasks can be added to the macro from the Toolbox. With a Macro
selected simply drag and drop tasks (or double click the name of the Task) into the
central task pane to add them to the Macro. You will end up with something like this:
Specification Tasks
Each one of the square blocks above is a Node. A Node can be either a Specification
Task or a Specification Condition. Each Specification Task has its own properties to
determine exactly what it does. An example of a Specification Task would be:
One Specification Macro can run any number of tasks to achieve the result you
require. It can even run other Macros and run other Macros in a loop.
As an example, this section of the manual will show you how to create a button on
your form, that when pressed will create a snapshot of the form at that time
When the button is clicked, you can run a Specification Macro that you have created in
your Project.
The Specification Tasks, contained within the Macro you have set the button to run,
will then be executed. You determine which Specification Macro is run via the Macro
Buttons Properties.
However, there are a few Properties that are unique to Macro Buttons and are
particularly important.
With a Macro Button on your Form, the most important Control Property is the Macro
Name. This property must be linked to a Specification Macro.
Macro Name
This Property requires the name of a Specification Macro. It determines the Macro to
run.
This Property must be filled in with the name of a Specification Macro. Without setting
the Macro Name Property, clicking the Macro Button will have no effect.
The Property is dynamic by default so you can build a Rule to run a different Macro
depending on other values.
Tip:
Use the Macros button on the Command Bar of the Rule Builder to link a Macro Button
to a Specification Macro. This will prevent any accidental mismatch in the name of the
Specification Macro.
Picture Properties
There are 5 properties that control the picture used on a Macro Button and how those
pictures are displayed. They are:
• Picture
This Property determines the picture shown on a Macro Button.
• Picture (Hover)
This Property determines the picture shown on a Macro Button when a cursor
hovers over the control.
In all cases, experimenting with each of these Properties will provide you with a full
understanding of their function.
Macro Argument
The Macro Argument Property is optional; however, it can be incredibly useful. The
result of the Macro Argument Property is written to the Special Variable called
DWCurrentMacroArgument each time the Macro Button is clicked. Therefore, you
can use this special Variable in other Rules to provide a different result based on the
button that was clicked.
A simple example of this is with ‘Add’ and ‘Subtract’ buttons. Instead of creating two
Specification Macros, one to add and one to subtract, both buttons could use the same
Specification Macro.
By using the same Specification Macro, the result would be the same for both buttons.
However, by referencing the Macro Argument, you could have different results. With
the Macro Argument set to +1 for the Add button and -1 for the Subtract button, the
DWCurrentMacroArgument could be used in the calculation. The Rule, if you were
changing a constants value, would be:
DWConstantExample+DWCurrentMacroArgument
If the Constant had a value of zero and the subtract button was clicked, the Rule would
be 0+-1 which equals -1.
If the Constant had a value of zero and the add button was clicked the Rule would be
0++1 which equals 1.
1. Go to the Main Left 3 Form and create a new Macro Button Control
2. Call this Control CreateSnapshot. Position the Button so it looks like the image
below
This will add a blank Macro Button to the Form. You can resize and move this button
to look right on the form.
Note:
Macros cannot be run in Form Design Test Mode. If you go into Test Mode on your
Form and click the button, a dialog will appear telling you this.
This is so you can see the text when we export the form later. If the background was
left as Transparent, it would be difficult to read the black text when viewing the image.
Now that we have created our Macro Button, the next thing we must do is create the
Export Form Document.
An Export Form Document, when released, will create an image file of the specified
Form. The Form will be cropped to the minimum size it can be, whilst still showing all
the visible Controls. The Export Form Document is found in the Documents – Files tab.
5. Select Export Form and give it the name Export Summary Form
6. Click the Build button at the end of the Form to Export row to launch the Rules
Builder
7. Change the rule from “Main Header” to “Main Left 3”. This will make sure the
correct form is exported
The Main Left 3 form is the Form shown when the Pricing Tab is selected, it’s also the
Form we created the Macro Button on earlier.
8. Now Build a rule for the Output Path. Build the following rule:
Note:
We do not need to build the path for this rule. This is because the Output Path will by
default use the Specification Path if no other path is specified. Therefore, we are just
going to specify the file name and save it into the Specification Folder.
Now that we have created the Export Form Document, we now need to create a
Specification Macro to release the Document and create the image.
Tip: You can Preview your Form Export Document to check you are exporting the
correct Form.
Specification Macros are used to run Specification Tasks. You can have any number
of Tasks contained within one Macro. Specification Macros can be triggered in various
ways, such as Macro Buttons and Specification Flow Operations and Transitions.
The above image shows the different sections of the Specification Macros tab.
• Specification Macro Flow Area – With a Macro selected, this central pane
shows all of the tasks and conditions contained within the Macro.
11. Click the Add button to create a new Specification Macro, call this
CreateFormSnapshot
Now that we have created a Specification Macro, we need to add some Specifications
Tasks to run when the Macro is triggered using the button you created on your form.
12. Add the Release Documents Task to the Macro by double clicking it in the right-
hand side Toolbox
Specification Tasks
Specification Tasks have a few key features that determines their behaviour. The
image below shows a standard Specification Task.
Specification Task Properties determine the outcome of the Task. You can make a
Task dynamic by double clicking the sigma symbol next to it.
Navigation Endpoints are used to determine the flow of the Macro. Navigation
Endpoints are green in color. Like Data Endpoints, Navigation Endpoints have inputs
and outputs which determine the order in which Tasks or Conditions are ran.
For all Endpoints, an input must be connected to an output, and vice versa. Also, a
Navigation Endpoint must be connected to another Navigation Endpoints, and the
same with Data Endpoints.
We now need to connect the Macro Task into the Specification Macro flow using the
Navigation Endpoints on the Start node and the Release Document Task we just
added.
13. Click and drag the green Navigation Endpoint on the Start node and join it to the
input Navigation Endpoint of the Release Documents Task node
The Task is now correctly linked into the Specification Macro flow. Tasks will only be
run when they are correctly joined together using connections between Navigation
Endpoints.
Most Tasks will have Properties that determine what the Tasks do when they are run.
Properties can either be static or dynamic, or you can use some of the special
Connection Points to automatically populate the Properties of a Task.
Tip:
To delete a connection, hover over one of the Navigation Endpoints, and click the red
cross next to the connection you want to delete.
Now our Specification Macro Task is connected into the Specification Macro flow, we
need to control its behaviour using its Specification Task Properties
Specification Task Properties control the behavior of a Task. Properties have Data
input and output Endpoints which can be used to determine the value of the property,
or pass its value to another property. You can also build a rule for these properties.
You can see by reading the Description for the Documents Property that the Task
simply needs to know the name of the Document we want to release. In this case, our
Form Export Document
15. Click the cross or the dimmed background to close the Help
16. Select the Export Summary Form from the Documents Property in the Release
Documents Task
Tip:
You can zoom in and out in the Macro Task Editor using the slider at the bottom of the
window or by holding Ctrl and scrolling with you mouse.
17. Navigate back to the Form Designer and go to the Main Left 3 Form
18. Select the Macro Button you created at the start of this lesson
19. Build a rule for the Macro Name Property of the Control
The Macro Name Property is what links the Macro button to the Specification Macro
you want it to run. The Property is Dynamic by default.
20. From the Command Bar of the Rules Builder select the Macros button. A dialog
will appear showing a list of all the Macros in your Project
This will add the Macro to your rule in a String format. You could also have manually
typed in this rule.
22. Run through a Project and click the Create Snapshot button. Do not click Save or
Generate, but instead open File Explorer and view the image that you have created
by going to your Specification Folder, and going into the most recent (highest
numbered) folder
You have now completed the DriveWorks Pro Essentials Training. Make sure you run
through your Project several times to make sure that everything that you have
implemented works.
When DriveWorks creates new model sets based on the masters, it is copying files
and then re-referencing any associated files.
It is therefore wise to construct the models and create mates knowing what is to be
driven.
For instance, if you mate parts in an assembly based on one of its features, and then
delete that feature based on a Rule, the mate will error in the new clone.
In-context Design
Be careful with in-context design when drilling down more than one level. DriveWorks
is fine with one level of in-context design, but because DriveWorks is creating new files
based on the masters, you need to be careful to ensure that the correct model is
referenced at all times.
DriveWorks will also not update references if a Part is in a sub assembly, which is in
an assembly, and the part is modelled in-context of the top level assembly. Stick to
one level only.
If multi-level in-context design is insisted upon, have sketches or planes in the sub
assembly that are in-context with the assembly, and then drive the Part from the sub
assembly.
Part Equations
Using part equations is fine, although DriveWorks will only perform the rebuild
operation once, after it has driven dimensions, features and custom properties. If the
equations are in the wrong order, subsequent manual rebuilds may be required.
That said, there is an argument to say that if you are controlling dimensions from
DriveWorks based on Rules, there is little need to use equations.
Configurations
DriveWorks can use Rules to select an existing configuration to use. When
DriveWorks is driving a dimension or feature, it will do this for all configurations, unless
the feature or dimension is configuration specific, then it will only be driven in that
configuration.
The DriveWorks Pro Help File is an invaluable source of information. Press F1 on your
keyboard, or click the question mark button in the top right hand corner of the
dialog.
The online Help File is continually updated with new articles and represents the
version that will be incorporated into the next service pack of DriveWorks.