Daten-Info-Elemente
Daten-Info-Elemente dienen zur Anzeige von Daten auf Basis von Datensätzen (lesender Zugriff), wobei immer nur ein Datensatz angezeigt wird. Ein Daten-Info-Element kann als schreibgeschütztes Daten-Edit-Element mit einem Register und einer Teilmenge der Eigenschaften eines Daten-Edit-Elementes verstanden werden.
Mit diesen UI-Element können folgende Anwendungen in den Applikationen entwickelt werden:
- Detail-Element eines Master-Detail-Elementes
Eigenschaften des Daten-Info-Elementes
| Bereich | Eigenschaft | Wert |
|---|---|---|
| Allgemeines | Name (Name) | Name des Elements (für Anwender nicht sichtbar) |
Anhängen an Daten-Info-Element der Partner-Kennung (AppendToPartnerId, AppendToPackageId) | Partner- und Lösungs-Kennung (bei Sage „Sage“) des gleichnamigen Daten-Info-Elementes, an das diese Definition angehängt werden soll; Einsatzzwecke:
Hinweis: Anhängen ist immer einstufig, Verkettungen sind nicht möglich | |
Ersetzen (Replace) | Festlegung, ob das Original beim Anhängen an ein Daten-Info-Element ersetzt werden soll (bei Ja). Die Verwendung des Ersetzens ist nur für Ausnahmefälle gedacht. Dabei wird das Original vollständig ersetzt. Die Verantwortung dafür trägt der Entwickler der Erweiterung. In der Folge werden an das Original angehängte Daten-Info-Elemente nicht mehr beachtet. Soll angehangen werden, muss an das ersetzende Daten-Info-Element angehangen werden. Berechtigungen des Originals werden ebenfalls nicht mehr beachtet. Es sind eigene Berechtigungen zu definieren. Wird ein Daten-Info-Element mehrfach ersetzt, „gewinnt“ das ersetzende Daten-Info-Element, das die kleinste Partner-ID bzw. bei gleicher Partner-ID die kleinste Lösungs-Kennung hat. Bei Bedarf kann die Reihenfolge im AppDesigner angepasst werden. | |
Titel (Title) | Titel des Elementes (für Anwender sichtbar) | |
Beschreibung (Description) | Kurze Dokumentation des Daten-Info-Elementes | |
Dialoggruppe (GroupName) | Die Dialoggruppe legt die Gruppierung fest, in der das Element angezeigt werden soll. Diese wird beim Export und Import von Konfigurationen genutzt:
| |
Kommentar (Comment) | Beliebiger Kommentar zur Dokumentation. Der Kommentar wird nicht zum Client übertragen und dient nur zur Dokumentation von Besonderheiten, Hinweisen, etc. Bei Auslieferung/Weitergabe der Lösung wird der Kommentar eingeschlossen, so dass der Empfänger ihn im AppDesigner sieht. | |
| Daten | Datensatz (DataRecordPartnerId, DataRecordPackageId, DataRecordName) | Partner-Kennung, Lösungs-Kennung und Name für den verwendeten Datensatz |
Primärschlüssel 1 für Datensatz (PrimaryKey1) | Referenz auf „Schlüsselfeld 1-9“ zur Verwendung als Primärschlüssel für den Datensatz. In der Regel stimmen die Nummer der Schlüsselfelder mit den Nummern in den Eigenschaften "Primärschlüssel" überein. Es ist aber nicht zwingend erforderlich. Zur einfacheren Zuordnung (oder zur Überprüfung) kann ein visuelles Mapping der Schlüssel aufgerufen werden (Bearbeiten-Schaltfläche in den Eigenschaften):
| |
Primärschlüssel 2 für Datensatz (PrimaryKey2) | analog "Primärschlüssel 1 für Datensatz" | |
Primärschlüssel 3 für Datensatz (PrimaryKey3) | analog "Primärschlüssel 1 für Datensatz" | |
Primärschlüssel 4-9 für Datensatz (PrimaryKey4-9) (ab Version 9.0) | analog "Primärschlüssel 1 für Datensatz" | |
| Darstellung | Höhe (Pixel) (Height) | Standard-Höhe des Elementes in Pixel (Wertebereich 80 bis 760) |
Minimum-Höhe (Pixel) (MinimumHeight) | Minimale Höhe in Pixel (Wertebereich 80 bis 300). | |
| Ereignisse (Makros) | Beim Anzeigen (OnCurrent) | Makros, die nach dem Anzeigen eines vorhandenen Datensatzes aufgerufen werden. Das Ereignis wird auf Client-Seite ausgelöst. |
| Lizenzierung | Land (Country) | Land (additiv, -1 = alle Länder):
|
Lizenz-Kürzel (LicenseTokens) | Applikationskürzel der zu prüfenden Lizenz (nur in Nicht-Sage-Lösungen verwendbar und änderbar) | |
Lizenz-Kürzel für Sage (SageLicenseTokens) | Applikationskürzel der zu prüfenden Lizenz (nur in Sage-Lösungen verwendbar und änderbar) |
Eigenschaften der Daten-Info-Element-Feldgruppe
| Bereich | Eigenschaft | Wert |
|---|---|---|
| Allgemeines | Name Feldgruppe (Name) | Eindeutiger Feldgruppenname (für den Anwender nicht sichtbar) |
Feld-Attribute anhängen? (DoAppendTo) | Sollen Eigenschaften an gleichnamige Felder dieser Feldgruppe des in "Anhängen an..." referenzierten Daten-Info-Elementes angehängt werden? Einsatzzweck:
| |
Titel (Title) | Titel der Feldgruppe (für den Anwender sichtbar) | |
| Darstellung | Position (Position) | Standard-Position der Feldgruppe innerhalb des Registers |
Ebene (Level) |
(kann aus technischen Gründen nicht ausgeblendet oder gesperrt werden) | |
| Ebene basiert auf | keine Wirkung (kann aus technischen Gründen nicht ausgeblendet oder gesperrt werden) | |
Neue Zeile beginnen? (StartNewRow) | Festlegung, ob die Feldgruppe zwangsweise in einer neuen Feldgruppen-Zeile, d.h. nicht hinter der vorherigen Feldgruppe, angeordnet werden soll Wird nur bei "Ebene" = 0 unterstützt. | |
Feldgruppen-Rahmen? (ShowBorderLine) | Soll für die Feldgruppe ein Rahmen bzw. eine Überschrift (Darstellung abhängig vom UI-Layout) angezeigt werden? Wird diese Einstellung auf Nein gestellt, können Dialoge ohne optisch kenntlich gemachte Feldgruppen gestaltet werden. Hinweis:
|
Eigenschaften der Daten-Info-Element-Felder
| Bereich | Eigenschaft | Wert |
|---|---|---|
| Allgemeines | Feldname (Name) | Eindeutiger Feldname (referenziert Datensatz-Feld) |
Feld-Attribute anhängen? (DoAppendTo) | Sollen Eigenschaften an das gleichnamige Feld des in "Anhängen an..." referenzierten Daten-Info-Elementes angehängt werden? Einsatzzweck:
| |
Funktionalität (Functionality) | Funktionalität des Feldes:
| |
| Darstellung | Position (Position) | Standard-Position des Feldes innerhalb der Feldgruppe. Wenn die "Position" = 0 ist, hat das Feld keine Position und ist so lange nicht sichtbar, bis der Anwender es platziert |
Sichtbarkeit (Visibility) | Sichtbarkeit des Felds:
"Versteckt" bedeutet, dass der Benutzer dieses Feld niemals zu Gesicht bekommen kann, auch nicht über Konfigurationsdialoge, Spalten einblenden, etc. Der Feldwert kann aber wie bei jedem anderen Feld verwendet werden, z.B. in Makros oder Funktionen. Hat der Benutzer zur Laufzeit keine Lese-Berechtigung für dieses Feld, wird automatisch als Wert für "Sichtbarkeit" 2 an den Client gesendet. | |
Zeilenanzahl (NumberOfLines) | Zeilenzahl für mehrzeilige Eingabefelder bei Texten (die Höhe wird technisch so realisiert, dass das Feld ein Vielfaches der Höhe anderer Felder inkl. deren Abstände ist). Wertebereich 1 bis 12. | |
Feld Einheit (UnitField) | Feldname der ein Datensatz-Feld referenziert, welches die Einheit enthält | |
| Lizenzierung | Land (Country) | Land (additiv, -1 = alle Länder): 1 = Deutschland -1 oder jede beliebige Summe aus den Einzelwerten. Geprüft wird gegen das Land des aktuellen Mandanten. |
Lizenz-Kürzel (LicenseTokens) | Applikationskürzel der zu prüfenden Lizenz (nur in Nicht-Sage-Lösungen verwendbar und änderbar) | |
Lizenz-Kürzel für Sage (SageLicenseTokens) | Applikationskürzel der zu prüfenden Lizenz (nur in Sage-Lösungen verwendbar und änderbar) |
Beispiel
Die Artikelauskunft unter "Stammdatenlisten/ Artikel" soll dahingehend geändert werden, dass die Informationen zum Artikel nicht in der Feldliste, sondern in einer gruppierten Übersicht angezeigt werden sollen.
Wir legen folgende Metadaten an:
- Anlage der Datenquelle "dtsArtikelauskunft" mit dem Assistenten "Tabelle importieren" (KHKArtikel) und Auswahl der Felder "Artikelgruppe", "Artikelnummer", "Bezeichnung1" und "Bezeichnung2"
- "OL-Klassen der benutzerdefinierten Felder" = "Artikel"
- "SQL-Tabellen" = "KHKArtikel INNER JOIN KHKArtikelVarianten ON KHKArtikel.Artikelnummer = KHKArtikelVarianten.Artikelnummer AND KHKArtikel.Mandant = KHKArtikelVarianten.Mandant INNER JOIN KHKVariantenAnzeigeTexte ON KHKArtikelVarianten.AuspraegungID = KHKVariantenAnzeigeTexte.AuspraegungID AND KHKArtikelVarianten.Mandant = KHKVariantenAnzeigeTexte.Mandant"
- Anlage des Datenquellenfeldes "AuspraegungID"
- "SQL-Abfrage" = "KHKArtikelVarianten.AuspraegungID"
- "Datentyp" = "Integer"
- "Schlüsselfeld 2" = "AuspraegungID"
- Anlage des Datenquellenfeldes "AuspraegungText"
- "Titel" = "Variante"
- "SQL-Abfrage" = "CASE WHEN (KHKArtikel.Variante IS NOT NULL AND KHKArtikelVarianten.AuspraegungID = 0) THEN $[GetString(Sage,System,Common,10)] ELSE AuspraegungText END"
- Anlage des Listen-Elementes "lstArtikelauskunft" mit dem Assistenten "Datenquelle zuordnen"
- Auswahl der Datenquelle "dtsArtikelauskunft.<ihre_partnerid>.<ihre_loesungid>"
- "Kontextmenü" = "Artikel.Sage.Wawi"
- "für Wawi?" aktivieren
- Im Feld "AuspraegungID" die Eigenschaft "Sichtbarkeit" auf "Versteckt" stellen
- Anlage des Daten-Info-Elementes "infArtikelauskunft"
- "Datensatz" = "recArtikelstamm.Sage.Wawi"
- Anlage der Feldgruppe "Disposition"
- "Feldgruppen-Rahmen?" aktivieren
- Import der Felder "Bestellmenge", "Bestellzeitpunkt", "Dispofaktor", "Dispoformel" und "Meldebestand"
- Anlage der Feldgruppe "Verkauf"
- "Feldgruppen-Rahmen?" aktivieren
- Import der Felder "IstVerkaufsartikel", "SachkontoVK", "Verkaufsmengeneinheit", "DezimalstellenVK" und "SachkontoVKMatchcode" ("Sichtbarkeit" = "Versteckt")
- Anlage der Feldgruppe "Lager"
- "Neu Zeile beginnen?" aktivieren
- "Feldgruppen-Rahmen?" aktivieren
- Import der Felder "Lagerfuehrung", "Lagermengeneinheit", "DezimalstellenLager", "UmrechnungsFaktorLME" und "Lagerbestand"
- Anlage der Feldgruppe "Einkauf"
- "Feldgruppen-Rahmen?" aktivieren
- Import der Felder "IstBestellartikel", "SachkontoEK", "Hauptlieferant", "KalkulatorischerEK", "LetzterEK", "HauptlieferantMatchcode" ("Sichtbarkeit" = "Versteckt") und "SachkontoEKMatchcode" ("Sichtbarkeit" = "Versteckt")
- Anlage des Master-Detail-Elementes "mdtArtikelstamm"
- "Titel" = "Artikelauskunft"
- "Titel Detailbereich" = "Dispo, Verkauf, Lager und Einkauf"
- "Master-Element" = "lstArtikelauskunft.<ihre_partnerid>.<ihre_loesungid>"
- "Detail-Elemente" = "infArtikelauskunft.<ihre_partnerid>.<ihre_loesungid>"
- "für Wawi?" aktivieren
- "Ersetzen" aktivieren
- "Anhängen an Master-Detail-Element der Partner-Kennung" = "Sage.Wawi"
Die Verbindung zwischen gewählten Datensatz im Master-Element und der Anzeige der abhängigen Daten erfolgt bei einem Detail-Listen-Element über die Eigenschaft "SQL-Where-Bedingung für Child-Elemente". Bei einem Daten-Info-Element erfolgt die Verbindung wie zwischen einem Navigationselement und einem Daten-Edit-Element. Es sind also die Schlüsselfelder der Tabelle in der Datenquelle des Master-Detail-Elementes zu hinterlegen. Da wir das Kontextmenü "Artikel.Sage.Wawi" verwenden und die Kontextmenüeinträge die Parameter KeyField(1) = Artikelnummer und KeyField(2) = AuspraegungID verwenden, sind in der Datenquelle diese Felder bereits hinterlegt worden. Im Daten-Info-Element fehlt noch die Zuordnung.
Selektieren Sie das Daten-Info-Element "infArtikelauskunft" und tragen Sie in "Primärschlüssel 1 für Datensatz" = "1" und "Primärschlüssel 2 für Datensatz" = "2" ein.
Rufen Sie in der Applikation Warenwirtschaft aus dem Regiezentrum "Stammdatenlisten/ Artikel" den Menüpunkt "Artikelauskunft" auf. Sie erhalten diese Auskunft:
