Vous êtes sur la page 1sur 10

|Java EE & .

NET| GED Alfresco & workflows| Portail Liferay|


"People & Technology for your Agility & Performance"
www.koosery-tech.fr
contact@koossery-tech.fr
1 mail du Professeur G. Math
Biopark Villejuif
94800 Villejuif.

Cration de site avec plan de classement par dfaut


dans un projet dextension Alfresco.

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

I.

Rsum Excutif............................................................................................................................................ 3

II.

Situation actuelle : impossibilit de crer un site avec plan de classement par dfaut........................... 4

III.

Composant permettant de crer un site avec un plan de classement par dfaut..................................... 6

III.1.

Fonctionnement ............................................................................................................................... 6

III.2.

Description technique ..................................................................................................................... 8

IV.

Conclusion............................................................................................................................................... 10

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

I. Rsum Excutif
ALFRESCO propose une solution de gestion lectronique de documents
innovante, techniquement moderne et open source.
Le caractre open source de cette solution permet aux clients dajouter ou de
modifier les fonctionnalits natives afin de les faire correspondre leurs
besoins.
Un des besoins souvent rencontrs est la possibilit de configurer le plan de
classement par dfaut qu'on voudrait voir mis en place pour des sites d'un
type donn.
Ce document, issu des ateliers techniques de KOOSSERY, entend
apporter une rponse ce besoin.

Page 3 sur 10

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

II.

Situation actuelle : impossibilit de crer un site


avec plan de classement par dfaut

Pour crer des sites dans Alfresco, on configure habituellement d'abord un type de site.
Le type de site renseigne sur la structure des sites crer.
Pour configurer un type de site il faut effectuer les 2 tches ci-dessous :
-

Tche 1 : configurer un fichier <ID>-presets.xml contenant la dfinition de la


structure du type de site

Tche 2 : aller dans le fichier create-site.get.js et y ajouter lID du type de site


la liste des types de site dj existants.

Tout site qui sera par la suite cr sur la base dun type de site configur aura une
structure correspondant ce qui a t renseign dans le fichier <ID>-presets.xml
correspondant.

Ci-dessous un exemple de fichier <ID>-presets-.xml.

ligne

[3] :

dfinition

dun

nouveau

type

DEFAULT_kcp_site,

Page 4 sur 10

de

site

auquel

on

donne

lID

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

lignes [4] [20] : dfinition des composants qui seront affichs dans une page.

lignes [22] [32] : dfinition dune page.

Lorsquon examine les informations renseignes dans le presets.xml, on se rend compte qu'il
manque un lment: la structure par dfaut du plan de classement.
Il sagit pourtant dun besoin souvent exprim lors de projets clients et ce besoin nest pas
de base satisfait dans Alfresco.
Nos ateliers ont donc dvelopp un composant qui permet de renseigner la structure par
dfaut du plan de classement pour un type de site.

Page 5 sur 10

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

III. Composant permettant de crer un site avec un


plan de classement par dfaut
III.1.

Fonctionnement

Pour chaque type de site identifi par son ID (l'id renseign dans le fichier presets.xml), il
faut renseigner la structure par dfaut du plan de classement dans un fichier nomm
<ID>-presets-classification-shemas.xml
Lors de la cration d'un nouveau site bas sur un type de site d'ID donn, le composant va
lire le fichier <ID>-presets-classification-shemas.xml et crer le plan de classement par
dfaut qui y a t renseign.
Ci-dessous un exemple de fichier <ID>-presets-classification-shemas.xml.

Lignes [3] [18] : La proprit presetID permet de renseigner lID du type de site (le
mme que celui dans le fichier presets.xml) et la proprit read-only permet de
renseigner si le site sera en lecture seule ou non

Ligne [4] : le tag <input> permet de spcifier le rpertoire daccueil des documents
qui seront injects dans le site par des applications tiers (exemple=chane de
numrisation).

Ligne [5] [9] : Il peut arriver que lon souhaite crer des documents sur la base des
modles de document prdfinis dans le site. On dfinit ici les diffrents types de
modle de documents dans le tag <content-template>.

Ligne [10] [17] : on dfinit la structure du plan de classement. Le tag <directory>


permet de dfinir un rpertoire du plan de classement. La proprit name indique le
nom de ce rpertoire et la proprit visibility (public|private) indique sa visibilit.

Page 6 sur 10

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

Pour pouvoir utiliser le composant, il faut :


-

mettre le fichier <ID>-presets-classement-schemas.xml dans le rpertoire

<XXX>/shared/classes/alfresco/extension.
-

dployer les JARs kcp.ecm.core.jar et kcp.ecm.srv.webscript.jar dans

<XXX> /webapps/alfresco/WEB-INF/lib.

Pour la cration dun nouveau site, on slectionne le type de site comme dans la figure cidessous :

Une fois toutes les informations renseignes on clique sur le bouton OK et notre site se cre
automatiquement avec son plan de classement par dfaut comme dans la figure ci-dessous :

Page 7 sur 10

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

III.2.

Description technique

Pour dvelopper le composant, les lments suivants du code de Alfresco ont t impacts :

com.koossery.extension.alfresco.repo.site.SiteClassificationSchemasService: ce service
expose la mthode createSiteClassificationSchema() qui sert crer le plan de
classement

du

site

en

cours

de

cration.

La

mthode

createSiteClassificationSchema() est invoque dans sites-post.json.js. Le service est


dclar dans le fichier Spring koossery.extension.site-services-context.xml.

sites-post.json.js : nous sommes lors de la cration du site afin dinvoquer la


mthode

createSiteClassificationSchema(String

SiteClassificationSchemasService:.

Page 8 sur 10

shortName)

du

service

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

Page 9 sur 10

Cration de site avec plan de classement par


dfaut dans un projet dextension Alfresco.
Java EE & .NET | GED Alfresco & workflows | Portail Liferay

IV. Conclusion
Nous esprons que cet article vous permettra davoir des ides pour ce qui concerne la
configuration du plan de classement par dfaut pour un type de site donn.
Vous pouvez tlcharger le code de lextension sur notre site web http://koossery-tech.fr
ou en nous contactant par mail ladresse contact@koossery-tech.fr

Page 10 sur 10

Vous aimerez peut-être aussi