Prime Radiant Online
Welcome to our Normalized Systems online documentation, located in the “Prime Radiant @ Star’s End”. This is where you will find all the information needed to use Normalized Systems.
Latest stable release: 2020.1.0
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:
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.
- web.xml (updated package for StrutsPrepareAndExecuteFilter)
- struts xml files (updated dtd reference)
- AccessInfoRetrieverAction (ActionContext::getParameters() has a different return type)
- TranslateTextAction (Uses StrutsLocalizedTextProvider instead of LocalizedTextUtil)
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:
The /primeRadiant/elements/applicationInstance/all is still available for this version, should any problems arise.
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.
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.
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
_docsdirectory (and preferably link to it from another page).
- The root articles for a directory are named
- Absolute links need to be prefixed with ``
- Links should point to the url, not the