Prime Radiant Online

Upgrade to Struts 2.5

Expanders 4.2.0+ will use Struts 2.5. Also required for this are baseComponents 2020.2.0+ and nsx-runtime 2020.2.0+ (provided by prime-data 2020.2.0+).

The reason for the upgrade is security, as previous versions of struts contain critical vulnerabilities:

https://nvd.nist.gov/vuln/detail/CVE-2018-1327

Note that since Struts 2.5 in not backwards compatible with struts 2.3.x, this upgrade might break custom code. In that case, consult the page below.

Artifacts changed

Expanders:

• web.xml (updated package for StrutsPrepareAndExecuteFilter)
• struts xml files (updated dtd reference)

baseComponents:

• AccessInfoRetrieverAction (ActionContext::getParameters() has a different return type)

nsx-runtime

• TranslateTextAction (Uses StrutsLocalizedTextProvider instead of LocalizedTextUtil)

Some Links:

https://cwiki.apache.org/confluence/display/WW/Struts+2.3+to+2.5+migration

Using Expansion-resources in PR

Expansion-resources (or expander bundles) are jars with additional expanders, features or other data the expanders can use to generate additional files or add additional code to existing artifacts.

These expansion resources often encapsulate a new concern, e.g. the rest-expanders generate classes which will expose a REST interface based on JaxRS.

New Expansion Control dashboard

In version 2020.2.0 of the Prime Radiant, it will be possible to add expansion-resources to an applicationInstance and to then use them during expansion.

The applicationInstance page has been replaced with the (very similar) expansion/control page. The links throughout the application have been updated:

However, you might still notice the different url being used /primeRadiant/expansionControl/expansion/control instead of /primeRadiant/elements/applicationInstance/all.

The /primeRadiant/elements/applicationInstance/all is still available for this version, should any problems arise.

Expansion Resources

On the expansion control page, you will find an Expansion Resources tab. In this tab, there is a list of all expansion-resources and an input field to add new expansion resource:

If the expansion resource does not exist yet, the PR will ask whether you wish to add it to the database. If confirmed, the expansion-resource will be added and stored to use in the future.

note: for this to work, you also need to press the update prime radiant button on /primeRadiant/elements/primeBase/all. This will add a new workflow that syncs the applicationInstance with the expansion setting.

Expanders Docs moved to exchange.stars-end.net

The auto-generated documentation on the Expanders and various other expander bundles, has been moved to exchange.stars-end.net.

The exchange site is, similar to this documentation, based on Jekyll and can be found in its own repository (normalizedsystems/exchange-docs).

The goal is to make a dedicated page to share expander bundles and hopefully provide some useful documentation. At the moment, the automatically generated documentation can seem a bit rough. We will continue to update the report-expanders to improve the insight into the expander bundles and allow for better integration with existing documentation.

Update to Jekyll

The documentation has been updated to use Jekyll as documentation engine.

There were several reasons to change:

• Gitbook was no longer being developed
• The build was starting to get slow because the gitbook build does not scale well
• Each new article needed to be added manually to the SUMMARY file, which also introduces issues with scalability.

Jekyll is based on Ruby. So if you wish to build it locally you will have to install Ruby (follow instructions on Jekyll website).

We are using a variant on the Docsy Theme.

There are a few differences with Gitbook:

• There is no SUMMARY file that needs to be kept in sync. Just drop your article in the _docs directory (and preferably link to it from another page).
• The root articles for a directory are named index.md instead of README.md.
• Absolute links need to be prefixed with ``
• Links should point to the url, not the .md file