Scripting

Refers to a specific user name.

The following example shows the XProtect Smart Client's login window with http://ourserver in the Server address field, and Tommy in the User name field:

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy"

This parameter is relevant only for Windows authentication and Basic authentication. You use the AuthenticationType parameter to control which authentication method to use.

Refers to a specific password.

The following example shows the XProtect Smart Client's login window with http://ourserver in the Server address field, Tommy in the User name field, and T0mMy5Pa55w0rD in the Password field:

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy" -Password="T0mMy5Pa55w0rD"

This parameter is relevant only for Windows authentication and Basic authentication. You use the AuthenticationType parameter to control which authentication method to use.

Refers to one of XProtect Smart Client's three possible authentication methods: Windows authentication (current user) (called WindowsDefault in startup scripts), Windows authentication (called Windows in startup scripts), or Basic authentication (called Simple in the startup scripts).

The following example shows the XProtect Smart Client login window with http://ourserver in the Server address field, Basic authentication selected in the Authentication field, Tommy in the User name field, and T0mMy5Pa55w0rD (masked by asterisks) in the Password field:

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy" -Password="T0mMy5Pa55w0rD" -AuthenticationType="Simple"

If you use Windows authentication, the example is:

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy" -Password="T0mMy5Pa55w0rD" -AuthenticationType="Windows"

If you use Windows authentication (current user), the UserName and Password parameters would not be necessary, and the example looks like this:

Client.exe -ServerAddress="http://ourserver" -AuthenticationType="WindowsDefault"

Refers to a full path to an .scs script (a script type targeted at controlling the XProtect Smart Client).

The following example uses an .scs script to login:

Client.exe -Script=c:\startup.scs

Example of an .scs script for logging in to http://ourserver with the current Windows user:

<ScriptEngine>

 <Login>

   <ServerAddress>http://ourserver</ServerAddress>

   <AuthenticationType>WindowsDefault</AuthenticationType>

 </Login>

</ScriptEngine>

You can use many of the XProtect Smart Client's function calls (see View a list of function calls) to add further functionality to .scs scripts. In the following example, we have added a line so the .scs script from the previous example will also minimize the XProtect Smart Client application:

<ScriptEngine>

 <Login>

   <ServerAddress>http://ourserver</ServerAddress>

   <AuthenticationType>WindowsDefault</AuthenticationType>

 </Login>

 <Script>SCS. Application.Minimize();</Script>

</ScriptEngine>

Valid parameter formats are:

{-,/,--}param{ ,=,:}((".')value(",'))

Examples:

-UserName Tommy

--UserName Tommy /UserName:"Tommy" /UserName=Tommy -Password 'Tommy'

• If your XProtect VMS system supports Smart Client profiles, you must enable HTML scripting on the required Smart Client profiles in XProtect Management Client.
• If your XProtect VMS system does not support Smart Client profiles, you must enable HTML scripting in the Client.exe.config file.

A very quick solution is to create an HTML page with buttons for navigation. You are able to create a wide variety of buttons on the HTML page. In this example, we will just create two types of buttons:

• Buttons for switching between the XProtect Smart Client's views

  Required HTML syntax:

  <input type="button" value=" Buttontext" onclick="SCS. Views.SelectView('Viewstatus.Groupname. Viewname');">

  Where Viewstatus indicates whether the view is shared or private (if the HTML page is to be distributed to several users, the view must be shared).

  Example from a real button:

  <input type="button" value="Go to Shared Group1 View2" onclick="SCS. Views.SelectView('Shared.Group1. View2');">

  This button would allow users to go to a view called View2 in a shared group called Group1.

  Buttons for switching between tabs: Live and Playback Bear in mind that, depending on their user rights, some users may not be able to access all tabs.

  Required HTML syntax:

  Live tab: <input type="button" value="Buttontext" onclick="SCS. Application.ShowLive();">

  Playback tab: <input type="button" value="Buttontext" onclick="SCS. Application.ShowBrowse();">

For advanced users it is possible to create many other types of buttons using the approximately 100 different function calls available for the XProtect Smart Client. See Scripting for more information.

In the following we have created two shared groups in the XProtect Smart Client . We have called them Group1 and Group2. Each group contains two views, called View1 and View2.

We have also created an HTML page with buttons allowing users to switch between our four different views as well as between two of the XProtect Smart Client 's tabs, Live and Playback. When viewed in a browser, our HTML page looks like this:

HTML page with buttons for navigating between views and tabs

We have saved the HTML page locally, in this case on the user's C: drive. When the HTML page is to be used for navigation, saving the HTML page locally is necessary because of security features in Internet Explorer.

When saving the HTML page locally, save it at a location to which an unambiguous path can be defined, for example in a folder on the user's C: drive (example: C:\ myfolder\file.htm). Saving the HTML page on the user's desktop or in the user's My Documents folder will not work properly due to the way Windows constructs the path to such locations.

We then imported the HTML page into the required XProtect Smart Client views.

You can also create an HTML page with more advanced content, for example, an image map allowing users to switch between views.

In the following example we have kept the two groups and two views from the previous example. Instead of using buttons, we have created an HTML page with an image of a floor plan, and created an image map based on the floor plan. Viewed in a browser, our HTML page looks like this:

HTML page with image map for navigating between views

For this example, we divided the floor plan into four colored zones, and defined an image map area for each zone. Users can click a zone to go to the view displaying cameras from that zone.

For instance, the red zone on our image map mirrors the Go to Shared Group2 View2 button from the previous example. If you click the red zone, you will go to View2 in Group2.

Importing a navigation HTML page into a view is in principle no different from importing any other type of HTML page into a view in the XProtect Smart Client. See Add HTML pages to views.

To create and distribute navigation HTML pages to XProtect Smart Client operators, do the following:

1. Create the required HTML page. The navigation controls in the HTML page must match the views users see in the XProtect Smart Client. For example, in order for a button leading to View1 to work, a view called View1 must exist in users' XProtect Smart Client installations. If you intend to distribute the HTML page to a group of users, the views in which the HTML page will be used should be placed in shared groups.
2. Save the HTML page locally on each computer on which it will be used. When saving the HTML page locally, save it at a location to which an unambiguous path can be defined, for example in a folder on the user's C: drive (example: C:\ myfolder\file.htm). Saving the HTML page on the user's desktop or in the user's My Documents folder will not work properly due to the way Windows constructs the path to such locations.
3. Import the HTML page into the required views in XProtect Smart Client. See Add HTML pages to views.
4. Test that the navigation controls on the imported HTML page work as intended.

If your HTML navigation page does not work as intended, consider the following:

• Have you used the correct syntax in your HTML?
• Is HTML scripting enabled in XProtect Management Client or in the Client.exe.config file?
• Does the intended audience have the user rights to access certain cameras, views, features, or tabs in XProtect Smart Client?