Set Up SolidWorks Advanced Property Mapping

Use advanced property mapping to write Vault properties back to the CAD file and display them.

Display Drawing Revision

Enable the display of document revisions so you can manage document releases. The following example describes how to make these adjustments to SolidWorks template files for consistent behavior. It is divided into three parts:
  • Create a custom revision property
  • Map the revision property
  • Change the document revision

To create a custom revision property:

  1. With a CAD file open in SolidWorks, select File > Properties.
  2. Go to the Custom tab of the Summary Information dialog box.
  3. Click inside the Property Name box to create a new property, and select Revision.
  4. Enter an initial value for the property; for example, “A”, “1” or “-“.
  5. If you are using a standard SolidWorks drawing, you should see the revison value in the title block.

To map the Vault revision property:

  1. From the SolidWorks Tools menu, select Administration and Vault Settings.
  2. On the Behaviors tab, click Properties.
  3. In the Property Definitions list, select the Revision property and click Edit.
  4. In the Edit dialog box, select the Mapping tab and click Add.
  5. Select File as the entity, and from the property provider box, select SolidWorks.
  6. If you have not yet loaded SolidWorks data into your Vault, select Import From File in the Import Properties box. Otherwise, select Import From Vault.
  7. Navigate to the modified SolidWorks file.

    When you select the file to import, you will see the SolidWorks custom property “Revision."

  8. Click OK.
  9. The mapping is created; it is one-dimensional from Vault to the File. That is, revisions are controlled from Vault.

To change the document revision:

  1. Highlight a drawing file (slddrw) in Vault Explorer and from the Vault menu bar select Revise.
  2. With the document selected in the Revise dialog box, select Primary from the Select Next Revision box .
  3. Click OK.

    The revision updates to the next value.

  4. Check the Vault properties for the file. There is now an equivalence error for the revision.
  5. Do one of the following to update the property.
    • In Vault Explorer, highlight the file and select Synchronize Properties from the Actions Menu, or;
    • In SolidWorks, use Open File From Vault to open the slddrw file, then select Update Properties from the Vault tab.
      The file is checked out and updated. You should see the new revison value in the title block.

Create Bidirectional Custom Property Mapping

Create bidirectional mappings so that you can edit a property from a CAD document, then edit it in Vault and write back to the CAD file. This is commonly done with properties such as Part Number, Title, Description, Project, Department, and so on. The following example describes how to do this and is divided into two parts:
  • Create custom properties for a SolidWorks file
  • Edit the custom property from Vault Explorer

To create custom properties for a SolidWorks file:

  1. With a CAD file open in SolidWorks, select File > Properties.
  2. Go to the Custom tab of the Summary Information dialog box and create your new SolidWorks properties.

    Make sure you assign values to the new properties.

  3. From Vault Explorer, select Tools > Administration > Vault Settings.
  4. On the Behaviors tab, click Properties.
  5. Click New in the Property Definitions dialog box.
  6. In the New (Property) dialog box, enter a name and select a type.
  7. In the Associations box, select File and the appropriate file types.
  8. Using the boxes in the Settings tab, set property behavior; for example, minimum and maximum lengths, required or not, case sensitive, predefined lists, default values, and so on.
  9. Go to the Mapping tab.
  10. Select File as the Entity type, and SolidWorks as the Provider.
  11. Under File Property, select Import Properties > Import From File.
  12. Select the file with the new properties you created.
  13. From the list, select the correct custom property for mapping.
  14. Select bidirectional mapping so you can edit the property in Vault or CAD.
  15. Click OK to save the new property with its settings and CAD mapping.
  16. Return to SolidWorks and check in the file to add it to Vault.
You should now see the property you created, with the Correct SolidWorks custom property.

Now you can edit the property in Vault Explorer.

To edit a user-defined property in Vault Explorer:
  1. In Vault Explorer, select one or more files.
  2. Click Edit > Edit File Properties.
    The Property Edit dialog box opens. You can edit the property that is in this dialog box, or add or remove properties from the grid as needed.
  3. Review the Property Edit Results dialog box.
  4. Close the Property Edit Results.
    You can see that the user-defined property has been updated.
  5. Open the file again from SolidWorks to confirm that the property has been updated.