Differences

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

--- integration [2021/02/17 03:34]
admin [Integrate TestOptimal in your web project (javascript/node.js)]
+++ integration [2021/02/25 22:23] (current)
admin [Integrate TestOptimal in your java project (Java /IDE Connector)]
@@ Line 3: / Line 3: @@
 There are several ways to integrate //TestOptimal// with other systems and tools, allowing you to leverage your investment in the existing test automation tools. These interfaces are:
-  * [[plugins#agent_plugin|Remote Agent]]
   * [[#Cloud Services]]
   * [[#Requirements]]
@@ Line 11: / Line 10: @@
   * [[# Integrate TestOptimal in your java project (Java /IDE Connector)]]
   * [[# Integrate TestOptimal in your web project (javascript/node.js)]]
+  * [[plugins#agent_plugin|Remote Agent]] - used to build Java Integration and Javascript/Node.js Integration above.
 ----
@@ Line 73: / Line 73: @@
 ----
 ==== Jenkins ====
-Add steps to [[https://www.jenkins.io/ | Jenkins]] build job to run models using //TestOptimal// REST APIs.
+For current version v6, you would use REST API documented at http://localhost:8888/swagger.
-This feature is only available for V5.0. For v6.0, you would achieve the same with http://localhost:8888/swagger.
+For V5, add steps to [[https://www.jenkins.io/ | Jenkins]] build job to run models remotely:
+  * Install [[https://plugins.jenkins.io/http_request/ | HTTP Request]] plugin installed in your //Jenkins//
-  * Check and install [[https://plugins.jenkins.io/http_request/ | HTTP Request]] plugin installed in your //Jenkins//
   * Add //admin// to connect to [[runtime_server | Runtime Servers]]
     * select menu //Jenkins / Credentials//
@@ Line 109: / Line 108: @@
 //TestOptimal// provides a suite of REST APIs to allow 3rd party tools and applications to communicate with //TestOptimal// server.
-You can use these REST APIs to access start and stop model execution, access model artifacts/files as well as perform system functions remotely.
+You can use these REST APIs as documented at http://localhost:8888/swagger to access start and stop model execution, access model artifacts/files as well as perform system functions remotely.
 ==== Organization of REST APIs ====
@@ Line 150: / Line 149: @@
      <groupId>com.github.testoptimal</groupId>
      <artifactId>JavaConnector</artifactId>
-     <version>1.0.2</version>
+     <version>1.0.4</version>
    </dependency>
@@ Line 158: / Line 157: @@
 See [[http://testoptimal.com/v6/JavaConnectorReadme.xml| JavaConnector README]] for more details.
+----
 ==== Integrate TestOptimal in your web project (javascript/node.js) ====
@@ Line 170: / Line 171: @@
-=== Making Connection ===
+=== Connecting to TestOptimal Server ===
    TOSvr = new TOServer("http://localhost:8888");
    TOSvr.setDebugCB((msg)=> console.logMsg ("DEBUG: " + msg), 2);
@@ Line 181: / Line 182: @@
       });
+=== State Model Sample Scripts ===
+== Creating State Model ==
+	var model = new Model ("VendingMachine");
+	var Welcome = model.addStateInitial("Welcome");
+	var Q1 = model.addState("25 cents");
+	var Q2 = model.addState("50 cents");
+	var Q3 = model.addState("75 cents");
+	var Q4 = model.addState("100 cents");
+	var ThankYou = model.addStateFinal("ThankYou");
+	Welcome.addTrans("add_quarter", Q1).addTrans("cancel", ThankYou);
+	Q1.addTrans("add_quarter", Q2).addTrans("cancel", ThankYou);
+	Q2.addTrans("add_quarter", Q3).addTrans("cancel", ThankYou);
+	Q3.addTrans("add_quarter", Q4).addTrans("cancel", ThankYou);
+	Q4.addTrans("select_drink", ThankYou).addTrans("cancel", ThankYou);
+	// TOSvr is the connection object created in Making Connection section above.
+	TOSvr.uploadModel(model).then (function(){alert("model uploaded");})
+== Generating Test Cases ==
+	TOSvr.genPaths("VendingMachine", "Optimal", 1000).then(printPaths);
+	function printPaths (sum) {
+	   console.logMsg(sum);
+	}
+== Opening Graphs ==
+	// graph types: model, sequence, msc and coverage
+	// except model graph, all other graphs are available for model execution.
+	var url = TOSvr.getGraphURL("VendingMachine", "model");
+	console.logMsg("model graph: " + url);
+	window.open(url, "ModelGraph");
+== Online MBT ==
+	 var execReq = {
+		modelName: "DEMO_RemoteAgent",
+		statDesc: "description",
+		options: { "autoClose": false }
+	};
+	var agentID = "DEMO";
+	TOSvr.execModel(execReq).then((data) => {
+		console.logMsg(data);
+		console.logMsg("Registering agent " + agentID);
+		TOSvr.regAgent(execReq.modelName, agentID).then(getNextCmd, errHandler);
+	});
+	function getNextCmd() {
+	   TOSvr.nextCmd(agentID, 2000).then(function(rmtCmd) {
+		  if (rmtCmd && rmtCmd.cmd) {
+			  var result = {
+				result: "I don't know",
+				reqTag: "DEMO",
+				assertID: "DEMO-" + rmtCmd.cmd
+			 }
+			 console.logMsg("received cmd: " + rmtCmd.cmd);
+			 console.logMsg("sending result: " + result.result);
+			 TOSvr.setResult (agentID, result).then (function(ret) {
+				setTimeout(getNextCmd, 1000);
+			  }, errHandler);
+		  }
+		  else modelExecDone();
+	   }, errHandler);
+	}
+	function modelExecDone() {
+	   console.logMsg("Model execution completed");
+	}function errHandler (err) {
+	   console.log("errored");
+	   console.logMsg(err);
+	   TOSvr.stopModelExec(execReq.modelName);
+	}
+== Retrieve Execution Results ==
+   TOSvr.getSummary("DEMO_RemoteAgent").then(function(ret) {console.logMsg(ret);})
+=== Combinatorial Model Sample Scripts ===
+== Create DataSet ==
+    var ds = new DataSet("DemoDataSet");
+    ds.addField ("F1", "text", ["aa","bbb"], "", false);
+    ds.addField ("F2", "int", [1,2,3], "", false);
+    TOSvr.uploadDataSet (ds).then(console.logMsg, console.logMsg);
+== Generate Test Cases ==
+   TOSvr.genDataTable("DemoDataSet", "pairWise").then(console.logMsg, console.logMsg);
+=== Demo Web Client ===
+You may try out above sample scripts with the web client bundled in //TestOptimal// installation:
+http://localhost:8888/DemoApp/Demo_MBT.html