master |
---|
The Alfresco Modeling Application is an extended version of the Activiti Modeling application (AMA), built using Alfresco Application Development Framework (ADF) components.
Run the following command to install all third-party dependencies:
npm ci
We need to set some environment variables to be able to run the local dev server. In the project root folder, create a .env
file (this is gitignored) with the following data:
# App config settings
APP_CONFIG_BPM_HOST="<url>"
APP_CONFIG_ECM_HOST="<url>"
APP_CONFIG_OAUTH2_HOST="<url>"
APP_CONFIG_IDENTITY_HOST="<url>"
APP_CONFIG_PROVIDER="ALL"
APP_CONFIG_AUTH_TYPE="OAUTH"
APP_CONFIG_OAUTH2_CLIENTID="alfresco"
APP_CONFIG_OAUTH2_IMPLICIT_FLOW=true
APP_CONFIG_OAUTH2_SILENT_LOGIN=true
APP_CONFIG_OAUTH2_REDIRECT_SILENT_IFRAME_URI="{protocol}//{hostname}{:port}/assets/silent-refresh.html"
APP_CONFIG_OAUTH2_REDIRECT_LOGIN=/
APP_CONFIG_OAUTH2_REDIRECT_LOGOUT=/
APP_CONFIG_APPS_DEPLOYED="[{"name": "simpleapp"}]"
# MODELING RELATED
APP_CONFIG_NOTIFICATION_LAST=6000
APP_CONFIG_SHOW_NOTIFICATION_HISTORY=true
# E2E settings
E2E_USE_MOCK_BACKEND=true
E2E_HOST="http://localhost"
E2E_PORT="4200"
BROWSER_RUN="true"
E2E_PREFIX="e2e"
SMART_RUNNER_DIRECTORY=".protractor-smartrunner"
SAVE_SCREENSHOT="true"
SCREENSHOT_URL="<url>"
SCREENSHOT_PASSWORD="<password>"
LOG_LEVEL="TRACE"
LOG=true
# Test user credentials
E2E_USERNAME="<username>"
E2E_PASSWORD="<password>"
E2E_UNAUTHORIZED_USER="<username>"
E2E_UNAUTHORIZED_USER_PASSWORD="<password>"
IDENTITY_USER_EMAIL="<username>"
IDENTITY_USER_PASSWORD="<password>"
SUPERADMIN_EMAIL="<username>"
SUPERADMIN_PASSWORD="<password>"
DEVOPS_EMAIL="<username>"
DEVOPS_PASSWORD="<password>"
MODELER_EMAIL="<username>"
MODELER_PASSWORD="<password>"
PROCESS_ADMIN_EMAIL="<username>"
PROCESS_ADMIN_PASSWORD="<password>"
HR_USER="<username>"
HR_USER_PASSWORD="<password>"
ADMIN_EMAIL="<email>"
ADMIN_PASSWORD="<password>"
Use one of the following commands to run the application:
# develop server
npm start
# Production server
npm start -- --prod
Use one of the following commands to build the application:
# develop build
npm run build
# Production build
npm run build -- --prod
npm test
First build the application as above.
Then docker build . -t alfresco/alfresco-apps: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
The application is supported in the following browsers:
Browser | Version |
---|---|
Chrome | Latest |
Safari (OS X) | Latest |
Firefox | Latest |
Microsoft Edge | Latest |