Alfresco is a content management system for Tomcat and written in Java.

Adding Calendars, Wikis and Blogs to a Site

You can’t add calendars, wikis or blogs to an Alfresco site through the Explorer application; they can only be added (and used) with the Share application.

To add the content, go to the site in Share, select More > Customise Site, and then drag content from the Available Site Pages.

Liferay Integration into a Subfolder

It’s impossible to specify Liferay to use a subfolder of Alfresco for its site. For example: Folder/Folder 1/Folder 2/Liferay Home

This results in the error:

Invalid property value:
   Constraint: 11200014 Value 'Root Folder/Folder 1/Folder 2/Liferay Home' is not valid as a file name. This property must be a valid file name.

Disabling Javascript Minification in Alfresco

As discussed here, to enable Javascript debugging (and to disable the minification of Alfresco Javascript), add this code to webscript-framework-config-custom.xml for Alfresco explorer:


For Alfresco Share, the relevant file is <tomcat>/shared/classes/alfresco/web-extension/share-config-custom.xml.

Call to undefined function alfresco_repository_access()

You may get this error when trying to install the Alfresco 6.x module within Drupal 6.x.

This is caused by not having the alfresco module enabled; but even if you specifically enable it, it still may fail.

The root cause is that the SOAP extension may not be enabled; enable it in your php.ini and try enabling the Alfresco module again.


To disable Drupal modules that are enabled but cause your site to crash (so you can’t disable them), see Drupal.

ReferenceError: “json” is not defined.

If you get this error while trying to call a Remote Alfresco API script, such as the following:

var clientRequest = json.toString();
var result = remote.connect("alfresco").post("/api/foo/" + encodeURIComponent( + "/profile/edit",
  clientRequest, "application/json");

The problem is that you need to specify application/json as a content type and re-encode the page arguments to JSON like so:

var clientRequest = page.url.args;
var result = remote.connect("alfresco").post("/api/foo/" + encodeURIComponent( + "/profile/edit",
  jsonUtils.toJSONString(clientRequest), "application/json");

“userhome” is not defined.

userhome is only defined for webscripts within the Alfresco Explorer interface, and not the Alfresco Share interface. I think the common way to solve this is to write an API interface (using JSON), i.e. your Alfresco Share-based app will call the Alfresco Explorer-based app to modify/create content within userhome.


To redirect from within an FTL script:

// redirect
status.location = url.context + "/page/redirect";
status.code = 302;
status.redirect = true;

The choice of Java constructor replace matching JavaScript argument types (function,string) is ambiguous; candidate constructors are: class java.lang.String replace(char,char), class java.lang.String replace(java.lang.CharSequence,java.lang.CharSequence)

Instead of using this:

return s.replace(/[]/g, "")
		.replace(/["]/g, """);

First try casting it to a “Javascript” string, like so:

return (s + "").replace(/[]/g, "")
		.replace(/["]/g, """);

Importing JQuery into an Alfresco Share page

You need to add an import for the JQuery library in the xxx.get.head.ftl template, for example:

<@script type="text/javascript" src="${page.url.context}/res/jquery/jquery-1.6.2.js"></@script>

Correct Format for the Alfresco d:date Data Type

The correct String format for an instance of the d:date data type is the full ISO8601 date format with milliseconds and timezone offset explicitly provided, i.e. 2005-09-16T17:01:03.456+01:00.

The following values will not work:

  • 16 Sep 2005
  • 16 September 2005
  • 2005-09-16 (ISO8601)
  • 2005-09-16 00:00:00
  • 2005-09-16T00:00 (ISO8601 ‘T’)
  • 2007-04-05T14:30Z (ISO8601 ‘T’ with UTC timezone indicator)
  • 23 Feb 2012 11:39:39 GMT+1300 (NZDT) (the format provided in its dateFormat <#macro /> example)

Failed to verify license - Invalid license on Alfresco Enterprise 4.0 Trial

This error can occur if you try to start the alfresco.war web application against an empty alf_data filestore, but the MySQL database is not empty. In this case, simply resetting the database can help:

drop database alfresco; create database alfresco;

com.gargoylesoftware.htmlunit.ScriptException: TypeError: Cannot find default value for object. (http://localhost:8080/share/res/yui/event/event-debug.js#385)

This error occurred when I was trying to test my Alfresco Share application using JWebUnit. One proposed solution was to apply this patch to prevent null objects from being used in a toString() method.

However I found that this patch wasn’t enough. My solution was to patch event-debug.js itself, and replace the failing code with:

     * @method toString
    toString: function() {
         return "CustomEvent: " + "'" + (typeof this.type == 'undefined' ? 'undefined' : this.type)  + "', " +
             "context: " + (typeof this.scope == 'undefined' ? 'undefined' : "");


Translate NodeRef to Person object

While not documented, people.getPeople("filter") returns a list of NodeRefs, not People. It is necessary to translate this into an object that can then be queried for properties.

From alfresco/WEB-INF/classes/alfresco/templates/webscripts/org/alfresco/repository/site/membership/potentialmembers.get.js:

peopleFound = people.getPeople(filter, maxResults);
for (i = 0; i < peopleFound.length; i++) {
  username = search.findNode(peopleFound[i]).properties.userName;
  // ...

jsonUtils.encodeJSONString(x) is instead a freemarker.template.TemplateBooleanModel

<#escape x as jsonUtils.encodeJSONString(x)>
   "success": ${success},

The problem, I think, is that encodeJSONString() expects a String, not a boolean. Therefore:

<#escape x as jsonUtils.encodeJSONString(x)>
   "success": ${success?string("true","false")},

GetChildren: exceeded maximum number filter/sort properties

This occurred when I was trying to execute a listSites query on the siteService:

var all_sites = siteService.listSites("*" + value, "*", 250 /* max results */);

The problem is the “*” parameter for the site type filter. The correct way to search for these sites is via:

var all_sites = siteService.listSites(value, "", 250 /* max results */);

Type Error: items is undefined

If you receive this Javascript exception when running a Share client-side page, then the problem may be that you are trying to read an invalid JSON response. Check Firebug and double check the syntax of the JSON the script is trying to process.

Secure FTP connection fails: bad record MAC

I was getting this error when trying to connect to an Alfresco Secure FTP server using FireFTP (using Auth TLS or Auth SSL). However using Filezilla (explicit secure FTP) worked fine. The error log that I was receiving:

220 FTP server ready
       AUTH SSL
234 Switching to SSL secure session
       PBSZ 0
502 Command not implemented

How to run a server-side Javascript in Alfresco Explorer

  1. Upload the Javascript to Company Home/Data Dictionary/Scripts.
  2. View “More Details” on the Javascript.
  3. Select “Run Action”
  4. Select the action “Run a script”
  5. Select your uploaded script
  6. Click Finish to run the script

Loading and deleting a node by reference in Javascript

var node = utils.getNodeFromString("workspace://SpacesStore/8cf7277f-a753-43dc-b498-f352c8ca815c");

Failed to execute search: Caused by: java.lang.RuntimeException: net.sf.acegisecurity.AuthenticationCredentialsNotFoundException: A valid SecureContext was not provided in the RequestContext

Are you trying to create a Webscript with the following authentication?


Even if you pass in valid authentication through Basic (etc), the Webscript still won’t be authorised to do anything. You need to change this Webscript authentication to: