Download TED4 (Include DotNet 1.0 and 1.1 - No ID file required)

 

 

What is TED?

TED is a local WinForm (.exe) application running in your local workstation generating aspx code for the Tornado applications. Given the fact that it is not appropriate to test your web applications in the production server, the alternative is to have a test server (extra license) or you can perform the development in a localhost environment where no extra license is required. The local workstation must have the same IIS and DotNet setup as the server except that the test is done via localhost (this the reason the Tornado id files comes with a localhost id). The application generated in the localhost can also be send to the remote server (the real thing) via ftp setup (see ftp tab in setup). So, you can test your application in both the local workstation and the remote server.

TED consists of 2 parts - Editor and Designer. Due to the fact that generating Web DB applications with Tornado does not require Visual Studio. The editor included in TED functions like VS or Web Matrix. Besides aspx file, the editor will execute all browser enabled files plus local batch files. Therefore, you can edit an html file and then click the "e" button to execute the html file under localhost of remote server.

TED editor embeds all the Tornado syntax as well as a lot of basic examples and program 'shells'. You can test your Access, SQL2K, Oracle, MySQL applications by just activating the examples or via the Designer.

 
Installation
Editor - Introduction

TED (Tornado Editor & Designer) is a WinForm (.exe) utility available to ASPdb.Net users under a maintenance contract. Because programming web database applications with ASP-db requires 'NotePad Only' and VB6 or Visual Studio is optional. The Editor part of TED provides code editing functionalities and the Designer part provides code generation hence the entire process is 'Point & Click'. For those who is using Classic ASP-db. TED is the same except it offers an integrated Editor. We are usually the highlight of ASP trade shows when use this tool to perform 'live' sessions in manipulating live data brought to us from show audiences (and many times exhibitors)  while the others are showing presentation slides and pre-programmed examples. If ASP-db can be the highlight in such a demanding environment - imagine what you can do with in your environment.

The editor house the most current syntax of Tornado in an external file 'TedSyntax3.ini'. Another external file 'Tedcode3.ini' contains many unique examples. The purpose of these examples is to aid the debugging process. For example, it contains generic aspx files to access various datasource (Access, SQL, MySQL, Oracle etc.) such that when a user have difficulties in using Tornado with a particular datasource, he/she can use these simple generic code to verify the datasource setup.

it is expected that TED will be used in a localhost workstation with administrator access to the http server such that file scan be transferred in both up and down direction.

A file called 'Ted3.ini' contains the default setup of the Editor and the Designer.

A file called 'Designer3.ini' stores all the Designer form data.

Upon returning from the editor, the Editor will open the default preview aspx file generates by the Designer. A preview can be done in the Editor as well as the Designer.

Preview can be done in the localhost as well as remote configuration.

Special editing features - There are many programming editing tasks that is in my own wish list and cannot be found in any other editors. I take the opportunity to incorporate these functions and it helps me a lot. The magic text functions can turn a long typing session into a few point and click action.

Ted Quick Start
Shortcut Key Table

 

Key Description
F12 Toggle preference setup
F11 Toggle syntax display
F10 Toggle templates display
F9 Toggle user template (if exists)
F8 Designer (F2 to return to Ted)
F7 Re-Highlight Text
F5 Re-load directory and re-read the external files headers to recognize new template items
F2 Toggle Directory
Ctrl-Z Undo
Ctrl-Y Redo
Ctrl-C Copy
Ctrl-X Cut
Ctrl-V Paste
Ctrl-A Select all
Ctrl-E Clear and set filename to Scratch\preview.aspx
Ctrl-F Find
Ctrl-H Find & Replace (^n=paragraph)
Alt-1 to 9 Favorite directories

 

Editor - Designer - FTP

The following remote file transfer activities requires FTP server is running in the local development station -

All activities use FTP setup parameters. The following is a standard sample of  FTP 'send' and 'get' -

  1. ftp
  2. open www.ftpserver.com
  3. username
  4. password
  5. binary
  6. send c:\inetpub\wwwroot\Tornado\Designer.aspx
  7. Bye

The send routine is used to send editor files to the remote server. After the active file is uploaded to the remote directory, it can be executed in the browser via the  'Remote Preview URL'. DO not mix up Remote URLs (http://www....)  and local URLs (http://localhost/...)

cd c:\inetpub\wwwroot\tornado\scratch

  1. ftp
  2. open www.ftpserver.com
  3. username
  4. password
  5. binary
  6. get Designer.aspx
  7. Bye

The get routine download the remote file to the scratch directory for editing.

FTP tab input

Note: FTP Password is encrypted and if it is left blank in the setup, it'll be prompted everytime.

Designer - General

Designer is designed for the Tornado programmer to quickly prototype the numerous properties and methods of Tornado. No error checking is incorporated for the obvious reason - it is a back end tool. For those who has been using the ASP-db Designer, Tornado Designer is just another version for Tornado (ASP-db.Net). It is more colorful and powerful because Tornado is much more than ASP-db. The fact that Designer is now combined with the ASP-db editor makes the entire programming process integrated.

Starts at Designer mode using a command line - Ted.exe /Designer3 (data file = Designer3.ini)

Starts at Ted mode - Ted.exe  (Configueration file = Ted.ini)

TedCode.ini - Tornado example files

Designer3.ini - Tornado Designer form data file. This is the system file name of the working file and cannot be changed. Copy this file to a separate name (Save As) if needed.

A 'Form/Open New Project' will delete this working file from disk creating a new project and the form data stored in memory will be erased.

A 'Clear Form' will reset the active form but the original data in memory is retained. A 'Reload' will restore to the form data or a 'Save' or 'Exit Form' will save the new form data. 'Exit Form' means the form lost its focus.

The Setup Path Form (Ted-F12) is extremely important as all the related paths will draw from them.  It is highly recommended that the local DB source to be stored in /tornado/DB.

Ted is available only to maintenance subscribers. Due to the fact that every update and patch will be incorporated into TED first, a 2004 Designer for example will not work properly with a 2003 Tornado.DLL.

Notes:

Designer - Connection

This form enables you setup your datasource connection. Primary datasources supported are - MS-SQL, Access, Oracle, MySQL, Excel, Paradox, DBase and Text. Different textboxes that applies to the specific datasource will have the backcolor painted with lightyellow.

Input Description
Type Select type of datasource as Type(Provider)
Local DB Select local datasource - file or directory (mdb, xls). For directory (Paradox, Text, DBase), just select any file the appropriate directory and only the directory will be used.
Server Name or IP Used in SQL class datasource as server name or in case of MS-SQL server IP or server URL is accepted. URL will be converted to IP during DSN. No error check. This IP access is not for a WAN and not limited to a LAN.
IP Port This is for SQL IP data source and defaults to 1433.
DB Name Database name like Northwind (Access), Pubs(SQL), test(MySQL), EMP(Oracle)
Table Name This entry has 2 purposes - First is that ODBC.Net has no more OpenSchema to obtain the table lists
User Id Which ever applicable
Password Which ever applicable
Global asax Global.asax file reside in the same level of the Tornado root directory. If it exists and if there are Application("...") in it - it'll be listed in the drop down as a pre-programmed DSN.
App Setting When ConfigurationSettings.AppSettings is not blank then it'll be listed in the drop down as a pre-programmed DSN.
Build DSN Draw from the lightyellow inputs to build the local DSN. You can modify this if you want to.
Remote DSN Copy and paste from local DSN and modify this entry if needed to reflect the DSN in the remote site. During remote preview, this DSN will be used.
Get Table Base on the DSN, get the table list. Remote ODBC datasources like MySQL and Oracle have no such support - use Table Names. Local datasource will be supported by reading the data table items w/o using ADO.Net.
Build SQL USe the Selected fields to build the dbSQL.
Hide Table Prefix Exclude those system or non-applicable tables that bear this prefix.
Group By Add Group By to dbSQL for tree  and menu.
Tables and field boxes Single click to select from table and field box. double click to delete from selected field box.

 

Designer - Display

This form enables you configure the look and feel aspects of the display.

Input
Title & Subtitle - Headers.
Mode & Options - Grid mode options.
Suppress Message - Suppress all error messages.
Inivisible - Suppress display of module output.
Obj - Arbitary object name - 
Unit - module identifier (important)
PageSize - Record to display per page.
FormCol - Snaking form.
Skin - Pre-programmed CSS styles. (Tutorial)
RecordCount - Retrieve actual record count of dbSQL/dbDSN.
Culture - Set application culture
Debug - Debug options to track SQL, Filters ... etc.
AllCase - Convert display case.
SuperBar - 2 types of special navigation bars.
MemoSize - Memo field truncate size.

 

Designer - Navigation and TextHolder

This form is the setup the navigation buttons and textholder.

b5 (default setup) = Top, prev, next, bottom, reload

Text Holder - This property allows you to insert text into strategic locations.

 

Designer - MagicCell

Tornado MagicCell has several improvements -

How to Use the Math Filter -

T.dbGridMagicCell="fi=Price| Mac=<<#Price#*50/100:C>> 50% Off!"

This MagicCell Macro process the #Price# field and display a 50% discount.

 

Designer - Menu

4 styles of menu are available  - Simple, Dropdown, Button and Tab. Refer to dbMenu in manual for details. Try the following to generate some menu example code.

Basic Menu

  1. Fire up the Design Console and go to the Designer.
  2. Click Menu in the left pane to display the Menu form.
  3. Clear the Form if needed by clicking the New-F button.
  4. Goto 'General' Tab and pick a pre-programmed style -> Gold and a menu style of "5".
  5. Set Width to 200
  6. Set Height to 15
  7. Goto 'Menu Template' tab. A sample template will be displayed
  8. Click 'Preview Menu'. Vola - You just created a 3 items menu.
  9. Go back to the 'General' tab and change the Width to 50 and Height = 50. Also Check the Vertical checkbox. Click 'Preview Menu' again. No Change in the browser? Always click the 'Reload' button for a new preview. Now you got a vertical version of the same menu.

Dropdown Menu

  1. Fire up designer and go to Menu form and General tab.
  2. Select Type 2 (dropdown).
  3. Select skin type = Gold.
  4. Set width to 600.
  5. Goto Menu Types tab and check 'Solid Arrows' and 3D border.
  6. Goto 'Menu Template' and see the re-built sample template
  7. Click 'Preview Menu'
  8. Repeat with other options.
  9. Goto 'Effect' tab; Click '3D' checkbox and preview.
  10. Goto 'Bar - Pie' tab and check 'Text Labels on', 'Value Labels On', 'Percent Labels Off' and preview.

 

Designer - Upload

This is a stand alone form and no data from any other forms are needed. That includes the title, skin and mail options. For a quick start, all the defaults are listed in the form and all needed is a click of the 'Preview' button. Confirm the SavePath is valid in your server.

 
Designer - Chart

Chart applies to the Gold version only. Run TornadoInfo via -> Ted?.exe | Help | TornadoInfo. Go to the bottom of the browser display and confirm the display of a sample chart which signals a good installation. Make sure the TED files are in the /inetpub/wwwroot/bin directory.

Do not use the normal 'Preview' button to view chart output unless it is a Grid-Chart. Use 'Preview Chart'. To see chart code generated, do not hit the code button, hit the "E" button to return to Editor to view the most recent Designer3.aspx file.

Step-by-step DB Chart -

  1. Activate TED; goto Designer; clear the session.
  2. Goto 'Connection' tab; take ACCESS(OleDB) default datasource type; select Northwind.mdb from /tornado/db directory.
  3. Click 'Build DSN'; click 'Get Tables'; select 'Orders' table.
  4. Click 'Fields & dbSQL' tab; select 'CustomerID' and 'Freight' and click right blue arrow to pick as 'SQL Fields'.
  5. Click 'Build dbSQL'; click 'blue IE' preview button and you'll see the grid display.
  6. Click 'Chart' and goto 'DataSet' tab. 'DB' radio should be checked, Set # should be '0'.
  7. Pick Chart Type 26; inspaect 'Set Value' drop box as it should contain all the SQL fields.
  8. For Dataset #0, pick 'yValue' for 'DataSet' and 'Freight' as 'Set Value'; click 'Build Data Set' to register the selection.
  9. Pick 'Labels' for 'DataSet' and 'CustomerID' as 'Set Value'; click 'Build Data Set' to register the selection.
  10. Click 'Preview Chart'. Refresh browser if neccessary to view chart.
  11. Go back to 'DataSet' tab; select '2=bar App' and preview; select '17-indBarApp' and 'Preview Chart'.
  12. Goto 'General Shared' change 'Width' to 400; Set 'Plot area - Color to black'.
  13. Goto 'Effects' tab; Set Chart 'BG Color' = black.
  14. Goto 'Axis' tab; Check 'xAxisOption';  Check 'LabelColor' and set 'Value' to 'white' and click 'Build xAxis'.
  15. Check 'yAxisOption'; Check 'gridOn' and 'tickOff' and click 'Build yAxis'; Check 'LabelColor' and set 'Value' as 'white' and click 'Build yAxis'; Check 'yAxisGridColor' and set 'Value' as 'white' and click 'Build yAxis'; Check 'yAxisGridColor' and set 'Value' as 'white' and click 'Build yAxis'.
  16. 'Preview Chart' !!
  17. To see the chart code, do not hit the regular code button, hit "E" to return to editor and the most recent Designer3.aspx file will be loaded.

Note:

Step-by-step User Chart -

  1. Clear form
  2. Select ChartType = 18; Check User Radio; Select 'Labels' from DataSet
  3. Input a,b,c,d,e in the User data area and click 'Build Data Sets'.
  4. Select yValues from DataSet and input 1,2,3,4,5 and click 'Build Data Sets'.
  5. Select 3D from effects and then Click 'Preview Chart'.

Step-by-step StackBar chart -

While most chart plots X vs Y, Col vs Col, Row vs Row. A Stack chart plot utilize the entire grid including header and labels making the construction quite complex. A one-button solution in TED is provided for such complex charts. Up to the point of the chart creation, this one-button click will create a default chart parameters and all you have to do is to customize a few parameters (title, size etc.) to create the chart. The following Csv file represents a commonlayout of a stack chart. The 1st column is the bar/column legend, header is the label and the rest of the grid are stack chart data.

Term,OCT,NOV,DEC,JAN,FEB,MAR,APR
Net of 0 - 30 Days ,"$5,000,000","$5,487,438","$5,224,856","$5,706,908","$5,243,021","$5,674,004","$5,380,943"
Net of 31 - 60 Days,"$5,538,366","$6,383,691","$5,228,618","$5,114,692","$5,417,751","$5,105,651","$5,537,058"
Net of 61 - 90 Days ,"$5,246,113","$5,432,359","$6,112,778","$5,183,747","$5,054,581","$5,313,107","$5,074,197"
Net of >90 Days ,"$6,164,898","$6,060,102","$6,072,076","$6,118,890","$5,669,299","$5,455,617","$5,335,739"

 

Action Comment
Cut and paste the above sample data and save it as /tornado/DB/Sbar.csv. Setup test data file.
Fire up TED and goto Designer. Hit <F12> and make sure data Paths are valid. Confirm TED paths.
Select Type = TEXT(ODBC) Setup data provider.
The localDB path should already be setup as -
c:\inetpub\wwwroot\Tornado\DB. If not locate the dirctory containing the Sbar.csv file
Setup data source for ODBC
Click Build DSN and Click Get Tables All the Csv files will be presented in the Tables listbox.
Select Sbar.csv All table fields will be presented in the Field RO select box.
Select Fields & dbSQL tab, HL all fields and click right arrow Select all the data records for the plot.
Click Build dbSQL Construct SQL
Select 'Display' Form and Set PageSize=-1 Plot all data
Set Title as 'My StackBar Plot' Give the activity a title
Goto 'Nav & TextHolder' Form and select None from the 'Navigation Buttons' listbox Suppress navigationitem because all records are included in the plot.
Click the Preview 'Blue e' button and inspect the grid display Validate data source via preview and get ready for Chart plotting.

While switching between forms, designer and editor and selecting various options to generate the code. The project data is kept in memory and not saved to disk yet. Click the save button to perform a disk save. You'll see 'All Forms data saved to disk' message in the status bar.

Select 'Mode' tab and set 'Mode & Option' to 'Grid-Chart' Set Grid Chart display format
Select 'Templates' form 'Grid-Chart' tab and modify the template to show chart below the grid instead of parallel. Eliminate the navigation buttons also. <center>
<table class=nb>
<tr valign=middle><td>
<center>[[Grid]]<p>
</center></td></tr>
</tr><td>[[Chart]]</td>
</tr></table></center>
Select 'Chart' form Get ready to build the chart.
Select ChartType=27 Specify a StackBar Chart. You'll see a Tronado button appears next to the Chart Type. This is the Magic One-Button.
Check DB radio button and click the magic One-Button setup. Specify data is from DB and let TED setup a default stack chart.
Save the form and click 'Preview' After preview the StackBar Chart, change the Charttype to 28 (StackColumn) and repeat the preview.
To see what parameters are set by the 'One button' - right click in the browser and inspect the PARAM and VALUE of the plot.

 

 

Important KB articles

 

Release History