Gestion des modèles

Cette fonction est déconseillée en production : elle doit être utilisée uniquement en phase de conception.

La création et l’édition d’un modèle sont accessibles aux administrateurs Pristy (membres du groupe GROUP_PRISTY_ADMINISTRATORS) ou aux super administrateurs. En revanche, le déploiement d’un modèle dans le référentiel ainsi que son activation/désactivation sont réservés aux super administrateurs - voir la section dédiée plus bas.

La gestion des modèles permet de construire un modèle de contenu (content model) Alfresco personnalisé - types, aspects, propriétés, associations et contraintes - sans écrire de XML à la main, puis de le déployer dans le référentiel.

Accéder à la gestion des modèles

Pour accéder à la gestion des modèles, cliquez sur l’entrée Gestion des modèles dans la section « Portail Administrateur » du menu latéral. La page s’intitule « Gestion des modèles de données ».

Créer ou sélectionner un modèle

Trois façons de commencer à travailler sur un modèle :

  • Nouveau modèle : ouvre une fenêtre de création avec les champs Nom du modèle, Préfixe, Namespace, Description et Auteur. Le nom, le préfixe et le namespace sont obligatoires et validés à la création :
    • le nom doit commencer par une lettre et ne contenir que des lettres, chiffres, tirets et underscores ;
    • le préfixe doit commencer par une lettre minuscule et ne contenir que des lettres minuscules et des chiffres ;
    • le namespace doit être une URI http:// ou https:// valide.
  • Importer un XML : téléverse un fichier .xml existant (limité à ce seul format) et reconstruit le modèle dans l’éditeur à partir de son contenu (métadonnées, contraintes, types, aspects, propriétés, associations).
  • Sélectionner un modèle : le sélecteur en haut à droite de l’écran liste les modèles déjà enregistrés (voir “Enregistrer le modèle en cours d’édition” plus bas) et charge le modèle choisi dans l’éditeur.

Importer un XML ou sélectionner un autre modèle remplace intégralement le contenu de l’éditeur en cours, sans avertissement si des modifications n’ont pas été enregistrées au préalable.

Modifier les métadonnées du modèle

Une fois un modèle chargé dans l’éditeur, un premier bloc permet de modifier ses métadonnées : Nom du modèle, Préfixe, Namespace, Description, Auteur, Version.

Gérer les types et les aspects

Le reste de l’écran est organisé en quatre onglets : Types, Aspects, Contraintes et Aperçu XML.

Types et aspects

Les onglets Types et Aspects listent respectivement les types et les aspects du modèle en cours d’édition, avec pour chacun : Nom, Titre, Parent, le nombre de Propriétés et le nombre d’Associations, ainsi que des actions Modifier et Supprimer (avec confirmation).

Le bouton Ajouter un type (ou Ajouter un aspect) ouvre une fenêtre d’édition avec :

  • Nom, Titre, Description
  • Type parent : liste déroulante éditable proposant les parents usuels (cm:content, cm:folder, cm:person, cm:authority, sys:base), mais acceptant aussi la saisie libre d’un autre type
  • Aspects obligatoires (uniquement pour un type, pas pour un aspect) : sélection multiple parmi les aspects déjà définis dans le modèle

Propriétés d’un type ou d’un aspect

Dans la fenêtre d’édition d’un type ou d’un aspect, la section Propriétés permet d’ajouter, modifier ou supprimer une propriété avec les champs suivants :

  • Nom, Titre, Description
  • Type de données : d:text, d:mltext, d:content, d:int, d:long, d:float, d:double, d:date, d:datetime, d:boolean, d:noderef, d:category, d:path, d:qname ou d:locale
  • Obligatoire et Multi-valeur (cases à cocher)
  • Valeur par défaut
  • Indexé : si coché, trois options complémentaires apparaissent - Index atomique, Index stocké, Index tokenisé
  • Contrainte : sélection d’une contrainte parmi celles définies dans l’onglet Contraintes (optionnel)

Associations d’un type ou d’un aspect

La section Associations permet d’ajouter, modifier ou supprimer une association avec :

  • Nom, Titre, Description
  • Association enfant (case à cocher) : détermine si l’association est générée comme child-association (composition) ou comme association simple
  • Source : rôle, obligatoire, multiple
  • Cible : classe cible (obligatoire), rôle, obligatoire, multiple

Définir des contraintes

L’onglet Contraintes liste les contraintes du modèle (Nom, Type), avec des actions Modifier et Supprimer. Le bouton Ajouter une contrainte ouvre une fenêtre avec :

  • Nom (obligatoire)
  • Type : LIST, REGEX, LENGTH ou MINMAX
  • Valeurs autorisées : liste de valeurs saisies une par une

Quel que soit le type choisi, l’éditeur génère la contrainte dans le XML sous la forme d’un paramètre allowedValues listant les valeurs saisies. Ce paramétrage convient nativement au type LIST ; pour les types REGEX, LENGTH ou MINMAX, [À vérifier] il pourra être nécessaire de retoucher le XML exporté pour respecter le format de paramètre attendu par Alfresco (expression, minLength/maxLength, minValue/maxValue, etc.).

Prévisualiser le XML généré

L’onglet Aperçu XML affiche, dans un éditeur CodeMirror en lecture seule avec numéros de ligne, le XML généré à partir du modèle en cours d’édition. Cet aperçu se met à jour automatiquement à chaque modification ; il ne peut pas être édité directement depuis cet onglet.

Importer et exporter le XML

  • Importer un XML (bouton dans la barre d’outils principale, voir plus haut) : charge un fichier .xml existant dans l’éditeur.
  • Exporter en XML : télécharge le XML actuellement généré sous forme de fichier <nom-du-modèle>.xml, sans passer par le référentiel Alfresco - pratique pour sauvegarder ou partager un modèle avant de le déployer.

Enregistrer le modèle en cours d’édition

Le bouton Enregistrer sauvegarde le modèle en cours d’édition dans la configuration de l’application Pristy (au format JSON). Cette sauvegarde est indépendante du référentiel Alfresco : elle permet de reprendre l’édition plus tard via le sélecteur de modèle, mais ne déploie pas le modèle dans le référentiel.

Enregistrer un modèle édité et le déployer dans le référentiel sont deux actions distinctes - voir la section suivante.

Déployer le modèle dans le référentiel (super administrateurs)

Une fois un modèle activé, Alfresco contrôle chaque redéploiement et refuse toute modification non incrémentale, que le modèle soit déjà utilisé par du contenu ou non. Testez vos modèles sur un environnement non critique avant tout déploiement en production.

Sur un modèle actif, Alfresco accepte :

  • l’ajout de types, d’aspects, de propriétés, d’associations et de contraintes,
  • la modification des titres, descriptions et valeurs par défaut,
  • le passage d’une propriété d’obligatoire à facultative, ou de protégée à modifiable,
  • la modification des valeurs d’une contrainte existante.

Il refuse en revanche :

  • la suppression d’un type, d’un aspect ou d’une association,
  • la suppression d’une propriété utilisée par au moins un nœud, ou d’une contrainte référencée par une propriété,
  • le changement du type parent, du type de données d’une propriété, de son caractère multivalué ou de son indexation,
  • le passage d’une propriété de facultative à obligatoire,
  • l’ajout d’un aspect obligatoire à un type ou à un aspect.

La désactivation d’un modèle est refusée tant qu’un de ses types ou aspects est utilisé par un nœud, y compris un nœud placé dans la corbeille, ou par une définition de workflow.

Si l’utilisateur connecté n’est pas super administrateur, un message d’information rappelle que le déploiement et l’activation/désactivation des modèles nécessitent des droits d’administrateur, et les boutons correspondants n’apparaissent pas.

Déployer ou redéployer

Le bouton Déployer le modèle (ou Redéployer le modèle si un modèle déjà déployé porte le même préfixe et le même nom) ouvre une fenêtre de confirmation qui rappelle l’emplacement de dépôt du fichier XML (/app:company_home/app:dictionary/app:models/), avec une option Activer le modèle immédiatement après le déploiement.

Cocher l’activation immédiate fait valider le modèle par Alfresco, qui recharge ensuite son dictionnaire de modèles. Un modèle invalide, ou une modification refusée (voir plus haut), fait échouer l’activation. Assurez-vous que le modèle est correct avant de l’activer.

Si un modèle portant le même préfixe et le même nom est déjà déployé, le déploiement met à jour le fichier XML et ses propriétés existantes plutôt que de créer un doublon.

Activer ou désactiver un modèle déjà déployé

Une fois le modèle déployé, deux boutons apparaissent selon son état d’activation :

  • Activer le modèle, s’il est actuellement désactivé
  • Désactiver le modèle, s’il est actuellement actif - une confirmation est demandée, avec un avertissement sur l’impact possible pour le contenu existant qui utilise ce modèle

Dernière modification - 5 novembre 2026
Appel à l’action

Essayer Pristy

Vous pouvez essayer la démo de Pristy en vous inscrivant au lien ci-dessous.

Demander une démo