Initialisation de la configuration de Pristy
Chaque application Pristy (Portail, Espaces, Actes, Marchés, Social) est
configurée par un fichier env-config.json stocké dans le dossier
Pristy - Configuration du Dictionnaire de données d’Alfresco.
L’initialisation de cette configuration se fait depuis l’interface d’administration du Portail Pristy.
Prérequis
Le dossier Pristy - Configuration et les groupes de base (PRISTY_ADMINISTRATORS) sont créés automatiquement au démarrage d’Alfresco par le module pristy-core. Aucune action manuelle n’est nécessaire pour cette étape.
Accéder à l’initialisation
- Connectez-vous au Portail Pristy avec un compte Administrateur Alfresco
- Ouvrez le menu Administration
- Cliquez sur Bootstrap Pristy
Cette page est réservée aux administrateurs Alfresco. Elle n’apparaît pas dans le menu pour les utilisateurs standards.
Assistant d’initialisation
L’assistant guide l’administrateur en quatre étapes.
Étape 1 : Sélection
Choisissez l’application à initialiser et le type d’initialisation :
| Application | Description |
|---|---|
| Portail | Tableau de bord, menus, liens externes |
| Espaces | Espaces de travail collaboratifs |
| Actes | Gestion des actes administratifs |
| Marchés | Marchés publics |
| Social | Réseau social d’entreprise |
| Media | Médiathèque |
Pour chaque application, trois fichiers d’initialisation sont disponibles :
| Fichier | Usage |
|---|---|
| init.yaml | Initialisation complète (groupes, utilisateurs, sites, dossiers, fichiers, permissions) |
| init-emails.yaml | Modèles d’e-mails uniquement |
| init-env-config.yaml | Configuration env-config.json uniquement |
Pour une première installation, utilisez init.yaml qui crée l’ensemble de la structure nécessaire. Pour une mise à jour de configuration sur un serveur existant, init-env-config.yaml suffit.
Étape 2 : Variables
Si le fichier d’initialisation contient des variables (mots de passe, noms de domaine…), l’assistant affiche un formulaire pour les renseigner.
Les mots de passe sont pré-remplis avec une valeur aléatoire sécurisée. Les autres variables affichent leur valeur par défaut que vous pouvez modifier.
Cette étape est ignorée si le fichier ne contient aucune variable.
Étape 3 : Plan (prévisualisation)
L’assistant analyse le fichier et affiche un résumé des actions prévues :
- Créer : éléments qui n’existent pas encore sur le serveur
- Existant : éléments déjà présents (ignorés)
- Mettre à jour : éléments à modifier
Le détail est affiché par phase (utilisateurs, groupes, membres, sites, dossiers, fichiers, permissions).
Aucune modification n’est effectuée à cette étape. Vous pouvez vérifier le plan avant de l’exécuter.
Étape 4 : Exécution
Cliquez sur Exécuter pour appliquer les actions. La progression s’affiche en temps réel. À la fin, un résumé indique le nombre d’éléments créés, mis à jour ou ignorés.
Cas d’usage courants
Première installation
Après le déploiement d’un serveur Pristy, lancez l’initialisation complète pour chaque application déployée :
- Portail →
init.yaml - Espaces →
init.yaml - Autres applications selon le besoin
Cela crée les groupes, les dossiers de configuration, les fichiers
env-config.json et les permissions.
Mise à jour de la configuration
Pour modifier la configuration d’une application (par exemple activer un module ou changer un paramètre) :
- Portail →
init-env-config.yaml - Vérifiez le plan (l’env-config existant apparaît comme « Mettre à jour »)
- Exécutez
Mise à jour des modèles d’e-mails
Pour déployer ou mettre à jour les modèles d’e-mails Alfresco (notifications, invitations, réinitialisation de mot de passe) :
- Portail →
init-emails.yaml - Exécutez
Méthode manuelle (curl)
Pour une mise à jour ponctuelle d’un seul fichier de configuration, il est
possible d’utiliser curl directement :
ALF_ADMIN=admin
ALF_PASS=
curl -X PUT https://server.pristy.net/alfresco/s/fr/jeci/pristy/config/espaces/env-config.json \
--user "${ALF_ADMIN}:${ALF_PASS}" \
-H 'Content-Type: application/json' \
--data "@/chemin/vers/env-config.json"
Remplacer espaces dans l’URL par le nom de l’application cible (portail,
actes, marches, social).
La méthode curl envoie le fichier tel quel sans fusion avec la
configuration existante. Assurez-vous que le fichier contient tous les
paramètres nécessaires.
Dernière modification - 30 avril 2026