Utilisation des règles « métier » sous Alfresco

Alfresco utilise la technologie AOP (Aspect Oriented Programming – Programmation orientée objet) comme framework de développement. Cela permet de modifier le comportement de l’application serveur sans toucher aux codes de l’application. Les règles « métier » profitent de cette technologies et nous permettent de modifier le comportement du serveur sans programmation.

Gestion des règles

Une règle « métier » est définie suivant les trois notions suivantes :

1. les conditions,
2. Les Actions,
3. Les déclencheurs.

La mise en place, des règles « métier », s’effectue en trois étapes :

1. la mise en place des conditions d’application des règles,
2. les actions à appliquer,
3. quelles sont les évènements déclencheurs.

Les conditions

Les conditions servent à définir sur quels contenus seront appliqués les règles métier.

Conditions des règles

Lors de la première étape de l’assistant il vous sera possible de choisir le contenu en fonction des critères suivants :

1. Une chaîne de caractère présente dans le nom du fichier,
2. Un document appartenant à une ou plusieurs catégorie,
3. Un type de format de document basé sur le type MIME,
4. Un document possédant un ou plusieurs aspect,
5. Un document ayant une propriété de type texte, date ou valeur numérique.

Vous pouvez croiser n’importe quelles conditions pour sélectionner le document. Le document doit répondre à toutes les conditions pour que la (ou les) règle(s) s’applique(nt).

Récemment il a été ajouté la possible de faire une sélection de type conditionnel en sélectionnant « Composite Choice ». Cela vous permet de spécifier autant de condition que vous voulez en les combinant avec la composant « OU ». Dans ce cas le document doit correspondre à une des conditions pour que les règles s’appliquent.

Conditionnel

Les actions

Un assistant vous aide dans la déclaration de vos actions.

Liste des actions

Lors de la deuxième étape de l’Assistant de création des règles, nous avons accès à la liste des actions suivantes (le libellé en anglais est fourni entre parenthèse) :

• Ajouter un ou des aspects (Add aspect to item) : Ajouter des propriétés et des comportements aux documents ou à un espace.
• Ajouter un processus simple (Add simlpe Workflow : ajouter un processus simple d’approbation documentaire avec possibilité de rejet sur un espace.
• Libération du document (Check in Content : Libération du document préalablement réservé pour modification.
• Réservation du document (Check out content : Réservation du document pour modification.
• Copier du document dans un espace défini (Copy item to specific space) : Copier le document dans un espace spécifique.
• Exécuter un script (Execute a script) : exécuter du code JavaScript
• Extraction de Meta-données du document (Extract Common metadara fields from content) : Extraire des méta-données du document
• Importation d’un ensemble de contenu Alfresco (Import Alfresco content package) : Importation d’un ensemble de contenu
• Attaché des catégories au document (Link item to category) :Attacher aux documents une ou des catégories spécifiques
• Déplacer un document dans un espace défini (Move item to a specific space) : Supprimer le document de l’espace actuel et le déplacer vers l’espace défini.
• Supprimer un aspect à un article (Remove an aspect from an item) : Supprimer une propriété ou un ensemble de propriétés aux documents ou à un espace.
• Envoyer un email à des utilisateurs définis (Send an email to spécific users) : envoyer un email à des utilisateurs définis ou groupes d’utilisateurs.
• Définir le type d’un document (Specialize the type of an item) : Définir le type de contenu pour le document (type MIME).
• Transformer et Copier un document dans un espace spécifique (Transform and copy content to a specific space) : Transformation d’un document de type bureautique tel que un ODF vers PDF avec la possibilité de le placer dans un autre espace.
• Transformer et Copier une image dans un espace spécifique (Transform and copy image to a specific space) : Transformation d’un document de type graphique tel qu’un JPG vers le format PNG avec la possibilité de le placer dans un autre espace.
• Blog_post (Blog_post) : Aucune idée, j’ai fait un test mais cela ne marche pas !!! POST sur le Forum attente réponse.
• Incrémentation d’un compteur (Incrément counter) : ????, pas encore testé.

Liste des différents « Aspect » pour l’action correspondant à « Ajouter un ou des aspects »

Liste des aspects

Liste des aspects disponibles quand vous choississez « Ajouter un ou des aspects» :

• Catégorisable (Classifiable) : Activer la notion de catégorisation pour permettre d’attacher des catégories au document.
• Conformité (Complienceable) : Ajouter une propriété de conformité« suppression à partir du (Remove after) » date à laquelle le document n’est plus valide.
• Dublin Core (Dubli core) : Ajouter les métadonnées Dublin Core pour le document. Dublin Core Metadata comprend les méta-données tels que Éditeurs, Auteurs, Sujet, et les Droits.
• Applicabilité (Effectivity) : Ajouter des propriétés d’applicabilité « applicable du (Effective from) » et « applicable au (Effectivity to) » dates pendant les quellles le document est applicable.
• Alias Mail (Email Alias) : Ajouter une propriété d’alias aux documentx ou à un espace.
• Réception de courriel (Emailed) : Ajouter un ensemble de propriétés nommé « Courrier électronique de données (Email data) » sur le document. Cet aspect est utilisé pour récupérer les informations de la messagerie, notamment si le courriel contient des documents en pièce jointe.
• Localisation (Localisable) : Ajoute une propriété de Localisation au document.
• Résumé (Summarizable) : Ajoute une propriété Résumé au document.
• Catégorisation (Taggable) : Ajoute la propriété de « catégorisation (taggable) » au document.
• Modèle (Templatable) : Activer le modèle de vue.
• Multilinguisme (Translatable): Ajouter la propriété « Multilingue (Translations) » au document.
• Versionable (Versionable) : Activer le versioning.

Les Déclencheurs

Lors de la troisième étape, nous aurons le choix de définir quel sera le déclencheurs de notre règle métier. Trois possibilités sont proposées :

1. Entrant (InBound) : Tout document arrivant dans l’espace, qu’il soit nouveau, copié ou déplacé,
2. Sortant (OutBound) :Tout document sortant de l’epace, qu’il soit supprimé ou déplacé,
3. Mise à jour (Update) : Tout document mise à jour, qu’il soit téléchargé ou sauvegardé.

Liste des déclencheurs

Si la règle métier doit s’appliquer dans les trois cas, il faudra créer 3 règles.