自訂 ThingWorx Navigate > 建立自訂任務 > 使用元件建立自訂任務 > ThingWorx Navigate 元件概觀 > 可用元件 > 項目清單 > 設計檔案
設計檔案
「設計檔案」是「項目清單」元件的預先定義組態，可顯示「零件」與 CAD 文件的設計檔案清單，其中包含描述者文件、參考者文件、附件與表示。「設計檔案」與「項目清單」具有類似的搜尋、排序、篩選及還原預設值功能。針對每個檔案，「設計檔案」都會顯示您可以透過組態選擇的屬性。預設屬性是「名稱」與「格式」，且其為自訂屬性。名稱包含可下載檔案的連結，而格式則包含具有其他所有可用下載格式且僅與表示相關的下拉選單。
以下是顯示設計檔案預先定義組態的範例圖像：
繫結內容 
如需有關繫結「設計檔案」的資訊，請參閱項目清單元件。
* 
• 針對「設計檔案」，輸入繫結內容支援 PTC.CADDocumentMgmt.CADDocument 與 PTC.ProdMgmt.Part 物件類型。
• selectedItems 繫結內容的輸出包含具有 PTC.ContentItem 與 PTC.VisualizationRepresentation 物件類型的項目。
組態內容 
如需有關配置「設計檔案」的資訊，請參閱項目清單元件。此外，下列 JSON 內容為「設計檔案」所特有。
如需有關組態結構的詳細資訊，請參閱元件組態結構。
如需有關子內容的詳細資訊，請參閱子內容與容器金鑰。
內容名稱
描述
內容類型
預設值
必要或選用
fileFormatsToDisplay
決定將擷取並顯示在「格式」欄下拉選單中的表示檔案格式。此子內容僅在將 representation 金鑰包含在 relationships 內容中時才相關。
選項：
• specifiedFormatsOnly - 僅擷取指定的檔案格式；使用 specifiedFormatsDefinition 內容來指定要包括的檔案格式。檔案格式以其在 specifiedFormatsDefinition 內容中列出的相同順序顯示在下拉選單中。
• allAvailableFormats - 擷取所有可用檔案格式。如果有適用設計檔案的 PDF 格式，「名稱」欄會包含下載 PDF 的連結，且 PDF 將是下拉選單中列出的第一種格式。
* 
如果只有一種檔案格式適用於表示，該格式會顯示在「名稱」欄下，且「格式」欄為空。
此子內容放置在元件組態中的 representationDefinition 內容下。
specifiedFormatsOnly
必要
showImplementationActions
當此內容包括 downloadZip 金鑰時，設計檔案會在內嵌「動作列」中包括全部下載按鈕。這可讓使用者下載所有設計檔案。
downloadZip 是「設計檔案」針對此內容支援的唯一值。
N/A
選用
specifiedFormats
要針對表示擷取之指定格式的清單。格式應以空格分隔。此處列出的格式順序指示這些格式在「格式」欄下拉選單中的顯示順序。
這是 fileFormatsToDisplay 的子內容，且僅在將 fileFormatsToDisplay 設定為 specifiedFormatsOnly 時相關。
PDF DXF PLT CGM
必要
relationships
要根據與零件或 CAD 文件之間的關係顯示之設計檔案類型的清單。可包含下列一或多個金鑰：
• describeBy 可顯示描述者文件
• referencedDocuments 可顯示參考者文件
• attachments 可顯示附件
• representation 可顯示表示
* 
representation 金鑰包含 representationDefinition 金鑰下的其他資訊。
N/A
必要
attributes
如需詳細資訊，請參閱項目清單。
接受 PTC.ContentItem 與 PTC.VisualizationRepresentation 物件類型的屬性。
此外，也接受分別擁有 PTC.Nav.DesignFiles.Custom.Implementation 與 PTC.Visualization.Representation.Custom.Implementation 物件類型的 Name 與 Formats 屬性。
N/A
必要
defaultSortField
如需詳細資訊，請參閱項目清單。
接受 PTC.ContentItem 與 PTC.VisualizationRepresentation 物件類型的屬性。
此外，也接受分別擁有 PTC.Nav.DesignFiles.Custom.Implementation 與 PTC.Visualization.Representation.Custom.Implementation 物件類型的 Name 與 Formats 屬性。
N/A
選用
範例組態 
{
"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
}
}
自訂服務 
除組態以外，每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明：
如需每個服務的傳回結果與參數範例，請參閱自訂服務的輸入/輸出範例。
名稱
描述
GetConfigurations
傳回「設計檔案」的可用組態。
參數：無
傳回：JSON
GetImplementationSettings
傳回設定資料，其中包含適用於「下載全部」按鈕的資料。此資料由「設計檔案」實行在內部使用。
參數：無
傳回：JSON 物件
GetItems
傳回來自後端系統的設計檔案清單及其屬性與值。
參數：
input (必要) - CCO 格式的 JSON，其中包括要從後端系統擷取之資料的輸入 ID，以及後端系統的轉接器資訊。
configuration (必填) - 包含組態的 JSON。
傳回：CCO 格式的 JSON
DefHookGetImplementationActionsList
傳回列在 GetImplementationSettings 服務中 implementationActions 金鑰下的動作。
參數：無
傳回：JSON:Array
DefHookImplementationConfigurationDefinitionGroup
傳回具有可用自訂組態的「設計檔案」實行定義。包括 relationships、fileFormatsToDisplay 與 specifiedFormats 組態內容的定義。
參數：無
傳回：JSON:Array
實行定義 
{
"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"
}
]
}
這是否有幫助?