Advansys Formativ - GroupWise Customization Made Easy! Formativ Admin 1.6.0.12 Formativ Developer 1.6.0.12 Formativ Runtime 1.6.0.12 Formativ Administration Tools 1.6 Copyright (c) 2001-2004 Advansys Pty Limited - All Rights Reserved Viewing this document ===================== If you are viewing this document in Notepad, select 'Word Wrap' on the 'Edit' menu. THIS DOCUMENT CONTAINS IMPORTANT INFORMATION REGARDING THE INSTALLATION OF ADVANSYS FORMATIV. IT IS IMPORTANT THAT YOU READ THIS DOCUMENT IN ITS ENTIRETY PRIOR TO INSTALLING THIS SOFTWARE. FOR EASE OF REFERENCE DURING THE REMAINDER OF THE INSTALLATION, WE RECOMMEND THAT YOU PRINT THIS FILE NOW. Table of Contents ========================================== 1. What's New? 2. System Requirements 3. Upgrading from Formativ 1.5 4. Business Solutions Pack 5. Bonus Applet Pack 6. Free Example Solutions Pack 7. Operation 8. Known problems and omissions 9. Technical Support ========================================== 1. What's New? 16 April 2004 - Version 1.6.0.12 released - Updated Formativ and the registration utility to provide better support for Windows Terminal Services/Citrix environments. 4 March 2004 - Version 1.6.0.11 released - Bug Fix: Applets with a minimum version requirement now load correctly. 30 January 2004 - Version 1.6.0.10 released - Bug Fix: The Registration Utility has been updated to work reliably under Windows XP. - Enhancement: GroupWise.CreateTrustedApplicationObjectEx added to allow the creation of Trusted Applications that support message retention. 6 November 2003 - Version 1.6.0.8 released - Bug Fix: Links to the Formativ documentation are now correctly added to the GroupWise 'About|Formativ' Help menu. 17 September 2003 - Version 1.6.0.7 released - New method: Utilities.UTCToLocalDateTimeEx(UTCDateTime: DateTime): DateTime - this method takes into account whether the date being converted falls under Daylight or Standard time in the local time zone. - New method: Utilities.LocalDateTimeToUTCEx(LocalDateTime: DateTime): DateTime - this method takes into account the fact the local time being converted may not be in the current Daylight or Standard time. - New method: Utilities.InDaylightSavingsPeriod(LocalDateTime: DateTime): Boolean - this method returns a Boolean indicating if the given date/time falls within Daylight saving time in the current time zone. 31 July 2003 - Version 1.6.0.6 released - Under certain circumstances a disabled copy of Formativ could become re-enabled by clicking on certain folders in the GroupWise client. The Formativ Control Panel applet has been updated to stop this occurring. - Header request properties are now exposed in the HTTPConnection object. - If the applet list/source code editor splitter was dragged all the way to the left and Formativ Central was shut down, it was impossible to move the splitter the next time Formativ Central was opened. 22 July 2003 - Version 1.6.0.4 released - VBS/VBE file associations are now correctly restored via the Formativ Windows Control Panel applet 18 July 2003 - Version 1.6.0.3 released - Fixed a problem with the applet recorder not working under certain circumstances. This problem only affected completely new installations of Formativ Developer and Admin. - Added an applet deletion confirmation dialog in Formativ Central. This only affects Formativ Developer and Admin. 14 July 2003 - Version 1.6.0.2 released - Added the 'LoadEx' method to the FileIterator object in the Formativ language. 'LoadEx' loads only directory names if the file specification value is set to 16 (faDirectory). - The FileIterator.Attributes property now works. This value was previously ignored and a value of 0 (all files) was used by the FileIterator object. - Added the new method 'MoveFileEx' to the FileSystemUtils object. See 'CopyFileEx' in the Language Guide for details. - Added the new method 'SetFileAttributes' to the FileSystemUtils object. This method takes two parameters: 'Filename' and 'Attributes'. 'Filename' is the full path to the file you wish to change the attributes of. 'Attributes' represents the attributes you wish to set. Attributes can any of the following values OR'd together: o $00000001 Read-only files o $00000002 Hidden files o $00000004 System files o $00000008 Volume ID files o $00000010 Directory files o $00000020 Archive files o $0000003F Any file - The installer now creates a default value of true for the LDAP 'Cache All Libraries' setting. - The uninstaller now removes all Formativ registry values. 3 July 2003 - Version 1.6.0.1 released - Fixed a bug where Windows XP/2K users with 'Power User' rights would receive a warning message stating the user has insufficient rights to the Windows registry. - Added two new settings for LDAP authentication: 'Use Default Username' and 'Use Default Password'. These settings are accessible from the Formativ Windows Control Panel applet, and are also configurable via the installer /i- config.ini option (see the Distribution Kit documentation for details). These options are used to force Formativ to use the default username and password values from the Windows registry (if available) when authenticating to an LDAP server. Any values stored in the users GroupWise account are ignored. - Changed the 'Save Password' LDAP option to also save the username in GroupWise. This feature has also been renamed to 'Save username and password in GroupWise'. - Added a new 'Save username and password feature enabled' setting in the registry. See the Distribution Kit documentation for details. 1 July 2003 - Version 1.6 released - Applet Pack Support o Formativ now supports multiple Applet Packs. An applet pack is a collection of applets that meet a specific industry need, or provide a related set of functionality. o Applet Packs make it easier for organizations by providing more choice, and the ability to purchase only those packs required. o Currently available packs include: ? Business Solutions Pack ? Example Applets Pack o Pack soon to be released include: ? Presentation Pack o Visit www.advansyscorp.com/formativ.htm for more information. - Support for GroupWise 6.5 o New language extensions designed to take advantage of many of the new features found in GroupWise 6.5 o Better visual integration with the GroupWise 6.5 client o Trusted Application Support: Use Formativ to easily build Trusted applets that are able to access all GroupWise data given the appropriate level of security. - New Integrations Manager o More intuitive, easier to use integrations manager makes it even easier to associate applets with GroupWise toolbar buttons, menu items and events. - New Event Ordering o You can now specify that an applet is to execute before, after, or in place of, any supported GroupWise event. o Provides finer control over when an applet is executed. o Lets you completely replace native GroupWise events. For example, you can replace the 'Delete' event so users are unable to delete email from their mailboxes. - New Conditional Event Canceling o You can now conditionally cancel a GroupWise event from within an applet. For example, you could stop an email message from being sent under applet control. - New Custom Message Support o Create new GroupWise message types o Define icons to represent your new message type in the GroupWise client o Build new user interfaces to display your new message types. - New Installation Options o The Formativ installation program has been updated to make it even easier for Administrators to install Formativ on large numbers of workstations. See the Distribution Kit documentation for more information. o The Distribution Kit can be downloaded from: ? www.advansyscorp.com/formativ_distribution_kit.htm - New Installation Paths o Completely new installations of Formativ use new system directories to store user applets and data. This makes it possible to have multiple Formativ users on the one computer, which is especially useful when using Windows NT Workstation, Windows 2000 and Windows XP. o The Formativ installer now provides the option to create default settings that affect either the current user, or all users of a single computer. o Formativ Solution Pack installers now provide the option to install applets so they available to all users of a computer, or just the current user. - New Administration Options o The Formativ trialware system has been updated to make it easier for Administrators to register both Formativ and associated Applet Packs. 2. System Requirements - Microsoft Windows 98, ME, NT, 2000 or XP. - Novell GroupWise 5.5, 5.5 EP, 6.0.1 and 6.5 Windows client. The Formativ Portal Manager (and applets that use the services of the Portal Manager) requires GroupWise 6.01 or above. Novell have released a beta FTF file for the GroupWise 5.5.7.1 Enhancement Pack client, which enables the use of Formativ Portal Manager based solutions with the GroupWise 5.5 EP client. See Novell TID 2963458 to download the GroupWise 5.5.7.2 Beta FTF file (f32eppp1.exe). http://support.novell.com/cgi- bin/search/searchtid.cgi?/2963458.htm . - Microsoft Windows Script (5.5 or above) (Normally installed by MS Internet Explorer). - Microsoft Internet Explorer 5.5 or above. - Novell NetWare Client is required for the Schema Wizard administration tool (Formativ administrators only). - The GroupWise C3PO architecture dictates that users require read and write access to the HKEY_LOCAL_MACHINE area of the Windows registry. Formativ will still operate without this access, but applets would need to be installed by an Administrator. The GroupWise client and MS Internet Explorer must be installed prior to installing Advansys Formativ. 3. Upgrading from Formativ 1.5 You should make a backup of any applets you modified or created prior to installing version 1.6. Formativ 1.5 applets are compatible with Formativ 1.6. Some new applets may reference services only available in Formativ 1.6. Check individual version requirements. Formativ 1.6 may be installed over the top of an existing Formativ 1.5 installation. No applets are replaced during the 1.6 installation. Several new installation options are available to system administrators via the installation configuration INI file. See the Distribution Kit documentation for details. There are no changes to the eDirectory features of Formativ in this release, and no changes are required to the schema. 4. Business Solutions Pack The optional Business Solutions Pack applets are no longer an installation option in Formativ Admin, Developer or Runtime. The Business Solutions Pack may be downloaded and installed separately from: www.advansyscorp.com/formativ_download.htm. 5. Bonus Applet Pack The free Bonus Solutions Pack applets are no longer an installation option in Formativ Admin, Developer or Runtime. The Bonus Solutions Pack may be downloaded and installed separately from: www.advansyscorp.com/formativ_download.htm. 6. Free Example Solutions Pack A large number of open source example solutions are available for use by Formativ Admin and Developer users. These examples demonstrate many aspects of developing solutions for Novell GroupWise. The example applets are available in the free Example Applets Pack, available for download from: www.advansyscorp.com/formativ_download.htm. Please note example applets are provided 'as-is', and are not supported by Advansys. 7. Operation Please see the User's Guide for introductory information. The User's Guide also provides links to other resources pertaining to programming with Formativ. The Programmers Guide contains many useful topics pertaining to general development issues. The Language Guide documents extensions made to the applet language syntax to allow interaction with GroupWise, and the creation of dynamic dialogs. The User's Guide contains many examples. Use them to get started. Many sample applets are also installed under the \Local folder. Network administrators who wish to take advantage of Formativ's eDirectory/NDS integration should refer to the Formativ Administrators Guide. A distribution kit is available from Advansys at http://www.advansyscorp.com/formativ.htm which provides information and tools designed to make distributing Formativ to large numbers of computers easier. The distribution kit includes ZENworks AXT files and GroupWise AddOn.CFG files. The distribution kit is supplied with comprehensive documentation. 8. Known problems, issues and omissions - Personalized Mass Email o GroupWise 6.5 introduced a bug that can cause the Personalized Mass Email applet to fail when sending messages to more than approximately 150 users when using a HTML email template. The applet has been updated to warn users if this problem is likely to occur. This issue is resolved in GroupWise 6.5 SP1. - Norton Anti-Virus o Some Formativ applets make use of the script engine FileSystemObject to access the file system. Some versions of Norton Anti-Virus intercept this action. To continue, choose the 'authorize this script' in Norton, or disable the script blocking option. 9. Technical Support Technical support for this product is provided via online moderated support forums at: http://advansys.atinfopop.com/4/OpenTopic?a=cfrm&s=7534089931&f=36340 89931 Thank you for using Advansys Formativ - GroupWise Customization Made Easy!