Activiti Modeling Application

master

Introduction

The Activiti Modeling Application (AMA) is an application built using Alfresco Application Development Framework (ADF) components and was generated with Angular CLI.

---

Running the application

Prerequisites

Installing dependencies

$ npm install

Setting up environment variables

To be able to run the local dev server, we need to set some environment variable. Simply crete a .env file (this is gitignored) in the root of the repository with filling in the following data:

API_HOST="http://my-acm.implementation.com/whatever"
OAUTH_HOST="http://my-acm.implementation.com/auth/realms/whatever"

Development server

$ npm start

Run the script above for the development server. Navigate to http://localhost:4100/ (opens by default).

Development server with local ADF components

$ npm run start:adfdev

Run the script above for the development server using the local ADF components. For this to work properly you must have to chek out the Alfresco Application Development Framework (ADF) to the same parent directory which contains this repository too. Like this:

• parent-folder
  • activiti-modeler-application
  • alfresco-adf-components

After starting the dev server, navigate to http://localhost:4100/ (opens by default).

Production server

$ npm run start:prod

Run the script above for the production server. This command is only intended to be used when running on the target environment.

After starting the production server, navigate to http://localhost:4100/.

---

Building the application

Development build

$ npm run build

Development build with local ADF components

$ npm run build:adfdev

Production build

$ npm run build:prod

Running in Docker

First build the application as above.

Then docker build . -t alfresco/alfresco-modeler-app:latest to build the image

Start with below (substituting with values for your deployment):

docker run -it -e APP_CONFIG_OAUTH2_HOST="http://KEYCLOAKHOST/auth/realms/activiti" -e APP_CONFIG_OAUTH2_CLIENTID="activiti" -e APP_CONFIG_BPM_HOST="http://GATEWAYHOST" -p 8080:80 alfresco/alfresco-modeling-app:latest

If any substitutions don't work then check that the placeholders in docker-entrypoint.sh match src/app.config.json

---

Running unit tests

$ npm test

Run the script above to execute the unit tests via Jest.

---

Browser Support

The application is supported in the following browsers:

Browser	Version
Chrome	Latest
Safari (OS X)	9.x
Firefox*	Latest
Edge	13, 14