Mit einem einfachen Code-Schnipsel kann die Gruppierung von Grids voreingestellt werden.
Um die Gruppierung von Grids voreinzustellen
- Aktivieren Sie im Web Designer am Grid-Knoten die Eigenschaft Erweiterte Eigenschaften.
- Fügen Sie am Grid-Knoten unterhalb des Eintrags Erweitere Eigenschaften einen neuen Knoten vom Typ Code-Snippet ein.
- Wählen Sie am neuen Knoten die Eigenschaft Code und bearbeiten Sie den Wert.
- Erfassen Sie folgenden Quelltext:
var dataSource = GridBand1.DataSource;
var col = dataSource.Table.GetColumn("UID_Department");
if (!dataSource.GroupingColumns.Contains(col))
dataSource.GroupingColumns.Add(col);
HINWEIS: Beachten Sie, dass Sie für GridBand1 der Bezeichner, der gewünschten Grid-Ebene und für UID_Department den gewünschten Namen der Spalte wählen, nach der gruppiert werden soll.
In der Datenbankschicht ausgelöste Fehlermeldungen beziehungsweise Exceptions (zum Beispiel Formatskripte an Datenbankspalten) werden im Web Portal mit einer allgemeinen Fehlermeldung zur Anzeige gebracht, da eine Ausnahme in den meisten Fällen für den Endanwender zu viele technische Details enthält.
Soll ein kundenspezifischer Fehlertext im Web Portal angezeigt werden, so muss aus dem Skript eine Exception mit der genauen Relevanz für den Endanwender ausgelöst werden. Sie haben folgende Möglichkeiten.
- Enduser
- Default
- Intermediate
- Technical
HINWEIS: Exceptions werden jedoch unabhängig von der Relevanz für den Endanwender immer vollständig im Protokoll der Webanwendung gespeicher.
Beispiel für ein Formatskript auf einer Datenbankspalte, die nicht mit einem Punkt enden darf
If Value.ToString().EndsWith(".") Then
Throw New ViException(#LD("This property may not end in a period sign.")#, ExceptionRelevance.EndUser)
End If
Bilder, die als kompilierte Ressourcen in einer der beiden Dateien VI.ImageLibrary.dll oder WebDesigner.ImageLibrary.dll liegen, können Sie durch Projektdateien ersetzen.
HINWEIS: Es ist nicht möglich ersetzte Bilder auf der Anmeldeseite zu verwenden, wenn die Webanwendung gegen einen Anwendungsserver läuft.
HINWEIS: Bevor Sie ein Bild ersetzen können, müssen Sie das zu ersetzende Bild und die damit zusammenhängenden Informationen wie Quelle, Dateiname und Größe und Status ermitteln.
Quelle ermitteln
Es gibt verschiedene Möglichkeiten, mehr Informationen über die Eigenschaften eines Bildes zu erhalten. Unter anderem können Sie die erforderlichen Informationen über die Bild-URL ermitteln. Über die Anzeige der Eigenschaften erfahren Sie unter anderem auch die richtige Quelle. Die Quelle VI.ImageLibrary erkennen Sie am Ausdruck stockImg. Der Ausdruck Img steht für die Quelle WebDesigner.ImageLibrary.
Datei ermitteln
Auch den Namen der Bild-Datei erfahren Sie über die Bild-URL. Der Dateiname steht direkt hinter der Quelle und könnte beispielsweise so aussehen:
stockImg=AssignedDirect
Größe ermitteln
Dieser Wert ist nur für Dateien aus der Quelle VI.ImageLibrary.Images erforderlich. Sie erhalten den Wert über die Bild-URL. Der Wert könnte beispielsweise so aussehen:
size=Small
Status ermitteln
Der Status ist nur relevant für Bild-Dateien aus der Quelle VI.ImageLibrary.Images. Auch dieser Wert kann über die Bild-URL ermittelt werden. Der Status könnte beispielsweise so aussehen:
state=Normal
Für die beiden verschiedenen Ressourcen-Dateien herrschen unterschiedliche Regeln für den Dateinamen, die im Folgenden getrennt voneinander erläutert werden:
Regeln für Dateinamen eines Bildes aus einer VI.ImageLibrary.dll
In der Datei VI.ImageLibrary.Images.dll sind die Ressourcen nach folgendem Namensschema abgelegt:
VI.ImageLibrary.Images.<Größe>.<Name des Bildes> <Pixel> <Status> p.png
Zum Beipsiel:
VI.ImageLibrary.Images.Small.DeleteDocument 16 n p.png
Die Werte für <Größe> und <Pixel> einer Ressourcen-Datei müssen zueinander passen.
Tabelle 70: Mögliche Werte für Größe und Pixel einer Ressource
| Small |
16 |
Bild in 16x16 Pixel |
| Medium |
24 |
Bild in 24x24 Pixel |
| Large |
32 |
Bild in 32x32 Pixel |
Der Status einer Ressource kann folgende Werte annehmen:
Tabelle 71: Statuswerte einer Resssource
| d |
deaktiviert |
| n |
Normal |
| h |
"Highlighted", heller eingefärbt |
WICHTIG: Bei dieser URL muss die Groß-/Kleinschreibung beachtet werden.
Regeln für Dateinamen eines Bildes aus WebDesigner.ImageLibrary.dll
In der Datei VI.WebDesigner.ImageLibrary.dll sind die Ressourcen nach folgendem Namensschema abgelegt:
VI.WebDesigner.ImageLibrary.<Name des Bildes>.png
Zum Beisipiel:
VI.WebDesigner.ImageLibrary.filter-small.png
Um ein Bild aus einer Ressourcen-Datei zu ersetzen
- Identifizieren Sie gegebenenfalls mit einer geeigneten Software den Namen des gewünschten Bildes in der Ressourcen-Datei.
Je nachdem um welche Ressourcen-Datei es sich handelt, gibt es unterschiedliche Namensschemata zu beachten.
- Erstellen Sie im Web Designer eine Projektdatei gleichen Namens und speichern Sie diese.
HINWEIS: Beachten Sie, das Bilder aus Ressourcen-Dateien gegebenenfalls im Cache des Browser liegen können.
Mit dem Web Designers werden Einstellungsmöglichkeiten zur barrierefreien Bedienung des Web Portals zur Verfügung gestellt. Um die Kompatibilität existierender Installationen nicht zu gefährden, müssen diese Einstellungen explizit vorgenommen werden. Dafür können Sie das Skript VI_GetWebSettings verwenden. Das Skript VI_GetWebSettings wird, sofern es im System definiert ist, nach jeder erfolgreichen Anmeldung aufgerufen. Es gibt eine Menge an Schlüssel/Wert-Paaren zurück, mit denen bestimmte Einstellungen aktiviert werden können. Diese Einstellungen gelten nur für die aktuelle Sitzung, für die Sie sich authentifiziert haben. Abhängig vom angemeldeten Benutzer, können unterschiedliche Konfigurationen verwendet werden.
Folgende Schlüssel und Werte sind möglich.
Tabelle 72: Einstellungsmöglichkeiten
| BaseCssClass |
String |
Werte:
TIPP: Sie können mehrere Werte durch ein Leerzeichen getrennt angeben. |
| GridGroupByDisabled |
Bool |
Wenn der Wert true ist, wird im Grid keine Möglichkeit zur Gruppierung angeboten. |
| GridResizeDisabled |
Bool |
Wenn der Wert true ist, wird im Steuerelement Grid keine Möglichkeit zur Änderung der Spaltenbreiten angeboten. |
| EnableHighAccessibility |
Bool |
Wenn der Wert true ist, werden Steuerelemente mit erhöhter Barrierefreiheit dargestellt. |
Das folgende Beispielskript verdeutlicht, wie die Einstellungen vorgenommen werden können.
Public Function VI_GetWebSettings() As System.Collections.Generic.Dictionary(Of String, Object)
Dim settings As New System.Collections.Generic.Dictionary(Of String, Object)
settings.Add("GridGroupByDisabled", True)
settings.Add("GridResizeDisabled", True)
settings.Add("BaseCssClass", "imx-highaccessibility")
' return settings
VI_GetWebSettings = settings
End Function
