Certified SOLIDWORKS® Solution Partner|Built for SOLIDWORKS and SOLIDWORKS PDM Professional|Free Community Edition, no key needed

Product features

The PDMPublisher Conditions Editor Explained

Walk through the PDMPublisher Conditions window: Root AND/OR, nested groups, the Variable list, comparison types, evaluation rules and the review dialog.

The Conditions window decides which files a publish job touches: every reference of an assembly runs through the tree you build, and only the files that pass are exported. This page walks the editor itself; for the strategy and recipes, read Conditional assembly processing.

In short

  • A tree of groups (And / Or) and rows (Variable, Comparison, Value, optional Configuration). A file passes when the root group is satisfied.
  • Variables are custom properties, PDM variables and built-in values such as (s) State, FileName or SheetMetal; Text equal accepts * as a wildcard and is not case-sensitive.
  • The review dialog shows which files passed and why the others did not, before anything is written.

The editor, row by row

PDMPublisher Conditions window with Root: Or, a FileName Text Equal To *.sldprt condition, a nested Group: Or and its Variable dropdown open listing (w) Workflow, (v) Version, (s) State, (name) FileName, (rev) Revision, (folderName) FolderName, (folder) FolderPath, (path) FilePath, (configurationName) ConfigurationName and custom properties Cost, Description, Finish, MDL_EngAppvl, MDL_EngAppvl_Date, Number, PartNo, PartNumber and UNIT_OF_MEASURE, with OK and Cancel buttons
The Variable dropdown: built-in values carry a bracketed short name such as (s) State.
  1. The root row sets the top-level logic, And or Or. The + buttons add a condition row or a nested group; checkboxes disable rows without deleting them.
  2. A condition row: pick the Variable (the dropdown lists what exists in the current context), the Comparison (Text equal, contains, not equal, Number greater than, Date before, Yes/No and so on), the Value, and optionally the Configuration to read it from.
  3. A row stays Undefined until a comparison is chosen; an Undefined row never matches.
  4. Nested groups let you combine logic: a root And with an Or group inside it for alternative spellings or configurations.
  5. Select Preview or run the job: the review dialog lists every file with its exclusion reason; the Use checkbox there is a one-off override and does not change the tree.
PDMPublisher review dialog listing assembly references that passed the condition tree with their evaluated destination paths, configuration, quantity and drawing status before publishing
The review dialog after evaluation: failed files show their exclusion reason.

Settings that matter

SettingWhat to putWhy
Root logicAnd for “all of these”, Or for “any of these”Most release rules are a root And.
ComparisonText equal with *, Text contains, not equal, numeric and date comparisonsPick the type that matches the property; text in a number property fails that file.
ConfigurationLeave empty, or name the configuration to readConfiguration-specific properties are read from the right place.
Ignore sub-assembly children when condition checks failOn to drop a rejected sub-assembly’s parts tooOff by default; children are still evaluated on their own.
PDMPublisher Conditions editor with a Root Or group and a nested And group of condition rows for variable, comparison, value and configuration
A Root: Or tree with a nested And group.

If something looks wrong

  • Everything is skipped: a root And with one impossible row rejects every file. Disable rows one at a time and rerun with the review dialog.
  • A row never matches: the comparison is Undefined, the wildcard is used outside Text equal, or the property does not exist on those files (missing evaluates as empty).
  • A number or date row fails unexpectedly: one file holds unparseable text in that property; search the Detailed log for the filename.
  • Unticking a file in the review dialog did not stick: that is a one-off override; change the tree to make it permanent.

Availability

The Conditions editor is shared by PDMPublisher for SOLIDWORKS and the PDM Professional task. The add-in evaluates values from the open assembly; the task evaluates PDM variables and properties from the vault files.

Keep going

Documentation

Frequently asked questions

What do (s), (name) and {x} mean in the PDMPublisher Conditions variable list?

Bracketed short names mark built-in values: (w) Workflow, (v) Version, (s) State, (name) FileName, (rev) Revision, (folderName) FolderName, (folder) FolderPath, (path) FilePath, (configurationName) ConfigurationName. {x} marks SOLIDWORKS custom properties or PDM variables found in the current context.

Why does my condition row say Undefined?

A new row has no comparison yet. Pick a Text, Number, Date or Yes/No comparison in the Comparison cell; until then the row is not evaluated.

Can I use wildcards in PDMPublisher conditions?

Yes. Text Equal To accepts * as a wildcard, for example FileName Text Equal To *.sldprt. Text comparisons are not case sensitive.

What happens when a number or date property contains text?

The comparison fails for that file and the reason is written to the log. The file is skipped if the rest of the tree does not let it pass.

Why are my assembly components not being filtered?

Conditions gate references, so Export references to file formats individually must be enabled. Without it only the launched document is processed.

Does unticking a file in the review dialog change my conditions?

No. The review dialog’s Use checkbox and format overrides apply to that run only; the saved condition tree and profile are unchanged.

Where to next

PDMPublisher for SOLIDWORKS · PDMPublisher for PDM Professional · All features · Conversion guides · Pricing · Documentation · Contact

The SOLIDWORKS add-in is free to start as the Community Edition. The PDM Professional task comes with a 7-day trial. Download the add-in or start the task trial.