Studio:AutoScript

 

Introduction 

Ascript is the definitive hierarchy of methods, objects, and properties provided by Autosense. While Autosense helps the user find the script methods/data desired in a script, Ascript is the definitive source of what is available from STRIDE when using Autosense.

Automation API

Ascript

When creating a script, the user types in Ascript followed by dot '.' to get Autosense to display. The user may select methods to be used within his script. The user may access property data within his script. this API is the definitive API for Autosense. The following table outlines the main objects and collections available to the user.

Member	Type	Description
Arguments	Collection	Collection of arguments.
Constants	Collection	Collection of constants.
Database	Object	Database settings.
Functions	Collection	Collection of functions.
Messages	Collection	Collection of messages.
Test Units	Collection	Collection of test units.
Timers	Collection	Collection of timers.

Ascript.Arguments

Arguments is a collection of arguments contained and managed through Ascript.

Member	Type	Description
object Item (     integer index )	Method	Retrieves the argument at the given index.

Ascript.Arguments.Item

An individual argument is accessed from the collection using the item(#) interface.

Member	Type	Description
Value	Property, Read-only, String	The argument value.

Ascript.Constants

Constants is a collection of constants contained and managed through Ascript.

Member	Type	Description
object Item (     integer index )	Method	Retrieves the constant at the given index.

Ascript.Constants.Item

An individual constant is accessed from the collection using the item(#) interface.

Member	Type	Description
Value	Property, Read-only, String	The value of the constant.

Ascript.Database

Database is an object containing properties related to the database managed by Ascript.

Member	Type	Description
Path	Property, Read-only, String	The path to the database.

Ascript.Functions

Accessing Ascript.Functions properties requires getting ahold of an actual function object. Ascript.Functions is actually a collection. Accessing a single function is performed via ascript.Functions.Item.[property]. Below is a table of function attributes that may be retrieved:

Member	Type	Description
Name	Property, Read-only, String	The function's name.
Owner	Property, Read-only, Object	Function's owner object.
SUID	Property, Read-Only, integer	STRIDE Unique IDentifier assigned by compiler.
Type	Property, Read-Only, String	Contains "Function".
User	Property Read-Only, Object	Function's user object.

Ascript.Functions.Item.Owner

Member	Type	Description
IsOverrideRegistered	Property, Read-Only, bool	TBD.
IsRegistered	Property, Read-only, bool	TBD.
Name	Property, Read-only, bool	TBD.
OutPointers	Property, Read-only, ?	TBD.
ParameterList	Property, Read-only, integer	STRIDE Unique IDentifier assigned by compiler.
void Register (void)	Method	Function's user object.
void Return (void)	Method	Function's user object.
ReturnValue	Property, Read-only, integer	STRIDE Unique IDentifier assigned by compiler.
SUID	Property, Read-only, integer	STRIDE Unique IDentifier assigned by compiler.
Type	Property, Read-only, String	Contains "Function".
void Unregister (void)	Method	Function's user object.
void UnregisterOverride (void)	Method	Function's user object.

Ascript.Functions.Item().User

Member	Type	Description
void Call()	Method	Function's user object.
CallBypassOverride()	Method	Function's user object.
CallBypassOverrideNonBlocking()	Method	Function's user object.
CallNonBlocking()	Method	Function's user object.
IsOverrideRegistered	Property, bool, Read-Only	TBD.
IsRegistered	Property, bool, Read-Only	TBD.
Name	Property, bool, Read-Only	TBD.
OutPointers	Property, b, Read-Only	TBD.
ParameterList	Property, integer, Read-Only	STRIDE Unique IDentifier assigned by compiler.
ReturnValue	Property, integer, Read-Only	STRIDE Unique IDentifier assigned by compiler.
SUID	Property, integer, Read-Only	STRIDE Unique IDentifier assigned by compiler.
Type	Property, String, Read-Only	Contains "Function".

Ascript.TestUnits

TestUnits is a collection of test units contained and managed through Ascript.

Member	Type	Description
object Item (     integer index )	Method	Retrieves the test unit at the given index.

Ascript.TestUnits.Item

An individual test unit is accessed from the collection using the item(#) interface.

Member	Type	Description
void Run (void)	Method	Method to run the test unit.
Suite	Property, object	The test unit test suite.

Ascript.Timers

Timers is a collection of timers contained and managed through Ascript.

Member	Type	Description
object Add (     object timerObject )	Method	Adds a new timer object.
object Item (     integer index )	Method	Retrieves the Timer object for the given index.
object Remove (     integer index )	Method	Removes the timer at the given index.

Ascript.Timers.Item

An individual timer is accessed from the collection using the item(#) interface.

Member	Type	Description
Active	Property, Read-only, bool	Contains true if timer is actively running.
Id	Property, Read-only, long	Contains timer identifier.
Duration	Property, long	Timer duration in milliseconds.
Periodic	Property, bool	Contains true if the timer is periodic.
void Start (void)	Method	Starts the timer.
void Stop (void)	Method	Stops the timer.