Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Créer un package AMP pour Alfresco  ECM  ALFRESCO , AMP , EXTENSIONS , TUTORI

Créer un package AMP pour Alfresco  ECM  ALFRESCO , AMP , EXTENSIONS , TUTORIEL  LEAVE A COMMENT Dans mon tutoriel sur les scripts Ant, j’avais évoqué les packages AMP (Alfresco Module Package). Ils sont utilisés pour ajouter des sets de fonctionnalités supplémentaires ou des fichiers pour personnaliser l’outil (images, icônes, modèles de données, scripts, etc.). Voyons comment transformer un projet en package AMP. 1. Le package AMP Un package AMP est un dossier compressé qui possède une structure bien précise : /config correspond à /WEB-INF/classe. Il contient les fichiers de configuration de vos extensions (web-client-config, modeles, -context.xml, resources.properties, etc.) /lib correspond à /WEB-INF/lib et contient tous les fichiers .jar dont vous avez besoin. /licences contient les éventuels fichiers de licence liés à des librairies externes que vous pourriez utiliser. /web est mappé à la racine de la webapp Alfresco, soit /tomcat/webapps/alfresco/. Les noms des dossiers qu’il contient parlent d’eux-même. Mais vous pouvez en ajoutez d’autres selon vos besoins. La structure du package n’est pas figée. Le fichier module.properties contient des informations sur votre module comme son nom, son id, une description et éventuellement des contraintes sur la version d’Alfresco à laquelle il peut s’appliquer. Nous y reviendrons plus tard. Le fichier file-mapping.properties est optionnel et vous permet de modifier le mapping des dossiers de votre package AMP par rapport à la webapp Alfresco. Si vous n’utilisez pas ce fichier, le mapping par défaut (décrit précédemment) est utilisé. 2. Le projet Eclipse Maintenant, voyons comment créer et structurer votre projet sous Eclipse. La structure est un peu différente du package amp mais un script Ant permettra de facilement remodeler le projet pour générer un package conforme en sortie. Le dossier source contient les classes java. Le dossier build sera utilisé par le script Ant pour compiler les classes et générer le jar. Nous retrouvons les dossiers lib, web et config. Le dossier WEB-INF peut contenir votre fichier web.xml si vous le modifiez ou bien le fichier faces-config- custom.xml. Nous retrouvons également file- mapping.properties et module.properties. Enfin il y a le script Ant project-build.xml et son fichier de propriétés. a. le fichier module.properties # my module properties module.id=myGreatModule module.aliases=my-great-module, module-1 module.version=1.0 module.title=My Uber module for Alfresco module.description=This module add great new features to the alfresco web client module.repo.version.min=2.0 module.repo.version.max=2.1 module.depends.alfresco.custom.module.myFi rstModule=1.0-* module.depends.alfresco.custom.module.mySe condModule=* Les propriétés marquée en bleu sont obligatoire ! Les deux lignes qui suivent la description du module permettent de spécifier la version d’Alfresco à laquelle peut s’appliquer votre module. Elles sont optionnelles. Les deux lignes suivantes indiquent que votre module ne peut être installé que si les deux modules cités sont déjà installés et avec une contrainte sur leur version. Concrètement, doivent être installés au préalable myFirstModule 1.0 minimum et mySecondModule toute version acceptée… b. le fichier module-context.xml L’autre fichier important pour créer notre package amp est le fichier module-context.xml. Ce fichier est un fichier de configuration Spring standard et va permettre de charger les différents fichiers xml de vos extensions au démarrage d’alfresco. Il se trouve dans le dossier /config/alfresco/module/<module.id>/ Et sont contenu peut être comme ceci: ? 01 02 03 04 05 06 07 08 09 10 <?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.o <beans> <import resource="context/bootstrap-context.xml" /> <import resource="context/custom-models-context.xml" /> <import resource="context/custom-actions-context.xml" /> <import resource="context/web-ui-config-context.xml" /> <import resource="context/resources-bundle-context.xml" /> </beans> Bien sûr, vous pouvez tout aussi bien déclarer vos beans directement dans le fichier module-context.xml. Personnellement, je n’hésite pas à multiplier les niveaux dans mon arborescence pour que tout soit bien structuré. c. le script Ant Maintenant que votre projet est bien structuré et que vous disposez de tous les fichiers nécessaire à la création du package amp, vous pouvez vous attaquer au script Ant ! Voici un exemple de script : ? 0 1 0 2 <?xml version="1.0"?> <project name="Alfresco extensions sample" default="package-amp" basedir="."> 0 3 0 4 0 5 0 6 0 7 0 8 0 9 1 0 1 1 1 2 1 3 1 4 1 5 1 6 1 7 1 8 1 9 2 0 2 1 2 2 2 3 2 4 2 5 2 6 2 <property name="project.dir" value="."/> <property file="${project.dir}/project-build.properties"/> <property file="${project.dir}/module.properties"/> <property name="project.name" value="org.alfresco.custom.extensions"/> <property name="build.dir" value="${project.dir}/build"/> <property name="config.dir" value="${project.dir}/config"/> <property name="jar.file" value="${build.dir}/lib/${project.name}.jar"/> <property name="amp.file" value="${build.dir}/dist/${module.id}.amp"/> <target name="mkdirs"> <mkdir dir="${build.dir}/dist" /> <mkdir dir="${build.dir}/lib" /> <mkdir dir="${build.dir}/classes" /> </target> <path id="class.path"> <dirset dir="${build.dir}" /> <fileset dir="${project.dir}/lib" includes="**/*.jar" /> <fileset dir="${alfresco.sdk.dir}/server" includes="**/*.jar" /> </path> <target name="clean"> <delete dir="${build.dir}" /> </target> <target name="compile" depends="mkdirs"> <javac classpathref="class.path" debug="${debug}" srcdir="${project.di destdir="${build.dir}/classes" target="1.5" encoding="UTF-8"/> <copy todir="${build.dir}/classes"> <fileset dir="${project.dir}/source" defaultexcludes="false"> <exclude name="**/*.java"/> <exclude name="**/.svn/**"/> <exclude name="**/CVS/**"/> </fileset> </copy> </target> <target name="package-jar" depends="compile"> <jar destfile="${jar.file}" encoding="UTF-8"> <fileset dir="${build.dir}/classes" defaultexcludes="false" /> </jar> </target> <target name="package-amp" depends="package-jar" description="Package the <zip destfile="${amp.file}" encoding="UTF-8"> <fileset dir="${project.dir}/build" includes="lib/*.jar" /> <fileset dir="${project.dir}" includes="config/**/*.*" excludes="* <fileset dir="${project.dir}"> 7 2 8 2 9 3 0 3 1 3 2 3 3 3 4 3 5 3 6 3 7 3 8 3 9 4 0 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 4 9 5 0 5 1 <include name="module.properties"/> <include name="file-mapping.properties" /> <include name="WEB-INF/**/*" /> <include name="lib/**/*" /> <exclude name="project-build.properties"/> <exclude name="project-build.xml"/> </fileset> <zipfileset dir="web" prefix="web"/> </zip> </target> <target name="install-amp" depends="package-amp" description="Uses the Alf <java dir="." fork="true" classname="org.alfresco.repo.module.tool.Mod <classpath refid="classpath.server"/> <arg line="install ${amp.file} ${alfresco.war.path} -force -verbos </java> </target> <target name="deploy-amp" depends="install-amp" description="Unzips the AM <unzip src="${alfresco.war.path}" dest="${alfresco.web.dir}" /> </target> </project> 5 2 5 3 5 4 5 5 5 6 5 7 5 8 5 9 6 0 6 1 6 2 6 3 6 4 6 5 6 6 6 7 6 8 6 9 7 0 7 1 7 2 7 3 7 4 7 5 ainsi que le contenu du fichier file-mapping.properties, utilisé ici pour mapper les dossiers web et WEB-INF : # Custom AMP to WAR location mappings # # The following property can be used to include the standard set of mappings. # The contents of this file will override any defaults. The default is # ‘true’, i.e. the default mappings will be augmented or modified by values in # this file. # include.default=true # # Custom mappings. If ‘include.default’ is false, then this is the complete set. # /WEB-INF=/WEB-INF /web=/ Voilà :) Vous avez à peu près tout ce qu’il vous faut pour créer vos packages amp. Une fois généré, il vous suffit de le placer dans le dossier /amp ou /amp-share puis exécuter le script apply_amps.bat pour l’injecter dans le war alfresco. Pour comprendre le fonctionnement des packages amp, j’ai utilisé les resources suivantes : AMP Files – wiki Alfresco Developing an Alfresco Module – wiki Alfresco Howto – Create a new Alfresco Module – A Geek’s perspective tutoriel] utilisation d’un script Ant pour packager une extension  ECM  ALFRESCO , ANT , ECLIPSE  1 COMMENT Alfresco est une application modulaire, ce qui signifie qu’on peut lui ajouter des extensions sans avoir besoin de recompiler tout le code source. Lorsque vous développez une extension avec Eclipse, vous pouvez utiliser des scripts Ant pour ajouter vos modifications dans Alfresco. Plusieurs solutions sont envisageables : Intégrer vos modifications dans une archive war alfresco et déployer cette archive dans tomcat. Packager vos fichiers puis les déployer directement sur un war alfresco éclaté. Générer un package AMP qui sera installé au prochain lancement d’Alfresco Lorsqu’il s’agit de déployer des modifications pour faire des tests rapides, il est sans doute préférable d’utiliser la seconde méthode. Les packages amp et l’intégration dans une archive war sont plutôt utilisés lorsque l’extension est terminée. Ils évitent d’avoir à déployer une archive de l’extension après l’installation d’Alfresco. C’est un gain de temps et de simplicité d’utilisation. Nous allons donc étudier un script ant standard utilisé pour déployer une extension sur un war alfresco explosé. Son but va être de compiler les classes java s’il y en a, de générer les archives jar puis de les copier, ainsi que tous les fichiers de configuration et les fichiers jsp/css/images nécessaires dans le répertoire de l’application web Alfresco, à savoir par défaut C:\Alfresco\tomcat\webapps\alfresco. Tout d’abord, regardons à quoi peut ressembler l’arborescence d’un projet d’extension pour Alfresco: source : Il contient vos classes java. vous en aurez besoin si vous voulez ajouter de nouvelles actions (copier/coller un document, le taguer, ajouter des commentaires, modifier ses paramètres, etc.) build : Ce dossier accueille le jar contenant vos classes et l’archive zip de tout votre projet. config : Ici se trouvent tous vos fichiers de configuration custom (web client, modèle, propriétés, etc.) web : les fichiers de personnalisation du client web. Pour utiliser un script Ant, ajoutez un fichier xml ant à votre projet et appelez le build.xml. Ajoutez également un fichier build.properties. Ce fichier va contenir quelques chemins absolus utilisés dans le build.xml. Copiez le code suivant à l’intérieur : ? 1 2 3 alfresco.sdk.dir=C:/alfresco-env/sdk/lib alfresco.web.dir=C:/Alfresco/tomcat/webapps/metalawyerweb alfresco.shared.extension.dir=C:/Alfresco/tomcat/shared/classes/alfresco/extension Bien sûr, pensez à modifier les chemins par rapport à votre environnement. Le dossier shared est inclus dans le classpath d’Alfresco et vous permet de séparer vos fichiers de configuration personnalisés du reste des fichiers uploads/Ingenierie_Lourd/ creer-un-package-amp-pour-alfresco.pdf