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.
|
4. item 4 5. item 5 For date, the entire line must be Cdate() valid like - 1/2/2003 Jan 2 1997 1/4/01 5-7-03 One Line sort - 4,1,2,5,7,3,45 will be sorted as 1,2,3, 4,5,7,45 |
| 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' -
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
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
Dropdown Menu
| 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 -
Note:
Step-by-step User 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 |