Element-Identität
Definition und Verwendung
Die 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 das Bild, den Haupttitel, den sekundären Titel, das sekundäre Symbol sowie verschiedene Identitätsattribute für das Element. Das sekundäre Symbol gibt den Elementtyp an und kann so konfiguriert werden, dass die Windchill Symbole verwendet werden. Die Element-Identität-Komponente 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 folgende Beispielabbildung zeigt die Komponente "Element-Identität":
Die Komponente "Element-Identität" kann auf folgende Weise konfiguriert werden:
• Definieren der Haupttitel und sekundären Titel
• Konfigurieren der in der eingebetteten Aktionsleiste zur Verfügung stehenden Aktionen
• Definieren der anzuzeigenden Identitäts-Attribute
• Auswahl, ob ein Bild angezeigt und ein standardmäßiger Bildpfad definiert werden soll
• Auswahl, ob ein sekundäres Symbol angezeigt werden soll
Aufgabenidentität und Teile-Identität sind die vordefinierten Konfigurationen, die für die Komponente "Element-Identität" verfügbar sind.
Bindende Eigenschaften
Eingabe | ||||
|---|---|---|---|---|
Eigenschaftenname | Beschreibung | Eigenschaftstyp | ||
Input | Dient zum Identifizieren der Daten, die aus dem Backend-System abgerufen werden sollen. Siehe folgendes Beispiel: Beispiel-JSON: { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] }
| JSON im CCO-Format | ||
TailoringName | Identifiziert eine Instanz der Komponente "Element-Identität" eindeutig. Dieser Wert wird intern für die Suche nach Anpassungsinformationen für die bestimmte Instanz verwendet. Verwenden Sie diese Bindungseigenschaft nur, wenn eine dedizierte Anpassungsseite für Ihre benutzerdefinierte Aufgabe vorhanden ist. | String | ||
Konfigurationseigenschaften
Die folgende Tabelle zeigt die für die Konfiguration dieser Komponente verwendeten JSON-Eigenschaften an.
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 | |||
|---|---|---|---|---|---|---|---|
actionBarConfiguration | Aktionen, die in der Aktionsleiste in der Benutzeroberfläche angezeigt werden sollen. Siehe die Komponente Aktionsleiste für weitere Informationen. | -/- | Optional | ||||
attributes | Die Liste der Attribute, für die die Daten aus dem Backend-System abgerufen werden
| -/- | Optional | ||||
defaultImagePath | Der Standardpfad für das Abrufen des Bilds Diese Eigenschaft ist eine Untereigenschaft von showImage und ist nur relevant, wenn showImage auf true festgelegt ist. Der Container-Schlüssel ist itemIdentityShowImageDefinition. | -/- | Erforderlich, wenn für showImage der Wert true festgelegt ist. | ||||
primaryTitle | Der Haupttitel, der oben im Bereich "Element-Identität" angezeigt wird | -/- | Erforderlich | ||||
secondaryTitle | Der sekundäre Titel, der unter dem Haupttitel im Bereich "Element-Identität" angezeigt wird | -/- | Erforderlich | ||||
showImage | Legt fest, ob ein Bild im Bereich "Element-Identität" angezeigt werden soll. Optionen: true, false. Wenn true festgelegt ist, wird ein Bild im Bereich angezeigt. Definieren Sie den Bildpfad mit der Eigenschaft defaultImagePath. Wenn false festgelegt ist, wird kein Bild angezeigt. | -/- | Erforderlich | ||||
showSecondaryIcon | Legt fest, ob ein sekundäres Symbol angezeigt wird. Optionen: true, false. Wenn true festgelegt ist, wird im Bereich ein sekundäres Symbol angezeigt. Wenn false festgelegt ist, wird kein sekundäres Symbol angezeigt. | false | Erforderlich | ||||
Beispielkonfiguration
Beispielkonfigurationen für die Komponente "Element-Identität" finden Sie unter Aufgabenidentität und Teile-Identität.
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 die Implementierung der Komponente 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 |
ProcessAttributesConfiguration | Verarbeitet die Attributkonfiguration und unterteilt Attribute in vordefinierte Attribute und zusätzliche Attribute. Gibt eine JSON mit Schlüssel-Wert-Paaren in der folgenden Form zurück: • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON Die Attribute werden nach ihrem Objekttyp in vordefinierte und zusätzliche Attribute unterteilt. Attribute, deren Objekttyp auf .Custom.Adapter oder .Custom.Implementation endet, werden als zusätzliche Attribute behandelt. Alle anderen Attribute werden als vordefinierte Attribute betrachtet. Die Komponente "Element-Identität" unterstützt nicht die Verwendung von Attributen mit einem Objekttyp, der auf .Custom.Implementation endet. Stellen Sie sicher, dass Sie mindestens ein Attribut mit einem anderen Objekttyp verwenden. Parameter: attributes (Erforderlich) – JSON mit der Liste der vordefinierten Attribute und zusätzlichen Attribute configuration (Optional) – JSON mit der endgültigen zusammengeführten Konfiguration, die aus der Anpassungsmanager-Ressource abgerufen wurde Gibt zurück: JSON im CCO-Format |
GetItemIdentityAttributes | Überprüft die Konfiguration, fügt zusätzliche erforderliche Attribute hinzu und ruft anschließend GetAttributeValues auf, um alle Attributwerte aus dem Backend-System abzurufen. Parameter: input (Erforderlich) – JSON im CCO-Format, das die Eingabe-ID für die aus dem Backend-System abzurufenden Daten sowie die Adapterinformationen für das Backend-System enthält configuration (Optional) – JSON mit der endgültigen zusammengeführten Konfiguration, die aus der Anpassungsmanager-Ressource abgerufen wurde attributes (Erforderlich) – JSON mit der Liste der vordefinierten Attribute, wie in der Konfiguration definiert oder über die Anpassung festgelegt Gibt zurück: JSON |
GetAttributesValues | Gibt eine JSON mit Attributen und deren Werten zurück. Parameter: input (Erforderlich) – JSON im CCO-Format, das die Eingabe-ID für die aus dem Backend-System abzurufenden Daten sowie die Adapterinformationen für das Backend-System enthält configuration (Optional) – JSON mit der endgültigen zusammengeführten Konfiguration, die aus der Anpassungsmanager-Ressource abgerufen wurde attributes (Erforderlich) – JSON mit der Liste der vordefinierten Attribute und zusätzlichen Attribute Gibt zurück: JSON im CCO-Format |
GetAdditionalAttributes | Gibt die Liste der zusätzlichen Attributen zurück, die der Liste der verfügbaren vordefinierten Attribute hinzugefügt werden sollen. Parameter: Keine Gibt zurück: JSON |
Implementierungsdefinition
Informationen zu Implementierungsdefinitionen für die Komponente "Element-Identität" finden Sie unter Aufgabenidentität und Teile-Identität.