Building Blocks for Component Configuration
The configuration for each component is written in JSON format and is made up of many configuration properties. There are many different types of configuration properties— for example, a property may define something simple, such as a string, integer, or Boolean, or something more complex, such as a list of items to return from the backend system. Each type of property has a different internal JSON structure. Understanding the property types and their structures will help you configure your components effectively.
Some properties have multiple configuration options, and when you choose one of the options, the property has a sub-property that you can use to further configure the component. Note that these sub-properties are not shown in the structures or examples listed below, because they vary. For more information, see Sub-Properties and Container Keys.
 |
Each of the property types below can include the inTailoring key with a Boolean value. This key can be used only in cases where there is a dedicated tailoring page for your custom task.
|
Textbox
Name: PTC.Nav.DynamicForm.Textbox
Description: Text string. Used primarily for labels.
Structure:
{
"value": "content of label"
}Example of a textbox from the progressBarMessage key in Task Progress:
{
"value":"[[PTC.Nav.TaskProgress.ProgressBarMessage]]"
}Toggle
Name: PTC.Nav.DynamicForm.Toggle
Description: The value is one of two options. Options are true and false.
Structure:
{
"value": true
}Example of a toggle from the showImage key in Item Identity:
{
"value":false
}Number
Name:PTC.Nav.DynamicForm.Number
Description: Number.
Structure:
{
"value": 500
}Example of a number from the maxTileCount key in Tiles:
{
"":{
"value":"5"
}
}Mashup Selector
Name:PTC.Nav.DynamicForm.MashupSelector
Description: Name of a mashup. Used to create links to a specific mashup.
Structure:
{
"mashupName": "name of mashup",
}Example of a mashup selector from thelinkToMashup key in Tasks:
{
"mashupName":"PTC.CRDetailedReviewAppMashup"
}Radio Button
Name:PTC.Nav.DynamicForm.RadioButton
Description: The value is one of the values specified in the component definition.
Structure:
{
"selectedKey" : "option1",
}Example of a radio button from the selectionType key in Attachments:
{
"selectedKey":"multi"
}In the above example, the options for selectedKey are none, single, and multi.
Checkbox Array
Name:PTC.Nav.DynamicForm.CheckBoxArray
Description: The value is one or more of the keys specified in the component definition.
Structure:
{
"selected":[
{
"key":"option1"
},
{
"key":"option3"
}
{
"key":"option6"
}
]
}Example of a checkbox array from the exportType key in Part Structure:
{
"selected":[
{
"key":"exportToCsv"
"label": "[[PTC.Nav.ItemList.ExportCSVActionLabel]]",
},
{
"key":"exportToExcel"
"label": "[[PTC.Nav.ItemList.ExportCSVAsExcelActionLabel]]"
}
]
}Dropdown
Name:PTC.Nav.DynamicForm.Dropdown
Description: The value is either one or many of the keys specified in the component definition. The component definition specifies whether the dropdown can accept only one key or multiple keys.
Structure:
{
"selected":[
{
"key":"key1",
"data":{"…"}
},
{
"key":"key2",
"data":{"…"}
}
]
}Example of a dropdown from the defaultExpansionLevel key in Part Structure:
{
"defaultExpansionLevel":{
"selected":[
"3"
]
}
}List
Name:PTC.Nav.DynamicForm.List
Description: The value is one or more of the keys specified in the component definition. Also supports ordering list items using the ordinal key.
Structure:
{
"selected":[
{
"key":"key1"
},
{
"key":"key2"
}
]
}Example of a list from the showImplementationActions key in Design Files:
{
"selected":[
{
"key":"downloadZip",
"ordinal":0
}
]
}Entity Selector (BETA)
Name:PTC.Nav.DynamicForm.EntitySelector
Description: Name of a Windchill Navigate entity, such as a Thing Shape, Thing Template, Thing, Mashup, User, or Group.
Structure:
{
"entityName": "name of entity"
}Example of an entity selector from the modelThingName key in Action Bar:
{
"entityName":"PTC.ActionBarModel.Thing"
}Field Filter
Name:PTC.Nav.DynamicForm.FieldFilter
Description: The filters object of a ThingWorx Query Parameter where the fieldName key has an empty string value.
Structure:
{
"filters" : 'filters' object of a TWX Query
}Example of a field filter from the defaultSelectedFilterValues key in Tasks:
{
"filters":{
"filters":[
{
"fieldName":"",
"type":"EQ",
"value":"POTENTIAL"
},
{
"fieldName":"",
"type":"EQ",
"value":"ACCEPTED"
}
],
"type":"Or"
}
}Definition Group
Name: PTC.Nav.DynamicForm.DefinitionGroup
Description: Placeholder that can be used to inject additional configuration properties into the component configuration.
Structure:
{
"value": {JSON representation of additional data},
}Example of a definition group from the implementationConfiguration key in Tasks:
{
"value":{
"taskTypeFilter":{
"value":"[{\"activityName\": \"Conduct Online CRB Review\",\"workItemProcessTemplate\": \"Change Request Workflow\"}]"
}
}
}Attributes Selector
Name:PTC.Nav.DynamicForm.AttributesSelector
Description: Used to select one or more attributes from the backend system. See the section Structure for Selecting Attributes below for more information.
Structure:
{
"selectedValues": {
"data": [{
"adapter": {
"thingName": "WindchillAdapterThing",
"instanceName": "JapanWindchill"
},
"itemListsData": [{
"objectType": "WT.PART.WTPart",
"items": [{
"id": "name of property",
"additionalData": {
"ContainerKey1":{additional properties},
"ContainerKey"2:{additional properties},
},
"ordinal": 2
},
{
"id": "name of property",
"additionalData": {
"ContainerKey1":{additional properties},
"ContainerKey2":{additional properties},
},
"ordinal": 1
}]
}
},
{
"adapter": {
"thingName": "WindchillAdapterThing",
"instanceName": "UKWindchill"
},
"itemListsData": [{
"objectType": "WT.PART.WTPart",
"items": [{
"id": "name of property",
"additionalData": {
"ContainerKey1":{additional properties},
"ContainerKey2":{additional properties},
},
"ordinal": 0
},
{
"id": "name of property",
"additionalData": {
"ContainerKey1":{additional properties},
"ContainerKey2":{additional properties},
},
"ordinal": 3
}]
}]
}]
},
}Example of an attributes selector from the attributes key in Tasks:
{
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"implementationAttributesDefinition":{
"linkToMashup":{
"mashupName":"PTC.CRDetailedReviewAppMashup"
}
},
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Activity|Name",
"ordinal":0
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Subject|SubjectName",
"ordinal":1
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Activity|Deadline",
"ordinal":2
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Status#Display",
"ordinal":3
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Activity|Context|Name",
"ordinal":4
}
],
"objectType":"PTC.Workflow.WorkItem"
},
{
"items":[
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":"PTC.Nav.TaskList.TaskProgress"
}
}
},
"id":"TaskProgress",
"ordinal":5
}
],
"objectType":"PTC.Workflow.WorkItem.Custom.Implementation"
}
]
}
]
}
}Attributes Sets Selector
Name:PTC.Nav.DynamicForm.AttributesSetsSelector
Description: Used to select attributes from the backend system and separate them into different groups. The value for name is a string that is the name of the set of attributes. The data key contains the same structure as the Attributes Selector property type. See the section Structure for Selecting Attributes below for more information.
Structure:
{
"sets": [
{
"name": "Set Name 1",
"data": {Structure for Selecting Attributes}
},
{
"name": "Set Name 2",
"data": {Structure for Selecting Attributes}
}
],
}Example of an attributes sets selector from the attributes key in Attributes:
{
"sets":[
{
"data":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"PTC.WCAdapter",
"thingName":"windchill"
}
}
]
}
},
"name":""
}
]
}Pattern Selector
Name:PTC.Nav.DynamicForm.PatternSelector
Description: Used to create a string or pattern that includes one or more attributes from the backend system. The structure for this property type is very similar to the Structure for Selecting Attributes, with the addition of the numericIdentifier key for each attribute and the pattern key at the end. In the pattern key, the % symbol together with a number represents the attribute that has the same number as its numericIdentifier value. In the user interface, the attribute name is shown in the pattern string.
Structure:
{
"selectedValues": {
"data": [{
"adapter": {
"thingName": "WindchillAdapterThing",
"instanceName": "JapanWindchill"
},
"itemListsData": [{
"objectType": "WT.PART.WTPart",
"items": [{
"id": "sold",
"numericIdentifier": 0
},
{
"id": "totalStock",
"numericIdentifier": 2
}]
}
},
{
"adapter": {
"thingName": "WindchillAdapterThing",
"instanceName": "UKWindchill"
},
"itemListsData": [{
"objectType": "WT.PART.WTPart",
"items": [{
"id": "totalStock",
"numericIdentifier": 1
}]
}]
}]
},
"pattern": "%0 and %2 out of %1"Example of a pattern selector from the primaryTitle key in Task identity:
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"numericIdentifier":1,
"id":"Subject|SubjectName"
}
],
"objectType":"PTC.Workflow.WorkItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
},
"pattern":"%1"
}Structure for Selecting Attributes
There are three property types that you can use for specifying the subset of attributes from the backend system that you want to display in the component: Attributes Selector, Attributes Sets Selector, and Pattern Selector. They each use a similar JSON structure that includes required properties and optional properties.
Required properties:
• thingName– the name of the adapter Thing for the backend system
• instanceName– the instance name of the backend system adapter
• objectType– the object type of the attribute
• id– the ID of the attribute
Optional Properties:
• additionalData– any relevant sub-properties are included under this property.
• ordinal– this property determines the order in which the attributes appear in the user interface, where the attribute with an ordinal value of 0 appears first, the attribute with an ordinal value of 1 appears second, and so on. For more information see the topic Use the Ordinal Configuration Property.
• hidden– This property is currently only available for the Item List component. When set to true, this property causes the given attribute to be hidden from the Item List grid in the user interface, and it is also excluded from exported files. When set to false or when not included in the configuration, the attribute is not hidden. Even when an attribute is hidden, it is still passed to the selectedItems binding property for an item that is selected.
The following code shows the general structure for selecting attributes.
| | Windchill Navigate currently only supports using one adapter and one instance in any particular configuration of a component. |
{
"selectedValues":{
"data":[
{
"adapter":{
"thingName":"WindchillAdapterThing",
"instanceName":"JapanWindchill"
},
"itemListsData":[
{
"objectType":"WT.PART.WTPart",
"items":[
{
"id":"name of property",
"additionalData":{
"ContainerKey1":{
"additional properties"
},
"ContainerKey2":{
"additional properties"
}
},
"ordinal":2,
"hidden": true
},
{
"id":"name of property",
"additionalData":{
"ContainerKey1":{
"additional properties"
},
"ContainerKey2":{
"additional properties"
}
},
"ordinal":1
}
]
},
{
"objectType":"PTC.Workflow.WorkItem",
"items":[
{
"id":"name of property",
"additionalData":{
"ContainerKey1":{
"additional properties"
},
"ContainerKey2":{
"additional properties"
}
},
"ordinal":0
},
{
"id":"name of property",
"additionalData":{
"ContainerKey1":{
"additional properties"
},
"ContainerKey2":{
"additional properties"
}
},
"ordinal":3
"hidden": false
}
]
}
]
}
]
}
}