Tareas
Las tareas es una configuración predefinida del componente Lista de elementos en el que se muestra una lista de las tareas del usuario en Windchill. En Tareas se muestran, para cada tarea, los atributos que se pueden definir a través de la configuración. Cada atributo se muestra como una columna en Tareas. Los atributos por defecto que se muestran son Nombre, Subject Name, Fecha de vencimiento, Estado, Nombre del contexto y Progreso de la tarea. El atributo Progreso de la tarea es exclusivo de la configuración predefinida de Tareas y muestra el número de miembros que han respondido a la solicitud de cambio relacionada con la tarea.
Para obtener información sobre cómo configurar tareas para mostrar tareas de un tipo específico y para obtener información más detallada, consulte el tema
Configuración de lista de elementos para mostrar tareas de un tipo de tarea específico.
Las tareas se pueden configurar de modo que los atributos de una de las columnas sean vínculos al mashup especificado.
Las tareas tienen las mismas funciones de búsqueda, clasificación, filtro, exportación y restauración de valores por defecto, similares a Lista de elementos. En la Barra de acciones integrada se incluye la acción Reasignar además de la acción Exportar. Cuando se pulsa, la acción Reasignar permite abrir una ventana emergente en la que se puede reasignar una o varias tareas a otro usuario.
A continuación, se presenta una imagen de ejemplo en la que se muestra la configuración predefinida de las tareas:
Propiedades de enlace
Para obtener información sobre cómo enlazar las tareas, consulte el componente
Lista de elementos.
| • Para Tareas, la salida de la propiedad de enlace selectedItems contiene elementos con el tipo de objeto PTC.Workflow.WorkItem. • De forma estándar, Tareas recupera elementos de tarea con el tipo de objeto PTC.Workflow.WorkItem. Por lo tanto, no requiere que ningún dato de entrada se enlace a la propiedad de enlace de entrada. |
Propiedades de configuración
Para obtener información sobre cómo configurar las Tareas, véase el componente
Lista de elementos. Además, las siguientes propiedades JSON son específicas de las tareas.
Para obtener más información sobre la estructura de la configuración, consulte
Estructura de configuración de componentes.
Para obtener más información sobre las subpropiedades, consulte
Subpropiedades y claves de contenedor.
Nombre de la propiedad | Descripción | Tipo de propiedad | Valor por defecto | Obligatorio u opcional |
---|
taskTypeFilter | Determina qué tipo de tareas se extraen y se muestran en las tareas, en función de una combinación de nombre de activityName y workItemProcessTemplate, que definen un conjunto único de tareas. Se utiliza para filtrar las tareas que se deben mostrar. Si se deja en blanco, se mostrarán todas las tareas con el tipo de objeto PTC.Workflow.WorkItem. Formato: matriz de objetos JSON convertidos en cadena, donde cada objeto JSON representa un único tipo de tarea que consta de una combinación de los campos activityName y workItemProcessTemplate. Esta propiedad de configuración se coloca bajo la propiedad implementationConfiguration en la configuración del componente. Ejemplo: "taskTypeFilter": { "value": "[{\"activityName\": \"Conduct Online CRB Review\", \"workItemProcessTemplate\": \"Change Request Workflow\"}]" } | | N/D | Opcional |
linkToMashup | Convierte el atributo especificado en un hipervínculo y define el mashup de destino que se debe abrir al pulsar en el atributo. Se puede utilizar para abrir una vista detallada de la tarea. Esta es una subpropiedad de la propiedad de configuración attributes. El mashup especificado se transmite a través de un parámetro de mashup junto con el ID de tarea de la tarea correspondiente. El parámetro de consulta en el URL resultante es TaskID=<ID de tarea>. La clave de contenedor de esta propiedad es implementationAttributesDefinition. Ejemplo: { "implementationAttributesDefinition":{ "linkToMashup":{ "mashupName":"PTC.CRDetailedReviewAppMashup" } } } URL de mashup resultante: /Thingworx/Runtime/index.html?mashup=PTC.CRDetailedReviewAppMashup&TaskID=<ID de tarea> | | N/D | Opcional |
attributes | Acepta los atributos del tipo de objeto PTC.Workflow.WorkItem. Además, acepta el atributo TaskProgress, que tiene el tipo de objeto PTC.Workflow.WorkItem.Custom.Implementation. El atributo TaskProgress muestra el número de miembros que han respondido a la solicitud de cambio. | | N/D | Obligatorio |
defaultSortField | Acepte los atributos del tipo de objeto PTC.Workflow.WorkItem. | | N/D | Opcional |
filterFields | Acepta los atributos del tipo de objeto PTC.Workflow.WorkItem. | | N/D | Opcional |
Configuración de ejemplo
{
"actionBarConfiguration":{
"value":{
"actionBarConfigurationJSON":{
"value":"{\"maxItemsToShow\": {\"value\": 2},\"modelThingName\": {\"entityName\": \"PTC.ActionBarModel.Thing\"},\"actions\": {\"selectedValues\": {\"data\": [{\"itemListsData\": [{\"items\": [{\"id\": \"Reassign\",\"additionalData\": {\"actionConfiguration\": {\"iconWhenDisabled\": {\"entityName\": \"PTC.ActionBar.ReassignDisabledIcon\"},\"iconWhenHovered\": {\"entityName\": \"PTC.ActionBar.ReassignHoverIcon\"},\"overrideLabel\": {\"value\": \"[[PTC.Nav.TaskList.TaskReassignLabel]]\"},\"popupHeight\": {\"value\": 579},\"inputConstraints\": {\"selectedKey\": \"InputRequired\"},\"actionButtonVisibility\": {\"selectedKey\": \"AlwaysShown\"},\"buttonStyle\": {\"selectedKey\": \"transparent\"},\"mashupName\": {\"mashupName\": \"PTC.AccessApp.WindchillServices.ReassignActionMashup\"},\"fireEventOnFinish\": {\"value\": false},\"activityType\": {\"selectedKey\": \"popup\"},\"iconWhenEnabled\": {\"entityName\": \"PTC.ActionBar.ReassignIcon\"},\"popupWidth\": {\"value\": 600}}},\"ordinal\": 0}],\"objectType\": \"WT.WorkItem.Actions\"}],\"adapter\": {\"instanceName\": \"windchill\",\"thingName\": \"PTC.WCAdapter\"}}]}}}"
}
}
},
"attributes":{
"inTailoring":true,
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"implementationAttributesDefinition":{
"linkToMashup":{
"mashupName":""
}
},
"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"
}
]
}
]
}
},
"defaultSortFields":{
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"itemListDefaultSortFieldDefinition":{
"defaultSortDirection":{
"selectedKey":"asc"
}
}
},
"id":"Activity|Deadline"
}
],
"objectType":"PTC.Workflow.WorkItem"
}
]
}
]
}
},
"enableSearch":{
"additionalData":{
"itemListSearchDefinition":{
"searchHintText":{
"value":"[[PTC.Nav.TaskList.FindHintText]]"
}
}
},
"value":true
},
"filterFields":{
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"itemListFilterFieldDefinition":{
"defaultSelectedFilterValues":{
"filters":{
"filters":[
{
"fieldName":"",
"type":"EQ",
"value":"POTENTIAL"
},
{
"fieldName":"",
"type":"EQ",
"value":"ACCEPTED"
}
],
"type":"Or"
}
},
"filterLabelOverride":{
"value":"[[PTC.Nav.TaskList.Status]]"
}
}
},
"id":"Status#Display",
"ordinal":0
}
],
"objectType":"PTC.Workflow.WorkItem"
}
]
}
]
}
},
"implementationConfiguration":{
"value":{
"taskTypeFilter":{
"value":"[{\"activityName\": \"Conduct Online CRB Review\",\"workItemProcessTemplate\": \"Change Request Workflow\"}]"
}
}
},
"label":{
"value":"[[PTC.Nav.TaskList.Label]]"
},
"maxNumberOfRowsInGrid":{
"inTailoring":true,
"value":50
},
"selectionType":{
"selectedKey":"multi"
},
"showExportAction":{
"inTailoring":true,
"value":true
},
"waitForInput":{
"value":false
},
"baseConfigurationVersion":{
"value":"nav.2"
},
"implementationConfigurationVersion":{
"value":"nav.1"
}
}
Servicios de personalización
Además de la configuración, cada componente soporta la extensión de la lógica empresarial para personalizar el componente. En la lógica empresarial de cada componente se incluyen los servicios desestimables en una plantilla de cosa que se pueden extender y sustituir. En la tabla siguiente se describen los servicios desestimables de este componente.
Para obtener ejemplos de las devoluciones y los parámetros de cada servicio, consulte
Ejemplos de entrada/salida para servicios de personalización.
Nombre | Descripción |
---|
GetConfigurations | Devuelve las configuraciones disponibles para las tareas. Parámetros: ninguno Devuelve: JSON |
GetImplementationLabel | Devuelve el nombre localizado del componente o el token que se puede utilizar para obtener el nombre localizado. Este nombre localizado se muestra en la interfaz de usuario de Mashup Builder. Parámetros: ninguno Devuelve: Cadena |
GetItems | Devuelve la lista de tareas para el usuario del sistema back-end, junto con sus atributos y valores. Parámetros: input (opcional): JSON en formato CCO en el que se incluye el ID de entrada de los datos que se van a extraer del sistema back-end y la información del adaptador para el sistema back-end. configuration (obligatorio): JSON con la configuración combinada final obtenida del recurso del administrador de personalización. Devuelve: JSON en formato CCO |
InitializeFilters | Devuelve la definición de tipo de filtro de los campos de filtro en la configuración. Inicializa los datos de opciones de enum de filtro para el primer elemento de campo de filtro en la clave filterFields de la configuración. Las opciones de enum del campo de filtro se recuperan de la API del adaptador. Parámetros: input (opcional): JSON en formato CCO en el que se incluye el ID de entrada de los datos que se van a extraer del sistema back-end y la información del adaptador para el sistema back-end. configuration (obligatorio): JSON con la configuración final obtenida del recurso del administrador de personalización. Devuelve: JSON en formato CCO |
DefHookImplementationConfigurationDefinitionGroup | Devuelve la definición de implementación de las tareas con las configuraciones personalizadas disponibles. Incluye la definición de la propiedad de configuración taskTypeFilter. Parámetros: ninguno Devuelve: JSON: matriz |
DefHookImplementationAttributesDefinition | Devuelve la definición de implementación de las tareas para los atributos seleccionados. Incluye la definición de la propiedad de configuración linkToMashup. Parámetros: ninguno Devuelve: JSON: matriz |
Definición de implementación
[
...
// Tasks injections to the Definition:
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"directDefinition": [ // Tasks specific:
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"hintText": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "taskTypeFilter"
}
]
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.DefinitionGroup"
},
"mandatory": true,
"key": "implementationConfiguration"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"supportedTypes": {
"data": [ // Tasks specific:
{
"adapter": {
"thingName": "PTC.WCAdapter",
"instanceName": "windchill"
},
"itemListsData": [
{
"objectType": "PTC.Workflow.WorkItem",
"selectionGroupIds": ["1"]
}
]
}
],
"allowSubsetForTailoring": false
},
"additionalDefinition": [
{
"key": "itemListAttributesDefinition",
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"hintText": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "fieldTitleOverride"
}
]
},
{
"key": "implementationAttributesDefinition",
"directDefinition": [ // Tasks specific:
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.MashupSelector"
},
"mandatory": false,
"key": "linkToMashup"
}
]
}
],
"updateServiceName": "UpdateAvailableAttributes",
"addServiceName": "GetCustomAttributes",
"maximumSelectedAttributes": null,
"minimumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": true,
"key": "attributes"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"supportedTypes": {
"data": [ // Tasks specific:
{
"adapter": {
"thingName": "PTC.WCAdapter",
"instanceName": "windchill"
},
"itemListsData": [
{
"objectType": "PTC.Workflow.WorkItem",
"selectionGroupIds": ["1"]
}
]
}
],
"allowSubsetForTailoring": false
},
"additionalDefinition": [
{
"key": "itemListFilterFieldDefinition",
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"type": {},
"dynamiclySetTypeServiceName": "GetFilterTypeDefinitionForFilterField"
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.FieldFilter"
},
"mandatory": false,
"key": "defaultSelectedFilterValues"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "filterLabelOverride"
}
]
}
],
"updateServiceName": "",
"addServiceName": "",
"maximumSelectedAttributes": 1,
"minimumSelectedAttributes": 0
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "filterFields"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"supportedTypes": {
"data": [ // Tasks specific:
{
"adapter": {
"thingName": "PTC.WCAdapter",
"instanceName": "windchill"
},
"itemListsData": [
{
"objectType": "PTC.Workflow.WorkItem",
"selectionGroupIds": ["1"]
}
]
}
],
"allowSubsetForTailoring": false
},
"additionalDefinition": [
{
"key": "itemListDefaultSortFieldDefinition",
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"options": [
{
"key": "asc",
"label": "[[PTC.Nav.ItemList.SortOrder.Asc]]",
"description": "",
"additionalDefinition": []
},
{
"key": "dsc",
"label": "[[PTC.Nav.ItemList.SortOrder.Dsc]]",
"description": "",
"additionalDefinition": []
}
],
"updateServiceName": "",
"addServiceName": ""
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "defaultSortDirection"
}
]
}
],
"updateServiceName": "",
"addServiceName": "",
"maximumSelectedAttributes": null,
"minimumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "defaultSortFields"
}
...
]