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 (void)	Method	Function's user object.
void CallBypassOverride (void)	Method	Function's user object.
void CallBypassOverrideNonBlocking (void)	Method	Function's user object.
void CallNonBlocking (void)	Method	Function's user object.
void IsOverrideRegistered (void)	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.
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".

Ascript.Messages

Messages is a collection of messages contained and managed through Ascript.

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

Ascript.Messages.Item

Member	Type	Description
Owner	Property, Read-only, Object	Message's owner object.
SMID	Property, Read-only, integer	STRIDE Message IDentifier assigned by compiler.
SUID	Property, Read-only, integer	STRIDE Unique IDentifier assigned by compiler.
User	Property, Read-only, Object	Message's user object.

Ascript.Messages.Item.Owner

Member	Type	Description
void Broadcast (void)	Method	Broadcast method.
void Register (void)	Method	Register method.
void RegisterOverride (void)	Method	Register override method.
void SendRsp (void)	Method	Send response method.
void Unregister (void)	Method	Unregister method.
void UnregisterOverride (void)	Method	Unregister method.

Ascript.Messages.Item.User

Member	Type	Description
void SendAndRead (void)	Method	Send and read method.
void SendAndReadBypassOverride (void)	Method	Send and read bypass override method.
void SendCmd (void)	Method	Send command method.
void SendCmdBypassOverride (void)	Method	Send command bypass override method.
void Subscribe (void)	Method	Subscribe method.
void Unsubscribe (void)	Method	Unsubscribe method.

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.