Aperte Web Services - bluesoft-rnd/aperte-workflow-core GitHub Wiki

Since aperte 2.0, a new web service mechanism is avaliable. It allows to perform simple actions through web services, like: starting new process, pushing process to next stage etc. For more information it is worth visiting [Web Service API] (http://bluesoft-rnd.github.com/aperte-workflow-core/webservice-doc/). Although api contains a large number of methods only few of them are avaliable through WS. So during study of api, it is worth to pay attention, if the current method is avaliable.

##Usage The WSDL is avaliable under http://[host]/aperteworkflow/services/data?wsdl and http://[host]/aperteworkflow/services/process?wsdl

##Security

The web services needs authorisation. It is secured with usage of: security-constraint.

<security-constraint>
   	<display-name>excluded</display-name>
   	<web-resource-collection>
   		<web-resource-name>Web Service API</web-resource-name>
   		<url-pattern>/services/*</url-pattern>
   	</web-resource-collection>
   	<auth-constraint>
   		<role-name>AWF_API</role-name>
   	</auth-constraint>
</security-constraint>

Web.xml fragment.

As is shown, application server needs to have configured AWF_API role to offer WS access.

Tomcat Example: In tomcat adding new role is realised through: tomcat-users.xml in /conf/ folder:

<role rolename="AWF_API"/>
 <user username="joebloggs" password="test" roles="AWF_API"/>
</tomcat-users>

##Programers If you would like to unblock one of web methods, just remove: (exclude=true) from integration project, inorg.apereworkflow.service package. Most of methods are tested and working correctly, but was considered to much "low level" and blocked.