ActiveUI502-Training

Prerequisites

Accounts and licensing

• You need an ActivePivot licence to be able to run the ActivePivot sandbox from your local computer
• You need access to Artifactory to be able to download the activeUI 5.0.2 sdk

software versions

• NodeJS version 14.16.0 or greater
• Yarn version 1.22.4 or greater

General Programming knowledge

• Javascript programming, including functional programming syntax
• Typescript basics are advised
• React, including the functional programming syntax and the following concepts
  • state/props
  • hooks
  • Provider / Consumer
  • HOC (Higher order component)

ActivePivot Sandbox

Download

ActiveUI 5 is compatible with all version of active pivot starting 5.8. Make sure your instance is up to date. For the Excercises in the training we use the sandbox-release-5.9.4

install

Go to the root of your sandbox and run

mvn clean install

start

Locate the ActivePivotServer class to start your project. It should be located at src/main/java/com/activeviam/sandbox/server/ActivePivotServer.java

content server initialisation

The github gist containing the files can be found here If you do not have access to the gist do the following:

• run the ActivePivot instance your are planning to use (we assume the sandbox-release-5.9.4).
• go to your content server (http://localhost:9090/content), and log in with a user with the role CS_ROOT (admin/admin will do for the sandbox). Make sure it does not contain any sensitive data as we are going to modify it.
• if a ui folder exist AND IT DOES NOT CONTAIN SENSITIVE DATA, delete it
• re create the ui folder
• once created, right click on the ui folder and enter ROLE_CS_ROOT for both OWNERS and READERS
• right click the ui folde again and click import
• Browse to the root directory of your training project and select initial-content.json

Downloading and Running Active UI

Setting up Access to artifactory

npm needs to be configured to use the internal repository for the @activeviam scope (the activeui packages indicated by @activeviam are not publicly accessible) To do so, run the following command:

npm login --scope @activeviam --registry https://activeviam.jfrog.io/artifactory/api/npm/npm-internal/

The result should be the following message:

Logged in as username to scope @activeviam on https://activeviam.jfrog.io/artifactory/api/npm/npm-internal/.

If the scope is not mentioned in the message, you may have to change the command to

npm login --scope=@activeviam --registry=https://activeviam.jfrog.io/artifactory/api/npm/npm-internal/

Install and Run

Now go to your project root directory and install the dependencies using

yarn install

Finally run your project with

yarn start