2023.9.0 (2023-08-15)

New Features

Area	Title	Description	Reference
Architecture	Background Task Fair Usage Policy	The background task fair usage policy aims to ensure that the different On Key Plus tenants each get an opportunity to have their work queued as background tasks being executed. Priorities are assigned to background tasks based on predetermined rules and server capacity is balanced based on these priorities. Instead of executing background tasks in a FIFO order, the following aspects are considered during the allocation of work across tenants and different users for the same tenant: tenant - each tenant gets an opportunity task priority - more important work is prioritised user - each user gets an opportunity created on - the creation date is considered origin - job or user request. For example if user A executes a synchronisation operation that results in 3 000 assets being synchronised (ie 3 000 background task steps are created) and other users also execute background task work at the same time, they should get a time slice for some of their work to be completed whilst user A's synchronisation operation completes.	OKPMARCH-97
Generic User Interface	AssetWorkOrder Screen Prototype	A new dedicated asset work order screen has been added which should assist contact centre users. The screen consists of three sections: an asset tree, a work order dashboard and a work order overview screen. All the windows are interactable and are updated as the user scrolls down the tree.	OKPMUX-140

Modifications

Area	Title	Description	Reference
Architecture	Tech debt - Client UI security and performance	Various security and performance enhancements have been added to the UI layer of the product.	OKPMARCH-139
Architecture	PostgreSQL 15 Upgrade	PostgreSQL 15 upgrade completed successfully.	OKPMARCH-140
Asset Health	Create WO from Mon Point Trigger - with Asset resolved	Standalone monitoring point trigger expressions can now automatically raise work orders from alarms. A new Asset field has been added to the expression screen, which will be used to create the work order. Previously this was a manual action, which now, has been automated.	OKPMAHM-30
Assets	Extend IsInitialise logic on Regular Asset Tasks	The IsInitialised logic has been extended to detect if the monitoring points on an inspection task have been set up correctly. If not, an IsInitialised reason is returned to notify the user that the task is not properly initialised and therefore will not be part of scheduling.	OKPMAST-146
Assets	Uninitalised Tasks due to Cost Element not a mandatory field	When new regular asset tasks containing stock items are synchronised, the system will try and provision the stock item's cost element, based on the site or material master information. This will greatly assist the process where users had to manually set this value in order for the task to be initialised.	OKPTPIMP-2
Generic User Interface	Asset Tree & Type Tree Search Enhancements	The Asset and Asset Type Tree search within On Key Plus is more powerful and searches across more entities than in On Key 5. This was introduced on the first release of On Key Plus. Many usability enhancements were gathered from clients using this feature and were incorporated as part of this design.	OKPIEP-118
Generic User Interface	Inline Editing of User Defined Fields - including lookup	Inline editing functionality has been extended to user defined fields. This enables the user to edit records on cell-level, directly in the grid. The functionality is also available on user defined fields that are lookup fields.	OKPMUX-136
Generic User Interface	Use browser field value suggestion as a Lookup Value	In previous versions of On Key Plus, the browser would suggest previously entered values when typing in values within a lookup field. The user could then select one of these and press tab - which would then resolve the lookup. This feature has been reintroduced.	OKPMUX-141
Helpfile	Precision of financial numerical values clarified	Added the following sub-section on the Financial Management landing page: Processing of financial numerical values: Financial numerical values are not explicitly pre-rounded before processing. Processing and aggregation is done with maximum precision of original numbers. Only once a number is written back to the display field is it rounded to the number of decimal places determined by the display requirements of the field.	OKPMHPTS-25
Maintenance Plan Development	Match Update Missing on Entities - Resources	The match update custom action has been added to the following dashboards: 1) Recursive browse screen Asset Type Tree > Tasks > Task Resources 2) Regular Asset Type Task Resource Dashboard More field have been added to the match update customs action on the following dashboards: 1) Recursive browse screen Asset Tree > Tasks > Task Resources 2) Regular Asset Task Resource Dashboard	OKPTPIMP-32
Material Management	UDF on warehouses	User defined fields can now be configured so that it can be used on the Warehouse entity.	OKPMMTM-56
Material Management	Add costing tab to requisition item transactions edit screen	A new Costing tab has been added to the Requisition Item Transaction screen.	OKPMMTM-61
User Access Management	Create Site has long delay	When a user now creates a new Site, it will be available immediately for use. Previously the user had to wait for a recalculation jobs to finalise before all the permissions were available in order to use the new Site. This will greatly increase the efficiency when creating Site hierarchies.	OKPMUAM-41
Work Management	CompleteAll result screen improvements	The user journey on the Complete All Action on Work Orders, have been improved. The user will not loose context of where he/she are when this action is done.	OKPMWMN-126

Bug Fixes

ID	Area	Title	Description	Reference
97547	Asset and Maintenance Plan Configuration	Regular assets with Parent asset UNKNOWN that needs to be changed	Remapped assets with parent 'UNKNOWN' to be 'ROOT' instead.	H0003217
99179	Asset and Maintenance Plan Configuration	Placeholder Asset Type Component Rule Development Status Changes	It is now possible to change the development status of the rules on placeholder asset type components.	TPMSP-2495
105972	Asset and Maintenance Plan Configuration	Standard Tasks - Task Duration Errors when Auto Calculate = True	On a standard task (with all the auto calculate options set as TRUE), the auto calculate options can now be unticked and the record saved successfully.	H0006792
106225	Asset and Maintenance Plan Configuration	Placeholder Asset Component Link does not pull through to the Edit screen	When there are placeholder asset components in the asset tree that are linked, the relevant information now correctly displays on the edit screen. The Placeholder For Asset Type and Linked to Asset Type fields on the edit placeholder asset component screens are now set. The Set a Placeholder and Set Linked Asset Type actions are no longer available in the Assist panel for this scenario.	H0006879
106231	Asset and Maintenance Plan Configuration	Standard Task - Component Look-up bug when linking standard task to Asset Type or Asset	Fixed the filter by asset type on the asset type component lookup if the asset type has a value. The asset type component textbox is now cleared when the asset type changes.	H0006793
106551	Asset and Maintenance Plan Configuration	Rule does not roll-up to the Asset Type	To reduce the likelihood of any contention in the side effect that maintains the asset type rules, it now responds in a batch manner at a higher level. A job has also been created that will periodically make sure there are no items out of alignment.	H0007192
106996	Asset and Maintenance Plan Configuration	Sorting Properties Panel issues on the Asset and Asset Type Tree	When opening the display options, the existing values on the profile are now read correctly, resolving any issues with rendering field content.	H0007339
107401	Asset and Maintenance Plan Configuration	Profiles not responding correctly	Sorting information is now processed correctly when display options are loaded with an existing profile. Sorting details are no longer lost when clicking Apply on the properties panel.	H0007396
104642	Asset Operation Management	Meter Errors Returning Null	When a meter reading with a Reading On date earlier than the oldest reading is inserted, the resulting error message is now correctly formatted.	H0006366
105472	Asset Operation Management	Asset types not in numeric order (std Asset Type tree)	The sorting information is now processed correctly when display options are loaded with an existing profile.	H0006790
107711	Business Intelligence	Massmart Change Data Trigger Notification Attachment (Wynn Report) is not rendering on Email!!	As a work around we have selected a Report user on the Change Data Trigger Notification Event Attachment. We also fixed the issue where reports could not be attached to a notification if the Change Data Trigger Notification Event Attachment 'Run As Admin' is true.	H0007738
106214	General	Cannot search on column filter	A content focus issue which caused the android system keyboard to close has been resolved.	B73703
106552	General	Data copy from On Key dashbaords no longer works to Excel	The copied text data now displays correctly in Excel.	H0007254
106723	General	CreatedOnOn date and WorkOrderLocation extraction - PASA	A script was created to extract data from the On Key 5 and On Key Plus change log and then apply to CreatedOn and TempLocationId UDF.	B73795
107475	General	Designer: Tabs changes according to the Pager Properties Items	Resolved an issue on the Pager Properties when reloading a profile and interacting with the tabs and associated Pager Properties panel.	H0007824
102335	General UI	Conditional validation not executing as expected	A validation error now correctly displays when creating a new requisition item and inserting a Description value with more characters than the maximum character amount specified in the validation added via the designer.	H0005516
106661	General UI	Unable to create or save profile with field to field filter criteria	It is now possible to use the field on the right-hand side of the visual expression.	H0007243
106960	General UI	Conditonal formatting on profiles	The applied formatting colours now display correctly on the grid properties panel once a profile is loaded.	H0007440
105877	Materials Management	Requisition related items display on assist even though requisitions are not being used	The missing conditional display property for requisition Assist actions has been rectified.	H0006717
106126	Materials Management	Displaying Code as number and not text field	The browser removes trailing zeroes by default, so the system interpreted the code as a number. The type is now explicitly being passed when applying the lookup value.	H0006919
106610	Materials Management	Requisitions pending to close due to Negative transaction Cost	It is now possible to close requisitions that have a negative overall transaction cost.	B73770
107036	Materials Management	Adding preferred material master code not working	Removed an unused Preferred Material Master property from the asset task spares dashboard.	H0007150
88357	Resource Management	Match Update Missing on Entities - Resources	Match update functionality is now available for Regular Asset Type Task Resources and Regular Asset Task Resources.	TPMSP-1883
105513	System Management	Various designer issues	A number of issues within the designer has been resolved. The User Defined Field tab option on the Tabs Properties panel no longer disappears when rearranging tabs and reselecting the tabs to make changes. The duplication of fields on the Select Fields dialog has been amended as well as sorting those fields into alphabetic order. The selection of tabs no longer causes two tabs to appear as active at once. The Header Properties panel now behaves as expected. And all translations are correctly being set on all the buttons within the Tabs Properties panel.	H0006828
105958	System Management	Custom Profiles via designer are not working correctly	There was an issue in the designer when removing tabs that uses a dropdown with options. The issue has been resolved and some robustness has been added to the UI to handle it better.	H0006887
95202	Work Management	Creating Work Order Tasks with Inactive Spares	It is now possible to add an asset task directly to a work order even when it has spares which are inactive.	TPMSP-2382
104377	Work Management	Sorting on date time fields are not sorting chronologically	Resolved the issue when a field has sorting applied, and then the field is removed off the dashboard. The corresponding sorting is now removed along with the field such that it does not interfere when subsequent sorting is applied to another column.	H0006183
105170	Work Management	Multiple Stock Items add	The user does not have access to view the permission tree ID field of the work order, therefore the process to add multiple stock items to the work order task failed. It was trying to send an invalid internal value to the API to finish the lookup linking. A generic fix has been implemented to lookup linking to prevent this invalid value to be sent to the server.	H0006558
105286	Work Management	Cannot modify task date	It is now possible to save a work order task with a Completed On date which is older than the Last Done date of the related asset task.	H0006600
105896	Work Management	Last done date updated on regular task with last scheduling method	When a work order is closed, the Last Done Date of the related asset tasks for the tasks on the work order is now only updated if the I date of the work order task is later than the Last Done Date of the associated asset task.	H0006709
106936	Work Management	OKP Work Order Tasks Column Properties	Work order task monitoring point fields have been removed from the default work order task dashboard and work arder tasks detail grid.	H0007422
107139	Work Management	Afrimat Dev kafak topic no working	WorkOrderTaskResourceDuration has been replaced with WorkOrderTaskResourceUsage.	H0007525

Known Issues

ID	Area	Title	Description	Reference
103455	Asset and Maintenance Plan Configuration	Development Status changes on children not rolling out to placeholder children	Changing development status on a detail asset type entity directly (eg on regular asset type spares) does not currently roll down to the corresponding detail entities of any placeholder asset types or placeholder asset type components. If the development status on a parent entity is changed and the option to include children is selected, then the development status of corresponding detail entities is updated. This will be fixed in a later release.
104280	Asset Operation Management	Meter Readings Error	Currently it is not possible to enter a new meter reading before the first meter reading. The first reading initialises the meter and sets the cumulative reading as well. In future releases we will relax these rules which would allow users to enter earlier readings than the first reading.	H0006081
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. 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. The duplicate FMECAs will then be collapsed into a single field and all the tasks will be grouped into that single FMECA. That way going forward, there will be no FMECAs.	H0007309
106379	Work Management	Proposed Work Orders - When setting Combine Resources On One Task checkbox to True work order generation fails	The work order generation from proposed work orders process will now select any default standard task configured in system options. If there are none, any task on the generated work order will be selected to combine the resources on. This issue will be fixed in the upcoming release.

How do I's

ID	Area	Title	Description	Reference
105893	Asset Health Managment	Unable to navigate to meter fuel types	Before On Key V6.0, Meter Fuel Type was a redundant entity, as the Asset Consumption feature that makes use of it did not exist yet. Any profiles that were created on Meter Fuel Type should be deleted and new profiles created on the new entity - Consumables.	H0006655
106414	Asset Operation Management	Functionality to delete Meter Readings with Asset Consumption	When costing is enabled in system options, asset consumption records have costs associated. Costs can never be deleted from anywhere in the system.  Potential solutions: 1) Disable costing in system options (but then no costing will be written anywhere in the system) 2) Update the current asset consumption instead of deleting it. It can be updated to the correct reading or be made 0. Some side effects will happen in the background to write the costs back or update it accordingly.	B73692
107471	Asset Operation Management	Monitoring Point: Cannot change bounds on Exsiting Monitoring Points	This is as designed and follows the same principles as in On Key 5. The monitoring point type and monitoring point bounds cannot be edited (if you opted out of them) after they have been saved. Already set values can be edited, but if you initially opted out (meaning they are null), then those fields are locked. The reason for this is twofold: 1) When these monitoring point types or monitoring points are added to asset type task follow-up tasks or asset task follow-up tasks, then they govern the 4 ticks that state which follow-up tasks should be enabled if the bounds are crossed. Once the bounds are locked on the type side, they are locked. Allowing changes to this would invalidate the asset register setup. 2) There are strict validations between monitoring point types and monitoring points with regards to these fields. Relaxing these would require considerable analysis to understand the impact.	H0007804
107304	General	Expressions in Helpfile	Expressions have been described in more detail in the On Key help. The syntax used to build expressions has been described. Practical examples of expressions have also been added for each application of expressions in On Key.	H0007637
105295	General Configuration	Change Data Trigger Criteria - Stock Item Minimum Level Not Evaluating	This is a "How Do I". The Filter Expression needs to be used as the server does not validate the properties according to the trigger properties.  To use the Old Value Expression/New Value Expression, the properties need to be specified on the Trigger Properties tab as the server needs to validate these properties changes. Both values would have to be updated else one of them won't have a new/old value, making the expression fail.	H0006718
107992	On Key Plus	Production- Follow Up tasks not visible in Asset Register for New Assets	The client had Inspection Tasks which were linked as Follow-Up Tasks. They had to undo this and after that the Follow-Up Tasks synced.	H0008021
106408	User Access Management	Unable to use complete all tasks when user operational role rule is strict	This is as designed. As a Strict user you can only view records that have profiles assigned to them. If your operational role does not have a User View or Edit profile assigned, you will not be able to view a user. The help content definition of the operational role rules has been updated to include: Strict - the user will only be able to see profiles linked to their operational role, therefore they can only view records that have these profiles assigned to them. Even if this user is set up as an administrator (Is Administrator selected), the user cannot create profiles and will not have access to system profiles, other operational role profiles, public profiles (that are not linked to the user's operational roles) or other users' personal profiles. They are not allowed to change the defaults that are assigned to them.	H0006979
104698	Work Management	Unable to utilise functions in query builder with Event Date field	The field being referenced (EventDate) is a date type field. Functions like utcnow only work on DateTime fields eg, completedOn. The uctnow function can therefore not be used for the EventDate field. Please log an idea in AHA if you need the EventDate to be a DateTime field.	H0006405