Calling the Rule Designer command-line tool

You can call the command-line builder from the command line, and customize the execution of the command-line tool.

Before you begin

To perform this task, you need an installation of Rule Designer with the JavaScript plug-in.

About this task

You use the Rule Designer command-line tool to automate routine operations from the command line and to extend the rule model by using JavaScript. The command-line tool launches Rule Designer to run specified JavaScript files.

Procedure

  1. To call the command-line builder, enter the following command with no line breaks:
    • On Windows:
      java -jar plugins/org.eclipse.equinox.launcher_1.0.1.<version>.jar 
      -data "absolute_file_path_to_a_workspace" 
      -clean
      -application ilog.rules.studio.javascript.runner 
      -script "absolute_file_path_to_javascript_file"
    • On Solaris:
      java -jar plugins/org.eclipse.equinox.launcher_1.0.1.<version>.jar 
      -data "absolute_file_path_to_a_workspace" 
      -os solaris 
      -ws gtk 
      -arch sparc 
      -clean
      -application ilog.rules.studio.javascript.runner 
      -script "absolute_file_path_to_javascript_file"
    For more information, see IlrJavascriptPlugin. Rule Designer starts in headless mode and performs the operations in the specified JavaScript file.
  2. To customize the execution of the command-line tool, use the following arguments:
    -script
    to specify the absolute path to the JavaScript file to run. This parameter is mandatory.
    -verbose
    to enable the plug-in execution process to write execution traces to the standard output.
    -silent
    to prevent any print to the standard and error output. This argument prevents the errors and warning from being printed.
    -progress
    to enable the plug-in execution to indicate its progress for long operations.