Altova Authentic 2023 Desktop

Navigation: Programmers' Reference > Application API > Overview > Programming Languages > JScript

Start Application

The JScript below starts the application and shuts it down. If the COM object of the 32-bit Authentic Desktop cannot be found, the code attempts to get the COM object of the 64-bit application; otherwise, an error is thrown. If an instance of the application is already running, the running instance will be returned.

Note:

For 32-bit Authentic Desktop, the registered name, or programmatic identifier (ProgId) of the COM object is AuthenticDesktop.Application. For 64-bit Authentic Desktop, the name is AuthenticDesktop_x64.Application. Be aware, though, that the calling program will access the CLASSES registry entries in its own registry hive, or group (32-bit or 64-bit). Therefore, if you run scripts using the standard command prompt and Windows Explorer on 64-bit Windows, the 64-bit registry entries will be accessed, which point to the 64-bit Authentic Desktop. For this reason, if both Authentic Desktop 32-bit and 64-bit are installed, special handling is required in order to call the 32-bit Authentic Desktop. For example, assuming that Windows Scripting Host is the calling program, do the following:

1.Change the current directory to C:\Windows\SysWOW64.

2.At the command line, type wscript.exe followed by the path to the script that you would like to run, for example:

wscript.exe "C:\Users\...\Documents\Altova\Authentic2023\AuthenticExamples\API\JScript\start.js"

// Initialize application's COM object. This will start a new instance of the application and
// return its main COM object. Depending on COM settings, the main COM object of an already
// running application might be returned.

try { objAuthentic = WScript.GetObject("", "AuthenticDesktop.Application"); }
catch(err) {}

if( typeof( objAuthentic ) == "undefined" )
{
try { objAuthentic = WScript.GetObject("", "AuthenticDesktop_x64.Application") }
catch(err)
{
WScript.Echo( "Can't access or create AuthenticDesktop.Application" );
WScript.Quit();
}
}

// if newly started, the application will start without its UI visible. Set it to visible.
objAuthentic.Visible = true;

WScript.Echo(objAuthentic.Edition + " has successfully started. ");

objAuthentic.Visible = false; // will shutdown application if it has no more COM connections
//objAuthentic.Visible = true; // will keep application running with UI visible

The JScript code listed above is available in the sample file Start.js (see Example Files).