Prime Radiant Release 2021.1.0

Downloads

Contents

Postgres-based

IMPORTANT: This release supports only Postgres database.

If you are looking for HSQLDB version, please use a previous release, or wait for a future one.

This release is targeting only Postgres database; using Postgres is also the recommended approach going forward. Note that we will be providing HSQLDB alongside Postgres for future releases for simplified setups.

Fresh Database

Due to the change of a database, it is not possible to preserve existing data. However there should be no problem in importing your applications again. If you need to migrate some specific data, please let us know.

NOTE: Extra database configuration.

Depending on your setup, you will need to adjust your database settings as described in the installation guide.

For both upgrading and fresh installations, make sure the read the local configuration section of the Installation guide.

Linux And Mac Support

We have introduced full support for both Linux and Mac.

The download is the same, however be sure to follow the platform-specific instructions in the Installation guide.

Rejuvenate Action

Tired of clicking all the buttons all the time? We have combined all of them into a single Rejuvante action.

Rejuvenate runs in order: Harvest, Export, Expand, and Build. If any of the actions fail, the process will terminate at that point, so you can investigate. For a clean-run, you can choose Clean Rejuvante from the button’s menu.

Application and Component Views

Application and Component views now always show their full name, as well as their ID.

The search box applies to both the short name and full name.

Component Diagrams

On an application page, you can now see a diagram of all components in an application.

Two variants are currently available.

D3-based

Includes some interactivity, such as zooming or dragging nodes.

PlantUML-based

NOTE: For Mac and Linux users, make sure you have GraphViz installed.

Expansion Resource Importing

Ever wanted to add a new REST expanders option, but it was not yet available in Prime Radiant, or the documentation was missing? Now you can import expansion resources directly.

You can add a new expansion resource to your expansion settings as you are used to, or you can do so on ExpansionResource page (via menu Analysis > ExpansionResource).

On the same page you can select an ExpansionResource you are interested in and click import. If the resource contains any options (or other data resources such as technologies), they will be imported, including their documentation where available.

Once imported, you can also see all the individual expanders in the resource, as well as features and their (markdown) documentation, and more.

ExpansionResource Feature

Expansion Trace

Expansion trace is structured representation of the entire expansion. This includes the actual content of the expanded files, their location and location of their harvests, model element and expander responsible for the file, segments contributed from features, external files, and much more.

You can now easily generate an expansion trace for you application, and then import it into Prime Radiant.

Expansion Overview

Expansion

Expansion Artifact Details

Artifact Details

Custom Insertion (Custom Harvest) Details

Custom Insertion


Generating and Importing ExpansionTrace

If you are using expanders 4.14 or higher, you can now generate expansion traces and import them to Prime Radiant.

  1. Add the following options to your expansionSettings
     <expansionOptions>
       <expansionOption>
         <expansionOptionType name="expansion.trace.enable"/>
       </expansionOption>
       <expansionOption>
         <expansionOptionType name="expansion.trace.exportToZip"/>
         <value>expansionTrace.zip</value>
       </expansionOption>
     </expansionOptions>
    
  2. Expand as usual
  3. Navigate to Analysis > ExpansionTraceUpload
  4. Import your freshly generated <wherever-your-application-was-expanded>/expansionTrace.zip
  5. Select the newly created entry and click Import

NOTE: Expansion Trace import can take quite a while, as it tends to be quite large, and also needs to resolve and import all used expansion resources.

Once everything is done, navigate to Analysis > Expansion and select your expansion.

For more info on expansion trace and its usage, see ExpansionControl::Expansion.

Live Editor

To help assist with consuming and playing with data in Prime Radiant, we have introduced an interactive editor. The editor lives in the frontend and uses TypeScript (you can use plain JavaScript as well).

You can access the editor via menu ProgramLibrary > Editor.

To use the editor, you must define a main function and press Ctrl+Enter to execute.

async function main() {
    return 12
}

Any value returned from the main function is converted to JSON and displayed in an output window on the right. The last executed script is also cached in the browser, so if you refresh the page, the code should still be present.

Example retrieving a list of DataElements and their Fields in the demoBooking Component.

Editor Json

To query data from Prime Radiant, you can use regular struts endpoints. We will be expanding the capabilities of this editor over the upcoming releases.

For more info, examples, and current capabilities, see Editor.

Live Diagrams

To generate PlantUML diagrams, PR offers an REST endpoint. This endpoint is currently used by the component diagrams, but you can use it in the Editor too.

Editor and PlantUML

See Editor for more.


If you encounter any issues, please open a new Jira ticket and select the prime-radiant component.