README.md

Cammand

Alternative UI to Camunda BPM Webapps (Tasklist, Cockpit, and Admin) + More!

Default app is a "Kitchen Sick" app that covers runtime and history apis.

Contributions and collaboration is always welcomed.

Features:

1. Extendable
2. Customizable
3. Enterprise Friendly
4. White-label Friendly
5. Theme-able
6. Runtime and History API access!
7. Swap APIs for your custom endpoints
8. What more do you need?

Quick Start for Demos and Development Testing

See Docker folder

Screenshots

Process Definitions

BPMN Data Overlays

BPMN Element Selection

Analyze your BPMN Element configurations (WIP):

Deployments and Forms

Process Instances

Start a Process and Tasklist

Jobs

Quick Start

1. open terminal at ./src/MainApp
2. run dotnet run
3. got to localhost:5001

Requires HTTPS on the Camunda API endpoint.

Quick SpringBoot Configs for Camunda:

Development use only.

@Configuration
class CamundaConfig {

    @Bean
    fun processCorsFilter(): FilterRegistrationBean<*> {
        val source = UrlBasedCorsConfigurationSource()
        val config = CorsConfiguration()
        config.allowCredentials = true
        config.addAllowedOrigin("https://localhost:5001")
        config.addAllowedHeader("*")
        config.addAllowedMethod("*")
        source.registerCorsConfiguration("/**", config)

        val bean = FilterRegistrationBean(CorsFilter(source))
        bean.order = 0
        return bean
    }
}

@Configuration
class CamundaSecurityFilter {
    @Bean
    fun processEngineAuthenticationFilter(): FilterRegistrationBean<*> {
        val registration = FilterRegistrationBean<Filter>()
        registration.setName("camunda-auth")
        registration.filter = getProcessEngineAuthenticationFilter()
        registration.addInitParameter(
            "authentication-provider",
            "org.camunda.bpm.engine.rest.security.auth.impl.HttpBasicAuthenticationProvider"
        )
        registration.addUrlPatterns("/engine-rest/*")
        return registration
    }

    @Bean
    fun getProcessEngineAuthenticationFilter(): Filter {
        return ProcessEngineAuthenticationFilter()
    }
}

application.yml

server.ssl.key-store: classpath:keystore.p12
server.ssl.key-store-password: MYPASSWORD
server.ssl.key-store-type: PKCS12
server.ssl.key-alias: tomcat

Code Examples

Generate Overlays for BPMN Model:

async Task SetupDocumentationOverlays()
    {
        var overlays = _bpmnViewer.BpmnElements.FindAll(el => el.BusinessObject.HasDocumentation())
            .Select(i => new OverlayConfig(i.InternalId, element =>
            {
                return new OverlayConfig(
                    elementId: i.InternalId,
                    overlayRenderFragment: _ => @<MudIcon Icon="@Icons.Filled.HistoryEdu" Size="Size.Small"/>,
                    positionTop: -25,
                    positionLeft: (element.Width / 2) - 5,
                    tags: new[] {"documentation"}
                    );
            }));

        _overlayConfigs.AddRange(overlays);
    }