You are here: MyConnection Server » Support » Manual » Overview

Manual Applet Configuration


This section allows you to configure the appearance and operation of the MyConnection Server applet.

MyConnection Server features a highly configurable connection testing applet.

This section allows you to modify the display and several behaviors of the applet, such as test types, color schemes, graphs, tabs, branding preferences and reporting options. Each piece of text that the applet displays is also changeable, allowing the whole applet to be translated into other languages.

The MyConnection Server can support multiple configurations. The web page on which the applet resides dictates which configuration is used. How is this done?

Any changes made to the configuration named default will affect all applets unless another configuration is specified in the web page.

To create or modify a custom test operation, such as which plug-in tests to perform, and define the parameters used for each test process, see Manage Tests in the Testing section.

How to specify which configuration an applet should use

If the applet you wish to change is served from another website:

Simply add the following line into your page's <applet> declaration:

<param name="config" value="myconfig">

replacing myconfig with the name of the configuration you wish to use.

For example:

<applet mayscript name="mcs" code="myspeedserver/applet/myspeed.class" archive="/myspeed/myspeed.jar,/myspeed/plugins.jar" codebase="http://69.65.110.163/myspeed" width=600 height=400>
     <param name="config" value="myconfig">
</applet>

If MyConnection Server is acting as a stand-alone server:

Click the Create Web Page link next to the server configuration you wish to use. You will be asked to enter a page name. A MyConnection Server applet with your chosen configuration will be made available at that page.

Additional Parameter tags

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 below, without altering the configuration file.

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


The extra line of code shown in red above would prompt the user to Enter Unique ID which could then be used to identify the users test in the database.

Some more popular params are detailed below:

Autostart
Description This determines if the test autostarts 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

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.


Javascript Reporting

The Javascript Reporting side of the Applet Configuration can be found in the Global Applet options section.

The section looks like the image below:

When a MyConnection test completes, you can call a Javascript function with the results. You can specify the name of the Javascript function and the arguments which are passed to it. The substitutions made in the arguments list are shown in the image above.

This feature gives the flexibility to use the results MyConnection Server gives in various different ways. For example customizing analysis text for your site based on the results (note this is not provided in MyConnection Server and is just an example of how it can be used).

To add this function to your applet fill in the corresponding text box on your MyConnection Server, shown at the bottom of the image above, with the parameters you want to pass.

For example typing:

mcs($VOIP.JITTER$, $VOIP.PACKETLOSS$, $VOIP.DJITTER$)

will store the VoIP Jitter, Packet Loss and Downstream Jitter results in a Javascript function called "mcs".

The "mcs" function can now be used in various ways for your benefit. An example of how we use this technology can be seen on the MyConnection Server Live Demo, click the link below for a VoIP test example and see how we pass the results into the web page.

http://www.myconnectiontest.net/voiptest/try.html


  Copyright © 1997-2009 Visualware Inc. · All Rights Reserved