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, 5.2.x, 6.1.X, 6.2.x, 7.0.x, 7.1.X, 7.2.X, 7.3.X, 7.4.X, 23.1.X (works on Community versions)
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 and docker-compose.yml files (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
This extension is a standard Alfresco Module, so experienced users can skip these steps and proceed as usual.
-
Stop Alfresco
-
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
-
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. -
Start Alfresco
Inside the project, you will find the run.bat
and run.sh
scripts. These are convenience scripts to quickly compile / test / run the project.
In the terminal window, use:
./run.sh build_start
for Mac OS X or Linux.run.bat build_start
for Windows.
If this is the first time you are doing this, it will take a while for Maven to download all the required dependencies and for Docker to download all the required images.
For more information about how to work with SDK project, see the online documentation.
/!\ Only actions performed from Share UI are "audited" /!\
Be aware that this module does NOT use alfresco audit mechanisms.
This module uses latest Share extension mechanisms.
You can deploy/undeploy AuditShare menus directly from : http://server:port/share/page/modules/deploy
Default CRON expression (every day at 06:05:04): share.stats.sites.volumetry.trigger=4 5 6 * * ?
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 * * ?
Created by: Alexandre NICOLAS and Bertrand FOREST
Contributors:
- Alexandre PINTO
- Anicet PRAO
- Antoine HEITZMANN
- Benjamin BRUDO
- Julien BERTHOUX
- Stรฉphane PROUVEZ
- Laurent MEUNIER
- Zylknet
- Etienne PERRIER
- Fabien CHENE
- Justin Poinsot
- รdnei Cristian
This extension is licensed under GNU Library or "Lesser" General Public License (LGPL)
.
Atol Conseils et Dรฉveloppements is Alfresco Strategic Partner Follow us on Twitter @atolcd