ReferenceKey Module (#20525)

This release note describes functionality introduced in CyberStore 2023.2.

Overview

The ReferenceKey Module standardizes how CyberStore formats external keys from integrated systems such as SYSPRO. It applies to values including customer numbers, sales-order numbers, and invoice numbers.

What changed

The module centralizes external-key formatting in CyberStore business logic.

• Formatting definitions are obtained from the external system, including SYSPRO configuration, when the CyberStore application starts.
• The ReferenceKey class formats and naturalizes key values for use across the application.
• Keys can be presented in the form required by reports, exports, integrations, and other business processes without changing their underlying stored value.
• Formatting rules are synchronized from SYSPRO so that CyberStore remains aligned with the external system.

For example, a numeric key stored in SYSPRO with leading zeros can be displayed in a different business-facing format while preserving the original database value.

Who benefits

This change benefits teams that work with CyberStore data across integrated systems by providing:

• More consistent presentation and processing of external keys.
• Less duplicated formatting logic in business processes and integrations.
• Better alignment between CyberStore and SYSPRO formatting rules.
• Lower risk of misinterpreting a formatted value as a changed stored value.

Scope

The ReferenceKey Module operates within CyberStore business logic and does not provide a direct user interface.