• Inhaltsverzeichnis
• 3950 Dashboard
  • Möglichkeiten für Kunden
  • Anwendungsbeispiele
  • Erstellung
  • TileControl
  • LayoutControl
    • Grid
    • Einstiegsfilter
    • Chart
    • Groups
  • Synchronisierung
  • Dashboard-Konfiguration (TLayoutFrameGrid)
    • _StandardSQL / _StandardSQLWrap
      • Macro-Verhalten mit _StandardSQL
    • _Config (INI-ähnlich)
      • Beispiel _Config
    • _SQLUpdate (Hinweis: Property heißt _SQLUpdate, nicht _UpdateSQL)
    • _MultiSelect
    • Wichtige Kombinationen

3950 Dashboard¶

Einstiegsvideo: Y:\KUNDENDATEN\CIMPCS\Intern\Arbeitsunterlagen\Schulungsvideos\Admin\Dashboard

Tastenkombinationen

STRG + Rechte Maus auf Objekt = Administrierfunktionen

Hauptmenü ~> Alle Quellen Durchsuchen = SQL Gehirn

Möglichkeiten für Kunden¶

1. Kundeneigene Erstellung von Dashboards
2. Nutzung vorgefertigter ProdatStandardDashboards
3. Entwicklung von kundenspezifischen Dashboards durch CIMPCS

Anwendungsbeispiele¶

Dashboard Beispiele

Erstellung¶

Aufpassen: beim Schließen wird nicht automatisch nach Speichern gefragt!

• Hauptmenü-Eintrag erstellen mit action: dashboard und proc: Dashboard-Kennzeichen zum Beispielzum Beispiel

  

• Dashboard öffnen
• Zahnrad / Bearbeiten AufklappenAufklappen

  

• Panel links / Popupmenu / Neue Seite erstellen AufklappenAufklappen

  

  • und folgende Parameter eingeben:
    • Menu.Caption
    • Menu.Hint
    • Menu.ImageIndex (Passende Icon von USysModule/ImageListHot)
  • die Parameter kann man später über Panel links / Popupmenu / Aktuelle Seite editieren anpassen
  • Seiten sind mit drag-n-drop miteinander kombinierbar (kann man als Baumstruktur darstellen) zum Beispielzum Beispiel

    

TileControl¶

• Editierte Seite auswählen
• Zahnrad / Erstellen AufklappenAufklappen

  

• Kontextmenü > Item bearbeiten
  • Name (Komponentname, also Groß- und Kleinschreibung ist nicht von Bedeutung, jedoch dürfen nur Buchstaben, Zahlen und der Unterstrich verwendet werden. Der Name muss mit einem Buchstaben beginnen)
  • Text 1 (oben links)
  • Text 2 (oben rechts)
  • Text 3 (unten links)
  • Text 4 (unten rechts)
  • MainMenu-Link (mm_id)
  • Font.Size(1)
  • Font.Size(2-4)
  • ImageIndex (Glyph = False) [wovon geladen / wie kann man bedienen?] Vorschlag: löschen und Image von oben ausgewählter mm_id laden.
  • mit Schift+Linksklick kann man die Größe anpassen (werden vorgegebene Größe nacheinander gesetzt)
  • BeispielBeispiel

    

LayoutControl¶

• Editierte Seite auswählen
• Zahnrad / Erstellen AufklappenAufklappen

  

• LayoutControl
• Popupmenu von LayoutControl:
  • Eigenschaften: heir kann man aktuell nur die Höhe anpassen
  • LayoutControl-Customizer: visuelle Layouteditor (Gruppierung, Positionierung, Ausrichtung, Umbenennung usw)

Offen: wie erzeugt man ein Split Element?

Grid¶

• Hinzufügen / Grid
• Popupmenu von Grid AufklappenAufklappen

  

  • Erste zwei Zeilen: automatisch generierte Namen von Frame und Layout zur Info
  • bei SQL kann man Standard-SQL-Name eingeben oder direkte SQL-Statement: zum Beispielzum Beispiel

    SELECT
      dbrid,
      ak_nr,
      ak_bez 
    FROM
      art 
    LIMIT 5
    

    

  • Parent anpassen für Master-Detail-Beziehungstabellen geeignet, zum Beispielzum Beispiel

    Erstellen zweite LayoutControl mit Grid
    

    SELECT
      r_descr,
      r_unit,
      r_value 
    FROM
      recnokeyword
    WHERE
      r_dbrid = :dbrid
    

    
    und setzen Beziehung zum erstem Frame
    

• Suche per Suchbegrif SQLSQL

  SELECT
    [...]
  FROM adk
  WHERE (:edSearch = '' OR tadk.tsvector(adk) @@ to_tsquery('simple', :edSearch || ':*'));   --- Suche
  

Einstiegsfilter¶

• Daten werden erst nach Enter-Taste in Suchfeld oder nach Suchen-Button Klick geladen AufklappenAufklappen

  

• Ganze Funktionalität nur bei Hauptframe möglich (wo keinen Parent angegeben ist)
• Aktivieren für das Grid: AufklappenAufklappen

  

• Filter-Liste sind Einträge von der datarowstate Tabelle
• BSP: AufklappenAufklappen

  

  
  

  INSERT INTO datarowstate (drs_type, drs_code, drs_sort, drs_filtersql, drs_textnr, drs_defregister)
                    VALUES ('CRM_dframe_Angebote_MA_lcFrame_angebbylkn', 's30Tage',   10, 'COALESCE(_auftg.modified_date > (CURRENT_DATE - INTERVAL ''30 DAY'')::DATE, false)', 4624, false), --Letzte 30 Tage
                           ('CRM_dframe_Angebote_MA_lcFrame_angebbylkn', 'sPosFirst', 20, '(SELECT MIN(ag_pos) FROM auftg AS _auftg WHERE _auftg.ag_nr = ag_nr) = ag_pos', 26573, true);  --Nur erste Position
  

• drs_type ist der Grid-Name. Dieser wird im Edit-Modus im Popupmenü angezeigt AufklappenAufklappen

  

Chart¶

• Hinzufügen / Chart
• Popupmenu von Chart
  • Parent anpassen und SQL analor Grid (siehe oben)
  • Eigenschaften: AufklappenAufklappen

    

    • GroupCaption
    • x[x] (Bezeichnung und Farbe definieren)
    • y[y1](Bezeichnung und Farbe definieren)
    • [y2] (Bezeichnung und Farbe definieren)
    • [y3] (Bezeichnung und Farbe definieren)
    • ToolBox (um Diagrammdarstellung im Laufzeit zu ändern)
    • ChartType (Beschreibung)
    • LegendPosition
  • Beispiel: AufklappenAufklappen

    SELECT
     ag_bdat,
     SUM(ag_brutto_basis_w) AS sum_brutto,
     SUM(ag_netto_basis_w) AS sum_netto
    FROM
     auftg
    WHERE
     ag_astat='E'
    AND
     NOT ag_done
    GROUP BY
     ag_bdat, ag_lkn
    ORDER BY
     sum_netto DESC
    LIMIT 8
    

    Eigenschaften:
    

    Diagramm:
    

• WICHTIGER HINWEIS: seit 22.05.2025 wurde bei Charts die Eigenschaft _YSeries implementiert, wenn Sie mit neuer Version alte Diagrammen anpassen möchten, sollen die als veraltete alte Eigenschaften verwendet werden, die orange markiert sind (für neue Version werden die komplett ignoriert) AufklappenAufklappen

  

Groups¶

Groups können sowohl als statische Gruppierung, als auch als Registerfenster verwendet werden.

~> Layout-Control Customizer > Kontextmenü der Gruppe > Layout Direction

Synchronisierung¶

WICHTIGER HINWEIS: Von Kunden vorgenommene Änderungen an Prodat-Dashboards können nicht zusammengeführt werden und werden bei der Synchronisierung überschrieben.

• Dashboards werden als OPTIONS (component_options) auf den SyncServer (PRODAT-18.08) synchronisiert und stehen damit für alle Kunden zur Verfügung
• Bei neuen Dashboards ist zusätzlich der neu erstellte Hauptmenüpunkt auf den SyncServer hochzuladen

---

Dashboard-Konfiguration (TLayoutFrameGrid)¶

_StandardSQL / _StandardSQLWrap¶

Es besteht die Möglichkeit die Dashboard-Tabellen mittels StandardSQL zu befüllen, oder diese als Grundlage für eine weitere SQL-Query zu nehmen:

Dazu geht man zunächst in den Bearbeiten-Modus (1), stellt dann eine StandardSQL ein, und kann dann (optional, 2) diese als Grundlage für weitere SQL-Bearbeitung nehmen:

SELECT * FROM (&standard_sql
) AS standard_sql

Es ist zu berücksichtigen, dass für die initiale standard_sql - Query die Syntax genau so (inklusive Zeilenumbrüchen) aussehen muss.
Achtung: Der AutoCheck wird beim Term &standard_sql fehlschlagen (intern definiertes Makro) - die Fehlermeldung an dieser Stelle kann man hier aber ignorieren.

Property	Wirkung
_StandardSQL	Lädt SQL aus systemsqlstatement (inkl. sql_macro-Mechanik).
_StandardSQLWrap	Erlaubt Wrapping-Statement mit Macro &standard_sql (Inhalt des geladenen _StandardSQL).

Macro-Verhalten mit _StandardSQL¶

• sql_macro-Einträge aus dem StandardSQL werden wie bisher berücksichtigt.
• Zusätzlich können Macros über _Config in [Settings] überschrieben werden (nur wenn das Macro im Query vorhanden ist).
• Schreibweisen für _Config-Macrokeys: &macroname=... oder macroname=....

_Config (INI-ähnlich)¶

Key	Typ	Default	Wirkung
FieldAliasViewTableName	String	leer	Setzt Alias-Tabelle für Feldbezeichnungen im Grid.
BtMode	Boolean	false	Vor Speichern fragen (Grünes Icon ganz links oben neben Tabelleneinstellungen )
Submenus	Boolean	false	Steuert Submenüs im Popup für „Bearbeitbare Felder“ und Pivot-Menüeinträge.
UpdateEditIcon	Boolean	true	Steuert Stift-Icon bei editierbaren Feldern (true = anzeigen, false = ausblenden).
PivotDirectEdit	Boolean	false	Erlaubt direkte Bearbeitung von Pivot-Feldern auch ohne _SQLUpdate (nur Pivot-View).
EditableFields	CSV/String	leer	Felder, die editierbar gesetzt werden (zusätzlich zur Pivot-Logik).
FixedColumns	CSV/String	leer	Felder, die im linken Fixed-Band fixiert werden.
&<MacroName> oder <MacroName>	String	abhängig von sql_macro	Überschreibt vorhandene Query-Macros aus _StandardSQL/sql_macro zur Laufzeit.

Beispiel _Config¶

[Settings]
EditableFields=ag_freigabe,ag_prio
FixedColumns=ag_nr,ag_kunde
Submenus=true
UpdateEditIcon=false
PivotDirectEdit=true
&macrowhere= AND ak_fertigung

Achtung: ein _Config macro zu verwenden sollte bevorzugt gegenüber _StandardSQLWrap verwendet werden. Die Pivot-Funktionen stehen sonst nicht zur Verfügung, wenn der Pivot-Aufruf im StandardSql definiert ist.

_SQLUpdate (Hinweis: Property heißt _SQLUpdate, nicht _UpdateSQL)¶

Wert	Wirkung
gesetzt (nicht leer)	Aktiviert normalen Edit-/Post-Update-Pfad (SQLUpdate, Grid Editing, Post/Cancel).
leer	Normales SQL-Update deaktiviert (read-only), außer PivotDirectEdit=true in Pivot-Views.

Priorität: _SQLUpdate hat Vorrang. Wenn _SQLUpdate gesetzt ist, bleibt der Standard-Updatepfad aktiv; PivotDirectEdit wirkt dann nur ergänzend.

_MultiSelect¶

Wert	Wirkung
true	Mehrfachselektion im Grid aktiv; relevant für Sammelaktionen im Popup (z. B. boolesche Feldänderungen).
false	Einzelselektion.

Wichtige Kombinationen¶

1. _SQLUpdate gesetzt + EditableFields gesetzt: klassischer editierbarer Grid-Betrieb.
2. _SQLUpdate leer + PivotDirectEdit=true: Pivot-Felder direkt bearbeitbar (Direktspeicherung über RecNoParam-Pfad).
3. Submenus=true: Popup gruppiert Bearbeitungs- und Pivot-Einträge in Untermenüs.
4. UpdateEditIcon=false: editierbare Felder ohne Stift-Icon.