Expand SOLIDWORKS PDM File ExplorerSOLIDWORKS PDM File Explorer
Expand SOLIDWORKS PDM Professional Item ExplorerSOLIDWORKS PDM Professional Item Explorer
Collapse SOLIDWORKS PDM Administration ToolSOLIDWORKS PDM Administration Tool
Expand Introducing the Administration ToolIntroducing the Administration Tool
Expand Local SettingsLocal Settings
Expand VaultsVaults
Expand Archive ServersArchive Servers
Expand SOLIDWORKS PDM Add-ins (For SOLIDWORKS PDM Professional only)SOLIDWORKS PDM Add-ins (For SOLIDWORKS PDM Professional only)
Expand Dispatch (For SOLIDWORKS PDM Professional only)Dispatch (For SOLIDWORKS PDM Professional only)
Expand Bills of MaterialsBills of Materials
Expand Data CardsData Cards
Expand Card Lists (For SOLIDWORKS PDM Professional only)Card Lists (For SOLIDWORKS PDM Professional only)
Expand Categories (For SOLIDWORKS PDM Professional only)Categories (For SOLIDWORKS PDM Professional only)
Expand ColumnsColumns
Expand File TypesFile Types
Expand Importing and Exporting Data (For SOLIDWORKS PDM Professional only)Importing and Exporting Data (For SOLIDWORKS PDM Professional only)
Expand Indexing the Vault (For SOLIDWORKS PDM Professional only)Indexing the Vault (For SOLIDWORKS PDM Professional only)
Expand Items (For SOLIDWORKS PDM Professional only)Items (For SOLIDWORKS PDM Professional only)
Expand  Installing and Configuring SolidNetWork Licensing Installing and Configuring SolidNetWork Licensing
Expand Message SystemMessage System
Expand Revision NumbersRevision Numbers
Expand Serial Numbers (For SOLIDWORKS PDM Professional only)Serial Numbers (For SOLIDWORKS PDM Professional only)
Expand  Tasks (For SOLIDWORKS PDM Professional only) Tasks (For SOLIDWORKS PDM Professional only)
Expand Templates (For SOLIDWORKS PDM Professional only)Templates (For SOLIDWORKS PDM Professional only)
Expand ToolboxToolbox
Expand Users and GroupsUsers and Groups
Expand VariablesVariables
Collapse WorkflowsWorkflows
Expand Administering Web Servers (For SOLIDWORKS PDM Professional only)Administering Web Servers (For SOLIDWORKS PDM Professional only)
Expand Database ServerDatabase Server
Expand MiscellaneousMiscellaneous
Expand SOLIDWORKS PDM Archive Server Configuration ToolSOLIDWORKS PDM Archive Server Configuration Tool
Expand SOLIDWORKS PDM File Version Upgrade ToolSOLIDWORKS PDM File Version Upgrade Tool
Hide Table of Contents

Transition Action Dialog Box

Use the Transition Action dialog box to define the actions that are triggered by a transition.

To display the dialog box:

Click a transition in the workflow editor. In the Properties dialog box, on the Actions tab, click Add Action, or click an action and then click Edit Action.

Description

Type a description.

For Send Mail actions, the description is used as the subject line for the message. To include system variables, click and select a variable (Transition Action Variables). For example: File %filename% is ready for approval.
You can include system variables only for Send Mail actions.
Type
Select an action type:

Type-specific options appear at the bottom of the dialog box based on your selection.

Comment, Execute command, Execute task, Export data to XML, and Import data from XML are not available in the workflow of a standard vault.
Run for items (SOLIDWORKS PDM Professional only)

Apply this action to items. See Items.

Run for named bills of materials (SOLIDWORKS PDM Professional only)

(Not available when Type is Set Variable.) Apply this action to named BOMs.

Run for files

Apply this action to files. When selected, you can limit the action to certain file types using Only run for files with these extensions.

Only run for files with these extensions

(Only available when Run for files is selected.) Limit the action to certain file types. Type one or more file extensions, separated by semicolons (;).

Comment (SOLIDWORKS PDM Professional only)

This option is available when Type is Comment.

This option is available only for automatic workflow transitions. When you change the workflow transition from automatic to parallel or normal, a warning appears.
Transition Comment Lets you enter a comment that will be processed during an automatic workflow transition. This comment appears in the transition line of the file's history. To include system variables, click and select a variable.
You can enter characters up to 250.

Execute Command ( SOLIDWORKS PDM Professional only)

These options are available when Type is Execute command.

Enter command to execute

Specifies the full path to the executable (as seen from the client computer performing the transition), or the name of the executable if it is already registered in Windows (such as Notepad or WordPad). Specify the path as if launching the executable from the command line or Start > Run.

Wait until the started program terminates

Suspends SOLIDWORKS PDM activity (for example, no other transition actions are run) until the program completes.

Execute Task (SOLIDWORKS PDM Professional only)

This option is available when Type is Execute task.

Select task to execute Initiates the execution of the selected task. See Tasks.

Export Data to XML (SOLIDWORKS PDM Professional only)

The following option is available when Type is Export data to XML.

Select export script to use

Exports data from SOLIDWORKS in XML format (for example, for use by an ERP system). Select an export script. See Export Rule Dialog Box.

Import Data from XML (SOLIDWORKS PDM Professional only)

The following option is available when Type is Import data from XML.

Filename of file to import from (use *as wildcard)

Imports XML data (for example, from an ERP application). See Import Rule Dialog Box. Type the name of the XML file to import. You can use the * wildcard. To include system variables, click and select a variable.

Inc. Revision

This option is available when Type is Inc. Revision.
SOLIDWORKS PDM does not write the revision number to a data file data card variable as part of the Inc. Revision action. Create a separate Set Variable action if needed.
Revision Comment Lets you enter a comment for increment revision that appears in the file's history. To include system variables, click and select a variable.
You can enter characters up to 250.

Send Mail

These options are available when Type is Send Mail.

To

Lists the user or group to receive the message.

Message
Shows the message body. To include system variables, click and select a variable. For example:
  Brian,
  %projectpath%%filename% is ready to be approved. Thanks. 
  %user%
Variables are replaced by their values at the time the message is generated.

Set Variable

These options are available when Type is Set Variable.
When updating a file data card variable from a transition action, SOLIDWORKS PDM creates a new version of the file. If the file includes references, the references are automatically updated to match the new version.
Variable

Shows the data card variable to update. The read-only Type field shows the variable's data type.

Configuration

Indicates the specific configuration tab of the data card on which the variable is to be updated.

To update all available configurations, leave this field empty.

Value

Sets the variable value. To include system variables, click and select a variable. For example, if you type Checked by %user%, and the login name of the person performing the transition is Bill, then the variable is set to Checked by Bill.

You can also include a source configuration with the system variable. For example, if you select a variable Description, and add a source configuration, MyConfig1 with a delimiter, the Value field displays %var_Description@MyConfig1%. This sets the variable to the description from the source configuration.

Version Comment Lets you enter a comment that appears in the file's history. To include system variables, click and select a variable.
Version Comment is shared for all set variable actions on a transition. You can enter characters up to 250.
You cannot add a comment to the version free variables that are updated through a transition.
Mapped Approvers (SOLIDWORKS PDM Professional only)

Expand Mapped Approvers to see the roles, role members (Users), and number of approvers that are required to complete this transition.

For example, if you have created the roles Engineering and Manufacturing, the expanded list shows those roles and the users who are members of the roles.

When you select one or more users, SOLIDWORKS PDM stores their user and system data for use as the variable value.

When the selected user approves the transition, the software displays the value in data cards that contain the variable.

This option is available only for parallel workflow transitions.

For more details, see Setting Parallel Approval Data Mapping.

Override Approver Value (SOLIDWORKS PDM Professional only)

To select this option, first expand Mapped Approvers.

When you select Override Approver Value, radio buttons replace the Users check boxes in the Mapped Approvers list.

This lets you select one user whose data is used for the variable value, irrespective of users who actually transition the file.

The software displays the selected user’s data in data cards that contain the variable.

For more details, see Setting Override Approver.



Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   Transition Action Dialog Box
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:

x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: SOLIDWORKS PDM 2016 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.