K2BToolsGXPreferences object - Migration to GeneXus 16 U4

Summary

This external object has been included in K2BTools for several years. This object was used to read the application’s configuration in runtime in code generated by K2BTools.

Due to changes in GeneXus' standard classes in GX16 U4, this object's implementation must be updated. There are two ways of doing this:

  1. Upgrade your application to K2BTools 12 or higher. (recommended)
  2. If upgrading to K2BTools 12 is not possible, you may import this XPZ into your application after upgrading to GX16U4.

You can find more information below. If having doubts, you may contact us at support@k2btools.com.

Detailed information

This external object has been included in K2BTools for several years. This object has been used to read the application’s configuration in runtime in code generated by K2BTools.

This is used mainly to adapt the application’s behaviour when URLs are encrypted.

As this object is included in the Knowledge Base, developers may have referenced it in objects not generated with K2BTools.

Two recent changes in GeneXus affect this solution:
  1. GeneXus has released the Configuration Manager external object, offering the same features to developers.

  2. GeneXus will introduce breaking changes to internal APIs used by the K2BToolsGXPreferences object. These changes will be included in GeneXus 16 Upgrade 4.

Because of these changes, we have decided to execute these actions in K2BTools 12:
  • Update all code generated with K2BTools so that K2BToolsGXPreferences is not referenced any more, calling the Configuration Manager instead.

  • Update the K2BToolsGXPreferences external object so that it is compatible with the changes introduced in GeneXus 16 U4.

  • As of this version, the K2BToolsGXPreferences external object is deprecated, and will no longer be maintained by K2BTools.

In conclusion, after migrating to K2BTools 12 and GeneXus 16 U4, everything should continue to work as usual. However, as the K2BToolsGXPreferences object will no longer be maintained, we advise you to follow these steps after migrating:

  1. Reapply all K2BTools instances.

  2. Open the K2BToolsGXPreferences external object and find all references to it.

    1. If no references are found, skip to the third step.

    2. If references are found, migrate those references to the Configuration Manager. If having doubts, contact our support team.

  3. Delete the K2BToolsGXPreferences external object.