Differences

This shows you the differences between two versions of the page.

--- scripting [2020/09/17 00:40] – wikiadmin
+++ scripting [2025/05/20 11:12] (current) – wikiadmin
@@ Line 1: / Line 1: @@
-**Scripting**
+**TransSECS Scripting Guide**
+See also: [[TransSECScriptingMethodList | Common TransSECS JavaScript Methods List]]
+Also see: Why you need to [[add_incomingValue_last_lineofscript|add "incomingValue" ]] to the end of all scripts and how to fix this if its missing
 The Devices version of TransSECS (TransSECS Devices) enables java scripting on the data sources, messages, and message data.
 Look at the sample scripts on the messages and data sources in the sample PLCTool.
+**Controller Reference**
+For all scripts where you need a reference to the tool interface (or host definition) you will need to get this interface using TransSECSController.getSingleController() or TransSECSController.findController("XXXXX") where XXXXX is a specific tool interface. If you only have one interface in your project the preferred way to access the interface is using the getSingleController() method without using a specific tool interface name.
+<code javascript>
+var TransSecsController = Java.type("com.ergotech.transsecs.secs.TransSecsController");
+secsInterface=TransSecsController.findController("PLCTool");
+</code>
+where "PLCTool" is the name of your tool definition. The preferred way to get a single controller reference when you only have one interface defined in the project (which is most common) is:
+<code javascript>
+var TransSecsController = Java.type("com.ergotech.transsecs.secs.TransSecsController");
+secsInterface=TransSecsController.getSingleController();
+</code>
 **Common Problems**
@@ Line 10: / Line 34: @@
 TypeError: null has no such function "someFunctionName", this usually means you forgot to add an import for a class which has method "someFunctionName".
 For example:
-TypeError: null has no such function "findController" is commonly due to forgetting to do this:
+TypeError: null has no such function "findController" or TypeError: null has no such function "getSingleController" is commonly due to forgetting to do this to import the TransSECSController class:
 <code javascript>
 var TransSecsController = Java.type("com.ergotech.transsecs.secs.TransSecsController");
-</code>
-before you do this:
-<code>
-secsInterface=TransSecsController.findController("PLCTool");
 </code>
-where "PLCTool" is the name of your tool definition.
 **Register to Receive All Events in a TransSECS host application**
@@ Line 43: / Line 60: @@
 **Trigger Events in a Tool**
-In this example there is one data source which triggers two events, a cassette placed event and a cassette lifted event
+In this example there is one data source which triggers two events, a cassette placed event and a cassette lifted event. If the value is 0, the cassette was lifted, if it is 1, the cassette was placed
-<code>
+<code javascript>
 var TransSecsController = Java.type("com.ergotech.transsecs.secs.TransSecsController");
- tool=TransSecsController.findController("GEMTool");
+ tool=TransSecsController.getSingleController();
  gemHandler =  tool.getGemHandler();
- liftedEvent = gemHandler.getServerForName("CEID.CASSETTELIFTED");
+ print(gemHandler);
- placedEvent = gemHandler.getServerForName("CEID.CASSETTEPLACED");
+ try {
+ liftedEvent = gemHandler.getServerForName("CEID.Lifted");
+ placedEvent = gemHandler.getServerForName("CEID.Placed");
- state=incomingValue.getIntValue();//this is the value for this data source tag
+ state=incomingValue.getIntValue();//this is the value of the data source
 //if state=0, cassette has been lifted,if state=1 then it has been placed
 if (state==0) {
-   //trigger Cassette1Lifted
+   //trigger lifted event
-   liftedEvent->setIntValue(1); //trigger this event
+   liftedEvent.setIntValue(1);
  } else {
-   //trigger Cassette1Placed
+   //trigger placed event
-    placedEvent->setIntValue(1);
+    placedEvent.setIntValue(1);
  }
+ } catch(e) {
+    print("Error in Cassette Lifted/Placed Event script: \n"+e.stack);
+    print(e);
+  }
 </code>