2023.10.0 (2023-12-05)

New Features

Area Title Description Reference
Architecture Archiving and Cleaning Strategy Implementation for Changelog Data

System Administrators can now set up an Archiving and Cleanup strategy with regards to redundant Change Log Records. This will greatly reduce the data size footprint that this table accumulates over time.

OKPTPIMP-37
Asset Health Alarm Status - Cancel by Work Order

Condition monitoring can now be configured in such a way that closing the work order that was created by the alarm also closes the alarm.

OKPMAHM-32
Asset Types New tab on a task displaying information on changes that needs to be confirmed

A new tab has been added to the Asset Type Task screen. The Changed Entities tab displays the details on a task that have been changed, resulting in the Development Status to change.

OKPTPIMP-44
Assets Document File Attachments on Regular Asset Tasks

Document File Attachments has now been rolled out to Regular Asset Tasks.

OKPMAST-156
General Configuration Match update user defined fields

The match update functionality has been extended to user defined fields across any entity that supports generic match updating. Records can be multi-selected to update all user defined field values.

OKPTPIMP-31
General Configuration Document File Attachment on Resources

Document File Attachments has now been rolled out to Resources.

OKPMGNC-89
General Configuration Match update Users, Meters and Stock Items

The match update functionality has been extended to Meters, Users and Stock Items.

OKPMGNC-90
Helpfile Performance optimisation of the system

System Management > Performance Optimisation: A new topic has been created to outline areas to investigate when dealing with On Key Plus performance issues.

OKPMHPTS-26
User Access Management Ability to set the user authentication to active or inactive in a bulk way

In many cases the system administrator needs to temporarily prohibit multiple users from entering the system, while doing maintenance on the system. This feature allows the system administrator to block these users for a certain period of time.

OKPTPIMP-38

Modifications

Area Title Description Reference
Architecture Query builder extended to facilitate fields containing arrays

Fields containing arrays can now be queried via the query builder. Users can filter on fields such as Asset Task Scheduling Reasons to find specific records.

OKPTPIMP-30
Asset Operation Meter readings validations

Two new validations have been introduced that are configured in system options:

- Average Daily Rate Variance: If a new meter reading causes the ADR to vary above a specified threshold, a warning will be displayed; or the meter reading entry will be prohibited.

- Max Average Daily Rate: If a reading causes the ADR value to exceed a specified threshold, a warning will be displayed; or the meter reading entry will be prohibited.

OKPMIGAOM-36
Asset Types Copy and paste group of task selection window profile

It is now possible to configure the screen via a query builder and save it as a re-usable profile.

OKPTPIMP-46
Common Functionality Inline editing of attributes

The inline editing functionality on attributes has been aligned to the capabilities of inline editing of user defined fields. Users can now inline edit attribute free text and predefined values.

OKPTPIMP-12
General Configuration Delete button added on Designer

Previously users had to use the delete button on the keyboard to delete entities off the designer screen. A long awaited Delete button has been added to the user interface whereby users may now delete entities.

OKPTPIMP-28
General Configuration Toggle between Id's or Codes within the Change Log

The user now has the ability to view the Codes of entries on an entity's Change Log. This will greatly improve the efficiency of finding information within the Change Log.

OKPTPIMP-49
Generic User Interface Default save action setting

Users can now choose their default save action when creating and updating records. Up to now the default action for any record has been Save and Close. Often users want to Save and Update a record as additional fields become available after saving. A system option has been added to edit this default behaviour.

OKPMUX-131
Maintenance Plan Development API - Asset Type Task & Asset Task - Change In Interval Type Not Automatically Defaulting Required Fields to Null

The API has been aligned to the field defaulting behavior of the User Interface.

OKPTPIMP-11
Reporting Default reports per entities

With this feature the user has the ability to configure default reports per entity. The user can further refine the feature whereby specific reports are presented, based on the criteria specified.

OKPRA-24
Reporting Wyn API change from GraphQL -> RestApi for future Wyn releases

On Key Plus is now compatible with the latest Wyn reporting

OKPRA-26
User Access Management Ability to multi select permissions when creating custom permissions

This feature allows the multi-selection of custom permissions on a User in a wizard type of flow. This greatly improves the efficiency of a previously tedious process to add multiple custom permissions to a user.

OKPTPIMP-42
Work Management Auto Populate Meter readings across all tasks

In this feature we have changed the logic where the meter reading is posted from the WO Meters table to Meter readings, rather than from WO tasks. It will also auto-populate meter readings when you complete a Work Order Task.

OKPMWMN-112
Work Management Provide system option that makes it mandatory to specify an asset for a work order

A new system option has been introduced whereby the user can determine whether it should be mandatory to specify an asset when creating a new work order.

OKPMWMN-134
Work Management Type of Work in Proposed Work Order split option

The Type Of Work splitting option has been added to the Proposed Work Order generation screen.

OKPMWMN-140

Bug Fixes

ID Area Title Description Reference
93734 Asset and Maintenance Plan Configuration On Key Plus In-Place Asset
In-place assets are now available in the Asset lookup field when creating a new work order.
TPMSP-2251
97549 Asset and Maintenance Plan Configuration Linked Placeholder Asset Component failing Rule Evaluation but not linked to any Rules
The issue occurred where the Parent's Rule Evaluation states did not roll out to child objects below it, leaving it in an orphaned state. The "Unknown" Reason was part of the Convert Logic from On Key 5, but should have subsequently been resolved. This bug is now fixed, and these descendants should now follow the behaviour of its parents.
TPMSP-2475
97551 Asset and Maintenance Plan Configuration Development Status and Rule Evaluation checks for creating new entities
Asset Component Placeholder, Regular Asset Component and Regular Asset Task will now fail when created under under a parent that has its development status = 'Deleted Confirmed' or have RuleEvaluationPassed = false. Currently these parents are covered in the validation: 
Regular Asset, In-place Asset, Asset Component Placeholder, Regular Asset Component
TPMSP-2479
99187 Asset and Maintenance Plan Configuration Last Done Task incorrectly Suppressed
A new field has been added to the due task that indicates the suppression type. This allow the user to understand why a task is being suppressed. When a task is fully suppressed (all intervals), the new field is then used to identify the first due LastDone to unlock and not suppress anymore.
A further issue where not all suppressors were persisted has been resolved. This required additional logic to properly reset the is_suppressed flag and suppresion_type once a suppressor is deleted. In order to support this logic, the suppression_type column has also been added to the suppressor.
TPMSP-2493
99194 Asset and Maintenance Plan Configuration Asset Spares passing Rule Evaluation when Asset Type Spare Rule is Inactivated TPMSP-2563
99222 Asset and Maintenance Plan Configuration Asset Task Spares - Applying a profile removes "Match Update" option
Applying a profile to the Asset Task Spares dashboard no longer removes the Match Update option from the Assist panel.
TPMSP-2490
101573 Asset and Maintenance Plan Configuration Due Tasks cannot be generated due to extremely small Meter Average Daily Rates
In certain scenarios the suppression window calculation can get to a value that is over 4000 years. This then causes the calculation to fall over. A cap has been put in place to limit the suppression window to 500 years, which should stop this scenario from happening.
H0005072
102324 Asset and Maintenance Plan Configuration Rule Evaluation (RE) is not applying correctly on asset 9000154029
Previously the parent item rule evaluation was not inspected when traversing custom asset items under inherited items. The behaviour has now been expanded to include this check and mark the children as RuleEval fail or pass.
H0005582
105282 Asset and Maintenance Plan Configuration ServiceNow #INC0026394 - Rule evaluation incorrect on spare part in MIG
This bug was caused due to Options not being properly maintained on the corresponding Regular Asset Type. When the user attempted to enter Option Values, the system marked them as invalid. The robustness around the maintaining of Options on the Regular Asset Type has been enhanced, which will prevent this scenario from happening again.
H0006525
107919 Asset and Maintenance Plan Configuration Profile, "glb Batch Update Multiple Asset Tasks", gives an error.
This was a missing resource action migration, which was fixed in V6.0. 
H0006058
108301 Asset and Maintenance Plan Configuration Unable to Link Existing Standard Tasks in the Asset Tree using certain Profiles
A migration intention has been added to resolve the profile related issues on the asset tree.
H0008267
108341 Asset and Maintenance Plan Configuration Standard Tasks - Task Duration Errors when Auto Calculate = True
Bug was fixed will now work as expected.
H0008284
108543 Asset and Maintenance Plan Configuration Tree Search Bar Doesn't Automatically Dismiss on Unique Find
The Tree Search toolbar now automatically closes once a search has been complete and a record has been found.
H0008338
108605 Asset and Maintenance Plan Configuration Conversion Bug : Sub tasks on Asset tasks
Sequence numbers now convert correctly for Asset Task Sub Tasks.
H0008394
108616 Asset and Maintenance Plan Configuration Auto calculate duration does not occur when component quantity is updated on regular asset tasks
Bug was fixed will now work as expected.
H0008005
108926 Asset and Maintenance Plan Configuration OKP- Sequence numbers do not match OK5
Sequence numbers Fixed
H0008581
110005 Asset and Maintenance Plan Configuration Reg Asset Type Missing in Tree
Expanding of tree nodes was using the same paging limit as the tree search did. The tree node expand is now limited to 50 000 records and the tree search will default to 1 000 records. The tree search limit can be changed on the screen should the user need to fetch less or more records.
H0009054
110092 Asset and Maintenance Plan Configuration Unable to Link Existing Standard Tasks in the Asset Type Tree using certain Profiles
Added a migration to resolve the profile issues on the Asset Type Tree
H0009090
110093 Asset and Maintenance Plan Configuration Standard Task - Component goes blank once + clicked - Asset Type
The Asset Type Component field on the Link Existing Standard Task screen no longer goes blank.
H0009091
110094 Asset and Maintenance Plan Configuration Standard Task Component Lookup Blank - Asset Tree
The Asset Component value is now visible on the Link Existing Standard Tasks screen when linking a standard task to an asset and selecting the component.
H0009092
110735 Asset and Maintenance Plan Configuration Duplicate Monitoring Point Trigger Expressions present when adding it on a Follow Up Task
Added a database validator to make sure that the regular asset type and non type monitoring point trigger development status is not Delete Confirmed when adding expressions to the follow up task expressions.
H0009346
111001 Asset and Maintenance Plan Configuration Last Scheduled tasks feedback not pulling throuugh due to Last Done task validation
This bug is fixed as part of Hotfix 10.0 due to be deployed 27 November 2023
H0009375
111045 Asset and Maintenance Plan Configuration Asset Code type in - not loading - Server work
The location element has been removed from the work order create screen. The location code and description will now be cleared when the asset has changed on the work order.
B74337
109031 Asset Health Managment Migration created monitoring point triggers
Bug was fixed by removing bounds conversion for monitoring point triggers
H0008689
110734 Asset Health Managment Unable to remove a Monitoring Point Code from a Monitoring Point Trigger Expression Parameter
The monitoring point property was not available for update on the REST API. It has been added and can now be updated.
H0009336
94506 General Query Builder - Unexpected Error - Type Provider must be an Enum
The On Key Query Language has been expanded to include a new CONTAINS operator that can be used to verify whether a list field contains all of the values specified. For example:  RegularAssetTask->SchedulingFailReasons contains ('AssetTaskNotActive','TaskIsPausedForScheduling').

Idea to further enhance the QB with regards to Contains drop down and error handling have been logged. https://on-key.aha.io/ideas/ideas/OKPMGNE-I-40
TPMSP-2335
90821 General Configuration In Line Editing - Attributes
User can now use Inline Editing to update the Value column of Attributes on a grid.
TPMSP-2088
109359 General Configuration Work Order Description: Translation only working on first translatable word.
Fix issue where only the first phrase translation for a given localization key was replaced in a phrase translatable field. Now all is replaced.
H0008755
93806 General UI Designer Delete button missing for line items
There is now a Delete button available in the toolbar above selected Field / Header / Group / Pager Properties in order to delete line items without the use of the keyboard.
TPMSP-2250
106941 General UI OKP Designer
The tab descriptions on the Designer no longer change to default values.
H0007411
107594 General UI Inconsistency when Adding a Conditional Validation in the Designer
Work order records which include a conditional validation on a UDF field can now be successfully saved after applying a profile.
H0007887
108692 General UI Error received when accessing Data Properties from the Designer
The Data Properties and User Defined Fields side menu buttons should not be accessible when working with dashboard on the Designer. Updated the states of these buttons to be disabled when working with dashboards
H0008437
109391 General UI Changelog unable to open when it contains many records
The changelog screen has been redesigned, which also resolved this issue.
H0008790
109998 General UI WO DB reloads when exiting an edit screen and the profile panel is inconsistent
A timing issue related to the profile sidebar was causing the profile to reload when the user already had a profile selected by default as part of an operational role. This has been resolved.
H0009038
110146 General UI Work Order Edit Screen Not Opening
The public profile (for the Work Order Update screen) that is used here has a resource action (GetWorkTaskCollection) that is marked as private. The profile is also linked to an operational role and when the user opens the work order update screen, that profile is loaded and tries to execute the private GetWorkTaskCollection. This results in an error since the user that is loading the profile does not have the View Other users Private Profiles permission.
This profile used to be a private profile and the user it used to belong to changed the restriction level of the profile to public.  There was an issue that the associated resource action(s) are not changed to public when the profile restriction level is changed to public. Thus the resource action(s) was left as private.
H0009108
110575 General UI Changelog - Limit On Records Returned
The changelog now shows all records based on the limit set in the system option Page Limit.
H0008790
110576 General UI Changelog - Styling Issue On Scrollbar
The scrollbar now visibly stops at the changelog bounds.
H0008790
110577 General UI Changelog - Performance Issues When Loading Large Amounts of Records
The rendering of the changelog change groups has been improved.
H0008790
110815 General UI "Save As" Profiles Not Creating New Resource Action Customisations
Cloning a profile and updating its restriction level will no longer update the original profile's resource action customisations restriction levels.
H0007887
107002 Work Management Designer - Default does not "select" on Work Order screen
Added a fix to allow defaults on edit screen to persist. When opening the edit the default values were saved as part of the initial values and excluded when submitting the save.
H0007351
108223 Work Management Work Order Task Feedback - Auto Tick Completed
It is now impossible to complete a work order task without specifying a Completed On value. Also, specifying a Completed On value without completing the task will result in an error.
H0008192
108334 Work Management Asset lookup inconsistent when creating a WO
This issue was resolved as part of a related profile validations and migrations bug.
H0008270
108548 Work Management Cannot Set Work Order Status
In this adjustment the user will now be able to set the status and edit multiple times without an error occurring.
H0008346
108581 Work Management Work Order Overview Button Bug
There was a bug in the process that did the toggling between the two views.
H0008375
108724 Work Management Work Order Feedback Tool Properties Panel Bug
There was a issue when removing a column from a group without any perspective defined on it.
H0008258
110123 Work Management Work Order Edit - Meter - In-line editing not working
Work order meter inline editing now works as expected.
H0009101
110243 Work Management Work Order Task Resource Usage - New Mandatory Financial Year Period Required for Creation
A proposed workaround (for the interim) is to create a financial year period and assign it to the site. When the user creates a work order task resource usage, the Financial Year Period will be auto populated by work order site financial year period. AND/OR when the user creates a work order task resource usage, the Financial Year Period lookup will display the newly created financial year period. 
H0009081
110535 Work Management Unable to Match Update pre-V10 Work Order Task Resources due to Unit Of Measurement
The match update functionality now works as expected on Work Order Task Resources that were created before V10.0.
H0009195
110670 Work Management WorkOrderMeter API Returns All Values As String
Decimal and float values are now returned as correct number types over the API.
H0009279
110726 Work Management Asset Code type in - not loading
The Asset value lookup issue has been resolved.
B74337
110797 Work Management APIs Return Values as Strings
This issue has been resolved as part of a related bug - Bug 110670: Work order meter API returns all values as string.
H0009368

Known Issues

ID Area Title Description Reference
106710 Asset Operation Management Duplicate Asset(Type)FMECA is possible and should not be
Currently it is possible to create duplicate Asset(Type) FMECA. During the conversion from On Key 5 to On Key Plus, a FMECA was created for each task linked to it thus resulting in the duplication of FMECAs. These FMECA's will be converted with an additional flag called 'Is Legacy' and it will be set to true. Duplicates from On Key 5 will be allowed but not for any new ones created in On Key Plus. Any new ones will be create with Is Legacy = false. 

The FMECA does not have a code or a description - a combination of various fields makes the FMECA unique. With the next release of On Key Plus, a unique constraint will be added to these fields for records where Is Legacy = false. Clients should take note to fix the legacy FMECA's by grouping the tasks under one unique FMECA. We will be deprecating the 'Is Legacy' flag in a future release which will prevent the client from migrating to newer OK+ version if the legacy data has not been fixed.
H0007309

How do I's

ID Area Title Description Reference
110149 Asset and Maintenance Plan Configuration TPMS Online - Update Permission code fails.
There is a setting in the Admin Console where  large messages can be split up in order to process them more effectively. This setting was applied and therefore the client's issue could be resolved.
H0008832
102376 General Configuration Fields not showing in notification email
The cross reference to the Work Order Code in the Notification Template should be {# IdWorkOrderAlarmCode #} and not {#Id.WorkOrderAlarmCode #}. 
A new On Key Help topic has been created to guide users in setting up notification templates: General Configuration > Notifications > Notification Templates > Notification Template Examples.
H0005636
107929 Work Management Work Order Task Meter Reading Value Not Editable for ONREQ Task
Asset Task functionality of capturing a non-usage based meter readings on a Work Order Task will address this request.
H0007823