Erweiterte Anpassung > Wiederverwendbare Komponenten verwenden > Verfügbare wiederverwendbare Komponenten > Element-Identität
  
Element-Identität
Definition und Verwendung
Die wiederverwendbare Komponente "Element-Identität" ist ein Widget, mit dem grundlegende Informationen, auch Identitätsinformationen genannt, für ein bestimmtes Element angezeigt werden können. Die Informationen werden in einem Fensterbereich angezeigt, der sich für gewöhnlich oben auf der Elementseite befindet. Der Bereich enthält den Haupttitel, den sekundären Titel, sowie verschiedene Attribute für das Element. Er enthält außerdem eine eingebettete Aktionsleiste mit Aktionen, die für das Element ausgeführt werden können. Sie können den Bereich "Element-Identität" mithilfe des Pfeils oben links im Bereich erweitern oder reduzieren. Ist der Bereich reduziert, so werden lediglich der primäre Titel und die Aktionsleiste angezeigt.
Die wiederverwendbare Komponente "Element-Identität" kann auf folgende Weise konfiguriert werden:
• Definieren der anzuzeigenden Identitäts-Attribute
• Konfigurieren der in der eingebetteten Aktionsleiste zur Verfügung stehenden Aktionen
• Definieren der Haupttitel und sekundären Titel
Die folgende Beispielabbildung zeigt die wiederverwendbare Komponente "Element-Identität":
"Aufgabenidentität" ist die einzige vordefinierte Konfiguration, die für die wiederverwendbare Komponente "Element-Identität" zur Verfügung steht. Siehe "Aufgabenidentität" für mehr Informationen sowie für eine Beispielkonfiguration.
Bindende Eigenschaften
Die wiederverwendbare Komponente "Element-Identität" besitzt zwei Eigenschaften für die Bindung:
• Input – Diese JSON ist die Eingabe-ID, für die Daten vom Backend-System abgerufen werden müssen. Diese Informationen werden in einem CCO-Format (Common Communication Object) bereitgestellt. Dies ist ein Beispiel:
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.ChangeMgmt.ChangeRequest",
"items":[
{
"id":{
"value":"OR:wt.change2.WTChangeRequest2:439476"
}
}
]
}
]
}
]
}
• TailoringName – Diese Zeichenfolge ist der Instanzname der Komponente. Es besteht eine enge Kopplung mit der Anpassung. TailoringName wird verwendet, um die gespeicherten Anpassungsinformationen für jede Komponente abzurufen.
Konfigurationsfelder
Die folgende Tabelle zeigt die für die Konfiguration dieser Komponente verwendeten JSON-Felder an.
Eigenschaftenname
Beschreibung
Typ
Standardwert
Erforderlich oder optional
attributes
Eigenschaftsnamen, für die Daten vom Backend-System erwartet werden. Siehe Untereigenschaften:
MultiValueSelector
-/-
Optional
id
Die ID für den Eigenschaftsnamen des Attributs im Backend-System Beispiel: “Category#Display”.
String
""
Erforderlich
ordinal
Reihenfolge, in der die Attribute in der Komponente angezeigt werden. 0 gibt die ursprüngliche Position ganz links an.
Integer
-/-
Optional
objectType
Objekttyp, für den die Attribute abgerufen werden sollen
String
""
Erforderlich
adapter
Quellkonfiguration für das Backend-System. Siehe Untereigenschaften:
JSON
-/-
Erforderlich
instanceName
Konnektorinstanz, d.h. welcher Konnektor für die Verbindung zum Backend-System verwendet werden soll
String
""
Erforderlich
thingName
Name des Backend-Systems oder des Adapters, von dem die Daten abgerufen werden
String
""
Erforderlich
inTailoring
Anpassbarkeit der Komponente "Element-Identität" auf der Anpassungsseite. Optionen: true, false.
Boolean
false
Optional
title
Der Haupttitel, der oben im Bereich "Element-Identität" angezeigt wird. Siehe Untereigenschaften:
-/-
-/-
Erforderlich
pattern
Zeichenfolge, die als primärer Titel in der Benutzeroberfläche für die Komponente angezeigt wird. Muster enthält numerische Identifikatoren, welche dynamisch ersetzt werden. Jede numerische ID in der Zeichenfolge entspricht einem der im Feld id angegebenen Eigenschaftsnamen.
String
""
Erforderlich
id
Die ID für den Eigenschaftsnamen des Attributs im Backend-System Beispiel: “Subject|SubjectName”.
String
""
Erforderlich
numericIdentifier
Jede id hat eine numerische ID. Die numerische ID wird in der Musterzeichenfolge durch den für id abgerufenen Wert ersetzt.
Integer
1
Erforderlich
objectType
Objekttyp, für den die Attribute abgerufen werden sollen
String
""
Erforderlich
adapter
Quellkonfiguration für das Backend-System. Siehe Untereigenschaften:
adapter
-/-
Erforderlich
instanceName
Konnektorinstanz, d.h. welcher Konnektor für die Verbindung zum Backend-System verwendet werden soll
String
""
Erforderlich
thingName
Name des Backend-Systems oder des Adapters, von dem die Daten abgerufen werden
String
""
Erforderlich
secondaryTitle
Der sekundäre Titel, der unter dem primären Titel im Bereich "Element-Identität" angezeigt wird. Siehe Untereigenschaften:
-/-
-/-
Erforderlich
pattern
Zeichenfolge, die als sekundärer Titel in der Benutzeroberfläche für die Komponente angezeigt wird. Muster enthält numerische Identifikatoren, welche dynamisch ersetzt werden. Jede numerische ID in der Zeichenfolge entspricht einem der im Feld id angegebenen Eigenschaftsnamen.
String
""
Erforderlich
id
Die ID für den Eigenschaftsnamen des Attributs im Backend-System Beispiel: “Activity|Name”.
String
""
Erforderlich
numericIdentifier
Jede id hat eine numerische ID. Die numerische ID wird in der Musterzeichenfolge durch den für id abgerufenen Wert ersetzt.
Integer
1
Erforderlich
objectType
Objekttyp, für den die Attribute abgerufen werden sollen
String
""
Erforderlich
adapter
Quellkonfiguration für das Backend-System. Siehe Untereigenschaften:
adapter
-/-
Erforderlich
instanceName
Konnektorinstanz, d.h. welcher Konnektor für die Verbindung zum Backend-System verwendet werden soll
String
""
Erforderlich
thingName
Name des Backend-Systems oder des Adapters, von dem die Daten abgerufen werden
String
""
Erforderlich
modelThing
Siehe Untereigenschaften:
-/-
-/-
Erforderlich
entityName
Der Name des Modelldings, das die Daten abruft
String
"PTC.ItemIdentity
ModelThing"
Erforderlich
version
Konfigurationsversion
String
"1.0.0"
Optional
actions
Aktionen, die in der Aktionsleiste in der Benutzeroberfläche angezeigt werden sollen. Siehe die wiederverwendbare Komponente Aktionsleiste für weitere Informationen und Untereigenschaften.
-/-
-/-
Optional
Beispielkonfiguration
Die folgende JSON-Beispielkonfiguration ist für die Element-Identität und deren Standardkonfiguration.
{
"secondaryTitle": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": ""
},
{
"items": [
{
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
},
"inTailoring": true
},
"title": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"actions": {
"maxItemsToShow": {
"value": 2
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [
{
"itemListsData": [],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}
},
"modelThing": {
"entityName": "PTC.ItemIdentityModelThing",
"version": "1.0.0"
}
}