Skip to content

External camunda admin portal, which make live in multi-camunda`s environment much easy #camunda

License

Notifications You must be signed in to change notification settings

KotskinKotskin/camunda-excamad

Repository files navigation

Warning

Starting from 01.11.2024 EXCAMAD became a part of https://stormbpmn.com/ and became closed source software. We made a huge redesign, remove old dependencies, rewrite everything from vue2 to vue3, add securty and more more stuff. If you want to use excamad\stormbpmn.com on commercial base, contact us https://stormbpmn.com/contact-sales. All previous code still covered by GNU GPLv3, but there will no more updates in open source.

Excamad

External camunda admin portal. Make life in multi-camunda`s environment much easy and provide some cool features. License : GNU GPLv3.

DEMO: http://excamad.bpmn2.ru (dont forget about CORS)

Description (russian): https://bpmn2.ru/blog/camunda-cockpit-enterpise-i-excamad

0. How to run

a) ---make excamad---

  • git clone
  • npm install
  • fill src/config/settings.js with own value
  • npm run serve (start dev server) OR
  • npm run build (produce html,js,css in to /dist/)

b) --prepare camunda--

If you are going use docker containers add this code to camunda container in /camunda/webapps/engine-rest/WEB-INF/web.xml

" CorsFilter org.apache.catalina.filters.CorsFilter cors.allowed.origins * CorsFilter /* "

OR

docker run -d -p 8080:8080 kotovdenis/excamad:latest

0.1 Default camunda rest endpoint

  • For embedded camunda: ${baseurl}/rest
  • For standalone camunda: ${baserurl}/engine-rest

Excamad work with default rest api, not cockpit api. So you havent auth user in your context.

1. Features

Processes

  • Online statistics about active and ended processes
  • Migration tool
  • Batch variables editor
  • Search instances in history by ID and variables
  • Old activity report
  • Browser viewer and modeler for deployed processes
  • Jira integration (fetch issue about activities from jira)

Decisions

  • Online statistics
  • Decisions viewer and modeler
  • Bitbucket integration
  • Deploy from browser

Incidents

  • Batch rerun activities
  • Fix selected activities
  • Delete failed instances

Live

Provide facebook-like feed about activities in system.

Tasklist

Simple forms and form generator. You need extend your Camunda rest api with method /taskfields

//example
@Path("/")
public ctaskfieldslass TaskFieldsService {

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    @Path("{taskId}")
    public String getFormFieldList(
        @Context HttpHeaders httpHeaders,
        @PathParam("taskId") String taskId
    ) {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        FormService formService = processEngine.getFormService();
        TaskFormData taskFormData = formService.getTaskFormData(taskId);
        List<FormField> formFieldList = taskFormData.getFormFields();
        System.out.println("Strike");
        String json = JSON(formFieldList).toString();
        return json;
    }
}

Business process as service

Organize camunda as provider of BPMN processes.

Multi-camunda`s

Easy switch server and environments.

Login

Ready login provider for basic auth and passthrough to Jira and Bitbucket.

2. Access to server

Excamad is serverless app - all api calls made from your browser. You need host produced files (/dist) on some web-server. And you need enable CORS on your`s camunda.

3. Install

npm install
-
npm run build  // produce files in dist/
OR
npm run serve  // start develop server

You need write global variables in settings.js and camundasUrl.js.