/Cammand

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

Primary LanguageC#

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

Process Instance Process Instance Process Instance Process Instance Process Instance Process Instance Process Instance Process Instance

BPMN Data Overlays

Bpmn Data Overlay 1 Bpmn Data Overlay 2

BPMN Element Selection

Analyze your BPMN Element configurations (WIP):

element data

element data element data element data element data element data

Deployments and Forms

Process Instance Process Instance Process Instance

Process Instances

Process Instance Process Instance Process Instance Process Instance Process Instance Process Instance

Start a Process and Tasklist

Process Instance Process Instance

Jobs

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);
    }