<< Click to Display Table of Contents >> Universal Netplans |
![]() ![]() ![]() |
SmartIS PC Client supports universal netplans, which can be configured in the INI file. The number of universal netplans is unlimited. You can set the appearance of each universal netplan individually both in Options and in the INI file. Universal netplans setting can be configured in [UNIVERSAL_NETPLANS] section of the INI file. Setting in Options is available only for netplans configured also in the INI file.
The most simple setting looks like this:
[UNIVERSAL_NETPLANS]
GRAPHUNI001.LABEL = "My New Netplan"
The first token GRAPHUNI001 is a name of the display. It must be valid universal display name created by the Display Generator on the server. The name must be in GRAPHUNIXYZ format, where XYZ are any letters or digits.
The LABEL option sets a title of the display. This title is visible in Options in Netplans - Universal category.
Even the minimal setting shown above is sufficient for marking GRAPHUNI001 as a netplan in SmartIS PC Client. If you connect to the server then you should see a netplan icon next to the display name in the workspace.
As all universal netplans are derived from GRAPHUNI display, they have UNIFIELD01 - UNIFIELD10 columns in the database table. By default, the client shows Field 01 - Field 10 legends of these columns, as shown in the following picture:
Also the filter dialog shows Field 01 - Field 10 by default.
This is acceptable in many cases, but it is also possible to show more precise legends and only fields that are really used. You can set it by FIELD options. For example:
GRAPHUNI001.FIELD.UNIFIELD01 = "Workstation"
GRAPHUNI001.FIELD.UNIFIELD02 = "App Id"
GRAPHUNI001.FIELD.UNIFIELD03 = "Jobname"
GRAPHUNI001.FIELD.UNIFIELD04 = "Op. No."
As a result, common fields and only four universal fields with modified legends are displayed both in Details Window and in the Filter. Also Node Styles options shows modified legends of universal fields.
Another setting allows you to change names of nodes and links.
The default node names are:
•ARROW-LEFT
•ARROW-RIGHT
•ELLIPSE
•IF
•OVAL
•PARALLELOGRAM
•RECT
•ROUNDED-RECT
•TRIANGLE
•TRIANGLE-UP.
The default link names are:
•LINK-DASHED
•LINK-DASHED-DOTTED
•LINK-DOTTED
•LINK-SOLID
These names say nothing about the real meaning of nodes and that's why you can overwrite them by NODE and LINK options:
GRAPHUNI001.NODE.ARROW-RIGHT = "Application"
GRAPHUNI002.NODE.ROUNDED-RECT = "Job"
GRAPHUNI002.LINK.LINK-SOLID = "Internal Link"
As a result, ARROW-RIGHT symbol name is changed to Application, ROUNDED-RECT is changed to Job and LINK-SOLID is changed to Internal Link.
These new names are visible both in Options and also in the Legend Bar:
You can also use DETAILS option to configure data fields that are visible in the Details window:
GRAPHUNI001.DETAILS.ARROW-RIGHT = "UNISYSTEM;UNIFIELD01;UNIFIELD02"
GRAPHUNI001.DETAILS.ROUNDED-RECT = "UNISYSTEM;UNIFIELD01;UNIFIELD02;UNIFIELD03;UNIFIELD04"
This code ensures that UNISYSTEM (its default legend is System) and UNIFIELD01 and UNIFIELD02 (which are renamed to Workstation and App Id) are displayed if you open the Details window of ARROW-RIGHT node (which is renamed to Application).
The system and four universal fields (i.e. Workstation, App Id, Jobname, Op. No.) are displayed for ROUNDED-RECT node (renamed to Job).
Field names in the DETAILS option must be separated by a semicolon. If you do not specify any FIELD option then all common fields and all universal fields are displayed. If FIELD option is set then you can use all common fields and only such universal fields that are specified by FIELD option.
Common fields are: XXRDATCLIENT, XXRDATENV, UNISYSTEM, UNIPRED, UNISUCC, UNILINK, UNISYMBOL
Universal fields are: UNIFIELD01 - UNIFIELD10
The last available option SEARCH sets what fields are part of the the Search window. Fields in the Search window may be therefore different to fields visible in Details window. You can use the same fields like in DETAILS option.
GRAPHUNI001.SEARCH.ARROW-RIGHT = "UNISYSTEM;UNIFIELD01;UNIFIELD02"
GRAPHUNI001.SEARCH.ROUNDED-RECT = "UNISYSTEM;UNIFIELD01;UNIFIELD02;UNIFIELD03;UNIFIELD04"
If you click on the Search icon, you can see renamed objects (Job and Application):
And fields visible in the Search window for Job and Application are different and correspond to the configuration:
You do not have to set all these options. This example shows all options together:
[UNIVERSAL_NETPLANS]
GRAPHUNI001.LABEL = "My New Netplan"
GRAPHUNI001.FIELD.UNIFIELD01 = "Workstation"
GRAPHUNI001.FIELD.UNIFIELD02 = "App Id"
GRAPHUNI001.FIELD.UNIFIELD03 = "Jobname"
GRAPHUNI001.FIELD.UNIFIELD04 = "Op. No."
GRAPHUNI001.NODE.ARROW-RIGHT = "Application"
GRAPHUNI001.NODE.ROUNDED-RECT = "Job"
GRAPHUNI001.LINK.LINK-SOLID = "Internal Link"
GRAPHUNI001.DETAILS.ARROW-RIGHT = "UNISYSTEM;UNIFIELD01;UNIFIELD02"
GRAPHUNI001.DETAILS.ROUNDED-RECT = "UNISYSTEM;UNIFIELD01;UNIFIELD02;UNIFIELD03;UNIFIELD04"
GRAPHUNI001.SEARCH.ARROW-RIGHT = "UNISYSTEM;UNIFIELD01;UNIFIELD02"
GRAPHUNI001.SEARCH.ROUNDED-RECT = "UNISYSTEM;UNIFIELD01;UNIFIELD02;UNIFIELD03;UNIFIELD04"
If you have more universal netplans, you must configure all of them in one [UNIVERSAL_NETPLANS] section. You only have to use correct display name (GRAPHUNI001, GRAPHUNI002, ...). You can also redefine the default GRAPHUNI dispaly name (without additional 3 letters) in the same way.