Alfresco Zimlet – updates and fixes

I’ve made an updated version of open-sourced Alfresco Zimlet.

New features and fixes:

  • SSO ticket based authentication support (‘alfresco_ticket’ and ‘alfresco_url’ cookies)
  • localization support (english and hungarian properties included)
  • works with Alfresco 4.x and Zimbra 7.x
  • bugfixes…

See README file for installation…

Alfresco side webscript installation steps:

1. Import web script package (ZIP) at Alfresco Explorer:

2. Update web scripts:

3. Verify installation with a simple request (update URL and PASSWORD with yours):

$curl --user "admin":"password"
{"children": [{"title": "User managed definitions", "isDocument": false, "path": "\/Company Home\/Data Dictionary", "label": "Data Dictionary"}, {"title": "The guest root space", "isDocument": false, "path": "\/Company Home\/Guest Home", "label": "Guest Home"}, {"title": "Imap Attachments", "isDocument": false, "path": "\/Company Home\/Imap Attachments", "label": "Imap Attachments"}, {"title": "Site Collaboration Spaces", "isDocument": false, "path": "\/Company Home\/Sites", "label": "Sites"}, {"title": "User Homes", "isDocument": false, "path": "\/Company Home\/User Homes", "label": "User Homes"}]}

Download Zimlet:

Alfresco Zimlet provides integration between two leading open source solutions, Alfresco Enterprise Content Management and Zimbra Collaboration Suite.

It was built on top of open technologies such as Alfresco Webscript, Zimbra Zimlet and YUI library.

It allows the end user to save incoming email attachments to the Alfresco ECM Server. The user is provided with the ability to select multiple Alfresco documents and attach them to outgoing emails. Links are provided for downloading Alfresco Documents when composing emails from within Zimbra.

Alfresco Documents and features are surfaced as shortcut links within the Zimbra application. Widgets are provided for ease-of-use in Alfresco space selection and repository navigation. A simple installation and setup is provided.

Original sources:
Original developer: Yong Qu

Discussion Thread on Zimbra Community Forum:

removePermission for all users/groups workaround

I take an ugly bug in removePermission JavaScript function of Alfresco 4.0.d Community Edition.

You can reproduce by this sample script:

var node = companyhome.childByNamePath("User Homes/louise");

permissions = node.getPermissions();
print("Before removePermission:");


permissions = node.getPermissions();
print("After removePermission:");

Results should be:

Before removePermission:
0 : ALLOWED;louise;All
2 : ALLOWED;abeecher;Coordinator

After removePermission:
0 : ALLOWED;louise;All
2 : ALLOWED;abeecher;Coordinator

Ok, don’t wait for 4.1, let see the workaround (removePermissionFromAll function):

var node = companyhome.childByNamePath("User Homes/louise");

permissions = node.getPermissions();
print("Before removePermission:");

removePermissionFromAll(node, "Coordinator");
permissions = node.getPermissions();
print("After removePermission:");

function removePermissionFromAll(node, roleName) {
    permissions = node.getPermissions();

... and the better result:

Before removePermission:
0 : ALLOWED;louise;All
2 : ALLOWED;abeecher;Coordinator

After removePermission:
0 : ALLOWED;louise;All

And as a bonus track, see a simple script to remove "All" permissions in user home folders:

var node = companyhome.childByNamePath("User Homes");

var foldersInUserHomes = node.children;

for(i=0; i

Inbound e-mail and accounts

I’ve tested Alfresco 4.0.d inbound email (to Space with Alias) configuration with Google Mail STMP, but mails not received…

To get the solution first increase logging level for subethamail package:

Let see the log events:

00:08:30,585 DEBUG [org.subethamail.smtp.server.Session] SMTP connection from, new connection count: 1
00:08:30,586 DEBUG [org.subethamail.smtp.server.Session] Server: 220 ESMTP SubEthaSMTP 3.1.6
00:08:30,615 DEBUG [org.subethamail.smtp.server.Session] Client: EHLO
00:08:30,615 DEBUG [org.subethamail.smtp.server.Session] Server:
250 Ok
00:08:30,643 DEBUG [org.subethamail.smtp.server.Session] Client: STARTTLS
00:08:30,643 DEBUG [org.subethamail.smtp.server.Session] Server: 220 Ready to start TLS
00:08:30,673 DEBUG [org.subethamail.smtp.server.Session] Error reading client command: Socket closed Socket closed
        at Method)
        at org.subethamail.smtp.server.Session.runCommandLoop(

As we read above, Google Mail SMTP tried to use TLS, but Alfresco was not configured with StartTLS support.

To take a quick fix to receive emails from gmail accounts, just hide TLS support in


Zimbra briefcase export tool

Simple shell script to retrieve all user accounts from Zimbra, and recursively download Briefcase contents into user-named subfolders.

Script requires https url of zimbra server with active admin account/password.

# Zimbra Briefcases export tool by
# Usage (run on Zimbra server):
#  ./ "" "" "mypassword"


mkdir ${OUTPUT_DIR}

echo "Retrieving all accounts from Zimbra into file '${ACCOUNT_LIST}'..."
su - -c "zmprov -l gaa >${ACCOUNT_LIST}" zimbra

echo "Processing all accounts on Zimbra host '${ZIMBRA_HOST}'"
while read USERNAME
    echo "Downloading Briefcase for account '${USERNAME}' into file '${USERNAME}.zip' and uncompressing..."
    cd ${OUTPUT_DIR}
    cd ..
done < ${ACCOUNT_LIST}
echo "Done."

Just like a Zimbra to Alfresco (User Homes) document library migration tool...

Alfresco with Zimbra LDAP

So, i’ve done with a working LDAP configuration to sync users and groups from Zimbra (see below), but one thing missing yet…

The Alfresco synchronizer service reads from LDAP and writes all users and all groups into repository, but does not reproduce nested group hierarchy.

Retrieve Zimbra LDAP root password:

zmlocalconfig -s zimbra_ldap_password

Let see the configuration in extension/subsystems/Authentication/ldap/ldap1/


# The URL to connect to the LDAP server

# The authentication mechanism to use for password validation


# This flag enables use of this LDAP subsystem for user and group
# synchronization. It may be that this subsytem should only be used for 
# authentication, in which case this flag should be set to false.

# The authentication mechanism to use for synchronization

# The default principal to use (only used for LDAP sync)\=zimbra,cn\=admins,cn\=zimbra

# The password for the default principal (only used for LDAP sync)

# The query to select all objects that represent the groups to import.

# The query to select objects that represent the groups to import that have changed since a certain time.
ldap.synchronization.groupDifferentialQuery=(&(objectclass\=zimbraDistributionList)(!(modifyTimestamp< \={0})))

# The query to select all objects that represent the users to import.

# The query to select objects that represent the users to import that have changed since a certain time.

# The group search base restricts the LDAP group query to a sub section of tree on the LDAP server.

# The user search base restricts the LDAP user query to a sub section of tree on the LDAP server.

# The name of the operational attribute recording the last update time for a group or user.

# The timestamp format. Unfortunately, this varies between directory servers.

# The attribute name on people objects found in LDAP to use as the uid in Alfresco

# The attribute on person objects in LDAP to map to the first name property in Alfresco

# The attribute on person objects in LDAP to map to the last name property in Alfresco

# The attribute on person objects in LDAP to map to the email property in Alfresco

# The attribute on person objects in LDAP to map to the organizational id  property in Alfresco

# The default home folder provider to use for people created via LDAP import

# The attribute on LDAP group objects to map to the authority name property in Alfresco

# The attribute on LDAP group objects to map to the authority display name property in Alfresco (v3.3+)

# The group type in LDAP

# The person type in LDAP

# The attribute in LDAP on group objects that defines the DN for its members

# If true progress estimation is enabled. When enabled, the user query has to be run twice in order to count entries.

Hint: Zimbra and LDAP posts at blog

Enable “remote” root object in Alfresco 3.4+

From the 3.3 version Alfresco is overriding the Spring Surf webscripts container bean removing the remote definition.

This modification also affects number of custom webscripts developed with previous releases. Let see, how to enable “remote” root object in current Alfresco installation;

1. Find your “web-scripts-application-context.xml” configuration file in alfresco webapp, or in shared classes.
2. Search for “webscripts.container”, and update “map” contents like this:




3. Restart Alfresco server
4. Check custom configuration with following code:

var serviceUrl = (args.service === null) ? "/api/repository" : args.service;
var conn = remote.connect("alfresco");
var result = conn.get(stringUtils.urlEncodeComponent(serviceUrl));

Just another, non-remote solution: Nathan McMinn: Calling Web Services from the Alfresco Javascript API

Alfresco 4.0

Ha hihetünk a roadmap-nek, akkor még szeptemberben megjelenik az Alfresco 4.0 community verziója, mely talán a szoftver eddigi legnagyobb fejlődési állomásának tekinthető.

Az előzetes verzió nightly build formájában érhető el, egyelőre szigorúan csak fejlesztők számára javasolt állapotban. Mindenesetre egy pillantást célszerű vetni rá, hiszen pontosan azokon a részeken javítottak a fejlesztők, amire a legtöbb panasz volt eddig. Talán az egyik legnagyobb és legfontosabb változás a beépített Lucene indexer – opcionális – Apache SOLR-ra való cseréje, mellyel kapcsolatosan az elvárás egy nagyságrendekkel nagyobb teljesítmény. A helyi adatbázis helyett a search query-k közvetlenül az indexer-nek lesznek címezve. A 3.4-es verzióban már átírták a node-okhoz tartozó örökölt jogosultság meghatározó algoritmusokat, de úgy tűnik ez még nem hozta el a várt eredményt, hiszen egy kellően mély és összetett hozzáférési rendszerrel rendelkező hierarchia esetén egy néhány ezer találatos válasz előállítása is kivárhatatlan ideig tartott. Az Apache SOLR-ra való áttérés egyben azt is jelenti, hogy az indexer rész leválasztható az Alfresco szerverről, így külön gépen, saját erőforrásokkal látható el. Itt egyrészről megjelenik egy kommunikációs overhead, másrészről pedig a skálázhatóság – performance tesztek majd a hivatalos megjelenés után.

Szintén jelentős alap-technológiai váltásnak nevezhető a jBPM munkafolyamat-motor – szintén opcionális – Activiti-re váltása. Ez utóbbihoz grafikus workflow designer csak az Enterprise verzióban várható. A szabványos dokumentum kezelő protokoll, a CMIS is bővült, az 1.0 szabvány mellett már a következő verzióba tervezettek implementációja is megkezdődött. Ahogy a többi ECM rendszer, úgy az Alfresco sem tudja a teljes CMIS-t, az Apache Chemistry (OpenCMIS) JAVA implementációját használják.

A felhasználói felületek közül elsősorban a Share fejlesztése hozott látványos eredményeket, hiszen a social funkciók, mint a “Like”, felhasználói aktivitás követése, illetve a felhasználói kapcsolatok kezelése mellett a böngésző és előnézet felületek is letisztultabbak, egyszerűbbek lettek. A HTML5 technológia alkalmazásával immár lehetőség van ezeken a felületeken a drag & drop dokumentum feltöltésre, illetve folder-ek közötti mozgatásra. A dokumentumok meta adatainak (properties) szerkesztése is történhet inline módon, azaz nem kell property sheet-et nyitni ahhoz, hogy átírjuk valamelyik mezőt, mint például a dokumentum neve, vagy a hozzáadott címkék.

Az Apple iWorks csomagot használók számára bizonyára jó hír, hogy az Alfresco 4.0 már a Pages, Keynote és Numbers dokumentumokat is képes indexelni és előnézeti képpen ellátni. Az alapszinten eddig is támogatott audió és videó formátumokról is van lehetőség előnézetet kérni.

Ezen változtatások mind-mind fontos előrelépést jelentenek az Alfresco ECM számára és a várható kezdeti gyermekbetegségek után, azaz a 4.0d verzió környékén remélhetőleg a felhasználók is egy stabil rendszert kapnak.

Az Alfresco 3.x és 4.x verziókhoz készült az Alfresco Mobile (Zia) alkalmazása, amely Apple iPad és iPhone készülékeken teszi elérhetővé a repository-kat, közvetlen dokumentum szerkesztést és feltöltést, folyamat kezelést illetve keresést valósít meg ezeken az eszközökön.

Alfresco Share – magyar lokalizáció

Az utóbbi napokban komoly ellenőrzésen és javításokon esett át az Alfresco magyar lokalizáció régebbi kiadása, így lassan elmondható, hogy az Alfresco Explorer 3.4-es felülete 100%-ban magyarul használható.

Ezek mellett nekiálltam a Share lokalizációjának is, ami jóval nagyobb feladat, mint az Explorer – millió apró file-t kell lefordítani, ráadásul van több olyan rész is, amit benne felejtettek a kódban. Mindezek ellenére haladok vele, lássunk két képernyőt, a bejelentkezést és a menüket:

Alfresco Share bejelentkezési képernyő magyarul
Alfresco Share menük magyarul

Az Alfresco Explorer magyar nyelvű lokalizációja: Alfresco 3.x, 4.x, 5.x hungarian localization pack (A lokalizáció folyamatos karbantartásáról a BroadBit Hungary gondoskodik…)