Tech Tip: DS-CR Vault File Distribution

Menu

DS-CR maintains electronics design data in a vault with controlled access and revision control. That data must be distributed outside the vault to support various business activities such as fabrication, assembly, and supply chain management.

Vault File Distribution provides software automation to extract files from the vault and place them into specified locations to support the business process that rely on them.

Configuration

There are two configuration points to set up Vault File Distribution. The first step is done in the App-Coordinator. Select the files to export using DS-CR’s search feature. The second step is to define the run-time parameters in a properties file. Detailed instructions are provided below the video.

This video shows an example application of Vault File Distribution with the steps to configure and run it.

Create Distribution Group in the App-Coordinator

  1. Right mouse key (RMK) on the Distribution Vault File and select New, as shown to below
  2. Enter the same value for Code and Name in the resulting popup window
  3. Use the Add Search Condition button to define the objects to be included in the distribution

  1. Select the Search Condition and Category, then fill the Property filters to select the objects to include (Tip: Use the EPS search feature to determine the search conditions to meet your needs)
  2. Select Sync Target as needed
  3. Several search conditions can be defined to run when the distribution is expected. Specify Single Run Mode to execute them in sequence or Multi Run Mode to run them in parallel
  4. The Distribution Vault File name, entered in Step 2, is referenced by an external program when the distribution is run

Vault Distribution Executable

The Vault Distribution executable – NdsVltDist – is included in the EPS install set and it is in the EPS installation directory. The environment variable DS2INSTALLROOT provides the path to it—enter %DS2INSTALLROOT% into the Windows File Explorer to navigate to it.

Properties file

A properties file is used to configure the executable; an example is provided below. The “#” character denotes a comment. Anything following it on a line is ignored.

~~~~ Example Properties file ~~~~
### docs.properties #This is a comment containing the properties file name
# Mandatory Items
ACCOUNT=admin #DS-CR login, typically an admin account
PASSWORD=xxxxx #Password
VAULTFILEDISTRIBUTIONCODE=Docs #The Distribution Vault File name—see Create Distribution Group, Step 7

###

# Optional Items
ISFULL=True #True for a full set, False for a delta that includes only new or changed items since the last distribution.
LOGFOLDER= C:\ZukenBatch\VaultDist\Logs #Folder to write log file – It must exist
#LOGKEEPSIZE= # The number of logfiles to keep

#POSTBATCHFILE= # A batch file to run after processing the distribution
### Please specify the mail address delimited by comma in case of multiple addresses.
#NORMALMAIL= # Email address to send run notification
#ERRORMAIL= # Email address to send error notification

Running the NdsVltDist program

The basic command format is: NdsVltDist  /P:propertiesfile

The paths to the program and the properties file are needed. Here is an example with the paths added:

%DS2INSTALLROOT%\NdsVltDist /P:C:\ZukenBatch\VaultDist\properties\docs.properties

To automate the process, the Vault Distribution program, NdsVltDist, is typically called from a batch file that is triggered by a scheduled task. These are advanced topics beyond the scope of this article.


 

Tom Warneke
Tom Warneke
Application Engineer for DS-2/CR/OP
Tom Warneke is an applications engineer, providing customer support for DS-CR and DS-OpenEDA applications used for Electronics Product Data Management (ePDM). His work focusses on enhancing business agility, productivity, and collaboration for electronics product design and supply chain management through ePDM integration to EDA and PLM/PDM systems. Outside of work he enjoys cycling, photography and time spent with friends and family.
  • Blog
April 24, 2020
Working Remotely with DS – Design Data Management Tools

The world that we all live in has been changed by the Covid-19 outbreak. Stay at home orders and social distancing significantly impact the way we live our daily lives. Working remotely presents a whole new set of challenges for engineers and the companies that employ us. We now work on company supplied-laptops that typically connect back to the corporate network through a VPN.

Read now
  • Blog
March 31, 2020
Tech Tip: Exporting Search Results

This brief video shows you how exporting search results to a CSV (Comma Separated Values) file works. A repeated support call topic is how to export a long list of search results, so we will cover that one, too. 

Read now
  • Blog
February 20, 2020
Tech Tip: Managing BOMs Through the Component EOL Cycle with Zuken’s DS-CR

Electronic components are constantly changing, causing parts to go EOL (End-of-Life) for various reasons: companies go out of business, component product lines change hands, old technology is updated with new. Electronic product manufacturers must be agile to keep their product BOMs (bill of materials) up to date and keep their supply chain humming. Fortunately for them, Zuken’s DS-CR customers leverage component and design data relationships to tackle the problem.

Read now
  • Blog
March 19, 2019
Tech Tip on the Circuit Block Manager

Modular circuit design allows engineers to create a set of electronics building blocks that can be reused and shared between products. The Circuit Block Manager facilitates reuse management and change control of a library of circuit blocks in a convenient and organized manner. This brief video shows how simple it is to use a hierarchical schematic containing circuit blocks as the basis for a modular circuit block library within DS-CR.

Read now