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))

DESKTOP=Action with Enterprise Architect desktop edition

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.

•DESKTOP can be omitted. CLOSE/NG/OK are the choices.

CLOSE is the project once, and re-open it after execution with Enterprise Architect Desktop edition.(default) NG is un-executable with Enterprise Architect Desktop edition.

OK is executable with Enterprise Architect Desktop edition.

•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

DESKTOP=CLOSE

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.

•Action with EA desktop edition closes the project once, and re-open it after execution.

•Show normal window.

Selection/update of requirements from external program

Use library (RaQuestMessageLib.dll 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 program

Please see following web page.

About interfaces with external command and external program.