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 a list of all available configuration properties for Design Files, see the Configuration Properties table for the Item List component. The following table provides additional information that is specific to Design Files regarding configuration properties.
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.
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
| 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"
}
]
}