Aufgaben

ThingWorx Navigate anpassen > Benutzerdefinierte Aufgaben erstellen > ThingWorx Navigate Komponenten in einer benutzerdefinierten Aufgabe verwenden > Verfügbare Komponenten > Elementliste > Aufgaben

Aufgaben

"Aufgaben" ist eine vordefinierte Konfiguration der Komponente "Elementliste", welche eine Liste der Aufgaben des Benutzers in Windchill anzeigt. "Aufgaben" zeigt für jede Aufgabe Attribute an. Diese Attribute können durch Konfiguration festgelegt werden. Jedes Attribut wird als Spalte in "Aufgaben" angezeigt. Die angezeigten Standardattribute sind: Name, Subject Name, Fälligkeitsdatum, Status, Kontextname und Aufgabenfortschritt. Das Attribut Aufgabenfortschritt ist für die vordefinierte Konfiguration von "Aufgaben" eindeutig und zeigt an, wie viele Mitglieder auf den zur Aufgabe gehörenden Änderungsantrag geantwortet haben.

Sie können "Aufgaben" so konfigurieren, dass die Attribute in einer der Spalten Links zu angegebenem Mashup darstellen.

"Aufgaben" verfügt über gleiche Funktionen für die Suche, das Sortieren, das Filtern, das Exportieren und das Wiederherstellen von Standardvorgaben wie die Elementliste. Die eingebettete Aktionsleiste umfasst neben der Aktion Exportieren auch die Aktion Neu zuweisen. Beim Klick auf Neu zuweisen öffnet sich ein Popup-Fenster, in dem Sie eine oder mehrere Aufgaben einem anderen Benutzer zuweisen können.

Die folgende Beispielabbildung zeigt die vordefinierte Konfiguration "Aufgaben":

Bindende Eigenschaften

Informationen zum Binden von "Aufgaben" finden Sie in der Komponente Elementliste.

• Für "Aufgaben" enthält die Ausgabe der Bindungseigenschaft selectedItems Elemente mit dem Objekttyp PTC.Workflow.WorkItem.

• Standardmäßig rufen Aufgaben Aufgabenelemente mit dem Objekttyp PTC.Workflow.WorkItem ab. Daher erfordert "Aufgaben" keine Bindung der Eingabedaten an die Eingabe-Bindungseigenschaft.

Konfigurationseigenschaften

Informationen zum Konfigurieren von "Aufgaben" finden Sie in der Komponente Elementliste. Darüber hinaus gibt es die folgenden spezifischen JSON-Eigenschaften für "Aufgaben".

Weitere Informationen zur Struktur der Konfiguration finden Sie unter Konfigurationsstruktur von Komponenten.

Weitere Informationen zu Untereigenschaften finden Sie unter Untereigenschaften und Container-Schlüssel.

Eigenschaftenname	Beschreibung	Eigenschaftstyp	Standardwert	Erforderlich oder optional
taskTypeFilter	Bestimmt, welcher Typ von Aufgaben abgerufen und in "Aufgaben" angezeigt wird, basierend auf einer Kombination von activityName und workItemProcessTemplate, die einen eindeutigen Satz von Aufgaben definieren. Wird verwendet, um die anzuzeigenden Aufgaben zu filtern. Wird das Feld leer gelassen, so werden alle Aufgaben mit dem Objekttyp PTC.Workflow.WorkItem angezeigt. Format: In eine Zeichenfolge konvertiertes JSON-Objektarray, wobei jedes JSON-Objekt einen einzelnen Aufgabentyp darstellt, der aus einer Kombination der Felder activityName und workItemProcessTemplate besteht. Diese Konfigurationseigenschaft wird unter der Eigenschaft implementationConfiguration in der Komponentenkonfiguration platziert. Beispiel: "taskTypeFilter": { "value": "[{\"activityName\": \"Conduct Online CRB Review\", \"workItemProcessTemplate\": \"Change Request Workflow\"}]" }	Textfeld	-/-	Optional
linkToMashup	Wandelt das angegebene Attribut in einen Hyperlink um, und definiert das Ziel-Mashup, das beim Klick auf das Attribut geöffnet werden soll. Kann zum Öffnen einer detaillierten Ansicht der Aufgabe verwendet werden. Dies ist eine Untereigenschaft der Konfigurationseigenschaft attributes. Das angegebene Mashup wird durch einen Mashup-Parameter zusammen mit der Aufgaben-ID der entsprechenden Aufgabe übergeben. Der Abfrageparameter in der resultierenden URL lautet: TaskID=<Aufgaben-ID>. Der Container-Schlüssel dieser Eigenschaft ist implementationAttributesDefinition. Beispiel: { "implementationAttributesDefinition":{ "linkToMashup":{ "mashupName":"PTC.CRDetailedReviewAppMashup" } } } Resultierende Mashup-URL: /Thingworx/Runtime/index.html?mashup=PTC.CRDetailedReviewAppMashup&TaskID=<Aufgaben-ID>	Mashup-Auswahl	-/-	Optional
attributes	Weitere Informationen finden Sie unter Elementliste. Akzeptiert Attribute des Objekttyps PTC.Workflow.WorkItem. Außerdem wird das Attribut TaskProgress mit dem Objekttyp PTC.Workflow.WorkItem.Custom.Implementation akzeptiert. Das Attribut TaskProgress zeigt die Anzahl der Mitglieder, die auf den Änderungsantrag geantwortet haben, an.	Attributauswahl	-/-	Erforderlich
defaultSortField	Weitere Informationen finden Sie unter Elementliste. Akzeptiert Attribute des Objekttyps PTC.Workflow.WorkItem.	Attributauswahl	-/-	Optional
filterFields	Weitere Informationen finden Sie unter Elementliste. Akzeptiert Attribute des Objekttyps PTC.Workflow.WorkItem.	Attributauswahl	-/-	Optional

Beispielkonfiguration

{
"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"
}
}

Anpassungsdienste

Zusätzlich zur Konfiguration unterstützt jede Komponente das Anpassen durch Erweitern ihrer Geschäftslogik. Die Geschäftslogik jeder Komponente umfasst überschreibbare Dienste in einer Dingvorlage, die Sie erweitern und überschreiben können. Die überschreibbaren Dienste für diese Komponente sind in der nachfolgenden Tabelle aufgeführt.

Beispiele für Rückgaben und Parameter für jeden Dienst finden Sie unter Beispiele für Eingaben/Ausgaben für Anpassungsdienste.

Name	Beschreibung
GetConfigurations	Gibt die verfügbaren Konfigurationen für "Aufgaben" zurück. Parameter: Keine Gibt zurück: JSON
GetImplementationLabel	Gibt entweder den lokalisierten Namen der Komponente oder das Token zurück, die verwendet werden können, um den lokalisierten Namen abzurufen. Dieser lokalisierte Name wird in der Benutzeroberfläche von Mashup Builder angezeigt. Parameter: Keine Gibt zurück: Zeichenfolge
GetItems	Gibt die Liste der Aufgaben für den Benutzer aus dem Backend-System zusammen mit deren Attributen und Werten zurück. Parameter: input (Optional) – JSON im CCO-Format, das die Eingabe-ID für die aus dem Backend-System abzurufenden Daten und die Adapterinformationen für das Backend-System enthält configuration (Erforderlich) – JSON mit der endgültigen zusammengeführten Konfiguration, die aus der Anpassungsmanager-Ressource abgerufen wurde Gibt zurück: JSON im CCO-Format
InitializeFilters	Gibt die Filtertypdefinition für die Filterfelder in der Konfiguration zurück. Initialisiert die enum-Optionsdaten des Filters für das erste Filterfeldelement unter dem Schlüssel filterFields der Konfiguration. Die enum-Optionen des Filterfelds werden aus der Adapter-API abgerufen. Parameter: input (Optional) – JSON im CCO-Format, das die Eingabe-ID für die aus dem Backend-System abzurufenden Daten und die Adapterinformationen für das Backend-System enthält configuration (Erforderlich) – JSON mit der endgültigen zusammengeführten Konfiguration, die aus der Anpassungsmanager-Ressource abgerufen wurde Gibt zurück: JSON im CCO-Format
DefHookImplementationConfigurationDefinitionGroup	Gibt die Implementierungsdefinition von "Aufgaben" mit den verfügbaren benutzerdefinierten Konfigurationen zurück. Enthält die Definition für die Konfigurationseigenschaft taskTypeFilter. Parameter: Keine Gibt zurück: JSON-Array
DefHookImplementationAttributesDefinition	Gibt die Implementierungsdefinition von "Aufgaben" für die ausgewählten Attribute zurück. Enthält die Definition für die Konfigurationseigenschaft linkToMashup. Parameter: Keine Gibt zurück: JSON-Array

Implementierungsdefinition

[
...
// 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"
}

...
]

War dies hilfreich?