Error messages or exceptions triggered in the database layer (for example, format scripts on database columns) are displayed in a general error message in the Web Portal because exceptions normally contain too much technical detail for the end user.
If a custom error text is displayed in the Web Portal, the script must trigger an exception with exactly the same relevance for the end user. You have the following options.
|
NOTE: However, exceptions are always saved in full in the Web application log, regardless of the relevance for the end user. |
You can replace images that are in kept as compiled resources in one of the files VI.ImageLibrary.dll or WebDesigner.ImageLibrary.dll with project files.
|
NOTE: It is not possible to use replaced images on the login page if the web application is executing against an application server. |
|
NOTE: Before you can replace an image, you must determine the image to be replaced and its associated information, such as, source, file name and, if necessary, size and status. |
There are different ways to obtain more information about an image's properties. You can, for example, find the required information about the image URL. Use the property view to determine the correct source. You can recognize the source VI.ImageLibrary by the name stockImg. The name Img stands for the source, WebDesigner.ImageLibrary.
You can also find the name of the image file through the image URL. The file name is directly after the source and could look like:
stockImg=AssignedDirect
This value is only required for file from the VI.ImageLibrary.Images source. You obtain the value through the image URL. The value could look like this:
size=Small
The state is only relevant for image files from the VI.ImageLibrary.Images source. This value can also be found from the image URL. The state could look like this:
state=Normal
There are different rules for the file names of both types of resource file, which are explained separately in the following:
Resources are stored with the following name format in the VI.ImageLibrary.dll file:
VI.ImageLibrary.Images.<Größe>.<image name> <Pixel> <Status> p.png
For example:
VI.ImageLibrary.Images.Small.DeleteDocument 16 n p.png
The values for <Size> and <Pixel> of a resource file must match.
<size> | <pixel> | Description |
---|---|---|
Small | 16 | Image in 16x16 pixels |
Medium | 24 | Image in 24x24 pixels |
Large | 32 | Image in 32x32 pixels |
This resource state can have the following values:
<state> | Description |
---|---|
d | Not set |
n | Normal |
h | "Highlighted", emphasized color |
|
IMPORTANT: This URL is case-sensitive. |
Resources are stored with the following name format in the WebDesigner.ImageLibrary.dll file:
VI.WebDesigner.ImageLibrary.<image name>.png
For example:
VI.WebDesigner.ImageLibrary.filter-small.png
To replace an image from a resource file
There are different name format depending on which resource file is being dealt with.
|
Note: Ensure that images from resource files can be cached in the browser if necessary. |
Web Designer offers setting options for barrier-free access to the Web Portal. To protect the compatibility of existing installations, these settings must be applied explicitly. You can use the VI_GetWebSettings script for this. The VI_GetWebSettings script is called up after each successful login, as long as this script is defined in the system. The script returns several key/value pairs that can enable specific settings. These settings only apply to the current session for which you have been authenticated. Different configurations can be implemented depending on the current user.
The following keys and values can be used.
Key | Value type | Description |
---|---|---|
BaseCssClass | String | The imx-highaccessibility value enables CSS rules to improve accessibility. |
GridGroupByDisabled | Bool | If the value is true, no grouping will be offered in the grid. |
GridResizeDisabled | Bool | If the value is true, no column width modification will be offered in the grid control. |
EnableHighAccessibility | Bool | If the value is true, the controls are displayed with increased accessibility. |
The following example scripts tries to show how the settings should be made.
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
© 2023 One Identity LLC. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy