Dokos
Documentation
Personnalisations

Paquets

Exporter des personnalisations d'un module dans un paquet versionné, puis l'importer dans un autre site Dokos.

Paquets

Un paquet transporte des personnalisations d'un site Dokos vers un autre. Il regroupe un ou plusieurs modules personnalisés et les documents qui leur sont rattachés. Chaque publication du paquet porte un numéro de version.

Les paquets se trouvent dans l'espace de travail Développement, section Paquets.

Préparer le contenu

  1. Créez un Module Def et cochez Personnalisation.
  2. Rattachez à ce module les documents à transporter, avec leur champ Module.

Le paquet exporte ces types de documents s'ils appartiennent au module :

GroupeTypes de documents
Types de documentType de document, Script client, Script Serveur (Python), Barre latérale
Site webPage Web, Modèle de bloc web, Thème du Site Web, Formulaire web
PersonnalisationEspace de travail, Champ personnalisé, Propriété personnalisée, Format d'impression, Notification

Créer le paquet

  1. Ouvrez la liste Paquet et cliquez sur Créer un·e Paquet.
  2. Saisissez le nom du paquet, puis remplissez Nom du paquet, Lisez-moi, Type de licence et Licence.
  3. Enregistrez.
  4. Ouvrez le module préparé plus tôt et sélectionnez ce paquet dans le champ Paquet.

Publier une version

  1. Ouvrez la liste Publication du paquet et créez une publication.
  2. Sélectionnez le Paquet.
  3. Si besoin, saisissez les numéros Principal, Mineur et Correctif. Sans valeur, Dokos incrémente le numéro de correctif de la dernière publication.
  4. Saisissez les Notes de mise à jour.
  5. Cochez Publié et enregistrez.

Dokos exporte alors les documents des modules dans une archive <nom du paquet>-<version>.tar.gz, par exemple crm_interne-0.0.1.tar.gz. L'archive est jointe à la publication et son URL s'affiche dans le champ Lien.

L'archive est un fichier privé du site (/private/files/<nom du paquet>-<version>.tar.gz), joint à la publication. Seuls les utilisateurs qui peuvent lire la publication peuvent la télécharger. Une archive créée par une version plus ancienne de Dokos peut être publique : ouvrez-la dans la liste Fichier et cochez Est Privé.

Importer un paquet

  1. Sur le site cible, ouvrez la liste Import de paquet et créez un import.
  2. Joignez l'archive .tar.gz dans Attacher le paquet.
  3. Cochez Activer.
  4. Cochez Forcer pour écraser les documents déjà présents, même s'ils sont plus récents.
  5. Enregistrez.

L'import a lieu à l'enregistrement. Le champ Journal liste les fichiers importés.