topic Re: How to call Assign-workflow webscript in Alfresco Archive

How to call Assign-workflow webscript

dsnkostic — Fri, 30 Jul 2010 09:08:57 GMT

Hi,I am trying to start advanced workflow using assign-workflow webscript (POST /alfresco/service/slingshot/doclib/action/assign-workflow). However I don't know how to pass parameters to this script. I understand that it is a POST method (not GET). Studying code for script I found that I need ID of

Re: How to call Assign-workflow webscript

mikeh — Fri, 30 Jul 2010 09:20:13 GMT

Most of Alfresco's REST APIs require a JSON data structure in the request body. Use something like Firebug for Firefox to see the format.

Thanks,
Mike

Re: How to call Assign-workflow webscript

groberts — Fri, 17 Sep 2010 16:38:34 GMT

Did you find the right syntax ? I have *exactly* the same question.

I guess I am going to have to build the json by trial and error by referrng to the implementing web script.

It kind of defeats the purpose of an interface if you have to look behind it to find out how to use it. I can see the required parameters but will have to guess at the format until it works.

One tip, sorry if its obvious, is to use Firefox Restclient to understand how to call the service before coding it in your client.

It would be great to see example json arguments with the other info about each call.

This would help people save time.

Re: How to call Assign-workflow webscript

groberts — Fri, 17 Sep 2010 16:41:21 GMT

(I can't use Alfresco web client to see the json because it calls the script from within the Java Server Faces thing)

Re: How to call Assign-workflow webscript

mikeh — Fri, 17 Sep 2010 22:35:12 GMT

Please note the /slingshot REST APIs are deliberately not documented, as they are not maintained so as to guarantee backward compatibility between versions. They are there purely to support that version of the Share client and are prone to change both parameters and output depending on Share's current requirements.

The /api namespaced webscripts are documented on the wiki.

Thanks,
Mike

Re: How to call Assign-workflow webscript

groberts — Sun, 19 Sep 2010 20:21:20 GMT

Thats a useful warning Mike. Thanks.

I could not tell from the service index that this Web Script was likely to change. It would be worth including a caveat in slingshot scripts to warn others.

I can't see any other Web Scripts in the index that can start a simple workflow. I need to let users of our client application assign tasks to other users, just really to sign off documents as happens in the JSF application.

This must be a common use case so I expect its been done several times, I just can't see the right script.

I've searched Jeff Pott's Alfresco Developer Guide book for a web script to assign basic workflow to people via a REST service but didn't find it.

Thanks again.

Re: How to call Assign-workflow webscript

groberts — Mon, 20 Sep 2010 10:36:37 GMT

In case anybody else wants to know how to call the script mentioned above, this is what the JSON sent by share looks like

{"date":"","description":"Test","nodeRefs":["workspace://SpacesStore/f6247846-cb02-41f9-820c-089289051dd2"],"people":["admin"],"type":"wf:review"}

But as Mike says it is not likely to keep working in future releases.

Re: How to call Assign-workflow webscript

mikeh — Mon, 20 Sep 2010 10:47:38 GMT

Indeed, I've removed that webscript (along with the create folder one) in 3.4. Share now supports both functions: Start Workflow and Create Folder via the Forms Service.

Thanks,
Mike

Re: How to call Assign-workflow webscript

groberts — Mon, 20 Sep 2010 23:26:36 GMT

Mike,

Just to put things in context, I'm using Ruby on Rails and EXT JS to write our client. We've not got a lot of resource (who has) and so I jump at any chance to use existing components.

Thanks for your continued work !

Guy.