Version 2008-02-15

The following is a summary of the changes included in this release.

1. FTP Server Ping Timeout - Added a preference setting which allows the developer to control the ping timeout seconds. If set to zero (0) the FTP server will not be pinged.
2. Package Builder/Editor - Added a button which allows you to add a new package from this window.
3. $closeApp - AutoUpdater will send a $closeApp message to the main library's Startup_Task if a $closeApp method exists. This gives your application control over what has to happen or prevent your app from being closed if some critical process is running or a window is in edit mode. If your $closeApp method returns true, AutoUpdater will contine and close the main library; if false, AutoUpdater will bail out.
4. Zoom Boxes - The $zoombox property has been set to true and a vertical scrollbar added to a couple of window for situations where AutoUpdater is being administered remotely with a small size monitor space.
5. Prompt for Update - The headed lists in this window have been set to $active=kFalse so that user can't select/deselect lines in the lists. The Cancel button has been change to read Skip with the tooltip Skip this update.
6. Local DB Files Server - Some changes have been made and more are to come as Andy Hilton works with implementing this option on some of his client's networks.

Update Instructions

If you are updating a previous version AutoUpdater library you will need to copy your oPreferences object into the new release AutoUpdater library and then copy two methods from the new release oPreferences object to your oPreferences object.

If you have made any changes to other classes in your existing AutoUpdater library you will need to copy those to the new release library.

Here are the recommended steps to follow:

1. Quit Omnis Studio.
2. Backup your existing AutoUpdater library.
3. Move your existing AutoUpdater library out of your APP folder to somewhere else. (e.g. an Archives folder)
4. Move the new release AutoUpdater library to your APP folder and rename the new release AutoUpdater library to match the fiile name of your existing AutoUpdater library.
5. Open the renamed new release AutoUpdater library. When prompted to open the main library, click No.
6. Rename the oPreferences object class to oPreferences_NewRelease.
7. Open your old AutoUpdater library. If prompted to open the main library, click No.
8. Drag the oPreferences object from your old AutoUpdater library to the new AutoUpdater library.
9. Close the old AutoUpdater library.
10. Copy the $:FTPPingTimeout and $:FTPPingTimeout.$assign methods from oPreferences_NewRelease to oPreferences in the new AutoUpdater library.
11. That should do it. Close and reopen the new AutoUpdater library and check the Preferences settings. They should be the same as your old AutoUpdater library.
12. Test the new release AutoUpdater library. When you get up the nerve click the Upload Self... button in the Preferences > Developer subwindow. This will upload the new AutoUpdater library to the files server. The new AutoUpdater library should automatically download and replace the existing old version AutoUpdater library for the each runtime user the next time their old AutoUpdater library checks for updates. You should immedatetest this with a runtime user
    
    
    

    The self update process always makes me a bit nervous, so please tread slowly and carefully. Once we've done this a dozen times successfully we'll all feel more confident about the AutoUpdater self update process. If worse comes to worse manually send the new AutoUpdater library to the runtime user and have them replace the old AutoUpdater library manually.

Details

Startup_Task/$closeApp (2008-02-06 Doug K.)
Added code which sends a $closeApp message to the main library's Startup_Task if the method exists. This gives the main library an opportunity to reject being closed in case there is a critical task running or a window is in edit mode.

oFTP/$:PingTimeout (2008-02-06 Doug K.)
Added ping timeout property which can be assigned. Default 15 seconds. If set to zero the pinging the server will be skipped.

oFTP/$:PingTimeout.$assign (2008-02-05 Doug K.)
Added method to allow developers to assign the $:PingTimeout value. If timeout is set to zero then this object skips pinging the server.

oFTP/$initialize (2008-02-06 Doug K.)
Corrected the method description. Remove the sentence that said this method opens a connection with the FTP server as that is no longer true.

oFTP/$pingServer (2008-02-06 Doug K.)
Use the $:PingTimeout value to ping the server. If timeout is zero ping is skipped and zero returned.

oFilesServer_FTP/$initialize (2008-02-06 Doug K.)
Get the ping timeout preference property value and include it with the oFTP object $initialize message.

oPreferences/$:FTPPingTimeout.$assign (2008-02-06 Doug K.)
Added $:FTPPingTimeout property method and $assign method to control TCP pings. If set to zero TCPPing will not be executed.

oWebBrowser/$createEmail (2008-01-30 Doug K.)
Formatting problem fix. Replace special characters in the subject and body with ASCII hex escape characters. The format "mailto:PersonName <email@domain.com>" format was causing trouble. Extract and use the email address only.

wAdministratorSettings/$#About (2008-02-06 Doug K per Andy H.)
Set $zoombox &amp; $vertscroll properties to kTrue

wAdministratorSettings/$event (2008-01-30 Doug K per Andy H.)
Added kFileOpsOpenApps parameter to FileOps.$getfilename so that MacOSX can browse application contents.

wAdministratorSettings/setSubWindows (2008-01-29 Doug K.)
Only set the wServerPackageAndFiles subwindow field's classname if the necessary $:LocalDB... preference properties have been set.

wErrorPrompt/viewLogFile (2008-01-30 Doug K.)
Changed $openLogFileViewer to $openErrorLogViewer.

wPackageBuilderEditor/$#About (2008-02-06 Doug K per Chuck Martin.)
Added button which allows the developer to add a new package directly from this window.

wPackageBuilderEditor/$event (2008-01-30 Doug K per Andy H.)
Added kFileOpsOpenApps parameter to FileOps.$getfilename so that MacOSX can browse application contents.

wPackageBuilderEditor/loadLocalPackage (2008-01-30 Doug K per Andy H.)
Added kFileOpsOpenApps parameter to FileOps.$getfilename so that MacOSX can browse application contents.

wPreferencesDB/$event (2008-01-30 Doug K per Andy H.)
Added kFileOpsOpenApps parameter to FileOps.$getfilename so that MacOSX can browse application contents.

wPreferencesDeveloper/$event (2008-01-30 Doug K.)
Added button to the developer preferences window to open the main library.

wPreferencesFTP/$#About (2008-02-06 Doug K.)
Added FTPPingTimeout field for the new property. Setting the value to zero skips pinging the FTP server.

wPreferencesLocalDB/$#About (2008-01-29 Doug K. per Andy H.)
Fix the LocalDBDatabaseName field $dataname. It was set to prefs.$:DatabaseName, should be prefs.$LocalDBDatabaseName.

wPreferencesLocalDB/$event (2008-01-30 Doug K per Andy H.)
Added kFileOpsOpenApps parameter to FileOps.$getfilename so that MacOSX can browse application contents.

wPromptForUpdates/$#About (2008-02-06 Doug K.)
Set the headed lists to $active=kFalse so that the use can't click on the lists which would make them think they are selecting what packages or files are to be downloading. (Not true)

wPromptForUpdates/$#About (2008-02-06 Doug K.)
Changed the name and text of the 'Cancel' button to 'Skip' and the tooltip to 'Skip this update' Just saying 'Cancel' sounds like absolutely nothing is going to happen if I click it. The reality is that the Omnis Studio main library will be opened, we'll just skip the update.

wPromptForUpdates/$setDownloadFilesList (2008-02-06 Doug K.)
Set the current line in the packages and files list to zero so that no lines will appear to the user to be selected in the headed list.

wShell/$#About (2008-02-06 Doug K per Andy H.)
Set $zoombox &amp; $vertscroll properties to kTrue

AutoUpdater Documentation - Copyright 2006 Vencor Software