Kacheln
Definition und Verwendung
Die Komponente "Kacheln" ist ein Widget, mit dem Sie Name-Wert-Paare, auch Attribute genannt, im Kachelformat anzeigen können. Zweck der Komponente "Kacheln" ist es, wichtige Informationen hervorzuheben, damit Benutzer diese auf den ersten Blick erkennen. Der Attributwert wird in der oberen Hälfte der Kachel angezeigt und der Attributname in der unteren Hälfte. Der Wert kann sich bis zu zwei Zeilen und der Name bis zu einer Zeile erstrecken. Ist der Wert oder der Name zu lang für die Kachel, so wird er abgeschnitten, was durch Auslassungspunkte angezeigt wird. Kacheln werden im Allgemeinen in einer einzigen Zeile angezeigt. Sind zu viele Kacheln für eine einzige Zeile vorhanden, so wird die Kachelgröße reduziert, damit alle Kacheln in eine Zeile passen. Sollten immer noch zu viele Kacheln für die Anzeige in einer Zeile vorhanden sein, so werden die Kacheln in eine zweite Zeile umbrochen.
Die folgende Beispielabbildung zeigt die Komponente "Kacheln":
Die Komponente "Kacheln" kann auf die folgende Weise konfiguriert werden:
• Die maximal anzuzeigenden Kacheln festlegen
• Zusätzliche Attribute hinzufügen
Generische Kacheln ist eine generische vordefinierte Konfiguration für die Komponente "Kacheln".
Bindende Eigenschaften
Eingabe | ||
|---|---|---|
Eigenschaftenname | Beschreibung | Eigenschaftstyp |
Input | Dient zum Identifizieren der Daten, die aus dem Backend-System abgerufen werden sollen. 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 "Kacheln" 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 | ||
|---|---|---|---|---|---|---|
attributes | Eigenschaftsnamen, für die Daten vom Backend-System erwartet werden. Diese Attribute können entweder vom Backend-System abgerufen werden oder zusätzlich sein. | -/- | Erforderlich | |||
maxTileCount | Maximale Anzahl der Attribute, die als Kacheln angezeigt werden. Ist diese Eigenschaft auf eine leere Zeichenfolge festgelegt, so besteht keine Einschränkung im Hinblick auf die Anzahl der angezeigten Kacheln. | -/- | Optional | |||
Beispielkonfigurationen
Eine Beispielkonfiguration für die Komponente "Kacheln" finden Sie in der Konfiguration Generische Kacheln.
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 standardmäßige 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 standardmäßige 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 standardmäßige Attribute betrachtet. Parameter: attributes (Erforderlich) – JSON mit der Liste der standardmäßigen 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 |
GetAttributesValues | Gibt eine JSON mit Attributen und deren Wert 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 standardmäßigen Attribute und zusätzlichen Attribute Gibt zurück: JSON im CCO-Format |
GetAdditionalAttributesValues | Gibt eine JSON mit Werten für zusätzliche Attribute zurück. Dieser Dienst sollte durch die Komponentenimplementierung implementiert werden. 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 zusätzlichen Attribute OOTBAttributesValues (Optional) – JSON im CCO-Format mit Werten der standardmäßigen Attribute, die von GetAttributesValues zurückgegeben werdenAnhand dieser Werte können Werte für zusätzliche Attribute berechnet werden. Gibt zurück: JSON im CCO-Format |
GetAdditionalAttributes | Gibt die Liste der zusätzlichen Attributen zurück, die der Liste der verfügbaren standardmäßigen Attribute hinzugefügt werden sollen. Parameter: Keine Gibt zurück: JSON |
Implementierungsdefinition
Die Implementierungsdefinition für die Komponente "Kacheln" finden Sie in der Konfiguration Generische Kacheln.