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\"}]" } | | -/- | 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> | | -/- | Optional |
attributes | 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. | | -/- | Erforderlich |
defaultSortField | Akzeptiert Attribute des Objekttyps PTC.Workflow.WorkItem. | | -/- | Optional |
filterFields | Akzeptiert Attribute des Objekttyps PTC.Workflow.WorkItem. | | -/- | 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"
}
...
]