Design Files
Design Files is a predefined configuration of the Item List component that displays a list of design files for both Parts and CAD documents, including described by documents, referenced by documents, attachments, and representations. Design Files has similar search, sort, filter and restore defaults capabilities as Item List. For each file, Design Files displays attributes which you can choose via configuration. The default attributes are Name and Formats, which are custom attributes. Name contains a link to download the file and Formats contains a drop-down menu with all other available formats for download, and is only relevant for representations.
The following is a sample image showing the Design Files predefined configuration:
Binding Properties 
For information on binding Design Files, see the Item List component.
* 
For Design Files, the input binding property supports the PTC.CADDocumentMgmt.CADDocument and PTC.ProdMgmt.Part object types.
The output of the selectedItems binding property contains items with the PTC.ContentItem and PTC.VisualizationRepresentation object types.
Configuration Properties 
For information on configuring Design Files, see the Item List component. In addition, the following JSON properties are specific to Design Files.
For more information on the structure of the configuration, see Component Configuration Structure.
For more information on sub-properties, see Sub-Properties and Container Keys.
Property Name
Description
Property Type
Default Value
Required or Optional
fileFormatsToDisplay
Determines what representation file formats are retrieved and displayed in the drop-down menu in the Formats column. This sub-property is only relevant when the representation key is included in the relationships property.
Options:
specifiedFormatsOnly– only retrieves the specified file formats; use the specifiedFormatsDefinition property to specify file formats to include. The file formats are displayed in the drop-down menu in the same order that they are listed in the specifiedFormatsDefinition property.
allAvailableFormats– retrieves all available file formats. If there is a PDF format available for the design file, the Name column contains a link to download the PDF, and PDF is the first format listed in the drop-down menu.
* 
If there is only one file format available for a representation, that format is shown under the Name column, and the Formats column is empty.
This sub-property is placed under the representationDefinition property in the component configuration.
specifiedFormatsOnly
Required
showImplementationActions
When this property includes the downloadZip key, Design Files includes a download all button in the embedded Action Bar. This allows users to download all design files.
downloadZip is the only value supported by Design Files for this property.
N/A
Optional
specifiedFormats
The list of specified formats to retrieve for representations. Formats should be separated with a space. The order in which the formats are listed here dictates the order that they appear in the drop-down menu in the Formats column.
This is a sub-property to fileFormatsToDisplay and is only relevant when fileFormatsToDisplay is set to specifiedFormatsOnly.
PDF DXF PLT CGM
Required
relationships
The list of types of design files to display based on the relationship to the part or CAD document. Can include one or more of the following keys:
describeBy to display described by documents
referencedDocuments to display referenced by documents
attachments to display attachments
representation to display representations
* 
The representation key contains additional information under the representationDefinition key.
N/A
Required
attributes
See Item List for more information.
Accepts attributes of the PTC.ContentItem and PTC.VisualizationRepresentation object types.
Additionally, accepts the Name and Formats attributes, which have the PTC.Nav.DesignFiles.Custom.Implementation and PTC.Visualization.Representation.Custom.Implementation object types respectively.
N/A
Required
defaultSortField
See Item List for more information.
Accepts attributes of the PTC.ContentItem and PTC.VisualizationRepresentation object types.
Additionally, accepts the Name and Formats attributes, which have the PTC.Nav.DesignFiles.Custom.Implementation and PTC.Visualization.Representation.Custom.Implementation object types respectively.
N/A
Optional
Sample Configuration 
{
"showImplementationActions":{
"selected":[
{
"key":"downloadZip"
}
]
},
"selectionType":{
"selectedKey":"none"
},
"waitForInput":{
"value":true
},
"implementationConfiguration":{
"inTailoring":true,
"value":{
"relationships":{
"selected":[
{
"key":"describeBy"
},
{
"key":"referencedDocuments"
},
{
"key":"attachments"
},
{
"key":"representation",
"additionalData":{
"representationDefinition":{
"value":{
"fileFormatsToDisplay":{
"selectedKey":"specifiedFormatsOnly",
"additionalData":{
"specifiedFormatsDefinition":{
"specifiedFormats":{
"value":"PDF DXF PLT CGM"
}
}
}
},
"filesToDisplay":{
"selectedKey":"defaultFileOnly"
}
}
}
}
}
]
}
}
},
"baseConfigurationVersion":{
"value":"nav.3"
},
"implementationConfigurationVersion":{
"value":"nav.1"
},
"defaultSortFields":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"additionalData":{
"itemListDefaultSortFieldDefinition":{
"defaultSortDirection":{
"selectedKey":"asc"
}
}
},
"id":"Name"
}
],
"objectType":"PTC.Nav.DesignFiles.Custom.Implementation"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
"attributes":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"Name",
"ordinal":0
}
],
"objectType":"PTC.Nav.DesignFiles.Custom.Implementation"
},
{
"items":[
{
"id":"Formats",
"ordinal":1
}
],
"objectType":"PTC.Visualization.Representation.Custom.Implementation"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
"label":{
"value":""
},
"showExportAction":{
"value":false
},
"enableSearch":{
"additionalData":{
"itemListSearchDefinition":{
"searchHintText":{
"value":"[[PTC.Nav.DesignFiles.FindDesignLabel]]"
}
}
},
"value":true
}
}
Customization Services 
In addition to configuration, each component supports extending its business logic to customize the component. The business logic of each component includes overridable services in a Thing Template that you can extend and override. The overridable services for this component are detailed in the following table.
For examples of returns and parameters for each service, see Examples of Input/Output for Customization Services.
Name
Description
GetConfigurations
Returns the available configurations for Design Files.
Parameters: None
Returns: JSON
GetImplementationSettings
Returns the settings data, which includes data for the download all button. This data is used internally by the Design Files implementation.
Parameters: None
Returns: JSON object
GetItems
Returns the list of design files from the backend system, together with their attributes and values.
Parameters:
input (Required)– JSON in CCO format that includes the input ID for the data to be fetched from the backend system and the adapter information for the backend system.
configuration (Required)– JSON with the configuration.
Returns: JSON in CCO format
DefHookGetImplementationActionsList
Returns the actions listed under the implementationActions key in the GetImplementationSettings service.
Parameters: None
Returns: JSON:Array
DefHookImplementationConfigurationDefinitionGroup
Returns the Design Files implementation definition with the available custom configurations. Includes the definition for the relationships, fileFormatsToDisplay, and specifiedFormats configuration properties.
Parameters: None
Returns: JSON:Array
Implementation Definition 
{
"array": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "actionBarConfigurationJSON"
}
]
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.DefinitionGroup"
},
"mandatory": false,
"key": "actionBarConfiguration"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"additionalDefinition": [{
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "fieldTitleOverride"
}
],
"key": "itemListAttributesDefinition"
}, {
"directDefinition": [],
"key": "implementationAttributesDefinition"
}
],
"updateServiceName": "",
"minimumSelectedAttributes": null,
"supportedTypes": {
"data": [{
"itemListsData": [{
"objectType": "PTC.ContentItem"
}, {
"objectType": "PTC.Visualization.Representation"
}, {
"objectType": "PTC.Nav.DesignFiles.Custom.Implementation"
}, {
"objectType": "PTC.Visualization.Representation.Custom.Implementation"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": true,
"key": "attributes"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [{
"label": "1",
"key": "1"
}, {
"label": "2",
"key": "2"
}, {
"label": "3",
"key": "3"
}, {
"label": "4",
"key": "4"
}, {
"label": "5",
"key": "5"
}, {
"label": "6",
"key": "6"
}, {
"label": "7",
"key": "7"
}, {
"label": "8",
"key": "8"
}, {
"label": "9",
"key": "9"
}, {
"label": "-1",
"key": "-1"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Dropdown"
},
"mandatory": false,
"key": "defaultExpansionLevel"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"additionalDefinition": [{
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [{
"description": "Sort column in ascending order",
"label": "[[PTC.Nav.ItemList.SortOrder.Asc]]",
"key": "asc"
}, {
"description": "Sort column in descending order",
"label": "[[PTC.Nav.ItemList.SortOrder.Dsc]]",
"key": "dsc"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "defaultSortDirection"
}
],
"key": "itemListDefaultSortFieldDefinition"
}
],
"updateServiceName": "",
"minimumSelectedAttributes": null,
"supportedTypes": {
"data": [{
"itemListsData": [
"objectType": "PTC.ContentItem"
}, {
"objectType": "PTC.Visualization.Representation"
}, {
"objectType": "PTC.Nav.DesignFiles.Custom.Implementation"
}, {
"objectType": "PTC.Visualization.Representation.Custom.Implementation"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "defaultSortFields"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": true,
"true": {
"additionalDefinition": [{
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "searchHintText"
}
],
"key": "itemListSearchDefinition"
}
],
"label": "[[PTC.Nav.Yes]]"
},
"false": {
"additionalDefinition": [],
"label": "[[PTC.Nav.No]]"
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "enableSearch"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"additionalDefinition": [{
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"dynamicallySetTypeServiceName": "GetFilterTypeDefinitionForFilterField",
"type": {
"enum": {
"options": [],
"updateServiceName": null,
"dynamicallySetOptionsServiceName": null,
"addServiceName": null,
"multiSelect": null
}
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.FieldFilter"
},
"mandatory": false,
"key": "defaultSelectedFilterValues"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "filterLabelOverride"
}
],
"key": "itemListFilterFieldDefinition"
}
],
"updateServiceName": "",
"minimumSelectedAttributes": 0,
"supportedTypes": {
"data": [{
"itemListsData": [{
"objectType": "PTC.ContentItem"
}, {
"objectType": "PTC.Visualization.Representation"
}, {
"objectType": "PTC.Nav.DesignFiles.Custom.Implementation"
}, {
"objectType": "PTC.Visualization.Representation.Custom.Implementation"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "filterFields"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": "",
"overflow": null,
"minimumSelectedItems": null,
"options": [{
"key": "describeBy",
"label": "[[PTC.Nav.ViewDesignFilesAppTailoringPageContent.DescribeBy]]",
"data": {}
"description": "Option to show the Design files for related Described By documents.",
}, {
"key": "referencedDocuments",
"label": "[[PTC.Nav.ViewDesignFilesAppTailoringPageContent.ReferencedDocuments]]",
"data": {}
"description": "Option to show the Design files for related Referenced By documents.",
}, {
"key": "attachments",
"label": "[[PTC.Nav.ViewDesignFilesAppTailoringPageContent.Attachments]]",
"data": {}
"description": "Option to show the Design files for related Attachments.",
}, {
"key": "representation",
"label": "[[PTC.Nav.ViewDesignFilesAppTailoringPageContent.Representation]]",
"data": {}
"description": "Option to show the Design files for related Representations.",
"additionalDefinition": [{
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [{
"description": "Display design files to related default representation only.",
"label": "[[PTC.Nav.ViewDesignFilesAppTailoringPageContent.DefaultFileOnly]]",
"key": "defaultFileOnly"
}, {
"description": "Display design files for to all related representations.",
"label": "[[PTC.Nav.ViewAppsCommon.Tailoring.AllFiles]]",
"key": "allFiles"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": true,
"key": "filesToDisplay"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [{
"description": "[[PTC.Nav.ViewAppsCommon.Tailoring.SpecifiedFormatsOnlyHelpText]]",
"label": "[[PTC.Nav.ViewAppsCommon.Tailoring.SpecifiedFormatsOnly]]",
"key": "specifiedFormatsOnly",
"additionalDefinition": [{
"directDefinition": [{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": true,
"key": "specifiedFormats"
}
],
"key": "specifiedFormatsDefinition"
}
]
}, {
"description": "[[PTC.Nav.ViewAppsCommon.Tailoring.AllAvailableFormatsHelpText]]",
"label": "[[PTC.Nav.ViewAppsCommon.Tailoring.AllAvailableFormats]]",
"key": "allAvailableFormats"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "fileFormatsToDisplay"
}
],
"key": "representationDefinition"
}
]
}
],
"updateServiceName": null,
"addServiceName": null,
"constraints": {}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.CheckboxArray"
},
"mandatory": false,
"key": "relationships"
}
]
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.DefinitionGroup"
},
"mandatory": false,
"key": "implementationConfiguration"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "label"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"minValue": 50,
"default": 500,
"maxValue": 10000,
"step": 50
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Number"
},
"mandatory": false,
"key": "maxNumberOfRowsInGrid"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [{
"description": "Disallow items selection",
"label": "[[PTC.Nav.ItemList.SelectionType.None]]",
"key": "none"
}, {
"description": "Allow single item selection",
"label": "[[PTC.Nav.ItemList.SelectionType.Single]]",
"key": "single"
}, {
"description": "Allow multiple items selection",
"label": "[[PTC.Nav.ItemList.SelectionType.Multiple]]",
"key": "multi"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "selectionType"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": true,
"true": {
"additionalDefinition": [{
"directDefinition": [{
"property": {
"options": [
[{
"label": "[[PTC.Nav.ItemList.ExportCSVActionLabel]]",
"key": "exportToCsv"
}, {
"label": "[[PTC.Nav.ItemList.ExportCSVAsExcelActionLabel]]",
"key": "exportToExcel"
}
]
]
},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": "",
"overflow": null,
"minimumSelectedItems": null,
"options": [],
"updateServiceName": null,
"addServiceName": null,
"constraints": {}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.CheckboxArray"
},
"mandatory": false,
"key": "exportTypes"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": false,
"true": {
"additionalDefinition": [],
"label": null
},
"false": {
"additionalDefinition": [],
"label": null
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "exportUnFilteredData"
}
],
"key": "itemListExportDefinition"
}
],
"label": "[[PTC.Nav.Yes]]"
},
"false": {
"additionalDefinition": [],
"label": "[[PTC.Nav.No]]"
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "showExportAction"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"listLabel": null,
"showFilter": false,
"minimumSelectedItems": 0,
"showDropDown": false,
"options": [{
"label": "[[PTC.Nav.Drawings.DownloadAll]]",
"key": "downloadZip"
}
],
"updateServiceName": null,
"addServiceName": null,
"showClearSelectedItems": false,
"dropDownLabel": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.List"
},
"mandatory": false,
"key": "showImplementationActions"
}, {
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": false,
"true": {
"additionalDefinition": [],
"label": "[[PTC.Nav.Yes]]"
},
"false": {
"additionalDefinition": [],
"label": "[[PTC.Nav.No]]"
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "waitForInput"
}
]
}
Was this helpful?