------------------------------------------------------------ IntraBuilder English Version 1.01a Trial/Update README.TXT Updated 12/19/96 4:32 PM IMPORTANT: If IntraBuilder is not currently installed on your system or if you choose to install the IntraBuilder Client/Server Trial Edition, the trial software will automatically expire 30 days from the date of installation. If you are using this installation to update any existing edition of IntraBuilder from version 1.0 to version 1.01a, the date limitation does not apply. For details and other important Trial/Update installation notes, see INSTALL.TXT. IntraBuilder Server setup instructions are in the file SERVER.HLP (a Windows Help file). Other general install and uninstall notes are in INSTALL.TXT. Both of these files are stored in your IntraBuilder root directory. If after installing this Trial Edition you purchase a copy of IntraBuilder 1.0 (not 1.01a), you should uninstall this Trial Edition before installing the full product, then reinstall this Trial Edition to update your copy of IntraBuilder. The version number is indicated at the top of the INSTALL.TXT file that is displayed at the beginning of the installation process. This update applies only to English-language versions of IntraBuilder. PLEASE NOTE: This Borland product offers no redistributable files. Also, for Client/Server edition users only, the Borland License Agreement allows you to install Remote Agents on multiple machines. ------------------------------------------------------------ WELCOME TO INTRABUILDER ------------------------------------------------------------ IntraBuilder is a visual JavaScript application development environment that lets you easily build and maintain live, data-driven Web applications. The applications you create with IntraBuilder provide your users with live, interactive access to your data through any browser. ------------------------------------------------------------ MINIMUM REQUIREMENTS ------------------------------------------------------------ * An Intel 486DX PC or better. * Microsoft Windows 95, Windows NT 3.51 or Windows NT 4.0. * A VGA/SVGA monitor and graphics adapter. * A TCP/IP Internet or intranet connection. * 30MB free space on your hard disk drive. * Memory requirements: IntraBuilder Designer: 12MB RAM for Windows 95, 16MB RAM for Windows NT. IntraBuilder Server: Minimum IntraBuilder Designer requirement plus 8MB for the Borland Web Server, or the stated memory requirement of another supported Web server. * IntraBuilder Client/Server has a "Remote Agents" feature which requires Windows NT. ------------------------------------------------------------ CONFIRMED OPERATING SYSTEMS AND WEB SERVERS ------------------------------------------------------------ IntraBuilder has been tested on Windows 95 and Windows NT 3.51, and NT 4.0. ------------------------------------------------------------ SUPPORTED WEB SERVERS ------------------------------------------------------------ Standard edition ---------------- Borland Web Server (included) Client/Server, Professional, and Trial edition users only --------------------------------------------------------- A chart showing which Web server applications are supported on which operating systems appears in SERVER.HLP (search keyphrase "supported servers"). Please note that if you choose to use the Microsoft IIS server on any version of Windows NT, your system login username must match the Anonymous Connections username in your Internet Service Manager setup. For more details on this requirement and instructions on how to change the Anonymous username, see SERVER.HLP. ------------------------------------------------------------ STARTING INTRABUILDER ------------------------------------------------------------ IntraBuilder is made up of two major components: the IntraBuilder Designer and the IntraBuilder Server. The IntraBuilder Designer is where you create, modify and maintain your IntraBuilder applications. To run the IntraBuilder Designer from Windows NT 3.51, double-click the IntraBuilder Designer icon in your IntraBuilder program group in the Program Manager. To run the IntraBuilder Designer from Windows 95 or Windows NT 4.0: 1. Click your Start button. 2. Choose Programs from the Start menu. 3. Choose IntraBuilder from the fly-out menu, then choose IntraBuilder Designer. IntraBuilder Server setup, startup and testing instructions are provided in SERVER.HLP, located in your IntraBuilder root directory. ------------------------------------------------------------ RUNNING THE PREBUILT BUSINESS SOLUTION APPLICATIONS ------------------------------------------------------------ IntraBuilder includes several prebuilt business solution applications which can be immediately run as-is or customized to meet your needs. The applications are installed into your IntraBuilder\Apps directory (default C:\Program Files\Borland\IntraBuilder\Apps). For descriptions of the applications and instructions on how to run them, see the README.TXT file in the \Apps directory. ------------------------------------------------------------ OTHER USAGE NOTES ------------------------------------------------------------ All editions of IntraBuilder ---------------------------- * Two updated Microsoft Access dynamic link libraries (DLLs) may help resolve problems with some Access tables and ODBC drivers. The DLLs (MSJT3032.DLL and MSWNG300.DLL) as well as information on the issues that the updates address, are available from the Microsoft Knowledge Base at www.microsoft.com/kb. Use the site's "Q-Finder" search option to locate article Q151186. The files are available for separate downloading directly from the article. * The following ODBC configurations have been certified for use with Microsoft Access tables: ODBC version Access version 2.10.0000 2.00.2317 2.50.0000 3.40.2505 * Do not use Microsoft Access (*.MDB) tables or indexes that reside in directories that have spaces in the directory name. However, you can use Access tables and indexes that reside in directories that have more than eight characters (e.g., /intrabuilder), so long as the directory name contains no spaces. * When adapting sample code written in VBScript, be mindful of the fact that JavaScript is a case-sensitive language, and so all events, properties and methods used in an IntraBuilder program must be cased correctly, or errors will result. It is particularly important to pay close attention to the casing of event handlers that are to be included in an IntraBuilder program. * After a successful setup of DBF security through the security adminstration dialogs, a dbsystem.db file is created. To allow the server to recognize and use this file, however, you must ensure that either: -- The dbsystem.db file is in the same directory as INTRA.EXE (located in your /IntraBuilder/Bin directory); or -- The location of dbsystem.db is specified in INTRASRV.INI as: [CommandSettings] DBSYSTEM= Currently, the two lines above are contained only in the file INTRA.INI (you can copy the lines from that file to INTRASRV.INI). Both INI files are located in your /IntraBuilder/Bin directory. * You should not save more than one custom form class to a custom form file. If you do, you may lose previously defined classes. * URLs to IntraBuilder forms or reports that require a parenthetical query will not work if issued from the Microsoft Internet Explorer 3.0 (MSIE) Address box. For example, the following entry into the MSIE Address box produces an error ("Site not found"): http://server/svr/intrasrv.isv?foo.jfm(123) In addition, any MSIE bookmarks that contain this URL construction will not work. You can, however, use a URL that contains a parenthetical query in an HREF link within a form or report, and the link will execute properly from MSIE. * For Windows 95 users only: Microsoft has issued a Windows 95 KERNEL32 system file update that resolves a known problem with a Windows Sockets memory leak. The leak occurs when opening and closing a Socket using the Windows Sockets API. Microsoft reports that this type of leak affects performance and system stability for users who run Windows Sockets applications continuously over a long period of time. We recommend that IntraBuilder users download and apply the update from the following location: http://www.microsoft.com/windows/software/krnlupd.htm * To close the IntraBuilder Agent on Windows NT 3.51, choose the minimized IntraBuilder Agent icon and press Alt+F4 (or close the application through the Windows Task List). On Windows 95, you can close the IntraBuilder Agent by right-clicking on the minimized IntraBuilder Agent icon and choosing Close. * Before running IntraBuilder after any new reinstallation or update, you should delete any *.GID (a hidden file type) and *.FTS files from your IntraBuilder directories before using the Help system. If you don't, you will get incorrect search and index information when using Help. * Do not use accented or extended characters as the first character in the name of a control on an IntraBuilder form or report. If you do, Netscape browsers will issue an error when attempting to access the form. * If you use IntraBuilder with dBASE files that were created with Visual dBASE version 5.5 or earlier, you may experience some problems with non-ASCII (non-English language) data. The reason: these early versions of dBASE normally used the ASCII character set. To remedy the problem, we recommend that you change the language of your early dBASE tables to the Western European ANSI (WEANSI) character set--the set normally employed by Internet applications. Visual dBASE users can find information on character set issues and how to change the set used by dBASE tables in Appendix C of the Visual dBASE Programmer's Guide. * On some Windows NT 4.0 Server machines, the file SERVER.HLP may run incorrectly. When opening the file you may see a tabbed Help dialog with only the Contents and Find tabs showing, if so you will have problems running the file. Rename the file (to SERVER1.HLP, for example), and change the properties for the IntraBuilder Server Help icon to reflect the new name. With this modification, the file will open and display correctly. Client/Server, Professional, and Trial edition users only --------------------------------------------------------- * The NSAPI interface to Netscape's FastTrack and Commerce Web Servers has a limitation on the length of HTML form variables. In most cases this limitation presents no problem, but if you have TextArea objects dataLinked to memo fields that contain more data than Netscape's NSAPI interface can handle then you may run into one of the following situations: -- Data saved from a Netscape Navigator browser to a Netscape server via the NSAPI interface from a TextArea control may be truncated. -- Data saved from Microsoft Internet Explorer from a TextArea control to a Netscape Web server using the NSAPI interface may generate a "Server Configuration" error, since Internet Explorer does not have the same restriction on the length of form variables. Netscape servers using the WinCGI protocol, the Borland Web Server, Microsoft's Internet Information Server, and WebSite do not have this limitation. Client/Server and Trial edition users only ------------------------------------------- * When using Remote Agents with Microsoft Internet Information Server, the dialog box "Waiting for Web Server to start..." does not close automatically when you start the web service. After the WWW service is Running in the Internet Service Manager, you must click Cancel to dismiss the dialog box. This action also closes the command prompt window used by the IntraBuilder Server. ------------------------------------------------------------ HELP FILE AND DOCUMENTATION UPDATES ------------------------------------------------------------ The main IntraBuilder Help file, as well as SERVER.HLP and other online documentation, is updated periodically and is freely available on the Internet at: http://www.borland.com/techpubs/intrabuilder/ The documentation site also features a complete list of new features and functionality for all editions of IntraBuilder 1.01a. ------------------------------------------------------------ INTRABUILDER HOME SITE ------------------------------------------------------------ The IntraBuilder home site is located at: http://www.borland.com/intrabuilder (the address is case sensitive). The site offers the latest product news and links to technical support information. ------------------------------------------------------------ UNINSTALLING INTRABUILDER ------------------------------------------------------------ For instructions on removing IntraBuilder from your system, see INSTALL.TXT. ------------------------------------------------------------ COPYRIGHTS AND ACKNOWLEDGEMENTS ------------------------------------------------------------ Copyright (c) 1996 Borland International, Inc. All rights reserved. All Borland products are trademarks or registered trademarks of Borland International, Inc. Other brand and product names used in this document and other documents and files included in this software package are trademarks or registered trademarks of their respective holders. This software is based in part on the work of the Independent JPEG Group (IJG). The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated.