Starting a process via REST Api (no forms)

Bayqush · December 9, 2016, 11:27am

Hi,

does anybody know if it’s possible to start a process via the REST API where the start process doesn’t have any forms (default: generic forms). When I manually create the process in the TaskList UI a Business Key is demanded which can be empty / null.

When I query they REST API like this:

http://localhost:8080/engine-rest/process-definition/key/myProcess/ or with http://localhost:8080/engine-rest/process-definition/myProcess/ as a POST with empty Request Body (tried completely empty and with {}) I get HTTP Status Code 405.

I tried to simulate it with the invoice example process and just deleted the required fields (removed the data upload part) and submitted the form data (variables and values) and it worked.

Can anybody give me an advice please?

Thanks in advance.

roman.smirnov · December 9, 2016, 11:53am

Hi @Bayqush,

Have a look into 1.

Cheers,
Roman

Bayqush · December 9, 2016, 12:06pm

I just overlooked that some parameters are required as well. Thanks… I’ll try it…

Bayqush · December 9, 2016, 12:17pm

It still doesn’t work. This is my request body:

{
“variables”: {{}},
“caseInstanceId”: “null”,
“businessKey”: “null”
}

roman.smirnov · December 9, 2016, 12:19pm

How does your request url look like? It must be

POST /engine-rest/process-definition/key/myProcess/start

Cheers,
Roman

Bayqush · December 9, 2016, 12:41pm

No. No success… I added form data, a variable set the correct id and tried to set a value in the input… It didn’t work with the rest request.

Request-Body:

{"variables": { "exampleVariable":{"value":"123","type":"String"}}, "caseInstanceId":"321", "businessKey":"123"}

roman.smirnov · December 9, 2016, 1:03pm

The properties variables, caseInstanceId, and businessKey are optional. It is not necessary to provide them with the request body; an empty request body should sufficient.

How does your request url look like?
Please share the corresponding stacktrace.

Cheers,
Roman

roman.smirnov · December 9, 2016, 1:05pm

In addition, did you deploy the camunda REST Api successfully?

Cheers,
Roman

Bayqush · December 9, 2016, 1:10pm

I used the camunda wildfly zip coming with deployments including the rest api app.

My request URL looks like this: http://localhost:8080/engine-rest/process-definition/key/My-Example-Process .

The rest api is working fine. The problem is that I can’t start processes…

Here is my Stacktrace:

2016-12-09 13:58:12,202 ERROR [org.jboss.resteasy.resteasy_jaxrs.i18n] (default task-117) RESTEASY002010: Failed to execute: javax.ws.rs.NotAllowedException: RESTEASY003650: No resource method found for POST, return 405 with Allow header
at org.jboss.resteasy.core.registry.SegmentNode.match(SegmentNode.java:382)
at org.jboss.resteasy.core.registry.SegmentNode.match(SegmentNode.java:121)
at org.jboss.resteasy.core.registry.RootNode.match(RootNode.java:43)
at org.jboss.resteasy.core.LocatorRegistry.getResourceInvoker(LocatorRegistry.java:79)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:129)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:107)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:133)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:101)
at org.jboss.resteasy.core.SynchronousDispatcher.invoke(SynchronousDispatcher.java:402)
at org.jboss.resteasy.core.SynchronousDispatcher.invoke(SynchronousDispatcher.java:209)
at org.jboss.resteasy.plugins.server.servlet.ServletContainerDispatcher.service(ServletContainerDispatcher.java:221)
at org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher.service(HttpServletDispatcher.java:56)
at org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher.service(HttpServletDispatcher.java:51)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:790)
at io.undertow.servlet.handlers.ServletHandler.handleRequest(ServletHandler.java:85)
at io.undertow.servlet.handlers.FilterHandler$FilterChainImpl.doFilter(FilterHandler.java:129)
at org.camunda.bpm.engine.rest.filter.CacheControlFilter.doFilter(CacheControlFilter.java:41)
at io.undertow.servlet.core.ManagedFilter.doFilter(ManagedFilter.java:61)
at io.undertow.servlet.handlers.FilterHandler$FilterChainImpl.doFilter(FilterHandler.java:131)
at io.undertow.servlet.handlers.FilterHandler.handleRequest(FilterHandler.java:84)
at io.undertow.servlet.handlers.security.ServletSecurityRoleHandler.handleRequest(ServletSecurityRoleHandler.java:62)
at io.undertow.servlet.handlers.ServletDispatchingHandler.handleRequest(ServletDispatchingHandler.java:36)
at org.wildfly.extension.undertow.security.SecurityContextAssociationHandler.handleRequest(SecurityContextAssociationHandler.java:78)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.servlet.handlers.security.SSLInformationAssociationHandler.handleRequest(SSLInformationAssociationHandler.java:131)
at io.undertow.servlet.handlers.security.ServletAuthenticationCallHandler.handleRequest(ServletAuthenticationCallHandler.java:57)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.security.handlers.AbstractConfidentialityHandler.handleRequest(AbstractConfidentialityHandler.java:46)
at io.undertow.servlet.handlers.security.ServletConfidentialityConstraintHandler.handleRequest(ServletConfidentialityConstraintHandler.java:64)
at io.undertow.security.handlers.AuthenticationMechanismsHandler.handleRequest(AuthenticationMechanismsHandler.java:60)
at io.undertow.servlet.handlers.security.CachedAuthenticatedSessionHandler.handleRequest(CachedAuthenticatedSessionHandler.java:77)
at io.undertow.security.handlers.NotificationReceiverHandler.handleRequest(NotificationReceiverHandler.java:50)
at io.undertow.security.handlers.AbstractSecurityContextAssociationHandler.handleRequest(AbstractSecurityContextAssociationHandler.java:43)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at org.wildfly.extension.undertow.security.jacc.JACCContextIdHandler.handleRequest(JACCContextIdHandler.java:61)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.servlet.handlers.ServletInitialHandler.handleFirstRequest(ServletInitialHandler.java:292)
at io.undertow.servlet.handlers.ServletInitialHandler.access$100(ServletInitialHandler.java:81)
at io.undertow.servlet.handlers.ServletInitialHandler$2.call(ServletInitialHandler.java:138)
at io.undertow.servlet.handlers.ServletInitialHandler$2.call(ServletInitialHandler.java:135)
at io.undertow.servlet.core.ServletRequestContextThreadSetupAction$1.call(ServletRequestContextThreadSetupAction.java:48)
at io.undertow.servlet.core.ContextClassLoaderSetupAction$1.call(ContextClassLoaderSetupAction.java:43)
at io.undertow.servlet.api.LegacyThreadSetupActionWrapper$1.call(LegacyThreadSetupActionWrapper.java:44)
at io.undertow.servlet.api.LegacyThreadSetupActionWrapper$1.call(LegacyThreadSetupActionWrapper.java:44)
at io.undertow.servlet.api.LegacyThreadSetupActionWrapper$1.call(LegacyThreadSetupActionWrapper.java:44)
at io.undertow.servlet.api.LegacyThreadSetupActionWrapper$1.call(LegacyThreadSetupActionWrapper.java:44)
at io.undertow.servlet.api.LegacyThreadSetupActionWrapper$1.call(LegacyThreadSetupActionWrapper.java:44)
at io.undertow.servlet.handlers.ServletInitialHandler.dispatchRequest(ServletInitialHandler.java:272)
at io.undertow.servlet.handlers.ServletInitialHandler.access$000(ServletInitialHandler.java:81)
at io.undertow.servlet.handlers.ServletInitialHandler$1.handleRequest(ServletInitialHandler.java:104)
at io.undertow.server.Connectors.executeRootHandler(Connectors.java:202)
at io.undertow.server.HttpServerExchange$1.run(HttpServerExchange.java:805)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
at java.lang.Thread.run(Thread.java:745)

roman.smirnov · December 9, 2016, 1:13pm

As I mentioned before your request url must look like this:

POST /engine-rest/process-definition/key/My-Example-Process/start

You have to append /start to your request url!

Cheers,
Roman

Bayqush · December 9, 2016, 1:16pm

Yeah omg how stupid… Now it works…

thorben · December 9, 2016, 1:21pm

No worries, happens to most of us at least once in my experience

Swarna_Latha · July 30, 2017, 9:03pm

Hi,
Can you provide your example process?

we want to hide this start process.
Thanks

Ingo_Richtsmeier · August 1, 2017, 2:43pm

Just create an empty html form and fill the form key to point to the embedded from.

Cheers, Ingo