1 Themenübersicht
Die Anwendung „Entwicklungsobjekte“ dient der Erfassung und Ansicht von Entwicklungsobjekten verschiedenster Typen. In dieser Dokumentation wird der Typ „Data-Description“ beschrieben, der weiter in „Column“ und „LDT“ unterschieden wird.
Allgemeine Informationen zur Anwendung „Entwicklungsobjekte“, beispielsweise die Beschreibung der anwendungsbezogenen Aktionen oder des Identifikationsbereichs, finden Sie in dieser Dokumentation „Entwicklungsobjekte“.
2 Beschreibung
Bei der Data-Description werden zwei Entwicklungsobjekttypen unterschieden:
- Data-Description-LDT und
- Data-Description-Column.
Diese besitzen zwar die gleichen Eigenschaften, aber unterschiedliche Bezugsebenen.
Die Data-Description-LDT bildet eine Einheit mit einem Logischen Datentyp
(identischer Namensraum und Entwicklungsobjektname). Sie beschreibt das Verhalten von Logischen Datentypen auf der Benutzeroberfläche.
Durch die Verwendung von Logischen Datentypen vom Typ „logisch“ wird implizit eine Vererbungshierarchie auf den zugehörigen Data-Descriptions abgebildet. Dazu muss für die Logischen Datentypen eine Data-Description-LDT definiert werden. In dieser wird dann bestimmt, ob die Werte über der Vererbung aufgelöst oder explizit angegeben werden.
Eine Data-Description-Column ist genau einem konkreten Attributpfad eines Business Objects, eines Parts oder einer Extension zugeordnet und beschreibt ebenfalls das Verhalten auf der Benutzeroberfläche. Sie kann von der Data-Description-LDT erben, die zum Logischen Datentyp des Attributs gehört. Den visuellen Elementen kann der Pfad zum Attribut übergeben werden. Über diesen wird die Data-Description-Column aufgelöst und dargestellt. Ist keine Data-Description-Column für das Attribut definiert, wird die Data-Description-LDT vom Logischen Datentyp des Attributs verwendet.
Der Entwicklungsobjektname der Data-Description-Column ist wie folgt zusammengesetzt:
<Busisness Object Namensraum>.<Business Object Name>:<Attributname>
Beispiel:
com.cisag.app.obj.BusinessObject:description
Existieren für ein Attribut eines Business Objects beide Data-Description-Typen, hat die Data-Description-Column Vorrang.
2.1 Unterer Karteireiter Attribute
Die Felder der beiden Entwicklungsobjekte im Einzelnen:
| Feld | Erläuterung |
| Logischer Datentyp | Data-Description-LDT
Angabe des zugehörigen Logischen Datentyps (Namensraum und Entwicklungsobjektname). Der Logische Datentyp kann nur bei einer Neuanlage erfasst werden. Wenn die Zuordnung (Data-Description-LDT – Logischer Datentyp) korrekt und die Data-Description zum ersten Mal gespeichert ist, dann kann der angegebene Logische Datentyp nicht mehr geändert werden. Die Data-Description wird im Verwendungsnachweis des Logischen Datentyps aufgenommen. |
| Ziel-Objekt | Data-Description-Column
Angabe des zugehörigen Business Objects, Parts oder Extension. Wenn die Zuordnung (Data-Description-Column – Business Object) korrekt und die Data-Description zum ersten Mal gespeichert ist, dann kann das angegebene Business Object nicht mehr geändert werden. |
| Attributpfad | Data-Description-Column
Auswahl der Spalte, auf die sich die Data-Description bezieht. Die Wertehilfe zeigt nur gültige Attribute aus dem angegebenen Zielobjekt. Wenn die Zuordnung (Data-Description Attribut – Business Object Attribut) korrekt und die Data-Description zum ersten Mal gespeichert ist, dann kann das angegebene Attribut nicht mehr geändert werden. Die Data-Description wird im Verwendungsnachweis des Business Objects (auf Attributebene) aufgenommen. |
| Einstellung Label | Definiert, ob das Label aus der Vererbung übernommen („Aus Vererbung“) oder explizit angegeben wird („Benutzerdefiniert“).
Bei „Vererbung“ wird die Vererbung der zugehörigen Logischen Datentypen aufgelöst und der Wert aus der zugehörigen Data-Description ermittelt. |
| Label | Das Label ist die angezeigte Bezeichnung eines Feldes in der Benutzeroberfläche.
Das Feld ist eingabebereit, wenn im Feld „Einstellung Label“ „Benutzerdefiniert“ ausgewählt ist. Die Länge ist auf 50 Zeichen beschränkt. Das Label ist übersetzbar. |
| Einstellung Vollständiges Label | Definiert, ob das Vollständige Label aus der Vererbung übernommen („Aus Vererbung“) oder explizit angegeben wird („Benutzerdefiniert“).
Bei „Vererbung“ wird die Vererbung der zugehörigen Logischen Datentypen aufgelöst und der Wert aus der zugehörigen Data-Description ermittelt. |
| Vollständiges Label | Das Vollständige Label ist die angezeigte Bezeichnung eines Feldes in der Benutzeroberfläche der anpassbaren Cockpits.
Das Feld ist eingabebereit, wenn im Feld „Einstellung Vollständiges Label“ „Benutzerdefiniert“ ausgewählt ist. Die Länge ist auf 50 Zeichen beschränkt. Das Vollständige Label ist übersetzbar. |
| Einstellung Kurzlabel | Das Feld legt fest, ob das Kurzlabel aus der Vererbung übernommen („Aus Vererbung“), explizit angeben („Benutzerdefiniert“) oder aus dem Label-Text übernommen („Aus Label“) wird.
Bei „Vererbung“ wird die Vererbung der zugehörigen Logischen Datentypen aufgelöst und der Wert aus deren zugehörigen Data-Description ermittelt. |
| Kurzlabel | Kurzlabel ist eine alternative Kurzbezeichnung des Labels, die verwendet wird, wenn in der Oberfläche zuwenig Platz zur Verfügung steht.
Das Feld ist nur eingabebereit, wenn im Feld „Einstellung Kurzlabel“ „Benutzerdefiniert“ ausgewählt ist. Die Länge ist auf 50 Zeichen beschränkt. Das Kurzlabel ist übersetzbar. |
| Einstellung Tooltip | Das Feld legt fest, ob der Tooltipp aus der Vererbung übernommen („Aus Vererbung“) oder explizit angegeben („Benutzerdefiniert“) wird.
Bei „Vererbung“ wird die Vererbung der zugehörigen Logischen Datentypen aufgelöst und der Wert aus deren zugehörigen Data-Description ermittelt. |
| Tooltip | Der Tooltipp ist ein Text, der erscheint, wenn die Maus einen kurzen Moment über einem Feld in der Benutzeroberfläche ruht.
Das Feld ist nur eingabebereit, wenn im Feld „Einstellung Tooltip“ „Benutzerdefiniert“ ausgewählt ist. Die Länge ist auf 256 Zeichen beschränkt. Der Tooltip-Text ist übersetzbar. |
| Pflichtfeld(Checkbox) | Wenn die Checkbox aktiviert wird, dann ist definiert, dass das Feld in der Benutzeroberfläche ein Pflichtfeld ist.
Ist kein Wert in dem Feld gesetzt, wird rechts oben eine graue Ecke gesetzt. Es erfolgt keine Prüfung, ob eine Eingabe stattfand. Diese muss in Java ausprogrammiert werden. |
| Editierbar
(Checkbox) |
Wenn die Checkbox aktiviert wird, dann ist definiert, dass das Feld in der Oberfläche eingabebereit ist. |
| Verborgen
(Checkbox) |
Wenn die Checkbox aktiviert wird, dann ist definiert, dass das Feld in der Oberfläche verborgen ist. |
| Wertehilfe | Angabe einer Suchdefinition (siehe OQL-Suche) mit vollständigen Entwicklungsobjektnamen. |
| Wertebereich | Definiert in Abhängigkeit des Logischen Datentyps einen Wertebereich.
· Kein: Keine benutzerdefinierten Eigenschaften. · Benutzerdefiniert: Benutzerdefinierte Eigenschaften in Abhängigkeit des logischen Datentyps. · Aus Vererbung: Benutzerdefinierte Eigenschaften werden aus der Vererbung aufgelöst. |
Bei der Neuanlage einer DataDescription zu einem logischen Datentypen vom Typ “Logisch” werden die Attribute Tooltip, Inhaltstyp, Horizontale Ausrichtung, Vertikale Ausrichtung und Wertebereich nun standardmäßig auf “Aus Vererbung” gestetzt.
Wertebereichsdefinition
Datentyp Valueset
Für die Valuesets können die Sortierung und die in der Oberfläche angezeigten Elemente definiert werden.
| Feld | Erläuterung |
| Einstellung Valuesetelemente | Definition der Eigenschaften:
· Aufsteigend nach Anzeige: Sortierung nach der Bezeichnung A–Z. · Absteigend nach Anzeige: Sortierung nach der Bezeichnung Z–A. · Aufsteigend nach Konstante: Sortierung nach der Konstanten 1–…. · Absteigend nach Konstante: Sortierung nach der Konstanten …-1. · Benutzerdefiniert: Hinzufügen und Entfernen von Elementen bzw. Verschieben von Elementen innerhalb der Liste. Eine Sortierung bei dieser Einstellung ist nicht möglich. |
Bei der benutzerdefinierten Einstellung stehen folgende Funktionen zur Verfügung:
| Funktion | Erläuterung |
| Neu | Hinzufügen von Valueset-Elementen, die nicht in der Liste vorhanden sind. |
| Löschen | Entfernen von Valueset-Elementen aus der Liste, diese werden nicht in der Oberfläche angezeigt. |
| In Liste an die erste Position verschieben | Verschiebt ein Element an den Anfang der Liste. |
| Nach oben | Verschiebt ein Element in der Liste um ein Element nach oben. |
| Ein Element nach unten gehen | Verschiebt ein Element in der Liste um ein Element nach unten. |
| Zum Ende | Verschiebt ein Element zum Ende der Liste. |
Datentypen Decimal, double, float
| Feld | Erläuterung |
| Maximale Nachkommastellen | Maximale Anzahl der erfassbaren Nachkommastellen. |
| Minimale Nachkommastellen | Minimale Anzahl der erfassbaren Nachkommastellen. |
Alle weiteren Datentypen
| Feld | Erläuterung |
| Datenlänge | Maximale Anzahl der erfassbaren Zeichen. |
2.2 Unterer Karteireiter Klassen
Factory-Klassen
Die Felder im Einzelnen:
| Feld | Erläuterung |
| Editor | Editoren werden von den anpassbaren Oberflächen benutzt um die Attribute eines DataViews zu visualisieren und zu editieren. Für alle primitiven Datentypen und Special-Parts sind Editoren vordefiniert.
Es ist der Name einer Klasse einzutragen, die das Interface “com.cisag.pgm.gui.EditorFactory” (oder “com.cisag.pgm.gui.FieldFactory”) implementiert. |
| Renderer | Renderer werden von den anpassbaren Cockpits benutzt um die Daten in der Ergebnisliste zu visualisieren. Für alle primitiven Datentypen und Special-Parts sind Renderer vordefiniert. Für “virtuelle Attribute” sind Renderer zwingend erforderlich.
Es ist der Name einer Klasse einzutragen, die das Interface “com.cisag.pgm.gui.RendererFactory” implementiert. |
| Formatter | Formatter (“java.text.Format”) wandeln einen Datentyp in eine Textrepräsentation und umgekehrt. Für die anpassbaren Cockpits können sie auch als Alternative zu den Renderern verwendet werden. Auch FilterExpressionEditoren können das Parsen und Formattieren an Formatter delegieren.
Es ist der Name einer Klasse einzutragen, die das Interface “com.cisag.pgm.gui.FormatFactory” implementiert. |
| Filter Expression | FilterExpressionEditoren werden von den anpassbaren Cockpits benutzt um Filterausdrücke zu bearbeiten. Für alle primitiven Datentypen und Special-Parts sind entsprechende FilterExpressionEditoren vordefiniert. Für “virtuelle Attribute” sind FilterExpressionEditoren zwingend erforderlich.
Es ist der Name einer Klasse einzutragen, die das Interface “com.cisag.pgm.search.gui.FilterExpressionEditorFactory” implementiert. |
| DataDescriptionFilter | Mit einem DataDescriptionFilter können bestimmte Eigenschafen der DataDescription zur Laufzeit modifiziert werden. Ein solcher Filter kann beispielsweise im Customizing “nachschlagen” und dann die DataDeschription auf “hidden” setzen.
Es ist der Name einer Klasse einzutragen, die das Interface “com.cisag.pgm.datatype.DataDescriptionFilter” implementiert. |
Darstellung
| Feld | Erläuterung |
| Maximale Feldbreite | Anzahl der sichtbaren Spalten (Zeichen) eines Feldes auf der Oberfläche.
Der Wert darf nicht mit der maximalen Anzahl von Zeichen z. B. bei Strings verwechselt werden. 0 ist der Vorschlagswert. Intern ist dieser auf 10 Spalten gesetzt. Im Standardlayout wird dieser Wert nicht berücksichtigt. |
| Inhaltstyp | Der ausgewählte Inhaltstyp hat Einfluss auf die Darstellung des Feldes und der Funktionalität in der Benutzeroberfläche:
· Aus Vererbung: Inhaltstyp ist im Basisobjekt definiert. · Email: Öffnet den lokalen E-Mail-Client mit der im Feld dargestellten Adresse. · Icon: Nicht implementiert. · ID: Eingabe von Großbuchstaben und Zahlen. Kleinbuchstaben werden automatisch in Großbuchstaben konvertiert. · Standard · Kennwort: Geschützte Eingabe, es werden nur Platzhalter „*“ angezeigt. · URL: Öffnet den im Feld dargestellten Link in einem neuen Browser. |
| Horizontale Ausrichtung | Dieses Feld legt fest, wie der Inhalt des Feldes in der Benutzeroberfläche horizontal ausgerichtet ist:
· Links = Linksbündig. · Mitte = Mittig. · Rechts = Rechtsbündig. · Aus Vererbung: Einstellungen aus Basisobjekt. · Standard: Abhängig vom Logischen Datentyp (Beispiel: Zahlen rechtsbündig, Zeichenketten linksbündig). |
| Eingabeformat | Dieses Feld wird noch nicht unterstützt. |
| Vertikale Ausrichtung | Dieses Feld legt fest, wie der Inhalt des Feldes in der Benutzeroberfläche vertikal ausgerichtet ist:
· Oben = oberer Rand. · Mitte = Mittig. · Unten = unterer Rand. · Aus Vererbung: Einstellungen aus Basisobjekt. · Standard: Abhängig vom Logischen Datentyp. |
| Ausgabeformat | Die Ausgabemaske wird in den Feldern com.cisag.pgm.gui.TimeField und com.cisag.pgm.gui.TimePointField bei der Ausgabe eines bestimmten Datumsformates verwendet.
Dafür sind folgende Konstanten definiert: · TIMESTAMP Pattern: dd.MM.yyyy HH:mm:ss:SSS (Zeitstempel mit Millisekunden). · DATE_TIME Pattern: dd.MM.yyyy HH:mm:ss (Zeitstempel ohne Millisekunden). · DATE Pattern: dd.MM.yyyy (Datum). · CALENDAR_WEEK Pattern: yyyy/ww (Kalenderwoche). · MONTH Pattern: MM.yyyy (Monat). · QUARTER Pattern: q/yyyy (Quartal). · YEAR Pattern: yyyy (Jahr). Diese Konstanten müssen in der Ausgabemaske angegeben werden. |