Saturday, June 25, 2011
Localization, Globalization, In-Page History

This a significant update to Code On Time web application generator and core library of generated applications. The summary of changes and enhancements is listed below.

Few users have reported a problem with automatic update installation. If the you experiencing errors while trying to upgrade then simply uninstall Code On Time and download a fresh copy at http://codeontime.com/download.aspx.

The update includes a brand new localization framework. All resources were externalized. There is a single file that can be changed to modify ALL of the client library text strings.

File ClientLibrary.*.txt (for example, ClientLibrary.en-US.txt or ClientLibrary.pt-BR.txt) will be created in the root of the project when you generate your application with the updated version of the code generator. Unlimited edition users can have multiple ClientLibrary.*.txt files matched to their selected cultures if more than one culture is supported.

If you change resource tokens in the file and re-generate the project one more time then the client library will use the content supplied by you. The ClientLibrary.*.txt file is not required at runtime.

There will also be additional resource files that are matched to resources such Web.Sitemap (for example, Web.Sitemap.fr-CA.txt) or data controllers descriptors (for example, ~/Controllers/aspnet_Memberhship.it-IT.txt). Changes to the files will be reflected at runtime. These files are a part of your application.

The web application generator will automatically produce localization files and perform actual translation using Google Translate if you apply a certain syntax to the text labels.

The localization and globalization tutorial will be available.

Fixes and improvements in this release:

  • Localization of both Web App Factory and Web Site Factory has been completed.
  • The entire client library now supports a mechanism to translate resources in a language of your choice.
  • In-Page History is now implemented in the Client Library. Previous implementation has stored user filters in the Session object on the server. The session state was restored whenever the data had to be presented. This was creating a somewhat undesirable user experience effect and significantly increased the size of the user session data. The new implementation will save history in the page and will restore the history only if you return to the page via Back button of your browser.
  • Container menus will now remember the selected tab. The new implementation of the in-page history will restore the selected tabs and selected row in Grid and Data Sheet views.
  • Field-level errors are now displayed in pop out boxes one at a time. This is probably the most visible change from the end user perspective. You can see the new style of field-level error message if you leave a mandatory field empty in a form and try saving it.
  • The bug preventing setting focus on a field in a Data Sheet view has been fixed.
  • Automatic localization of localized resources via Google Translate is now supported in all editions of the code generator.
  • Two new classes Localizer and CultureManager are now a part of the core framework of generated applications.
  • Membership bar will now display a language selector if multiple UI cultures are supported in your application. Multiple cultures are supported in Unlimited edition only.
  • Dynamic reports are using the current UI culture and display currency, numbers, and dates as is required by locale.
  • Adaptive filters have been changed to supported “typed” filter values. Previous implementation has been relying on simple string conversions between the client and the server. “Typed” values eliminate all sorts of filtering problems that were encountered with some locales.
  • Designer will open all objects in “edit” mode when an object is selected from a grid view. This should speed up and simplify project modifications.
  • Page containers show tabs with linked data views and controls when selected in Designer.
  • Numeric values will not wrap when displayed in Grid and Data Sheet views.
  • Modal forms will maintain the same width if user navigates between records using navigation arrows.
  • Interface System.Web.SessionState.IRequiresSessionState is implemented in all generic handlers to support ASP.NET session. This will ensure that you can access session data in business rules during import, export, and blob processing.
  • Membership bar replaces the browser URL to prevent the home page with login prompt from being displayed when user clicks the Back button in a browser. This only affects applications that do not rely on a dedicated login page.
  • The 'About'  box header text on pages has been placed in resources to support globalization.
  • BusinessRules class implements Localize(token,text) method to simplify localization of messages sent to the client from business rules classes.
  • MembershipBusinessRules class is using the new Localize method to display system messages.
  • Grid views will remember the last view type (Data Sheet or Grid) selected by end user and restore the view type when user returns back to the page via browse Back button.
  • Help system has been upgraded to include configuration instructions. It has been enhanced to match the web application theme and display a relevant customization instruction when a user selects Help link on the membership bar.
  • System messages by blob handler, controller, and annotation plug-in are now localized via global Resources.*.txt file.
  • Component DataViewExtender now supports method AssignStartupFilter. This method allows setting up an initial filter values using custom code. We recommend placing a custom user control on a page in designer and writing the logic assigning the initial filter in the code-behind file of the user control.
  • Import processor is not using the thread pool anymore. This will eliminate the bug related to unavailability of HttpContext during the export process. Context is now available since the execution of the import process is not asynchronous anymore. We will revisit this later to see if asynchronous processing can be accomplished via other means.
  • Added support for missing handlers to allow blob, reports, etc. with IIS / IIS Express and .NET 3.5 web apps. This was typically resulting in BLOB images not displayed when application is executed.
  • Sandbox app in Web App Factory solutions will now have the same base page YourNamespace.Web.PageBase to support globalization and localization.

Coming next:

  • Azure Factory project is ready to go. We wanted to implement a complete localization framework prior to rolling this out. The plan is to roll Azure Factory out over the next weekend. The feature will be available to Premium edition users.
  • Partial implementation of the Tree view has been released in this update. You can give it a try if you change the type of grid view to “Tree” in Designer and add a self-referring data field to this view. We are hoping to complete this data presentation style in the release. The feature will be available to Premium edition users.
  • Custom Membership and Role providers. We are planning to include this feature in Unlimited edition.