skip to main content
Corticon Studio: Quick Reference Guide : Ruletests : Ruletest window : Ruletest menu commands
 

Try Corticon Now
Ruletest menu commands
The following menu is available when the Ruletest editor is the active window.
The Ruletest menu has the following items:
*Testsheet
*Add Testsheet - Inserts a new Testsheet.
*Remove Testsheet - Deletes the specified Testsheet.
*Link To Previous Testsheet - Causes the Input panel of the second Testsheet to be populated with the date from the Output panel of the first.
*Change Test Subject - Opens a window that lets you select a new Rulesheet or Ruleflow to test in Corticon Studio, or a Decision Service to test where it is deployed on a Corticon Server.
*Cut Testsheet - Cut the active Testsheet.
*Copy Testsheet - Copy the active Testsheet.
*Paste Testsheet - Paste the active Testsheet.
*Rename Testsheet - Opens an entry window to change the Testsheet name.
*Move Backward - Moves the selected Testsheet tab one tab towards the beginning of the Ruletest.
*Move Forward - Moves the selected Testsheet tab one tab towards the end of the Ruletest.
*Move To Beginning - Moves the selected Testsheet tab directly to the start of the Ruletest.
*Move To End - Moves the selected Testsheet tab directly to the end of the Ruletest.
*Comment - Opens the Add Comment window to add and display a comment of up to 200 characters to the one selected item in the Input column. When no item is selected, the comment applies to the Testsheet – it can be of indeterminate length, and will be added to a Ruleflow report.
*Import
*XML/SOAP - Import a valid CorticonRequest XML document into Corticon Studio as a Ruletest.
*JSON - Import a valid CorticonRequest JSON document into Corticon Studio as a Ruletest.
*Data
*Set to Null - Resets the selected Testsheet tree node to null.
*Go to Entity - Displays an entity when an association tree node is selected.
*Sort Entities - Sorts entity nodes alphabetically by name. One entity must be selected.
*Properties - Displays the Ruletest Properties window.
*Input
Export Request XML - Exports the active Testsheet's Input pane as a CorticonRequest XML document.
Export Request SOAP XML - Exports the active Testsheet's Input pane as a CorticonRequest XML document with SOAP envelope.
Export Request JSON - Exports the active Testsheet's Input pane as a CorticonRequest JSON document.
Exclude Transients - Ignores attribute values that are transient data mode in tests. Toggling this setting under one tree toggles it for Input, Output, and Expected.
Generate Data Tree - Constructs the minimum Input data structure necessary to test the chosen Rulesheet. Uses the Rulesheet's scope for guidance.
*Output
Export Response XML - Exports the active Testsheet's Output pane as a CorticonResponse XML document.
Export Response SOAP XML - Exports the active Testsheet's Output pane as a CorticonResponse XML document with SOAP envelope.
Export Response JSON - Exports the active Testsheet's Output pane as a CorticonResponse JSON document.
Exclude Transients - Ignores attribute values that are transient data mode in tests. Toggling this setting under one tree toggles it for Input, Output, and Expected.
Copy to Expected - Copies the data in the Output panel to the Expected panel.
*Expected
Export Response XML - Exports the active Testsheet's Expected pane as a CorticonResponse XML document.
Export Response SOAP XML - Exports the active Testsheet's Expected pane as a CorticonResponse XML document with SOAP envelope.
Export Response JSON - Exports the active Testsheet's Expected pane as a CorticonResponse JSON document.
Exclude Transients - Ignores attribute values that are transient data mode in tests. Toggling this setting under one tree toggles it for Input, Output, and Expected.
*Export WSDL - Create a WSDL directly from the Input pane of a Ruletest. For more information about using WSDLs to integrate Decision Services, see Server Integration & Deployment Guide
*EDC Database Access - See the following section for details.
*Execution Properties - Toggles suppression of each of the message types and test output in test results. See the section below for more information.
*Deploy - Compiles the Ruletest target without executing it.
*Run Test - Compiles (if needed) and executes Ruletest.
*Output Validation > Validate - Reruns the color-coded validation of the Output and Expected data.  See Reviewing test results when using the Expected panel.
*Run All Tests - Executes all Testsheets in the Ruletest.
*Report - Creates an HTML report and launches your browser for viewing.  See Creating a Ruletest Report.
*Remove Invalid Nodes - Discards all invalid nodes in Input, Output, and Expected columns in all Testsheets in the Ruletest.

EDC Database Access options

The Testsheet options that are available when you are connecting to a database through the Enterprise Data Connector are:
The first option group determines, when not set to None, whether the Vocabulary's database connection is intended to provide Read Only or Read/Update access to the database. The chosen option decorates the testsheet's tab as stylized here where the sheet name is appropriate to its database access selection:
The second option group determines what is returned in response messages. It does not apply when Database Access is None.
*Return All Entity Instances - Instructs Corticon Server to return all entities (queried during the course of rule execution) in the response message.
*Return Incoming/New Entity Instances Only - Instructs Corticon Server to return only entities which were directly used in the rules, present in the request message, and/or generated by the rules (if any).
For more information, see the topic How data from an EDC Datasource integrates into rule output
The third option group, Enable Cache or Disable Cache, determines whether the Testsheet should Enable Cache or Disable Cache when running tests. This features requires that you set Vocabulary and Rulesheets to use caching. It does not apply when Database Access is None.
For more information, see the topic Working with database caches

Execution Properties

When you choose to suppress selected level of messages in server output and logs, you might want to see that same behavior in your Ruletests first. These settings restrict each of the three types of Rule Messages (info, warning, and violation) from being posted to the output of an execution. They are test server settings that correspond to the Corticon Server properties:
com.corticon.server.restrict.rulemessages.info
com.corticon.server.restrict.rulemessages.warning
com.corticon.server.restrict.rulemessages.violation
Also, you can choose to suppress the work document output in server output and logs, and you can test that same behavior (suppressing the Output pane) in your Ruletests first.
The following execution property suppresses the creation of the output pane, and displays just rule messages:
com.corticon.server.restrict.response.rulemessages.only
You can see the impact of these restrictions in testsheets by engaging each of the toggles under Execution Properties on the Ruletest > Testsheet menu as shown:
When an option is checked, messages of that type are suppressed:
Clicking an option again clears it, so that the message type or output is again produced.
Exporting messages from a Testsheet adds in any execution properties you set. For example, in SOAP/XML:
<ExecutionProperties>
<ExecutionProperty
value="true"
name="PROPERTY_EXECUTION_RESTRICT_RULEMESSAGES_INFO"/>
<ExecutionProperty
value="true"
name="PROPERTY_EXECUTION_RESTRICT_RESPONSE_TO_RULEMESSAGES_ONLY"/>
</ExecutionProperties>
Importing that message will toggle -- in this example -- the corresponding Testsheet options, Restrict Info Messages and Return Only Rule Messages.