Skip to content

Upgrading

Upgrading to 5.0.0 or later

Version 5 features a checklist rewritten from the ground up.

Data structure

There's a few fields on the internal limetype checklist_item that have been deprecated and can be removed (Optional) But the required ones needs to be edited to not being required because they're not used anymore. There's also some new fields that needs to be added to the checklist_item which is easiest to do using the addon installer.

  • Edit your data structure in the database designer to make sure that:
    • title field on checklist_item is NOT required.
    • owner_table field on checklist_item is NOT required.
  • Go to Settings => Dynamic Checklist => Setup and run the addon installer.
    • To add the new required fields on the checklist_item

Custom limeobject replaced by Automation

Remove the custom limeobject code in each checklist owner and replace it with the new Initialize Checklist automation.

Packages/Modules/Classes have been changed

A big refactor of a lot of modules and packages which means both modules/packages/classes and functions have been renamed/moved/removed. Below you see a list of the public ones that needs to be updated.

Because it's common that solutions use internal imports a good way to verify that it doesn't break is to run a test that imports all files that imports anything from limepkg_dynamic_checklist to verify that you don't get any ImportErrors.

  • limepkg_dynamic_checklist.checklist_template.ItemData => limepkg_dynamic_checklist.checklist_template.ChecklistItemTemplate
  • limepkg_dynamic_checklist.checklist_template.Template => limepkg_dynamic_checklist.checklist_template.ChecklistTemplate
  • limepkg_dynamic_checklist.checklist_owner.before_update Have been removed
    • Replaced by automation

Custom endpoints in checklist items

There are several properties that have been removed in the custom endpoint call if configured on a checklist item template.

So if you in any of your custom endpoint for the checklist are using any of these fields you need to rewrite them before upgrading to this version: The removed fields are:

  • item_id
    • It doesn't exist anymore until after a user interacts with the item, so this cannot be replace with anything.
  • value
    • Instead use item_action which is an enum with the following values CHECK, UNCHECK, IGNORE or UNIGNORE
  • ignore
    • Instead use item_action which is an enum with the following values CHECK, UNCHECK, IGNORE or UNIGNORE
  • item_limeobject
    • It doesn't exist anymore until after a user interacts with the item, so this cannot be replace with anything.

Customizations regarding checklist_item that have not been interacted with will stop working

From now on the internal checklist_item limeobjects will only be created when a user interacts with an item. So the rendering of "future" items are read from the checklist template and when a user have interacted with the item (check/skip) we create a checklist_item to keep track of the state of the checklist

All support for running the checklist in the desktop client has been dropped.

Make sure to configure your webclient to include the checklist.

Security config has partly been moved from the addon configuration to the component configuration.

You now configure who can soft reset and re-create each checklist in the view config where you add the checklist component, allowing you to tailor each checklist flow in your solution. Can't remember your old configuration? Don't worry, switch to code editor in lime admin to see the stored values from version 4.

Upgrading to 4.0.0 or later

This version introduced technical version control of checklist templates. This means that existing checklist templates will be migrated to the first version of version handling. This is to be able to add and change the Checklist builder more drasticly going forward. Ensure to test and verify your templates after upgrading.

This version also includes breaking changes in structural in modules/packages in the checklist. Meaning if you have modified or used this in some sort of customization (rare and not recommended) things might break. So if you know that these functions have been modified, please adjust your code:

  • Separate limepkg_dynamic_checklist.checklist_helper to sub modules
  • Separate limepkg_dynamic_checklist.checklist_template to sub modules
  • Delete unused functions/endpoints

Upgrading to 3.2.0

Fix - Can configure history type of forced notes:

You can now in Lime admin select what history type that should be used when creating force notes in the checklist. Default is comment

Fix - Access config is now done in Lime admin for both web and desktop:

If you have set userGroups in the desktop app that will override what's in Lime admin. So to enable this you must set the wanted groups in lime admin and then remove the userGroups property in the config of the desktop app

Upgrading to 2.1.0

Fix - template property id is now a picker instead of text input:

The template property id is now a picker so it needs a search view and generated search index to work. Make sure that all configured Template Properties serach views and search indexes.

Feature - readonly mode on desktop checklist:

The desktop client now supports readonly mode so that a checklist could be readonly when helpdesk is closed for example. See example here

Upgrading to 2.0.0

This is the first version that includes the web client checklist. If you want to use it, make sure to configure it

This new major version have a lot of structural changes, this could affect existing checklists. Make sure to test them and make sure that they work. Some unwanted things/crashes could occur if not double checked.