React Starter Back Background/Overview

• Please see:  DX Starter Packs 

Version Naming changes

One of the changes with the latest Community posts of the React Starter Pack is to go to new version naming syntax.  React starter pack versions will now contain the “SP-R” prefix (for “Starter Pack-React") followed by a Pega Minor release reference followed by a specific incrementing version #.  Hence, the first post with the new syntax was version SP-R.87.1. 

This syntax allows understanding what the most recent minor Pega release that the Starter Pack officially supports along with a continuously increasing starter pack specific version number. 

The “87” signifies that the the Starter Pack supports Infinity releases from 8.3.x to 8.7.x. 

Newer Infinity capabilities and Starter Packs 

Starter Packs are written to leverage newer capability when it is available, but also to gracefully fall back to some reasonable behavior when encountering an Infinity server which may not have this capability.  Sometimes this is done automatically in the code and other times, a specific setting within endpoints.js or a visible application setting was added to allow configuration of whether to attempt to exercise some specific capability or not. 

For example, support for “Screen Flow” (Multi-step forms) requires the addition of some API updates that are only available with 8.5.x servers.  It also requires the invocation of a newer v2 DX API endpoint.  That also means that the authentication for the “api” (v2 DX API) and “application” (v2 DX API) are consistent.  For this reason, a “use_V2apis” endpoints setting governs whether the code should assume the server is capable of supporting DX API-based “Screen Flow”. 

Useful Markdown files within docs folder 

The Starter Pack application includes a docs folder and two key files that developers will find very useful: 

KeyReleaseUpdates.md 

Implementation Notes.md 

Here are excerpts from the KeyReleaseUpdates.md for the SP-R.87.1 release: 

Key Updates Since release 1.5 

• Dropdowns can now be quickly filtered to see entries that begin with entered chars 

• Hide grid's Add Row/Delete Row buttons if rowEditing is set to readOnly 

• Handle number decimal places value auto (-999) scenario 

• Selected dropdown values may now be cleared 

• POST_VALUE action type support added back 

• Added support for Cancel action set and optionally showing close button in the confirm page 

• Replaced usage of large oidc-client external library with own OAuth implementation (within PegaAuth.js) 

• Separated single Use Page Instructions setting into two to allow disabling usage for Embedded Pages while enabling for Page Groups and Page Lists. Page instructions for Embedded Pages can now be disabled when v1MergeStrategy DSS setting is utilized. 

• Examine server related field value changes as part of a refresh and generate corresponding Page Instructions if appropriate 

• New setting to display all workgroup workbaskets (in addition to the main user worklist and any workbaskets explicitly associated within the current operator record) 

• Honor specified display range (Next X Years, Previous Y Years) settings for pxDateTime fields (requires recent 8.7 DX API update) 

• Fixed issue with inability to open cases which immediately creates a child case and first visible step is an assignment within the child case 

• Upgraded react-scripts to 5.0.0 

• pr-field-* classnames are now available for all root elements which implement a specific field/control so they may be better styled via CSS 

• Fixed various issues with adding and deleting grid rows 

• Updated Page Instructions generation to fix issue with updating Pages within a Page List or Page Group