Please note: The remote preview client application has been decommissioned in version 3.5.1 and all related settings have been removed. It is only available for previous versions. The articles will be removed soon.

The preview client section explains how to use the preview client.

The configuration is divided into four parts:

1.Enable of the preview option globally on the InterFormNG2 host.

2.The main configuration of the preview client.

3.The log configuration of the preview client.

4.You also need to enable the use of the preview client in the designer.

Configure preview globally on the InterFormNG2 host

Before you can use the preview client you need to enable it globally in InterFormNG2. You do that by signing on as a system administrator and then configure preview connections to the host as described in the section, Remote Design preview setup.

On the host you need to decide what port number to use for previews. This is default 8110 and should also be referenced on the client settings below as the preview port.

If you want a secure https connection, then you also need to setup a keystore on the host (recommended) or to use the internal demo keystore of InterFormNG2.

Please note, that you need to stop and start the InterFormNG2 service (on the host) in order to active any change on the host preview configuration.

After a restart of the service, you should consider checking the system log to verify, that the keystore and matching password could be used.

Main configuration

The first time you start the InterFormNG2 preview client you will see this in the middle of the pop up window:

Each of the parameters are covered below:

1. Protocol
   Here you setup how secure the connection should be. The possible values are:
   http: If you select this, then the connection is unsecure, but it easier to setup. You can e.g. first ensure, that you can get an unsecure connection and then switch https, when you are sure that the http value works.
   https: This sets up a secure connection, but for this you also need to configure a keystore and setup a keystore path and password below.
2. Host
   The machine, where InterFormNG2 is running. If you are running the preview client on the same machine as InterFormNG2, then you should here type localhost or 127.0.0.1.
3. Service port
   This is the port number, that you use for accessing the InterFormNG2 web interface on the host. The default value in InterFormNG2 is 8086, so you should probably change the value to that.
4. Preview port
   Specify the port via which the preview client should preview. This must match the port number specified on the hosts global preview settings.
5. Keystore path
   This is the path to the local keystore, that should be used for the preview client. The local keystore should match the preview keystore of the host. The default value refers to a simple built in keystore, but it is recommended to use your own keystore. If you refer to your own keystore then you should specify the full path to the keystore file like e.g. C:\Program Files\InterFormNG2\keystore. This is covered in the section: Create a keystore for the preview client.
6. Keystore password
   Here you type the password for the local keystore. This parameter is optional. If the keystore has no password, then you can of course ship this parameter.
7. Tenant
   Here you type the name of the tenant on the InterFormNG2 host, that you want to connect to. If the InterFormNG2 host only has a single tenant, then you can leave this blank.
8. User name
   The user on the tenant that is used for signing on to the InterFormNG2 host.
9. Password
   The password for the user specified above on the InterFormNG2 host.

Log configuration

In the bottom of the Preview client configuration, you can setup the log level of messages, that you want to see in the preview client:

    

The default and recommended setting is shown above. Especially debug and trace should be avoided if possible - they are only for special debugging sessions.

The message decrease in severity and the increase in number from left to right. 

1. Error
   Only error messages are shown in the log.
2. Warning
   Only warnings are shown in the log.
3. Info
   All information messages are shown in the log.
4. Debug
   Includes a lot of debug information. This setting effects performance.
5. Trace
   Includes even more debug information as it dumps a lot of data in the log. This setting effects performance.