部品構造

ThingWorx Navigate のカスタマイズ > カスタムタスクの作成 > コンポーネントを使用したカスタムタスクの作成 > ThingWorx Navigate コンポーネントの概要 > 使用可能なコンポーネント > アイテムリスト > 部品構造

部品構造

部品構造は、アイテムリストコンポーネントの定義済みコンフィギュレーションです。部品構造には構造ツリーが含まれており、部品または CAD ドキュメントとその子の階層関係が表示されます。ツリー内の各アイテムに対する部品構造には、コンフィギュレーションを介して選択できる属性が表示されます。デフォルトの属性は番号、名前、状態です。

ツリーの初期展開レベルを設定するように部品構造を設定できます。デフォルトでは、初期展開レベルは 3 に設定されています。ユーザーはツリー内のエレメントを展開したり折りたたんだりすることができます。

部品構造ツリーには、構造レベルを視覚的に表示するインデントが含まれています。コンフィギュレーションによってテーブルの 1 列目に表示する列を定義できます。デフォルトでは、1 列目は番号です。

部品構造のエクスポート機能はアイテムリストと同じです。エクスポートされたファイルには、構造内の各アイテムの数値レベルを示す列が含まれており、構造レベルを表示するインデントが含まれています。

「部品構造」定義済みコンフィギュレーションのサンプルイメージを以下に示します。

構造ツリーを表示しているユーザーが構造内のアイテムに対するアクセス権を持っていない場合、そのアイテムは表示されず、「いくつかのアイテムは、そのアイテムに対するアクセス権がないため非表示になっています」というメッセージが表示されます。

部品構造はアイテムリストウィジェットでのみ使用でき、廃止予定のアイテムリストマッシュアップでは使用できません。

バインドプロパティ

「部品構造」のバインドについては、アイテムリストコンポーネントを参照してください。

部品構造の場合、入力バインドプロパティで PTC.ProdMgmt.Part および PTC.CADDocumentMgmt.CADDocument オブジェクトタイプがサポートされています。

selectedItems バインドプロパティの出力には、オブジェクトタイプ PTC.ProdMgmt.PartStructureItem と PTC.CADDocumentMgmt.CADStructure.を持つアイテムが含まれています。

コンフィギュレーションプロパティ

「部品構造」の設定については、アイテムリストコンポーネントを参照してください。さらに、「部品構造」専用の次のような JSON プロパティがあります。

コンフィギュレーションの構造の詳細については、コンポーネントのコンフィギュレーション構造を参照してください。

サブプロパティの詳細については、サブプロパティとコンテナキーを参照してください。

プロパティ名

説明

プロパティタイプ

デフォルト値

必須またはオプション

defaultExpansionLevel

構造ツリーの初期展開レベルを定義します。1 から 9 までの数値と -1 を入力として受け入れます。このプロパティが -1 に設定されている場合、構造ツリーは最初は完全に展開され、すべてのレベルが表示されます。

例:

{
"defaultExpansionLevel":{
"selectedKey":[
"3"
]
}
}

• 大きな構造の場合、デフォルトを 3 より大きい値に設定すると初期ロードのパフォーマンスが低下する可能性があります。

• このプロパティに無効な入力が渡された場合、デフォルトの展開レベルは 3 になります。

ドロップダウン

オプション

attributes

詳細については、アイテムリストを参照してください。

PTC.ProdMgmt.PartStructureItem および PTC.CADDocumentMgmt.CADStructure オブジェクトタイプの属性を受け入れます。

各属性の序数プロパティを設定することで、列の順序を設定できます。序数値が 0 の属性が 1 列目に表示され、序数値が 1 の属性が 2 列目に表示されます。詳細については、序数コンフィギュレーションプロパティの使用のトピックを参照してください。

デフォルトでは、部品構造ツリーは、1 つ目の属性、つまり非負序数が最も小さい属性によって並べ替えられます。

属性セレクタ

なし

必須

サンプルコンフィギュレーション

{
"attributes":{
"inTailoring":true,
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"Part|Number",
"ordinal":0
},
{
"id":"Part|Name",
"ordinal":1
},
{
"id":"Part|State#Display",
"ordinal":2
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
},
{
"items":[
{
"id":"CADDocument|Number",
"ordinal":0
},
{
"id":"CADDocument|Name",
"ordinal":1
},
{
"id":"CADDocument|State#Display",
"ordinal":2
}
],
"objectType":"PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
"defaultExpansionLevel":{
"selectedKey":[
"3"
],
"inTailoring":true
},
"label":{
"value":""
},
"selectionType":{
"selectedKey":"multi"
},
"showExportAction":{
"additionalData":{
"itemListExportDefinition":{
"exportTypes":{
"selected":[
{
"key":"exportToCsv"
},
{
"key":"exportToExcel"
}
]
},
"exportUnFilteredData":{
"value":true
}
}
},
"value":true
},
"waitForInput":{
"value":true
},
"baseConfigurationVersion":{
"value":"nav.3"
},
"implementationConfigurationVersion":{
"value":"nav.1"
}
}

カスタマイズサービス

コンフィギュレーションに加え、コンポーネントごとにビジネスロジックを拡張してコンポーネントをカスタマイズできます。各コンポーネントのビジネスロジックには、拡張およびオーバーライド可能な Thing Template 内のサービスが含まれています。次のテーブルは、このコンポーネントのオーバーライド可能なサービスの詳細を示しています。

各サービスの戻り値とパラメータの例については、カスタマイズサービスの入力/出力の例を参照してください。

名前	説明
ComputeMessages	部品構造に表示するメッセージを計算します。現在のメッセージの JSON と候補のメッセージの JSON を受け取り、アイテムリストに表示するメッセージが含まれている通知メッセージの JSON を返します。パラメータ: getItemsResponse (必須) - getItems サービスから返されたアイテムが含まれているCCOフォーマットの JSON オブジェクト。 currentMessages (必須) - ユーザーインタフェースに表示されている現在の通知メッセージが含まれている JSON オブジェクト。 suggestedMessages (必須) - 候補のメッセージのセットが含まれている JSON オブジェクト。候補のメッセージを使用することをお勧めします。 input (オプション) - 構造のルートにあるアイテムの入力 ID が含まれているCCOフォーマットの JSON。 configuration (オプション) - コンフィギュレーションが含まれている JSON。 scope (オプション) - getItemsResponse 内のデータの範囲を示す JSON。この JSON オブジェクトには、値 root と child を受け入れる scope キーが含まれています。階層データに関連します。例: { "scope": "root" } 戻り値: アイテムリストのグリッドに表示されるメッセージが含まれている JSON オブジェクト。例: "INFO":{ { "messages":[ "[[PTC.Nav.ItemList.HiddenItemsBecauseAccessRightMessage]]" ] } }
DefHookAttributesTypesInfo	アダプタ情報および部品構造でサポートされている属性のオブジェクトタイプが格納されている JSON 配列を返します。パラメータ: なし戻り値: JSON 配列
GetChildren	部品または CAD ドキュメントを受け取り、そのアイテムの子、つまり、階層データ構造でその部品または CAD ドキュメントの 1 レベル下にあるすべてのアイテムが含まれている CCO フォーマットの JSON を返します。返された JSON には、階層データではなくフラットリストとして子が含まれています。パラメータ: input (オプション) - 構造のルートにある部品または CAD ドキュメントの入力 ID が含まれているCCOフォーマットの JSON。 configuration (必須) - コンフィギュレーションが含まれている JSON。 item (必須) - 返される子の親アイテムが含まれている JSON。戻り値: CCOフォーマットの JSON
GetConfigurations	部品構造で使用可能なコンフィギュレーションを返します。パラメータ: なし戻り値: JSON
GetImplementationSettings	部品構造の実装の設定データを返します。実装はこのサービスをオーバーライドして独自の設定を提供できます。詳細については、アイテムリストの selectedItems 入力バインドプロパティの有効化を参照してください。パラメータ: なし戻り値: JSON オブジェクト
GetItems	入力で指定されている部品または CAD ドキュメントの構造を返します。パラメータ: input (必須) - バックエンドシステムからフェッチするデータの入力 ID およびバックエンドシステムのアダプタ情報を含む、CCOフォーマットの JSON。 configuration (必須) - 調整マネージャリソースから取得した最終マージコンフィギュレーションを含む JSON。戻り値: CCOフォーマットの JSON
GetItemsByExpansionPath	ルートからリクエストされたアイテムまでのパス上にあるすべてのアイテム (リクエストされたすべての属性、itemIdentifierKeys、itemExpansionKeys を含む) が含まれている階層構造 CCO を返します。階層構造 CCO にはパス上のすべての兄弟が含まれています。このサービスは、ロードされていないアイテムを指定する入力を selectedItems バインドプロパティが受け取った場合に呼び出されます。パラメータ: input (オプション) - 構造のルートにある部品または CAD ドキュメントの入力 ID が含まれているCCOフォーマットの JSON。 configuration (必須) - コンフィギュレーションが含まれている JSON。 itemExpansionValues (必須) - 展開がリクエストされた部品または CAD ドキュメントの itemExpansionKeys が格納されている JSON 配列。この配列の値は、ツリー内のパスに従って、ルートの部品または CAD ドキュメントを先頭に並べ替えられます。戻り値: CCOフォーマットの JSON
GetStructureSkeleton	階層構造のすべてのレベルを CCO フォーマットで返します。ここで、構造内の各部品または CAD ドキュメントには、GetImplementationSettings サービスで定義されているように、itemIdentifierKeys と itemExpansionKeys の両方が含まれています。パラメータ: input (オプション) - 構造のルートにある部品または CAD ドキュメントの入力 ID が含まれているCCOフォーマットの JSON。 configuration (必須) - コンフィギュレーションが含まれている JSON。戻り値: CCOフォーマットの JSON
MapItemToInputObject	部品または CAD ドキュメントを入力にマッピングし、これを GetItems サービスで使用できます。パラメータ: input (オプション) - 構造のルートにある部品または CAD ドキュメントの入力 ID が含まれているCCOフォーマットの JSON。 item (必須) - マッピングする部品または CAD ドキュメントが含まれている JSON。戻り値: 単一の部品または CAD ドキュメントの id 属性だけが含まれているCCOフォーマットの 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": [
{
"selectionGroupIds": [
"PSI"
],
"objectType": "PTC.ProdMgmt.PartStructureItem"
},
{
"selectionGroupIds": [
"CS"
],
"objectType": "PTC.CADDocumentMgmt.CADStructure"
}
],
"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": "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"
}
],
"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": [
{
"selectionGroupIds": [
"PSI"
],
"objectType": "PTC.ProdMgmt.PartStructureItem"
},
{
"selectionGroupIds": [
"CS"
],
"objectType": "PTC.CADDocumentMgmt.CADStructure"
}
],
"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": [
{
"selectionGroupIds": [
"PSI"
],
"objectType": "PTC.ProdMgmt.PartStructureItem"
},
{
"selectionGroupIds": [
"CS"
],
"objectType": "PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": 1
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "filterFields"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"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": {
"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"
}
]
}

これは役に立ちましたか?