Additional server-side services

The integration between Alfresco and Platform does not finish with the exchange of metadata and documents. A very common customization carried out inside Alfresco is the development of web scripts. Web scripts can be easily invoked by Platform: GUI events can be listened by Platform and can invoke actions. A server-side javascript action can be linked to events and used to invoke web scripts.

This is an example of how to invoke an Alfresco Web Scripts from a server-side javascript:

var success = utils.getAlfrescoWebScript(url, false, "GET", null);

Other examples are:

• Set ACL for a document

service/createFileACLs?applicationId=...&appId=...&uuid=... &roleId=...&canRead=..& canAdd=& canEdit=...& canDelete=...

Parameters:

• Application ID

• AppId

• Folder/Document UUID (Unique Identification)

• Platform Role ID

• CanRead : Y/N value that indicates wether the file/folder is visible for the specified role

• CanAdd : Y/N value that indicates wether the specified role can add files/subfolders in the selected folder

• CanEdit : Y/N value that indicates wether the file is editable by the specified role

• CanDelete : Y/N value that indicates wether the file/folder is deletable by the specified role Response : JSON object with true/falce success property .

• Inherit ACL settings for the specified file/folder

service/setInheritPermission?applicationId=...&appId=...&id=...&enabled=...

Parameters:

• Application ID

• Folder/Document UUID (Unique Identification)

• Enabled : Y/N value to inherit ACL settings from the parent folder

• Changes metadata for a document (one or more metadata) Note : This method must be called via POST request

service/setMetadataForOneFile?applicationId=...&appId=..

Parameters:

• Application ID

• AppID

• In the request body there must be a JSON string with all the metadata for the record. Usually it is the stringified VO with some modified values, for example

/* .. previous code .. 
I expect to have a vo here, for example

vo['name'] = 'John';
vo['surname'] = 'Dooe';
*/

vo['surname'] = 'Doe';  /* Here I modify the value of a property */

vo = JSON.stringify(vo); /* Stringified object */

var result = .... /* Request, pass vo as the body parameter */

• Changes a single metadata of a document

service/setAttributeValue?applicationId=...&appId=..&attributeName=...&attributeValue=...&uuid=...

Parameters:

• Application ID

• AppID

• Folder/Document UUID (Unique Identification)

• AttributeName : Name of the attribute to change

• AttributeValue : The new value for the specified attribute

• Programmatically downloads a file

service/downloadfile?applicationId=...&appId=..& name=...&id=...& path=..&log=...&userId=...

Parameters:

• Application ID

• AppID

• Name : Filename of the file to download

• Folder/Document UUID (Unique Identification)

• Path : Optional parameter used to execute a web call to Alfresco

• Log : true/false optional parameter used to store the download event in the CON60_LOGS DB table

• UserID : true/false optional parameter used in the CON60_LOGS DB table

In case the Web Script returned a JSON response, this can be sent back to the Platform UI through this final instruction:

utils.setReturnValue(success);

Server-side javascript actions can be invoked starting from the Platform GUI in different ways:

• by linking that action to a custom button

• by linking that action to a loading/saving event in grids/forms

• by linking that action to a generic event.

A common scenario is when a server-side javascript action must be manually invoked from some point in the GUI. This is an example of how to do that:

var result = new SyncRequest().send(contextPath + '/executeJs?actionId=...&applicationId=' + applicationId + '&id=' + vo.id, 'GET', null, 'application/json');

var obj = JSON.parse(result);

In this example, a specific server-side action is invoked (through the actionId parameter) and a parameter named id is also passed to the server, filled with a corresponding id attribute contained in the vo. Some kind of result, expressed in JSON format is also sent back.