System Capture Configuration

Top  Previous  Next

The System Capture configuration tab allows you to:

Configure the location in which to create your PTF file.

Define field and value name substitution rules to apply during PTF file creation.

Generate the PTF file of formal parts with a report logging substitutions applied and number of parts for each System Capture Part.

You will need to have permissions to configure these settings or create a PTF file. To enable CIP to provide full functionality with CIP System Capture client plug-in, you must enable the Transfer Fields to Design settings to either System Capture or CIP and System Capture as shown in the following figure.

Admin-Configuration-TransferToDesign

Characters allowed for field names in System Capture include only the following character set: 0-9, a-z, and _. Additionally, length of field names cannot exceed 30 characters. For example, field names such as Rated Voltage or Rated Power will not be allowed in System Capture. To avoid manually changing all your field names and potentially affecting OrCAD Capture designs, you can define substitution rule using the System Capture tab in Admin > Configuration.

Configure Location of PTF file:

The PTF file is not required by CIP to place parts onto a schematic page. The PTF file is used by System Capture to display parts in Unified Search as well as other System Capture functions.

1.Make sure you open CIP while inside System Capture if you plan on generating the PTF file. The location, subtitution rules, and PTF report functions can be used inside or outside of System Capture.

2.Select Admin > Configuration > System Capture.

Admin-Configuration-SystemCapture1

3.Select the Edit Button_Edit button to enter/edit the PTF File location.

4.Enter the path of the PTF file. The PTF file should be placed in the same location as your library. CIP will add this path to the site.cpm file during PTF generation.  A path name that includes CDS_SITE will ensure consistent access by all users. Prepend a "$" to specify a directory relative to a predefined environment variable. If using the System Capture starter library as your guide, enter $CDS_SITE/Libraries/SysCapModel.

Admin-Configuration-SystemCapture2

Note: If the CDS_SITE environment variable was not set up during installation of the CIP System Capture Client plugin, you will need to set it up manually and restart System Capture.

5.Click the Save Button_Save button.

Define Substitution Rules for PTF Generation:

The format of the PTF file must conform to specifications for DE-HDL. Additional information may be found in Cadence documentation Working with Part Table Files (PTF) in Design Entry HDL.

PTF files for System Capture and indexer have restriction on fields and values. Supported characters for field names consists of a-z, 0-9, and _. Field name lengths are limited to 31. Truncation of fields to meet the length requirement may lead to duplicate field names. To ensure a validate PTF is generated, by default, a sequential number will be added. You have the option to change this to a letter. Options available for field name substitution of unsupported characters are removal or replacement with an underscore. Options available for value substitution of unsupported characters are provided in the UI. Alternately, you may modify the display name of the field.

1.Select Admin > Configuration > System Capture

2.Click the Edit Button_Edit button to change Data Validation and Substitution Rules for PTF Generation. This option ensures that truncation of fields do not to duplicate field names.

Admin-Configuration-SystemCapture4

3.Use the pull down list to change the rules you want to apply. Click the Save Button_Save button when complete.

Admin-Configuration-SystemCapture5

Generate PTF file:

The PTF generation process performed by CIP performs the following:

Generate PTF Report with defined (substitution) rules  and the number of parts, before the PTF file is actually created.

Generate PTF File (global.ptf) using the same Defined (Substitution) Rules as the report. A backup of the prior global.ptf is save each time the Generate button is clicked.

Indexing of the System Capture Library and PTF file to show models and parts in the System Capture Unified Search.

 

Steps for PTF file generation are:

1.Review the substitution rules to ensure they contains the rules you want to apply during PTF generation.

2.Click the Report button to see a report of the parts before generating the PTF file.  If running Report while in System Capture, it may take more time for System Capture to display the entirety of results. You may run the report in a standard browser (such as Chrome or Edge) for faster response time.

Admin-Configuration-SystemCapture3

3.Review the PTF Report on the right side of the page, which was created using your defined substitution rules. Look for reported PTF Errors and fix any issues before proceeding to Generate. You may save a copy of the Report when using a standard browser.

PTF_Report

4.Click the Generate button, which is enabled inside System Capture in order to run the indexing process. This will Generate the PTF Report and PTF File, and perform indexing of the System Capture Library and PTF file. These processes run in parallel and performance will depend on the configuration, hardware, and security rules set on your web, database, and file servers. The activity busy screen shows during Report generation. This process can take several minutes for a large library or number of parts. Once the PTF file is created, a command window opens to index the contents of your library and PTF file. DO NOT close this window until you see the message to "Press any key to continue..." that indicates completion. Review the command window screen for any errors before pressing any key to continue, since the window will dismiss immediately after you press any key. The index process enables System Capture to display parts and library models in Unified Search.

Admin-Configuration-SystemCapture3a

5.A completion pop-up window appears when the PTF report and PTF file have been created. The indexing of the PTF file occurs in parallel. You may click OK to dismiss the Generate PTF window and continue using CIP. Press any key in the command window screen to dismiss the indexing window. Both of these processes need to finish before you can use the parts in System Capture's Unified Search.

PTFandIndexer