The REST Client is an addon module for TransSECS. When you receive the module zip, save the file, but do not unzip it, but go to Help→Install Modules in TransSECS

then browse to the file. TransSECS will install the module. You then need to restart the TransSECS application.

Once the module is installed, you will be able to add a REST client. Add the “Devices” node, if it does not already exist by right-clicking on the root of the tree and selecting “Add Devices”

If the “UtilityServers node does not exist under the “Devices” node add that also:

After that you can add a REST Client:

Give your REST Client a suitable name. For reading (“GET”) there's no need to configure the client:

When writing (“PUT” or “POST” ) you may need to set the “Content Type” under the expert properties tag:

Set this to “application/json” if you are going to send JSON to the server.

In this example, we perform two actions - request the recipe from a REST Service and use that in a PP-SELECT remote command and store data received at the end of a lot to a REST Service.

When the “LotLoaded” report is received, we call a REST endpoint to get the correct recipe for the tool. This recipe is then set to the PP-SELECT remote command and that message is sent to the tool.

The format of the URL we are calling is:

http://hostname/Recipe/{toolname}/{lotid}

an example, might be:

http://localhost/Recipe/GEMHost/Lot123

Change this to match your service URL. In this case, the return is a JSON map. The script then parses the returned JSON and uses the recipe to populate the PP-SELECT remote host command.

// whenever this report is received, get the lotid, use the REST Service to read the recipe and then set it to the PP-SELECT S2F41 message and send it to the tool
var TransSecsController = Java.type("com.ergotech.transsecs.secs.TransSecsController");
var DataSource = Java.type("com.ergotech.vib.servers.DataSource");


DataSource.logMessage ("Lot Loaded Event");

toolName = "GEMHost";

try{

    host=TransSecsController.findController(toolName);

    lotId = incomingValue.getProperty("MAP").get("LOTID").getStringValue();  // the name must match exactly.  It is case sensitive
    // demo URL http://hostname/Recipe/{toolname}/{lotid}
    resultJSON = /Devices/UtilityServers_Servers/GetRecipe->callRestServer("http://localhost:7000/Recipe/"+toolName+"/" + lotId, "GET", null);  

    
    DataSource.logMessage ("LotId " + lotId + " Recipe JSON " + resultJSON);
    
    // in this case our JSON is just '{"Recipe":"recipe1"}' but could be any (valid) JSON
    resultMap = JSON.parse(resultJSON);
    ppid = resultMap.Recipe;
    
	//use this ppid and the lotid in the PPSELECT host command and send the message

	ppselect = host.getMessageBean("HostCommandPPSELECT");
	ppselect.setCP2Value(lotId);  // ser the LOTID
	ppselect.setCPValue(ppid);  // set the PPID
 
	DataSource.logMessage ("Send the Message and wait for the reply");

    reply=host.getMessageBean("HostCommandReply");
	reply=ppselect.sendMessageAndWait();   // send the host command

	DataSource.logMessage ("Response "+ reply.getHCACK()[0]);

    if (reply.getHCACK()[0] == 0 ) {  // could also be a 4
      // good response
      print ("Recipe selection successful");
    } else {
      print ("Recipe selection failed:" + reply.getHCACK()[0]);
    }
    
} catch (e) {
    DataSource.logMessage("Error in LotLoaded Script: \n"+e.stack);
    print(e);  
}