Integration with Other Applications > Windchill Workgroup Manager Documentation > ECAD > ECAD Document Information Page > Manage Design Directory
  
Manage Design Directory
The Windchill Workgroup Manager for ECAD previously introduced the concept of the Workspace Local Directory (WLD). This defines the physical location of the workspace. Manage Design Directory is additional functionality that compliments the workspace local directory.
The Manage Design Directory action enables you to map the design object to point at the design directory of your choosing to populate the workspace. The design directory can also be set during the initial check-in activity using the ECAD Check In action. The WLD can continue to be used, but Manage Design Directory provides functionality that ECAD designers prefer.
* 
The following characters cannot be used in the Manage Design Directory name.
! ~ @ # $ ^ % & ( )
The following design workflows deliver a method to set the design directory.
New design — This design has never been checked into Windchill.
The new design workflow delivers content for the first time to Windchill by way of an initial check in using the ECAD Check In action
Legacy (already existing) designs—This design is in Windchill and the designer would like to check out and set the Design Local Directory.
The legacy design workflow utilizes the Manage Design Directory action. When a design is checked out, the content is placed in the WLD. The data stays there until you initiate the Manage Design Directory action which in turn moves the data to a design directory that you specify.
Menus
You can access Manage Design Directory using one of two methods.
Right-click on an applicable ECAD object in the workspace. This delivers a drop down menu that displays Manage Design Directory
Navigate to the detail information page of an ECAD Object. From the workspace listing, select the item information icon, then select Manage Design Directory
The Manage Design Directory screen displays the current location of the design. Newly checked out data added to the workspace resides in the Workspace Local Directory. If the design was previously moved, Current Location: displays its previous location.
This path can be change by selecting the Move Design option and entering the new location. A browse wizard is presented to navigate to the new design directory.
* 
Local & Network drives are supported. Some examples are shown below:
C:\SPB_Data\small demo\small_demo\ECAD\work\small_demo\physical
D:\Mentor_Data\DxProjects\Project1
Z:\Altium\Altium_Designer_09(Z(\\hq-ncfs7\cad)
Examples of machine locations NOT supported.
\\computer1l\Shared\ECAD_Designs\Zuken_cr5000
\\system2\cad\Libretto\software\CAD_CDs\_CAD_Data_\ECAD
* 
To support these types of configurations, map the above to a drive letter that can be used as the DLD location.
There are three conditions when a relative path can be appended to the new location. This can remain the same, or you can change it by selecting the Edit Top Directory name (may include relative path) option.
* 
When any of the following three tool suites listed below are used, the relative path of the nested structure is stored and presented when Manage Design Directory is invoked.
Cadence Allegro Design Entry HDL/ Cadence Allegro Editor
Mentor Graphics DX Designer/ Mentor Graphics Expedition PCB
Mentor Graphics Design Capture/ Mentor Graphics Expedition PCB
When OK is selected, the design is moved to the new location and the design directory is set with the new path. This path is now used for all actions that require the design data location, including the ECAD Check In action.
* 
When you remove a design from the workspace, the DLD mapping is deleted. If the design is added again to the workspace, Manage Design Directory must be used in order to map it to a local directory.
Supported Use Models
The following use cases are supported by the new Manage Design Directory action.
One design object with one design directory.
Two design objects in the same workspace, each with different design directories.
Multiple workspaces with the same design object, each with different design directories.
Non-separable design objects with the same design directory.
Non Supported Use Models
The following use cases are not supported by the new Manage Design Directory action.
One design object with multiple design directories.
Two design objects with the same design directory.
Two design objects in two different workspaces with the same design directory.
Using the Manage Design Directory
This section provides examples of Manage Design Directory usage.
You create a new combined board-schematic design.
1. New combined board-schematic design is created in the common space.
2. Checkout the designs and add to the workspace.
3. Use the ECAD Check In action on the schematic design.
4. The ECAD Check In window for the Schematic appears.
5. The related board can be collected by selecting the Include Associated Design Data option.
6. Click Browse to select the design location for the respective board-schematic local design.
* 
The location set above is for the design location. Check in the design to make the above location the design directory.
7. After design check in, you will see the design.zip file and design.dld file in primary content.
8. After initial check in, you will see the Manage Design Directory option available.
* 
The design must have valid content for the Manage Design Directory option to be available.
The Manage Design Directory option is available for both checked in and checked out designs.
The Manage Design Directory option is only available for designs located in the workspace.
9. When the Manage Design Directory option is chosen, the directory path is shown and an option to move the directory location.
10. Click on Move Design and browse to the new directory location. Note the new path under the New Location field. The top directory name is also created under the selected new location.
11. The design name is always saved as the top directory name and can be edited. Click OK.
The design moves to the new directory. The top directory is created if it does not already exist.
12. The new location of the schematic design.
13. The board design can also be moved to the new location. Highlight the board and select Manage Design Directory.
14. The current location is shown. The board design shows the relative path to the schematic design.
15. Move the board design to its new design directory the same as previously done for the related schematic.
* 
The path set as top directory, is automatically appended to the new design location.
16. We previously changed the top directory for the schematic design from ata_demo to ata_demo123. This is also done for the board so that it resides under the same schematic directory.
* 
Any change made in the top directory path is automatically appended to your new location.
17. Click OK.
The confirmation screen displays to confirm the board move to a new design directory.
18. Click OK.
The new design location for the board is displayed.
* 
1. The Windchill ECAD design points to this local design directory as long as the design resides in the workspace. If you remove the design from the workspace, the link from the design to the above design location is lost. This does not remove or modify the local design contents.
2. If in the future you add this design to the workspace again, the path will show as the workspace local directory and you have the option to move it.
Messages for the Design Directory
1. Each design can have a unique design directory, no two designs can share the same design directory.
You set the design directory of one design to another Windchill ECAD design, you will get the following error. Flat ECAD designs where the board and schematic both reside in same directory cannot be used due to this restriction.
2. You get an error message when you try to set a new design directory which is the same as the current design directory.
3. You get a confirmation message when trying to select folder as design directory which resides under the design directory of another design.
4. You get a confirmation message when trying to set a design directory to a folder which already has content.
Best Practices for the Manage Design Directory
1. When working with a combined board/schematic design and the board resides under schematic or the schematic resides under board, the sequence of moving the design directory of these combined designs is important so that there is no data loss due to overwriting of the files.
a. For a combined board/schematic design, where board resides under schematic, you need to set the design directory of the schematic design first and then the board design using the Manage Design Directory user interface.
b. For a combined board/schematic design, where schematic resides under board, you need to set the design directory of the board design first and then the schematic design using the Manage Design Directory user interface.
2. When removing a design from the workspace, the link for the ECAD Windchill design with the design directory is lost, however the contents of the design directory are intact.
This design directory can now be used by another Windchill ECAD design or you can again add the same Windchill ECAD design to workspace and set the same design directory using the Manage Design Directory user interface.
3. After performing a clear cache on a system, the current location field of the ECAD design in the Manage Design Directory user interface is shown as the workspace local directory location. You can use the Move Design option in the Manage Design Directory user interface and set a new local design directory.