Upgrade Guide to ASPRunnerPro 4.1 Home

Introduction
Welcome
System requirements
Licensing details
What is the registration
Using ASPRunner
Working with projects
Templates
What are templates
Cars
Classified ads
Events
Jobs
Knowledge base
News
Paypal
Real estate
Sporting
Vacation houses
Connecting to the database
Datasource tables
Master-details
SQL query page
About SQL query designer
Query Designer
SQL
Results
Charts
Creating chart and setting parameters
Chart appearance
Using SQL to shape chart data
Reports
Creating report and setting parameters
Report totals and layout
Choose pages
Login page
User login settings
Advanced security settings
User group permissions
Dynamic permissions
Fields order and totals
Miscellaneous settings
Choose theme
Visual Editor
About
Toolbars
Page Elements
"View as" settings
"Edit as" settings
Validation types
Lookup wizard
Events
Output directory settings
After you are done
FTP upload
FrontPage Publishing
Advanced topics
Connecting to database
Connecting to MS Access database
Connecting to MS SQL Server database
Connecting to FoxPro database
Connecting to MySQL database
Connecting to Oracle database
Connecting to MS Excel database
Connecting to CSV or Text file
Events
Data Access Layer
More about events
Global events
Table events
Page life cycle overview
Predefined actions
Send simple email
Send email with new data
Save new data in another table
Insert a record into another table
Check if specific record exists
Display a message on the Web page
Redirect to another page
Custom code
Sample code
Show list of customer orders
Check if start date is ealier than end date
Before deleting a record check if related records exist
Speed up data entry using events
Publishing ASP application to the remote Web server
Using third party FTP client to publish ASP pages to the remote Web server
Using FrontPage to publish ASP pages to the remote Web server
Demo account
What is the Demo Account?
Terms and Conditions
Enterprise Edition
Online report/chart builder
Master-details relationships
Using JOIN SQL queries
AJAX-based Functionality
ASPRunner session variables
Debugging tips
Template files processing rules (Files.txt)
Multilanguage support
Useful functions and links
ASPRunner templates
Stylesheets
Template language
Rich Text Editor plugins
How to control Inline Add/Edit functionality from script
Troubleshooting "Operation must use an updateable query" errors
ODBC
Upgrade Guide from ASPRunnerPro 4.0 and older
Frequently Asked Questions
Error: Operation must use an updateable query.
Error: Syntax error in UPDATE statement.
Error: Syntax error in INSERT INTO statement
Error: Login failed for user 'MACHINE_NAME\IUSR_MACHINE_NAME'
Error: Data type mismatch in criteria expression
Error: The Microsoft Jet database engine cannot open the file (unknown).
Error: Unable to open registry key 'Temporary (volatile) Jet DSN for process ...
Error: Data provider could not be initialized
Error: Invalid use of Null: 'Replace'
Error: Specified driver could not be loaded due to system error 5 (Oracle in OraHome92)
How can I add new ODBC Datasource
Error: Too many fields defined
Error: I enter correct login and password but receive Invalid Login error. I use SQL Server.
I cannot find ODBC Administrator applet on Windows 2000 machine
I cannot connect to my Excel (Access) database
Where can I download latest ODBC drivers
How to work with Access database stored on the remote computer?
Reserved Access, T-SQL, ODBC keywords.
Order ASPRunner online

 
  ASPRunner manual


Upgrade Guide from ASPRunnerPro 4.0 and older

 

 1. Overview
 2. Project structure has changed
 3. No hidden fields
 4. There are no arguments in OnLoad events
 5. Template editor is gone
 6. Custom templates created in older versions
 7. Old URL of search results won't work
 8. Passing master key value to another page

 

Overview

ASPRunnerPro 4.1 comes with WYSIWYG editor. To enable drag-n-drop editing of generated pages HTML part was separated from the code. Each page now consists of .htm file (visual template) which defines appearance of the page and .asp file that provides page functionality.

ASPRunnerPro uses very basic template engine that was written from scratch for this project. It uses syntax similar to original Smarty templates syntax.

Project structure has changed

Each project in ASPRunnerPro goes to its own directory which contains the following subdirectories:

  1. visual - Contains modified visual templates.

  2. tmp - Temporary storage of visual templates.
  3. output - Directory with output files. Can be changed on Output directory step to point to any other directory.

Default directory for a new project is ASPRunnerPro/projects/project_name. Project file will be saved under project directory as project_name.aspr.

When you open projects created with previous versions of ASPRunnerPro you are prompted to choose project directory. After you select a directory your project file is copied there. Next time open your project from the folder you selected, not from the original location.

If you upload files to the Web server using third party FTP client you need to upload the whole content of the output directory.

When you make a backup of your project you may backup the whole project directory with subdirectories. As a minimum backup the project file itself along with visual directory.

Save Project As option appears. If you want to save current project as other one for development purposes or to create a backup, for example, you should choose Save Project As option. In this case new project directory with project file and all necessary files will be created.

No hidden fields

In new version we recommend to use readonly fields with default values or assign default values via events.

Here is the sample code for Before record added event:

Function BeforeAdd(dict)

' Parameters:' dict - Scripting.Dictionary object. ' Each field on the Add form represented as 'Field name'-'Field value' pair

dict("Field1") = "default value for Field1"
dict("UpdatedDate") = dbvalue(now())
dict("UpdatedBy") = SESSION("UserID")

BeforeAdd = True' set BeforeAdd to True if you like to proceed with adding new record' set it to False in other case End Function

 

There are no arguments in OnLoad events

OnLoad event handlers don't have parameters anymore. The events code is converted automatically when you open old project.

Template editor is gone

In new version there is no template editor anymore. It was replaced by WYSIWYG visual editor.

Custom templates created in older versions

You cannot use custom templates created in older versions of ASPRunnerPro

Old URL of search results won't work

Now to obtain new search URLs you should run search once again and copy URL from browser's address box.

Passing master key value to another page

To obtaining the current master table key value in ASPRunnerPro 4.1 use:

SESSION(strTableName & "_masterkey1")

instead of:

GetRequestForm("masterkey")

 

The CHM file was converted to HTML by chm2web software.