topic start a new process in Alfresco Archive

start a new process

Thu, 31 Oct 2013 22:08:53 GMT

Hi, I try to start a new process via the public api on a 4.2 on-premise installation.If I send a POST request with a REST client to the URL http://localhost:8080/alfresco/api/-default-/public/workflow/versions/1/processeswith this body {"processDefinitionKey": "activitiAdhoc","businessKey": "55","v

Re: start a new process

kaynezhang — Fri, 01 Nov 2013 02:14:00 GMT

I didn't find an webscript match you url (http://localhost:8080/alfresco/api/-default-/public/***)，are you sure it is written correctly?

Re: start a new process

Fri, 01 Nov 2013 12:01:00 GMT

I copied the url from the chapter "Api Reference" on docs.alfresco.com. The format I used is described there. Maybe I missundeestood something.

Re: start a new process

kaynezhang — Fri, 01 Nov 2013 14:24:20 GMT

open your web browser and visit http://localhost:8080/alfresco/service/index/package/org/alfresco/repository/workflow,all webscripts related to workflow are listed here.you can see their descriptions and matching uri.

Re: start a new process

Mon, 04 Nov 2013 19:20:29 GMT

hi kaynezhang,

yes you are right, the WebScript I try to call is not listed at http://localhost:8080/alfresco/service/index/package/org/alfresco/repository/workflow. However the script is described in the Alfresco One Public API Reference and the fact that a GET call on the script http://localhost:8080/alfresco/api/-default-/public/workflow/versions/1/processes delivers a reasonable response let me assume that the script is there.

Hence I think my POST body has a bug. Could anybody help me creating a process via the public api?

Re: start a new process

boriskr — Fri, 20 Mar 2015 12:12:11 GMT

Hello! I've also stucked with a process launch. I do everything according to the reference:
http://docs.alfresco.com/community/pra/1/concepts/act-processes-post-process.html

It works fine if no variables are passed:


 { "processDefinitionKey":"approvingProcess" }
‍‍‍

And when I pass some variables,


 { "processDefinitionKey":"approvingProcess",
"variables": [
    { "name":"department",
      "value":"Trades"}]
 }
‍‍‍‍‍‍‍

I get an error
"Could not read content from HTTP request body: Can not deserialize instance of java.util.LinkedHashMap out of START_ARRAY token\n at [Source: java.io.BufferedReader@1be281f9; line: 1, column: 44] …and so on…
What can be the cause?

Re: start a new process

Anonymous — Mon, 20 Apr 2015 14:47:09 GMT

Hi,

I'm facing this too with 5.0.d. It seems it is a jackson deserialization issue.

From what I see, the Json value of "variables" that we pass is an array of serialized Variable object.
But in the ProcessInfo object, the expected type for "variables" is a Map<String, Object>.
Jackson is then saying a kind of "I can't deserialize a map from a START_ARRAY token".

Sebastien.

Re: start a new process

Anonymous — Tue, 21 Apr 2015 07:55:43 GMT

Hi,

It seems that the documentation behind the link following link is wrong :
http://docs.alfresco.com/community/pra/1/concepts/act-processes-post-process.html

The JSon representation of a simple map (Map<String, String>) is like :

{
 "key1" : "value1",
 "key2" : "value2",
 …
}‍‍‍‍‍

As said previously, the target type of the <i>variables</i> attribute is Map<String, Object>.

So I managed to start a workflow with the following request :


POST http://localhost:8080/alfresco/api/-default-/public/workflow/versions/1/processes?alf_ticket={{ALF_TICKET}}
Request body : 
{
   "processDefinitionId": "activitiAdhoc:1:4",
   "processDefinitionKey": "activitiAdhoc",
   "businessKey": "myBusinessKey",
   "variables": {
          "bpm_assignee" : "myUserId"
   },
   "items": []    
}‍‍‍‍‍‍‍‍‍‍‍‍

Re: start a new process

jm_pascal — Tue, 21 Apr 2015 19:24:08 GMT

Aloah,

This is an example :

<b>POST : http://hostnameort/alfresco/api/-default-/public/workflow/versions/1/processes</b>


{
   "processDefinitionId":"activitiAdhoc:1:4",
   "variables":{
      "bpm_assignee":"admin",
      "bpm_workflowDescription":"Title Of Task",
      "bpm_sendEMailNotifications":false,
      "bpm_workflowPriority":1,
      "bpm_workflowDueDate":"2015-04-21T00:00-0400"
   },
   "items":[
      "a7049303-e538-4df0-b62e-8684bf26047d"
   ]
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Hope it helps.

Re: start a new process

arak — Sat, 20 Jun 2015 22:55:36 GMT

Thanks for this information, right at this moment I needed start a workflow using the RESTful API Alfresco.

Greetings,
Pablo.