Task
Task è una configurazione predefinita del componente Elenco elementi che visualizza un elenco dei task dell'utente in Windchill. Per ogni task, Task visualizza gli attributi che è possibile impostare tramite la configurazione. Ogni attributo viene visualizzato come colonna in Task. Gli attributi di default visualizzati sono Nome, Subject Name, Data di scadenza, Stato, Nome contesto e Avanzamento task. L'attributo Avanzamento task è univoco per la configurazione predefinita Task e visualizza il numero di membri che hanno risposto alla richiesta di modifica correlata al task.
È possibile configurare Task in modo che gli attributi in una delle colonne siano link a un mashup specificato.
Task ha le stesse funzionalità di ricerca, ordinamento, filtro, esportazione e ripristino dei valori di default dell'Elenco elementi. La Barra delle azioni incorporata include l'azione Riassegna oltre all'azione Esporta. Se si fa clic sull'azione Riassegna, si apre una finestra popup che consente di riassegnare uno o più task a un altro utente.
Di seguito è riportata un'immagine di esempio che mostra la configurazione predefinita Task:
Proprietà di associazione
Per informazioni sull'associazione di Task, vedere il componente
Elenco elementi.
| • Per Task, l'output della proprietà di associazione selectedItems contiene elementi con il tipo di oggetto PTC.Workflow.WorkItem. • Per impostazione predefinita, Task recupera gli elementi dei task con il tipo di oggetto PTC.Workflow.WorkItem. Task non richiede quindi che i dati di input siano associati alla proprietà di associazione di input. |
Proprietà di configurazione
Per informazioni sulla configurazione di Task, vedere il componente
Elenco elementi. Le seguenti proprietà JSON, inoltre, sono specifiche di Task.
Per ulteriori informazioni sulla struttura della configurazione, vedere
Struttura di configurazione del componente.
Per ulteriori informazioni sulle sottoproprietà, vedere
Sottoproprietà e chiavi contenitore.
Nome proprietà | Descrizione | Tipo di proprietà | Valore di default | Obbligatoria o facoltativa |
taskTypeFilter | Determina quali tipi di task vengono recuperati e visualizzati in Task, in base a una combinazione di activityName e workItemProcessTemplate, che definiscono un insieme univoco di task. Proprietà utilizzata per filtrare i task da visualizzare. Se lasciata vuota, vengono visualizzati tutti i task con il tipo di oggetto PTC.Workflow.WorkItem. Formato: matrice di oggetti JSON a stringa, dove ogni oggetto JSON rappresenta un singolo tipo di task costituito da una combinazione dei campi activityName e workItemProcessTemplate. Questa proprietà di configurazione viene posizionata sotto la proprietà implementationConfiguration nella configurazione del componente. Esempio: "taskTypeFilter": {
"value": "[{\"activityName\": \"Conduct Online CRB Review\",
\"workItemProcessTemplate\": \"Change Request Workflow\"}]"
} | | N/D | Facoltativa |
linkToMashup | Trasforma l'attributo specificato in un collegamento ipertestuale e definisce il mashup di destinazione da aprire quando si fa clic sull'attributo. Può essere utilizzata per aprire una vista dettagliata del task. Si tratta di una sottoproprietà della proprietà di configurazione attributes. Il mashup specificato viene passato attraverso un parametro di mashup insieme all'ID task del task corrispondente. Il parametro di interrogazione nell'URL risultante è TaskID=<ID task>. La chiave contenitore di questa proprietà è implementationAttributesDefinition. Esempio: {
"implementationAttributesDefinition":{
"linkToMashup":{
"mashupName":"PTC.CRDetailedReviewAppMashup"
}
}
} URL mashup risultante: /Thingworx/Runtime/index.html?mashup=PTC.CRDetailedReviewAppMashup&TaskID=<ID task> | | N/D | Facoltativa |
attributes | Accetta gli attributi del tipo di oggetto PTC.Workflow.WorkItem. Accetta inoltre l'attributo TaskProgress, che ha il tipo di oggetto PTC.Workflow.WorkItem.Custom.Implementation. L'attributo TaskProgress mostra il numero di membri che hanno risposto alla richiesta di modifica. | | N/D | Obbligatoria |
defaultSortField | Accetta gli attributi del tipo di oggetto PTC.Workflow.WorkItem. | | N/D | Facoltativa |
filterFields | Accetta gli attributi del tipo di oggetto PTC.Workflow.WorkItem. | | N/D | Facoltativa |
Configurazione di esempio
{
"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":"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"
}
]
}
]
}
},
"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":"9.0.0"
},
"implementationConfigurationVersion":{
"value":"9.0.0"
}
}
Servizi di personalizzazione
Oltre alla configurazione, ogni componente supporta l'estensione della logica aziendale per personalizzare il componente. La logica aziendale di ciascun componente include servizi ignorabili in un modello di oggetto che è possibile estendere e sostituire. I servizi ignorabili per questo componente sono descritti in dettaglio nella tabella seguente.
Per esempi di elementi restituiti e parametri per ogni servizio, vedere
Esempi di input/output per i servizi di personalizzazione.
Nome | Descrizione |
GetConfigurations | Restituisce le configurazioni disponibili per Task. Parametri: nessuno Restituisce: JSON |
GetImplementationLabel | Restituisce il nome localizzato del componente o il token che può essere utilizzato per ottenere il nome localizzato. Il nome localizzato viene visualizzato nell'interfaccia utente di Mashup Builder. Parametri: nessuno Restituisce: stringa |
GetItems | Restituisce l'elenco di task per l'utente del sistema di back-end, insieme ai relativi attributi e valori. Parametri: input (facoltativo) - JSON in formato CCO che include l'ID input per i dati da recuperare dal sistema di back-end e le informazioni sull'adattatore per il sistema di back-end. configuration (obbligatorio) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni. Restituisce: JSON in formato CCO |
InitializeFilters | Restituisce la definizione del tipo di filtro per i campi di filtro nella configurazione. Inizializza i dati delle opzioni enum di filtro per il primo elemento del campo di filtro sotto la chiave filterFields della configurazione. Le opzioni enum del campo di filtro vengono recuperate dall'API dell'adattatore. Parametri: input (facoltativo) - JSON in formato CCO che include l'ID input per i dati da recuperare dal sistema di back-end e le informazioni sull'adattatore per il sistema di back-end. configuration (obbligatorio) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni. Restituisce: JSON in formato CCO |
DefHookImplementationConfigurationDefinitionGroup | Restituisce la definizione di implementazione di Task con le configurazioni personalizzate disponibili. Include la definizione della proprietà di configurazione taskTypeFilter. Parametri: nessuno Restituisce: JSON:Array |
DefHookImplementationAttributesDefinition | Restituisce la definizione di implementazione di Task per gli attributi selezionati. Include la definizione della proprietà di configurazione linkToMashup. Parametri: nessuno Restituisce: JSON:Array |
Definizione di implementazione
[
...
// 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": "UpdateAvailableFilterAttributes",
"addServiceName": "GetCustomFilterAttributes",
"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": "UpdateAvailableSortAttributes",
"addServiceName": "GetCustomSortAttributes",
"maximumSelectedAttributes": null,
"minimumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "defaultSortFields"
}
...
]
