2.0.2 to 2.0.3 Migration Notes

The upgrade from 2.0.2 to 2.0.3 should be totally transparent to your end-users. However a few things changed between the two versions. Depending on the way you use the application you may want to pay special attention to the following points:

Usability

The following change may have an impact on the user experience:

  • The global search now requires the end-user to type at least 3 characters. There was no such limitation previously. This limit (3 characters) is configurable via the configuration parameter full_text_needle_min.

REST/JSON API

Check the REST/JSON Documentation for the latest version of the API. The following changes may have an impact on your integrations:

  • The output of the core/delete operation has changed. The operation now properly reports what was done.
  • The handling of “CaseLog” attributes has been improved. The output format now reflects the structure of the case log (one item per entry in the case log), and, in input it is now possible to add several items to a case log or even completely replace it.
  • A new operation core/check_credentials has been introduced… to check the credentials of a given user.
  • The output of boolean attributes changed: it was “1” (meaning true) and “” (empty string, meaning false) previously, it is now “1” (meaning true) and “0” (meaning false).
  • The value returned for Enumerated fields (like the status of a ticket) is now always the 'code' (i.e. a non-translated value) and no longer the localized label.
For security reasons, the use of REST/JSON webservices by user accounts with the profile Portal User will be disabled in the next major version of iTop. If you use one of the webservices only to check the credentials of a user, adjust your code to use the new core/check_credentials operation.

Data Model Customizations

If you performed your own customizations to the iTop data model, pay attention to the following changes:

  • The definition of the menu for “Admin tools / Query Phrasebook” changed to add the search form at the top. If you have implemented your own menus (normally defined in itop-welcome-itil module), make sure that you update the menu definition to show the search form at the top as well.
  • For performance reasons, the default tracking_level on link sets has been changed. Unless specified otherwise in the data model, the default behavior is now to disable the history tracking of 1:n links for fresh installations.

Data cleanup

During the upgrade, the setup process will perform a cleanup of unused records in the history tracking. Depending on the size of the priv_change table and the number of unused records to remove, this may take several minutes.

latest/install/202_to_203_migration_notes.txt · Last modified: 2023/07/21 10:19 (external edit)
Back to top
Contact us