2025.15.0 (2025-06-23)

New Features

Area Title Description Reference
Common Functionality Bulk Import Capability within On Key Plus

The Bulk Import feature in On Key Plus is designed to provide a streamlined and user-friendly method for all end users (non-specialist users) to import data into the system. By leveraging the robust capabilities of the existing import API, this feature abstracts the complexity with the use of import schemas and an easy-to-use file upload process. It enables users to upload, process and manage large datasets efficiently, ensuring a smooth and accessible experience for all users, regardless of technical expertise.

 OKPMGNE-99
General Configuration Enable UDF's on slaServiceLevelMeasures and slaServiceLevelMeasureTriggers

UDF's have been added to the following tables:

  1. Service Level Agreement Measure

  2. Service Level Agreement Measure Trigger

 OKPMGNC-121
Helpfile Link OKP YouTube videos to OKP help file

The "On Key How To" YouTube videos are now linked to the relevant entities in On Key Plus. The videos are available from the Help panel. These entities include Operational Roles, Operational Role Profiles, Localisation Key Translations, Events, Monitoring Points, Work Orders, Options, Rules, Change Data Triggers, Change Data Trigger Criteria, Notification Templates, Conditions, Regular Asset Tasks, Due Tasks and Proposed Work Orders.

 OKPMHPTS-39
Helpfile Add Assist custom action section to all CRUD screens

A list of the available Assist custom actions with a description of each action has been added to the On Key Help page of each entity screen.

 OKPMHPTS-40
Helpfile Request Types missing from Helpfile

General Configuration > Request Types

The General Configuration item "Request Types" is now available in the On Key Help.

 OKPMHPTS-44
Helpfile Add status legend to Requisitions help panel

Material Management > Requisitions > Requisitions > View Requisition Base Status Legend

A status legend is now available in the Requisitions help panel. The following requisition status icons and descriptions are included: Awaiting Approval, Awaiting Approval Workflow, Approved, Completed, Cancelled and Closed.

 OKPMHPTS-47
Helpfile Missing help content: Change asset type on regular asset

Asset and Maintenance Plan Configuration > Assets > Regular Assets > Change Asset Type on Regular Asset

The steps for changing the asset type on a regular asset record is now available in the On Key Help.

 OKPMHPTS-49
Work Management Asset Warranty

The asset warranty functionality is designed to provide essential information during the creation of reactive work orders. The inclusion of warranty details directly within the work order process aids in decision-making, potentially reducing costs by utilising warranty services when applicable and appropriate.

The following key points summarise the purpose and utility of the asset warranty functionality:

  • Warranty notification: Whether the asset or component is currently under warranty at the time of creating a reactive work order.

  • Supplier information: Identification of the primary supplier responsible for the asset.

  • Warranty expiration: The specific date when the warranty on the asset or component expires.

  • Type of warranty: Details about the type of warranty (for example mechanical or electrical warranty) linked to the asset and/or component.

  • Multiplicity of warranties: Allows for the management of multiple warranties associated with a single asset (covering different aspects of the asset).

  • Warranty strictness: Differentiation between strict and non-strict warranties, which dictates the conditions under which the warranty is applicable.

 OKPMWMN-60

Modifications

Area Title Description Reference
Architecture Observability improvements

The observability enhancements to the admin portal in version 14 significantly improved the ability of On Key administrators to manage and maintain the health of multiple tenants efficiently. By providing easier navigation, more detailed health information, and direct access to error management tools, the system reduces the need for tenant-specific logins and streamlines the troubleshooting process.

Version 15 introduces new system alert functionality to improve observability and proactive issue resolution. This feature enhances the existing health indicators and monitoring tools by adding email notifications for critical system events. Key points:

Alert types:
• Background task alerts
• Domain event alerts
• Job alerts
• Message outbox alerts

Notification targets:
• On Key users
• Tenant support
• Tech support

Configuration options:
• User opt-in for system alerts
• Tenant support contact information
• Tech support email address (required)
• Alert spam prevention interval

 OKPMARCH-177
Architecture Expose GetFileTypes and GetFileTypeGroupings within the SYSTEM APIs

The file type group names and allowed file extensions are now visible within the system options window. This allows system administrators to view the configured file types for the tenant and also allows API users to query this data.

OKPMARCH-178
Asset Health Efficient monitoring point provisioning on an asset

This feature makes it easy and intuitive to add new monitoring points to a specific asset while in the context of the asset.

This functionality provides users with an efficient user interface on an asset to:

  1. See a list of all monitoring points required by tasks on that asset and its lower-level components - ie all the monitoring point types required by tasks or expressions related to tasks. There may be multiple monitoring points required of the same type. These are all listed with some context of which task/component they relate to.

  2. Provide the user with an easy selection method to link monitoring points of the correct type already available on the asset.

  3. Provide an easy way to create a new monitoring point if the right one is not available yet - one-click create assuming this asset as the parent of the monitoring point.

 OKPMAHM-38
Asset Operation Ability to clear Site on Meters

The purpose of this feature is to provide users with the ability to clear a Site value on a meter. Furthermore, we also introduced Site as a match updatable field.

OKPMIGAOM-45
Asset Operation Meter reset - Updating of readings on linked tasks

When a meter is reset it is important to have the linked asset tasks' last scheduled reading and last done reading update accordingly to ensure due tasks are predicted correctly, to in turn have accurate proposed work orders.

The following work has been done as part of this feature:

  • If a meter is manually reset, the difference between the reset value and the previous meter reading value is used in order to offset all Asset Task’s (linked to that meter) Last Scheduled- and Last Done reading.

  • Predicted Meter Readings are calculated for the affected meter.

  • New Due Tasks are run on the affected asset tasks

  • The Auto Reset functionality of Meters have temporarily been disabled. Users will no longer be able to have an Auto Reset Value on a Meter. Clients will have to clear all Auto Reset Value fields on Meters to be able to migrate.

  • A new Is Ready For Scheduling validation has been introduced for negative last scheduled- and last done readings (scheduling method dependent) Depending on how the task is scheduled, when an asset task's estimated next due reading is negative the task will become not ready for scheduling as the predicted meter readings only start from 0. The user will have to fix the task's invalid reading for scheduling to commence.

 OKPMIGAOM-46
Asset Types Options - Make Upper/Lower Bound Validation Optional

The Options functionality has been extended to include some outstanding validations.

Options:

  • Only allow upper and lower bounds for the following data types: DateTime, Float, Integer

  • Upper and lower bounds values are optional for the following data types: DateTime, Float, Integer

  • Upper bound values must be larger or equal to lower bound values

  • Bounds may be negative for the following data types: Float & Integer

  • Bounds input (UI) must be in line with Option Data Type

  • When changing the data type of an option, the system will now verify that the option is not being used by rule options

  • When changing the bounds, a warning will now appear if the option is being used by asset option values

Asset Option- and Placeholder Asset Component Values:

  • Upper and lower bounds are now enforced on Asset Option Values and Placeholder Asset Component Option Values

  • The system now validates that the value matches the data type

  • Value input (UI) must be in line with Option Data Type

 OKPMATY-134
Assets Tree search enhancements

The following tree search enhancements have been implemented:

  1. Additional toggles have been added:

    • Asset and Asset Type Tree search: toggle added for deleted confirmed records

    • Asset Tree search: toggle added for rule evaluation failed records.

  2. Improved tree search usability when locating tree items: When viewing search results in the tree, the system checks the visibility display options and if off, will be switched on to ensure that the record is successfully located and viewed in the tree.

  3. The ability to pin the search panel in order to keep the panel open when location the search results in the tree.

  4. Performance improvement: The task search results are limited to asset tasks and asset type tasks. Suppressed- and follow up tasks are excluded.

 OKPMAST-173
Assets Allow for IsInspection Task to be Follow Up Task on Automatic Monitoring Task

In the field there is a low-level inspection task (Pass/Fail, typically with no specialised equipment or expertise) done frequently. If this inspection fails a more in-depth inspection is required, perhaps by a different skilled person and/or with different equipment. These two different inspections could thus be on separate work orders.

The following functionality has been developed:

  1. Allow for a follow up task to be an inspection task (excluding Inspection Type = Automatic Monitoring. These are only used to initiate work, when a monitoring point reading triggers an expression that is linked to a task in the tree)

  2. The follow up inspection task cannot be on the same work order as the inspection task. This validation is necessary to be able to deal with work order tasks only going one level deep.

 OKPMAST-183
Assets Add components to Asset Work Orders View

Asset components are now visible in the Asset Work Orders tree view.

 OKPMAST-195
Common Functionality Prevent removal of required query builder fields

Required data source fields (for example Work Order Code) can no longer be removed using the query builder.

 OKPMGNE-157
Common Functionality Basic Expression Validation

Expression validation has been implemented on the On Key Plus editor. Users are not allowed to add field expressions for fields that are not in the grid. Syntax is now also validated.

 OKPMGNE-161
Document Management Default file attachment category based on entity type

This feature comprises the implementation of a system option that enables users to define a default file attachment category when adding attachments to entities. The purpose of this feature is to enhance user efficiency by eliminating the need for manual category selection with each attachment.

To further streamline the process, a default file category level enum has been added to automatically populate the file attachment category based on the specific file type uploaded by the user (if configured in system option).

Possible enum values are Global or Extension:

  • Global: File type not specified. File Type field = null

  • Extension: File type is specified. File Type field needs to be populated. May not be null.

 OKPMDOC-30
Document Management Add Notes field to File Attachment Categories entity (and others that don't have it)

The Notes field has added to entities that did not have a Notes field.

 OKPMDOC-33
General Configuration System Options - First Week of Year

This functionality is used to determine the week number of the first week (week 1) of a new year.

Options include:

  • Starts On Jan 1: A week is regarded to be the first week of the year if it includes January 1st

  • First 4 Day Week: A week is regarded to be the first week of the year if it includes at least 4 days of the new year

  • First Full Week: A week is regarded to be the first week of the year if it includes at least 7 days of the new year

 OKPSC-10
General Configuration Permission to rename User Defined Fields

A new global permission has been added for the User Defined Field entity: Rename User Defined Field Name. This permission governs the renaming of the user defined field name.

A validation has been implemented to check and prevent the updating or deletion of a user defined field record if it is being used in the system by expressions, profiles or permissions.

 OKPMGNC-96
General Configuration Changelog in System Options

The changelog feature in the system options dashboard is designed to enhance user experience by providing comprehensive visibility into the changes made within the system options dashboard. This feature is essential for system administrators and users who need to track modifications for audit, troubleshooting or operational purposes.

The changelog feature is conveniently accessible directly from the system options dashboard.

The system options changelog encompasses four distinct viewing options:

  1. System Options Entity Changelog

  2. System Options Detail Entities' Changelog

  3. System Options' Work Order Validation Changelog

  4. All Changes Made in System Options

Depending on where the user is focussed on in the System Options screen there will always be two options available:

  1. The changelog of the item the user is focussed on

  2. All System Options related changes made

 OKPMGNC-100
General Configuration OK5 Parity: Multi select to make active/in-active

On Key Plus (2024.12.0 RTM (Build 5288)) caters to a minimum number of entities, whereby a user can have multiple records be made either active or inactive.

This has been extended to more entities per parity with On Key 5. Time was not explored to go through every single entity in OKP to validate

 OKPMGNC-106
General Configuration Delete UDF validation required

The deleting of a user defined field record could have massive impacts where it is being.

This feature introduces a validation when deleting a UDF record to first validate if it is being used by a profile or an expression. It will return an error with the list of profiles and/or expressions using the UDF. The user will first have to remove the UDF from all relevant profiles and/or expressions before the UDF can be deleted.

 OKPMGNC-108
General Configuration Bulk Update Records: Active and Inactive

Currently +- 200 dashboard are without the set active/inactive custom action. Set Active and Set Inactive are available when on the edit screen, but not in the entities’ dashboard.

We now introduce Set Active and Set Inactive as custom actions on a dashboard. In order for users to have the ability to bulk update multiple records and make them inactive or active.

 OKPMGNC-110
General Configuration Add UDFs on Languages

This feature aims to implement the existing functionality of User Defined Fields (UDF) to a new entity, Languages. This enhancement will provide greater flexibility and customisation options for users working with this entity.

 OKPMGNC-117
General Configuration Add user defined fields to work order attributes and work request attributes

This feature aims to implement the existing functionality of User Defined Fields (UDF) to new entities, specifically Work Order Attributes and Work Request Attributes. This enhancement will provide greater flexibility and customisation options for users working with these entities.

 OKPMGNC-120
Generic User Interface View long text on the grid

Memo field handle implemented on the dashboard grids to provide ability to view and copy log text.

 OKPMUX-167
Generic User Interface Grid Grouping Label Improvements

Improvements to the grid group chip label to display the header label.

  • Old: statusDescription

  • New: Status Description

 OKPMUX-194
Generic User Interface Make QB Filter Criteria more prominent

The most used part of the Query Builder, the Filter Criteria tab has been moved to the front.

New Query Builder tab order: Filter Criteria, Fields, Parameters.

Meaningful empty states have also been implemented.

 OKPMUX-199
Helpfile Update Expression Entity list

On Key Tools > Expressions

The SLA and Approval workflow entities have been added to the expression entity list.

 OKPMHPTS-45
Helpfile Importing

On Key Tools > Export and Copy Data

All references to importing data via the Assist panel have been removed from the On Key Plus Help. This functionality is currently being redesigned as part of the bulk importing feature.

 OKPMHPTS-48
Helpfile Improve styling of Keep in Mind section in help topics

Help topics have a fresh new look. The "Keep in Mind" section in help topics has been highlighted.

 OKPMHPTS-50
Resource Management Match Update Resources Is Active field

We introduced Set Active and Set Inactive as custom action on the Resources dashboard. Users can now bulk update multiple records and make them inactive or active.

 OKPMRES-27
System Management System Options Save Button Feedback Enhancement

Implemented visual feedback on the Save button for the following System Options screens:

  • Meters Defaults

  • Requisitions Defaults

  • Work Order Defaults

  • Work Requests Defaults

Purpose: Indicate to the user that the save button has been clicked.

 OKPMSYM-24
Work Management Due Tasks Suppressors tab is empty

The Due Tasks preview screen has been enhanced. A new Suppression grouping has been introduced as well as two new fields Is Suppressed and Suppression Type. In addition, a new Suppression Type column has been added to the Due Tasks dashboard.

 OKPMWMN-166
Work Management Changing Work Performed after the WO is in Completed Status

Depending on a client’s business process, the work performed needs to be captured while the work order is in a specified base status. For some clients there is a need to edit the field later in the process, but other clients want to restrict the editing of this field.

A new field has been introduced in system options to govern in what base status the work performed is editable, “Work Performed is editable in base status”. Possible values are Approved and Approved and Completed.

 OKPMWMN-177
Work Management Add button to 'Add Multiple Resources' and 'Add Multiple Spares' to Tasks

This feature's improvements focus on expanding the capabilities of resource allocation and spare parts management.

Users can now add multiple staff members and special resources to Regular Asset Tasks and Regular Asset Type Tasks. This functionality is accessible through the entity's detail tab, under the Resources section.

The ability to add multiple stock items to Regular Asset Tasks and Regular Asset Type Tasks has also been implemented. This functionality is available in the entity's detail tab, under the Spares section.

 OKPMWMN-187
Work Management Proposed Work Order Task Dashboard

A new Proposed Work Order Task dashboard has been introduced.

This will assist users to be able to see the Task Asset Code here, and not only the work order asset. This is handy when roll-up points are being used to group tasks of different levels onto a work order.

 OKPMWMN-194
Work Management Work Order Status Change Date

A new date field is available on the Work Order Status Change API which the FEA app can make use of.

This is required as a short term work-around for the current issue where the FEA app and the SLA feature do not have the capability to capture when the user offline actually did the status change. The intent is to add a new date field to the Work Order Status Change API where the FEA app can store the Offline Status Changed On date when the status change was actually done.

OKPMWMN-213

Bug Fixes

ID Area Title Description Reference
115332 Asset and Maintenance Plan Configuration Conversion of Scenario's to Conditions
Asset Type- and Asset Task Condition Intervals & states are being converted correct now.
H0011129
121341 Asset and Maintenance Plan Configuration Changing Event permission tree field
To resolve this issue, the Permission Tree lookup was disabled on the edit CRUD.
H0012824
121645 Asset and Maintenance Plan Configuration Conversion error - MeasurementTypeQuantity to be set for DD When converting from On Key 5 to On Key Plus the "Days" unit of measurement is set as the standard unit for a day and as such the the measurement type and measurement type quantity must be set. The conversion now correctly sets these values even if the code for the unit of measurement in On Key 5 was "DD" rather than "dd".
122152 Asset and Maintenance Plan Configuration Alarm Types - 'Create': Incorrect Lookup screen Label (Default Work Order Status Field)
The title of the lookup screen has been corrected to read "Lookup Default Work Order Status".
123545 Asset and Maintenance Plan Configuration Regular Asset Differs Across Regular Asset Task and Suppressed Task
A task (for suppression) can now only be linked if it is beneath the same Regular Asset record. 
In addition, the following fixes were also implemented:
  • Broken preview lookup for suppressed task on Regular Asset Task Suppressed Task create screen resolved
  • Is Regular validation added for Regular Asset Task Suppressed Tasks
  • Type side validation for Regular Asset Type Task Suppressed Tasks changed to display errors using codes
H0013568
127135 Asset and Maintenance Plan Configuration Unable to Edit, Import or Rename Profiles in Placeholder Asset Type Component Edit Screen
This issue was fixed within the Release 15 timeframe.
H0014565
123411 Asset Health Managment Alarms not being created
When a monitoring point has no Alarm Type value configured for the Upper Warning Bound, but has an Alarm Type value configured for the Upper Critical Bound and a monitoring point reading is added which triggers both bounds, an alarm is now successfully triggered for the bound for which an Alarm Type value has been configured.
H0013522
129185 Asset Health Managment Mon Point Trigger Expression - When creating a new Expression, the Parent is not auto populated
Added back the defaulting of the Mon Point Trigger Id in order for the silent lookup to function accordingly.
126691 Financial Management OKP Imports : Costing : Unable to Import ExpenseType
It is now possible to set an Expense Type when inserting Costing records. This can be done either by posting to Imports on the On Key API or by posting directly to Costing on the On Key API.
H0014450
129188 General Configuration Designer - Work Order Edit - removing all tabs except Overview and UDF, does not apply
a User will now be able to remove all the desired tabs and successfully apply the changes followed by saving a profile successfully
124281 General UI On Key Help File with Incorrect Hyperlink
The hyperlink to the On Key Query Language page has been updated to a relative link.
H0013797
121500 On Key Plus Helpfile - Asset Value - Depreciation statement
The intent behind this module is to accumulate all asset value data. The initial design was to start with a standard module to record basic asset value data and then add an advanced module to track asset valuation and depreciation at a later stage.
The helpfile incorrectly described the advanced module. This has been updated to read "The Asset Value module provides the functionality to configure and record basic asset value data for use on assets".
 H0012965
122687 On Key Plus OK5 ConvertMaterialMaster convert error
Created a script to set lead time values to null for all inventory records with negative lead time values.
H0013320
123450 On Key Plus AHM : Wyn Dashboard not remaining signed in
Please test by acquiring for a dedicated Dashboard User for each tenant and and logging in directly into the Report server, and generate the "long running Reports"
H0013482
123715 On Key Plus Default resource cost element on user gets removed once saved
The invalid defaulting on the Work Order Task Resource Cost Element field has been removed.
H0013498
123723 On Key Plus License generator Site limit
The warning limit on licence measures has been set to optional and not required.
H0013651
123811 On Key Plus Audience field clarity
The help definition of the Audience field has been expanded to specify that the field should contain email addresses if the Output Type value is set to Email.
B76860
123869 On Key Plus Script required for component path sequence field on asset components
Created a script to populate the specified UDF value for all asset components. This is scheduled to run on a daily interval.
H0013685
124076 On Key Plus Importing as "Private Profile" Outputs Permission Error
The Restriction Level set on the import dialog is now correctly applied.
H0013727
124305 On Key Plus R0018030- unable to download attachment
The file name of the file attachment contained an invalid character (a dash). Renaming the file to use the normal minus character ("-") resolved the issue. The files have been renamed and both can be downloaded now.
An additional header was added to the response resulting in successful file download.
B76991
124867 On Key Plus OK5 to Plus conversion does not link Contacts to Resources for Sites
The conversion from OK5 now correctly converts the Contact1 and Contact2 information on sites to site resources, along with their respective phone numbers and email addresses.
 H0013948
124868 On Key Plus OK5 to Plus conversion does not link Contact Details to Resources for Staff Members
The contact details on Staff Member records from On Key 5 are now converted to Resource (type Staff Member) records in On Key Plus.
H0013950
125615 On Key Plus v13 to v14 migration : could not create unique index
Four records were identified where the data points to the incorrect predecessor ID column. A SQL file was created to rectify the broken records.
H0014127
126096 On Key Plus Unable to remove Insights Identifier
Removed validation that prevented user from clearing Insights Identifier for a Tenant in the Admin Portal
H0014270
126721 On Key Plus Requisition number sequence continuation from On Key 5
Requisition conversion will now generate a code that uses the latest sequence available in cases where the requisition code prefix is null.
H0014433
126869 On Key Plus stock_item_document warehouse_item_document crosswired convert error
The stock documents conversion step was using thethe incorrect material master documents. Conversion was fixed to convert the correct OK5 warehouse item documents instead.
H0014511
127099 On Key Plus OKP Imports : Costing : WorkOrderAssetCode not auto populating
When costing is imported for a work order which has an asset, the Costing->WorkOrderAsset field is automatically defaulted. Also, if an Asset is not specified and the Work Order is specified and the Work Order has an Asset, then the Costing->Asset field is now automatically set according to the asset on the work order.
H0014551
127672 On Key Plus stock_item_document warehouse_item_document crosswired convert error
The stock documents conversion step was using thethe incorrect material master documents. Conversion was fixed to convert the correct OK5 warehouse item documents instead.
H0014511
127731 On Key Plus FASA : Launching default reports
The feature was used in a way that pointed out a design improvement that can be made in order to improve the performance of the feature.
H0014695
129123 On Key Plus Placeholder problem
As part of the unlinking of Placeholder Asset Components the documents were not being processed. This caused a duplicate error when linking again. This has now been resolved by also removing the documents.
B78074
129400 On Key Plus Import - Change DataTrigger Notification Event
Fixed a metadata issue that resulted in the wrong Query metadata endpoint being used.
B78147
129568 On Key Plus Feedback Profiles do not save
There was a issue with the loading of the profiles when editing the sequences. It cleared the profile sidebar and the user could not save a profile.
H0015004
129882 On Key Plus OK+ applied licenses not reflecting after maintenance
Removed the validation of the License Renewal Warning date against today's date when a Tenant starts up.
H0015071
89245 User Access Management Profiles - When Grouped, Headers Lose Their Unique Name
When renaming a column header via the Properties Panel and then grouping the dashboard by this uniquely named column, the unique column name now correctly displays and not the original column name.
TPMSP-1975
121375 Work Management Bulk status update hangs without any indication of what is happening
A loading animation was added to the Accept button to make it visible to the user that the process is still running and awaiting a response from the server.
H0012886
121376 Work Management Completed on timestamp for tasks populating differently based on method of completion
If a work order has a value for Completed On and the work order task(s) on that work order is completed, the Completed On value of the work order is used as the Completed On value for the work order task(s). If the Completed On value on the work order is not specified, the current date and time is used as the Completed On value for the work order task.
H0012925
121609 Work Management Visual Dashboard not Pulling Data
Users are now prevented from adding presets belonging to fields that are not available in the data source grid. A notification has been implemented to give the user visual feedback.
H0012880
122159 Work Management Adding Multiple Stock Items via WO Dashboard's Overview Screen
It is now possible to add multiple stock items when on the Work Order Dashboard Overview screen as expected.
H0013180
124234 Work Management Splitting Tasks from Work Order Error - Cannot Split R Work Orders Which I did not create
The validation that the Requester- and CreatedByUser FullName values need to match in order to action a work order split or for a work request to be converted to a work order has been removed.
H0013757
124578 Work Management Record modified by another user when using quick status change icon after other updates
Users are now able to successfully match update work order status values using the quick status change function after performing Assist custom actions.
 H0013832
125711 Work Management Work Order Dashboard "Filter" Fails When Adding Specific Fields
The filter functionality now works as expected when adding cross reference information from linked database tables into the current table view.
 H0014165

How do I's

ID Area Title Description Reference
126190 On Key Plus API Error - Multiple user error
The client found a workaround for the issue
H0014332