Summary	This article describes how to create a click & go Supervisor or CATI station.
Applies to	askiavoice
Written for	Fieldwork manager
Keywords	supervisor; click & go; click and go ;cati ; clickngo

Introduction

Click&Go workstations are a seemless way of using Supervisor.exe or CATI.exe on remote machines. Indeed :

• No installation is required
• Doesn't contain extra files, only the .exe
• Dependancies, such as Visual C redistributable (vcredist.exe) aren't required
• Registry keys aren't used at all

The programs are merely sophisticated self-extracting zip files. It works roughly like this upon running:

• A temp folder is created in the windows temp folder
• Everything necessary is extracted to this directory
• Supervisor.exe is started with an embedded command line
• After Supervisor.exe closes the temporaty directory (and everything inside) is deleted

 

There are two ways to obtain a Click&Go workstation :

• If the CCA to which the workstations will connect does have the CCAPortal feature installed, simply grab the Click&Go from there, it will already be configured
• Or, download and configure your Click&Go stations from your CCA. The file located in the working directory (usually C:\AskiaField\ClicknGo )

 

Supervisor Click&Go (manual configuration) :

The exe internally contains the command line necessary to start Supervisor.
This command line contains everything needed:

• IP address of CCA
• Associated setup version -> if this version is lower than the latest version available on CCA, the program will abort!
• standalone option to signal the registry has to be ignored
• (optional) port number of cca
• (optional) agent ID for login
• (optional) password for login (encrypted or not)
• (optional) location ID
• (optional) default workspace ID for startup

For an overview, run

Supervisor.exe -? 

When getting a Click&Go via CCAPortal, the EXE is automatically generated with the correct parameters.

Would you need to create the .exe manually, here is the command to run in Window's command prompt :

"Supervisor Click&Go.exe" -setcommand:"Supervisor.exe -standalone -cca:127.0.0.1:903 -agentid:1 -password: -locationid:2 -workspace:2 -setup:5.3.1.0"

To manually create and distribute a supervisor Click&Go, you need to add, into the same folder:

• the supervisor Click&go from the same version than your cca (you will find it into the askiafield\setups directory on your cca server)
• a bat file

How to proceed:

• create a txt file first (with notepad).
• add the command with all parameters needed
• save the txt file and change the extension from .txt to .bat
• double click on the .bat file. A window will appear to indicate if the execution is a success.

Once it's done, you can send the supervisor click&go.exe file to your customer (no need to send the .bat file).

 

CATI Click&Go (manual configuration) : 

Follow the exact same steps than for a Supervisor Click&Go.
The only difference is in the command line : 

You can also update the command yourself by running the "setcommand", you will have to use the connection port 901, instead of 903 :

"Cati Click&Go v5.3.5.1047.exe" -setcommand:"cati.exe -standalone -cca:MyExternalCCAIpAddress:901 -agent:Shaft -password:groovy -locationid:205 -setup:5.3.5.1047"



Additional note in 5.4 and above: It could happens that the Supervisor or Cati Click & go downloaded from the CcaPortal doesn't start when executing the exe received.
That could be due to a cache corruption problem. In this case, please, empty the two followingt folders on the Webserver where CcaPortal is installed:
C:\Windows\Temp\CcaAPI
and
\wwwroot\CcaWebAPI\Resources
Then please download the exe again.