Universal Netplans

<< Click to Display Table of Contents >>

Navigation:  Administration > INI File >

Universal Netplans

Previous pageReturn to chapter overviewNext page

 

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:

 

clip0063

 

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.

 

clip0004

 

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:

 

clip0037

 

clip0038

 

clip0046

 

 

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).

 

clip0060

 

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):

 

clip0014

 

And fields visible in the Search window for Job and Application are different and correspond to the configuration:

 

clip0061

 

clip0062

 

 

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.