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 になります。
* 
製品表現に使用できるファイルフォーマットが 1 つだけの場合、そのフォーマットが「名前」列に表示され、「フォーマット」列は空になります。
このサブプロパティは、コンポーネントコンフィギュレーションのプロパティ representationDefinition の下に配置されます。
specifiedFormatsOnly
必須
showImplementationActions
このプロパティに downloadZip キーが含まれている場合、「設計ファイル」の埋め込み操作バーに「すべてダウンロード」ボタンが含まれます。これによりユーザーはすべての設計ファイルをダウンロードできます。
図面ファイルによってサポートされているこのプロパティの値は downloadZip のみです。
なし
オプション
specifiedFormats
取得対象として指定した製品表現のフォーマットのリスト。各フォーマットはスペースで区切る必要があります。ここでフォーマットが表示される順序によって、「フォーマット」列のドロップダウンメニューに表示される順序が決まります。
これは fileFormatsToDisplay のサブプロパティであり、fileFormatsToDisplay が specifiedFormatsOnly に設定されている場合にのみ関連します。
PDF DXF PLT CGM
必須
relationships
部品または CAD ドキュメントとの関係に基づいて表示される設計ファイルのタイプのリスト。次のうち 1 つ以上のキーが含まれることがあります。
• describeBy - 詳細ドキュメントを表示する
• referencedDocuments - 親参照ドキュメントを表示する
• attachments - 添付資料を表示する
• representation - 製品表現を表示する
* 
representation キーには、representationDefinition キーの下に追加情報が含まれています。
なし
必須
attributes
詳細については、アイテムリストを参照してください。
PTC.ContentItem および PTC.VisualizationRepresentation オブジェクトタイプの属性を受け入れます。
さらに、PTC.Nav.DesignFiles.Custom.Implementation オブジェクトタイプの Name 属性と PTC.Visualization.Representation.Custom.Implementation オブジェクトタイプの Formats 属性を受け入れます。
なし
必須
defaultSortField
詳細については、アイテムリストを参照してください。
PTC.ContentItem および PTC.VisualizationRepresentation オブジェクトタイプの属性を受け入れます。
さらに、PTC.Nav.DesignFiles.Custom.Implementation オブジェクトタイプの Name 属性と PTC.Visualization.Representation.Custom.Implementation オブジェクトタイプの Formats 属性を受け入れます。
なし
オプション
サンプルコンフィギュレーション 
{
"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
}
}
カスタマイズサービス 
コンフィギュレーションに加え、コンポーネントごとにビジネスロジックを拡張してコンポーネントをカスタマイズできます。各コンポーネントのビジネスロジックには、拡張およびオーバーライド可能な Thing Template 内のサービスが含まれています。次のテーブルは、このコンポーネントのオーバーライド可能なサービスの詳細を示しています。
各サービスの戻り値とパラメータの例については、カスタマイズサービスの入力/出力の例を参照してください。
名前
説明
GetConfigurations
「設計ファイル」で使用できるコンフィギュレーションを返します。
パラメータ: なし
戻り値: JSON
GetImplementationSettings
「すべてダウンロード」ボタンのデータを含む設定データを返します。このデータは、設計ファイル実装によって内部で使用されます。
パラメータ: なし
戻り値: JSON オブジェクト
GetItems
バックエンドシステムから設計ファイルのリストとその属性および値を返します。
パラメータ:
input (必須) - バックエンドシステムからフェッチするデータの入力 ID およびバックエンドシステムのアダプタ情報を含む、CCOフォーマットの JSON。
configuration (必須) - コンフィギュレーションが含まれている JSON。
戻り値: CCOフォーマットの JSON
DefHookGetImplementationActionsList
GetImplementationSettings サービスの implementationActions キーの下にリストされている操作を返します。
パラメータ: なし
戻り値: JSON 配列
DefHookImplementationConfigurationDefinitionGroup
使用可能なカスタムコンフィギュレーションを含む設計ファイル実装定義を返します。relationships、fileFormatsToDisplay、および specifiedFormats のコンフィギュレーションプロパティの定義が含まれています。
パラメータ: なし
戻り値: JSON 配列
実装定義 
{
"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"
}
]
}
これは役に立ちましたか?