JavaScript Java FreeMarker CSS Other
bforest Bump version to 1.5.9-SNAPSHOT
Change-Id: I6397227a04fb8741510a36b58e6524f432c27ed6
Latest commit 232a901 Aug 7, 2018

README.md

Build Status HitCount

"AuditShare" for Alfresco

AuditShare is an extension totally integrated into the Share UI accessible by administrators and site managers.
This app displays sites and repository usage info: number of created/read/updated/deleted documents displayed by day/week/month/year.
In sites, others informations are "audited" concerning wiki, blog and discussions components but also users connected and sites volumetry.

Works with:

  • Alfresco Enterprise 4.2.x, 5.0.x, 5.1.x and 5.2.x (should works on Community versions but not tested)

Building the module

Check out the project if you have not already done so

    git clone https://github.com/atolcd/alfresco-audit-share.git

Maven build scripts are provided to build AMP files containing the custom files.
Before building, ensure you have correctly configured repositories in the parent pom.xml file (alfresco-public for Community, alfresco-private-repository for Enterprise).

To build AMP files, run the following command from the base project directory:

    mvn clean package

Installing the module

This extension is a standard Alfresco Module, so experienced users can skip these steps and proceed as usual.

  1. Stop Alfresco

  2. Use the Alfresco Module Management Tool to install the modules in your Alfresco and Share WAR files:

     java -jar alfresco-mmt.jar install com.atolcd.alfresco.auditshare-XXX-repo-X.X.X.amp $TOMCAT_HOME/webapps/alfresco.war -force
     java -jar alfresco-mmt.jar install com.atolcd.alfresco.auditshare-XXX-share-X.X.X.amp $TOMCAT_HOME/webapps/share.war -force
    
  3. Delete the $TOMCAT_HOME/webapps/alfresco/ and $TOMCAT_HOME/webapps/share/ folders.
    Caution: please ensure you do not have unsaved custom files in the webapp folders before deleting.

  4. Start Alfresco

Using the module

/!\ Only actions performed from Share UI are "audited" /!\
Be aware that this module does NOT use alfresco audit mechanisms.

Configuration

This module uses latest Share extension mechanisms.
You can deploy/undeploy AuditShare menus directly from : http://server:port/share/page/modules/deploy

CRON volumetry

Default CRON expression (every 4 hours): share.stats.sites.volumetry.trigger=0 0 0/4 * * ?

This expression can be overridden from alfresco-global.properties file (http://wiki.alfresco.com/wiki/Scheduled_Actions#Cron_Explained).
Example (at 1:00 PM and 9:00 PM every day): share.stats.sites.volumetry.trigger=0 0 13,21 * * ?

Screeshots

Sites stats

User connections

Volumetry

Contributors

Created by: Alexandre NICOLAS and Bertrand FOREST

Contributors:

LICENSE

This extension is licensed under GNU Library or "Lesser" General Public License (LGPL).

Our company

Atol Conseils et Développements is Alfresco Strategic Partner
Follow us on Twitter @atolcd