Bootstrap Pristy
Cette page est réservée aux super administrateurs. L’appartenance seule au groupe GROUP_PRISTY_ADMINISTRATORS ne donne pas accès à cette page : l’entrée Bootstrap Pristy n’apparaît dans le menu latéral que pour un utilisateur disposant de la capacité d’administration native Alfresco. Un utilisateur non habilité qui accède directement à l’URL voit le message « Cette page est réservée aux super administrateurs. ».
Bootstrap Pristy initialise une instance Pristy : création de comptes et de groupes, d’espaces de travail, de dossiers, dépôt de modèles de courriel, écriture de fichiers de configuration et de permissions. Chaque application sert ses propres plans d’initialisation, des fichiers au format YAML.
La page comporte deux onglets :
- Configuration commune : la liste des applications de l’instance,
- Configuration par application : l’assistant qui applique un plan d’initialisation.
Pour modifier ensuite un paramètre de configuration d’une application, la Page de configuration est le chemin naturel.
Accéder à la page
Cliquez sur l’entrée Bootstrap Pristy dans la section « Portail Administrateur » du menu latéral.
Configuration commune
Cet onglet règle la liste des applications proposées par le sélecteur d’applications et par les liens du menu latéral de Pristy Portail. Cette liste vaut pour toute l’instance : elle est enregistrée dans la configuration commune (clé APPLICATIONS), lue par chaque application avant sa propre configuration.
Une étiquette indique si la configuration commune existe déjà (« Fichier commun présent ») ou non (« Aucun fichier commun »).
Le formulaire présente :
- l’URL de base de l’instance : le bouton Remplir reconstruit l’adresse de chaque application à partir de cette URL,
- une ligne par application : un interrupteur pour la proposer ou non, son icône (cliquez dessus pour en choisir une autre) et son adresse. Les applications propres à l’instance, inconnues du catalogue Pristy, sont listées après les autres et conservées telles quelles.
Trois boutons :
- Initialiser (aucune configuration commune) ou Réinitialiser (configuration existante, après confirmation) remplit le formulaire avec toutes les applications du catalogue, construites sur l’URL de base,
- Enregistrer écrit la liste dans le référentiel. Les autres clés de la configuration commune sont conservées.
Initialiser et Réinitialiser remplissent le formulaire, sans écrire : rien n’est envoyé au serveur avant Enregistrer. Si aucune application n’est activée, le sélecteur d’applications restera vide.
Configuration par application
L’assistant se déroule en quatre étapes : Sélection, Variables, Plan d’exécution et Exécution. Un plan peut être relancé sans risque : chaque élément déjà présent est signalé comme existant ou mis à jour, jamais dupliqué.
Étape 1 - Sélection
Choisissez l’Instance qui sert le plan, en cliquant sur sa tuile : Portail, Espaces, Marches, Social, Media, Actes, ou Autre… pour saisir une URL de base personnalisée, complète (par exemple https://example.com/espaces/).
Pour une instance de la liste (hors Portail), l’URL de base est déterminée à partir de l’adresse configurée pour cette application ; pour Portail, l’origine de la page courante est utilisée.
Les plans proposés par l’application s’affichent ensuite sous Fichier d’initialisation, une tuile par plan avec son titre, sa description et son nom de fichier. Cette liste est lue dans le manifeste de l’application (init-manifest.yaml). Sans manifeste, un avertissement s’affiche et la liste par défaut est proposée, dont les fichiers peuvent ne pas exister :
| Fichier | Titre | Contenu |
|---|---|---|
init.yaml | Initialisation | Groupes, comptes de service, dossiers et fichiers de configuration nécessaires à l’application |
init-demo.yaml | Démonstration | Comptes, espaces de travail et adhésions de démonstration, dont les noms sont modifiables |
init-emails.yaml | Modèles de courriel | Modèles FreeMarker de notification, d’invitation et de réinitialisation de mot de passe |
init-env-config.yaml | Configuration du portail | Le fichier env-config.json de l’application |
init.yaml ne crée aucun compte ni espace de démonstration : il peut être appliqué à une instance de production. init-demo.yaml s’applique après init.yaml, dont il utilise les groupes.
Le bouton Charger télécharge le plan choisi et l’analyse. Une erreur de chargement ou de lecture du YAML s’affiche sous les champs, sans quitter cette étape.
Étape 2 - Variables
Le plan peut contenir des variables, sous la forme {{ nom_variable }} ou {{ nom_variable | default(valeur) }}. L’assistant propose un champ pour chacune, avec un libellé fourni par le plan et le nom de la variable :
- une valeur par défaut
trueoufalseaffiche un interrupteur. Un interrupteur peut inclure ou exclure des éléments optionnels du plan (un plan de classement de démonstration, par exemple) : les champs qui ne servent qu’aux éléments exclus sont masqués, - un mot de passe aléatoire est généré au chargement et affiché en clair, avec un bouton Régénérer : il sera celui du compte créé,
- toute autre variable affiche un champ texte, pré-rempli avec sa valeur par défaut.
Les variables utilisées par les fichiers externes référencés par le plan (propriété source) sont aussi proposées. Un fichier externe introuvable ou illisible est ignoré sans message à l’écran.
Si le plan ne contient aucune variable, cette étape est sautée. Le bouton Analyser lance la comparaison avec le référentiel.
Étape 3 - Plan d’exécution
L’assistant compare chaque élément du plan avec le référentiel, puis l’affiche, phase par phase : Utilisateurs, Groupes, Membres, Sites, Membres de sites, Configurations, Dossiers, Fichiers, Permissions. Trois compteurs résument le plan : éléments à créer, existants et à mettre à jour.
Chaque ligne porte un statut :
- Créer : l’élément n’existe pas,
- Existant : l’élément existe et ne demande rien,
- Mettre à jour : l’élément existe et sera réécrit,
- Erreur : la comparaison a échoué, le détail s’affiche sous le statut.
Les utilisateurs, groupes, adhésions, sites, membres de sites et dossiers sont comparés sur leur seule existence. Les fichiers et configurations sont comparés sur leur contenu : un contenu identique est marqué Existant, et un plan réappliqué à une instance à jour ne réécrit rien.
- Un fichier est comparé par son empreinte
SHA-256, calculée par Pristy Core. Si l’empreinte du fichier en place n’est pas disponible, le fichier est marqué Mettre à jour, avec une icône « Empreinte indisponible ». C’est toujours le cas lorsque Pristy Core ne propose pas la capacitéhash.content(version antérieure à 4.9, ou empreintes désactivées). - Une configuration est comparée en
JSON, sans tenir compte de l’ordre des clés.
Pour un fichier ou une configuration différent, le bouton Diff ouvre une comparaison côte à côte : « Contenu en place » à gauche, « Contenu du plan » à droite. Les fichiers binaires n’ont pas de comparaison.
Cliquer sur l’étiquette Créer ou Mettre à jour d’une ligne applique cet élément seul, sans passer par l’étape 4.
Avant de cliquer sur Appliquer, vérifiez chaque ligne, en particulier les éléments marqués Mettre à jour, qui écrasent un contenu existant. Les Permissions d’un dossier sont toujours marquées Mettre à jour.
Le bouton Retour réinitialise l’assistant à l’étape 1. Le bouton Appliquer est désactivé si le plan ne contient aucun élément à créer ou à mettre à jour ; sinon, il lance l’exécution du plan entier.
Étape 4 - Exécution
L’assistant applique chaque élément du plan dans l’ordre du tableau, sauf les éléments Existant. Les éléments marqués Erreur à l’étape 3 sont retentés. Un indicateur signale la ligne en cours ; le détail d’une erreur s’affiche sous le statut de la ligne concernée.
À la fin, un message récapitule le nombre d’éléments créés et mis à jour, et le nombre d’erreurs éventuelles.
Comptes créés
Chaque compte créé par l’exécution (plan entier ou ligne seule) est listé dans le panneau Comptes créés, avec son identifiant et son mot de passe. Le bouton Copier les identifiants les copie dans le presse-papiers, un compte par ligne. Un compte déjà existant garde son mot de passe et n’est pas listé.
Notez ces mots de passe immédiatement : ils ne sont conservés nulle part et ne sont plus affichés après avoir quitté la page.
Le bouton Retour réinitialise l’assistant à l’étape 1, ce qui permet d’enchaîner par exemple sur init-demo.yaml après init.yaml.
Cas d’usage courants
Première installation
Après le déploiement d’un serveur Pristy :
- dans l’onglet Configuration commune, initialisez puis enregistrez la liste des applications,
- appliquez
init.yamlde chaque application déployée (Portail, Espaces, puis les autres selon le besoin), - pour une instance de démonstration, appliquez ensuite
init-demo.yaml.
Mise à jour des modèles de courriel
Appliquez init-emails.yaml depuis l’instance Portail.
Le dossier Pristy - Configuration du Dictionnaire de données et le groupe PRISTY_ADMINISTRATORS sont créés au démarrage d’Alfresco par Pristy Core : ils ne demandent aucune action manuelle.
Dernière modification - 5 novembre 2026