Skip to content
This repository has been archived by the owner on May 18, 2022. It is now read-only.

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ssarkisy authored May 3, 2018
1 parent 93a901d commit 32927ce
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Installation
## Prerequisites
Firstly, please import and compile the [Ensemble Workflow REST API](https://github.com/intersystems-ru/EnsembleWorkflow) project.

Then, you will need to create and setup 2 CSP-applications.

### REST Application
1. Go to Ensemble Management Portal, Web Applications and create a new one for Namespace where you imported Ensemble Workflow REST API project.
2. Set it’s name as `/wf/api` for instance.
3. Set Allowed Authentication Methods for “Password” only.
4. Set Group By ID for any string you want (remember it)
5. Set dispatch class for `Workflow.REST`
6. Set Session Cookie Path for `/wf` (it depends from name of the app in step 2)
7. Assign roles for application if needed (depends on configuration and security rules of your Ensemble instance)

## Client Application
1. Go to Ensemble Management Portal, Web Applications and create a new one for the same Namespace as REST Application.
2. Set it’s name as `/wf` for instance (it depends on app name in step 2 of REST Application setup. The idea is to set the same Cookie Path for both applications, that they could share same CSP-session. Cookie path depends on app name).
3. Set Allowed Authentication Methods for “Password” only.
4. Set Group By ID to value you used in step 4 of REST Application setup.
5. Set CSP Files Physical Path to folder where you will extract files of the current project (or configure it later)

## Use Release
To use the latest release, go to ‘Releases’ tab of this repository. Download and extract zip to the folder you chosen in step 5 of Client Application Setup.

## Build from source
To build application from source you need to install **Node.js** with **npm** package manager.
Then, use following command inside source directory to install all the dependencies: `npm install`
After that, use `npm run build` to build the application. Result application will be placed in `dist` directory.

## Config
**Important**

Go to `/assets/config/config.json` and set apiServer.appName to the name of you REST Application.

0 comments on commit 32927ce

Please sign in to comment.