How to Switch Quotes, Rebates and Agreements & Promotions to React
Introduction
The react version of Quotes, Rebates and Agreements & Promotions detail brings improved user interface with new features and the most recent and improved shared components. It’s also utilizing a new backend API which comes with an upswing in performance when working with larger documents with many line items.
With that in mind, this comes with some changes and limitations.
CRM Integrations
Additional implementation steps are needed before switching to React in case customers access the application through a CRM integration.
The Pricefx application uses Interceptors as a communication layer between the application and the CRM system. These need to be updated by engineering prior to making the switch.
Customers interested in making the switch should contact their Custom Success Manager to get the process started with the engineering team.
Known Gaps and Changes
Changes
No Save button, by default React documents are auto-saved.
Create options in System Configuration (Do nothing, Save and Calculate Immediately, Calculate Immediately) are not applicable to React Detail pages. By default, every document is saved immediately.
There is no selection of views (Tree View, Table View, Simple Table View). In 9.2 and 9.3 we introduced ways to alter the layout for cases where the default view was not ideal.
There is also the concept of performing actions asynchronously once actions are associated with a long waiting time.
The asynchronous actions are performed based on the number of line items and are set on the configuration page (100 by default).
Need to reload using the “Load Default” in Message templates.
It’s not necessary to load default email template if URLs are changed manually. It could be possible to create a migration script. New URLs can be used for both Ember and React.
Old style of message links:
href="$baseURL$/app/#/quotes/detail/$entity.uniqueName$/messages/$msgEntity.typedId$"
New style of message links:
href="$baseURL$/app/modules/#/qc/go-to-quotes/$entity.uniqueName$/messages/$msgEntity.typedId$"
Full list of highlighted changes and improvements is available at https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/4611605243.
Gaps
Partial Deals (closed in 9.4.2)
Preferences for Result Matrix are available even if they are disabled in the logic.
Feature flags (see the section below)
Feature Flags (In progress)
Certain Feature Flags are specific to Ember and no longer applicable in React. The below page (Pricefx internal) provides information on the current implementation status and what is in scope for the new version for Quotes, Rebates and Agreements & Promotions.
https://pricefx.atlassian.net/wiki/spaces/product/pages/3922789536
How to Enable React?
Trough the Feature Flags page only partition-wide setting is enabled.
Partition-wide setting is enabled on the Administration > Feature Flags page.
Search for UseReactFor and enable quoteDetail (8.0), rebateAgreementDetail (8.0) or contractDetail (9.0).
To apply changes in other partitions, you can follow one of the two possible methods:
Go to Administration > Configuration > System Configuration > Advanced Configuration Options page and manually edit JSON configuration files.
Feature flags values can also be changed in PlatformManager (since version 1.45). When using PlatformManager, you can check and modify feature flags for multiple partitions in one go.
Found an issue in documentation? Write to us.