Please enable JavaScript to view this site.

ASPRunnerPro 10.2 Manual

Navigation: Using ASPRunnerPro

PHPrunner32x32     ASPRunnerPro manual


Event Editor

Scroll Prev Next More

 

Events are fragments of ASP or Javascript code that are executed automatically when certain conditions are met, for instance: a record was added to the database, or the user opened the List page. You can use sample Event code snippets or write the code on your own.

 

Here are a few examples of events:

 

send an email containing the data from a new record or showing changes to an existing record;

 

save new data in another table;

 

check if a specific record exists;

 

limit the number of records a user can add.

 

There are two types of events: Global and Table events. Global events can be used with any table/view. Table events work with a specific table/view.

Event Editor toolbar description

Button

Description

add_action_bt

Allows adding one of the predefined actions.

erase_bt

Erases the event code.

undo_bt

Reverses the last operation.

redo_bt

Reverses the last "Undo" operation.

check_syntax_bt

Checks the event code syntax.

search_bt

Opens the Search and Replace dialog. Note that you can search and replace content in all events as well as the selected one.

find_all_bt

Opens the Find All dialog.

revisions_bt

Displays the revision history panel.

 

Working with events

To add an event:

 

1. Go to the Events screen.

 

2. Select an event from the tree in the left pane. To show only the events with code in them, click the show_actual_code_bt button. To filter the events by name, use the text field above the tree in the left pane.

 

Each event has a collapsible hint with the event description, function syntax, and a list of parameters. To hide the hint, click the hide_bt button.

events_asp

 

yellowbulbNote: you can change the font size on the Event Editor and Editor screens. Hold CTRL and scroll the mouse wheel to do so.

 

3. Add the code or click the add_action_bt button to open the predefined actions popup.

 

See also:

Sample events - examples of commonly used events with code snippets.

Common parameters you can use in the events.

 

4. Choose one of the predefined actions to add a code snippet to the event.

send_simple_email_select_action

 

5. Modify the code snippet by inserting the necessary values instead of the ones colored in red.

step11_asp

 

In the example above, you need to insert:

 

the email address - instead of "[email protected]";

 

the email message - instead of "Hello there" and "Best regards".;

 

the email subject - instead of "Sample subject".

 

yellowbulbNote: you can add more than one predefined action to an event.

 

To edit the event, select an event and modify the code. To delete the event, select an event and click the erase_bt button.

Revisions

You can track the changes made to any event, review and restore any revision. To see the revision history, click the Revisions button.

 

Click Show changes at the bottom of the revision panel to see the changes between the current and previous revisions. To restore any revision, select that revision and click Restore revision.

events_revision_asp

Intellisense

Intellisense is a convenient way to access the descriptions and variables of the functions. The Event Editor recognizes the functions and variables and shows the function description or the list of available variables to choose from in a popup.

 

Here are a few examples:

 

Data Access Layer, database field names

intellisense_dal_asp

 

Javascript API functions

intellisense_jscontrols

 

Field names

intellisense_values_asp