Support Overview


Client API Usage Examples

Upgrade Information


New Release History

You are here:   Visualware >   MyConnection Server >   Support >   Online Manual Overview >   Custom Applet Configuration

Custom Applet Configuration


Sub section menu:

Click the VIEW PUBLISHED TESTS link in the TOOLS section of the MCS main menu.

On the resulting page click the Create or modify an Applet Config file manually (advanced) link.

Create a New Configuration

Enter a configuration name and cick the CREATE BUTTON. It's possible to base the new configuration on an existing one. To do this simply select the existing one from the drop down menu.

The new configuration will appear just above the section shown on the right. Click the MODIFY link to edit the configuration.

Modify Configuration Menu

The applet configuration menu is designed to alter the appearance, wording and other test related metrics for each test type.

The page will look similar to the image on the right.

The customization options are explained in detail when each section is expanded.

If further help is requried don't hesitate to contact us.


Reporting Options

The REPORTING OPTIONS section is found under the GLOBAL APPLET heading.

JavaScript reporting is designed to pass test results to a JS function for further usability.

The text field at the bottom of the JS Reporting section allows the user to enter the metrics they want to pass to a JS function. The user will have to manually create the JS function to process the results.

For example, specifying mss($SPEED.DSPEED$, $SPEED.MAXPAUSE$) will cause the function mss to be called with two arguments: the first the download speed; the second the maximum pause between data transfers.

SESSION ID REPORTING is used to help identify results in the database.

The SID is a text field editable by the end user and recorded on the server alongside the results. It allows you to ask your end user for their name, employee id, session ID, or anything else you want. Keep in mind that the end user can then input any text they want (which may not be what you want or expected).

You can set the SID 'param' value in the web page and make the field uneditable by placing an "*" before the SID value, as below. This option enables you to automatically pass a string as the SID value.

<param name="SID" value="*UKnetwork">

Take a look at our Client API Usage Examples, which are designed to help show how various customization options can be used in MCS.


Direct Applet HTML Parameters

Once you have your applet up and running with your custom configuration you may find it necessary to add or remove a particular feature/setting of your current configuration.

This can be done without the need to re configure the whole applet configuration file by using extra param tags within your applet code.

For example you may suddenly have the need to have your users identify each test they perform with a unique ID. This can be done using the SID param tag as shown on the right, without altering the configuration file.

There are many many more parameters available. You will find these listed in the default.bin file found in the /www directory of your MyConnection Server installation folder.


Session ID Applet Example:

<applet mayscript name="mcs" code="myspeedserver/applet/myspeed.class" archive="/myspeed/myspeed_s_8.jar,/myspeed/plugins_s_8.jar" codebase="http://yourMCSserver/myspeed" width=600 height=400>
<param name="config" value="myconfig">
<param name="SID" value="Enter Unique ID">

Other Parameter Examples:

Auto start
Description This determines if the test auto starts without the user needing to click a button
Example Code <param name="autostart" value="yes">
Outcome This will start the test automatically as soon as the applet loads

Max Users and Max Days
Description This determines how many tests per how many days a user can use the applet.
Example Code <param name="maxuses" value="5">
<param name="maxusesdays" value="3">
Outcome Each user will only be able to perform 5 tests in every 3 days.

Test Finished Tab
Description This determines which tab is shown once test test has finished.
Example Code a: <param name="finishtab" value="noswitch">
b: <param name="finishtab" value="graph">
c: <param name="finishtab" value="advanced">
Outcome a: The applet does not change tab, it stays on the initial tab.
b: The applet switches to the Graph tab upon completion.
c: The applet switches to the Advanced tab upon completion.

Font Size
Description This determines the size of the font displayed in the applet
Example Code <param name="fontsize" value="14">
Outcome This sets the font size for the applet text to 14 pts

Speed Tab: Test Initiation Message
Description This determines the message displayed when a test is started in the Speed tab
Example Code <param name="working" value="Your speed test is about to start...">
Outcome This sets the text when a speed test is started to Your speed test is about to start..., this message stays on screen for about 1 second

VoIP Specific Examples

VoIP Lines
Description Alters the number of VoIP lines to simulate
Example Code <param name="voip_lines" value="4">
Outcome The test will simulate 4 VoIP lines instead of the standard 1.

Bytes Per Packet
Description Alters the number of bytes in a packet
Example Code <param name="voip_bytesperpacket" value="80">
Outcome This would set the the packet size to 80 bytes.

Packets Per Second
Description Alters the number of packets sent per second
Example Code <param name="voip_packetspersecond" value="50">
Outcome This would set the number of packets sent per second to 50.

MyConnection Server

Online Testing Portal

Visualware Products

Visual IP Trace


© Visualware Inc. 2017 - All Rights Reserved