Interfaces with External Command and External Program

<< Click to Display Table of Contents >>

Navigation:  Additional Features >

Interfaces with External Command and External Program

Call of External Command

By configuring a setting file, it is possible to set a menu of external tool at RaQuest's Tools.

Setting

Create an arbitrarily name folder under the installation folder, and then create an ini extension file under it. Format of the ini file is as follows.

MENUNAME=menu name
EXECFILE=command full path
ARGUMENT=command argument
EXECDIR=command execution directory
SHORTCUT=displaying order (shortcut key))
SHOWWINDOW=Window's show status

ARGUMENT

o$f The file path/connection string of the current project

o$k type of selected element

o$g GUID of selected element

o$e EAID of selected element

o$p GUID of project

o$%id% etc. attribute value of requirement when selected element is requirement

($%(User-Defined attribute name)% etc.)

Double quote when needed to match the number of argument.

EXECDIR can be omitted. When omitted, directory is set to an ini file's folder.

SHORTCUT is from 1 to 10. Omit-able.

Shortcut keys correspond with CTRL+F1 to CTRL+F10.

SHOWWINDOW can be omitted. When omitted, show normal window.

0 is hidden window.

1 is show normal window.

Example:

MENUNAME=menu name
EXECFILE=C:\test.bat
ARGUMENT="$f" $g
EXECDIR=C:\
SHORTCUT=1
SHOWWINDOW=1

In the above configuration:

Display "menu name" in menu.

Executable file is C:\test.bat

Argument is currently opening project file($f), and selected element GUID($g).

Execution directory is C:\.

Shortcut key is CTRL+F1.

Show normal window.


Selection/update of requirements from external program

Use library (RaQuestMessageLib.dll(32bit)/RaQuestMessageLib64.dll(64bit) in the installation directory)

Library function

SetTargetProjectGUID:Specify the project, targeted to be sent a message.

FindTargetInstance:Find a currently opening specified target project from RaQuests

UpdateRequirement:Send updating messages of requirement

SelectRequirement:Send selection messages of requirement

CloseMessage:Send Close messages


Sample

Please see following web page.

Interface samples with external command and external program.