diff --git a/_install/dependencies.json b/_install/dependencies.json
index 4263cbdeb9d85310b9c5b5c60927bf3004ad7104..095325c0804af183b9cedddb8e844b1dd19216a8 100644
--- a/_install/dependencies.json
+++ b/_install/dependencies.json
@@ -29,7 +29,7 @@
],
"default_description": "# Bienvenue dans vMap ! \n\nPlus d'information sur [http:\/\/www.veremes.com](http:\/\/www.veremes.com)",
"default_theme": "6",
- "branch": "master",
+ "branch": "next_version",
"name": "vmap",
"enable_custom_restrictions": false,
"url": "git@gitlab.veremes.net:Development/vitis-2020/applications/vmap.git",
@@ -62,7 +62,7 @@
"name": "module_vmap",
"url": "git@gitlab.veremes.net:Development/vitis-2020/sources/module_vmap.git"
}, {
- "branch": "master",
+ "branch": "next_version",
"name": "module_cadastre",
"url": "git@gitlab.veremes.net:Development/vitis-2020/sources/module-cadastre-2020.git"
}]
diff --git a/bin/mount_project.sh b/bin/mount_project.sh
index 827a027ddd63de17c1303167aee05500878ff04d..9aa9e88fa36888f0edada0f911651aa04ac1fd59 100755
--- a/bin/mount_project.sh
+++ b/bin/mount_project.sh
@@ -35,18 +35,28 @@ then
echo "---- Mount module's assets folder ----"
sudo mount --bind src/vitis/client client
mkdir -p client/src/modules/vmap
- sudo mount --bind src/module_vmap/module client/src/modules/vmap
+ # Mount les assets de vmap
+ for subfolder_vmap in "src/module_vmap/module"/*/; do
+ subfolder_vmap_name=$(basename "$subfolder_vmap")
+ # Vérifie si le dossier ne s'appelle pas "components"
+ if [ "$subfolder_vmap_name" != "components" ]; then
+ # Crée le dossier dans le dossier de destination
+ mkdir -p "client/src/modules/vmap/$subfolder_vmap_name"
+ sudo mount --bind "src/module_vmap/module/$subfolder_vmap_name" "client/src/modules/vmap/$subfolder_vmap_name"
+ echo "Dossier '$subfolder_vmap_name' monté dans 'client/src/modules/vmap'."
+ fi
+ done
mkdir -p client/src/conf
sudo mount --bind conf client/src/conf
- # Motage des modules Angular
+ # Montage des modules Angular
if [ -f conf/modules-components.ts ]; then
cp -f conf/modules-components.ts src/vitis/client/src/app/modules/modules-components.ts
else
cp -f src/vitis/client/src/app/modules/modules-components.sample.ts src/vitis/client/src/app/modules/modules-components.ts
fi
if [ -d src/module_vmap/module/components ]; then
- mkdir src/vitis/client/src/app/modules/vmap
+ mkdir -p src/vitis/client/src/app/modules/vmap
sudo mount --bind src/module_vmap/module/components client/src/app/modules/vmap
fi
fi
diff --git a/doc/source/administrator/impression/impressions.md b/doc/source/administrator/impression/impressions.md
new file mode 100644
index 0000000000000000000000000000000000000000..88089a4b442c8c9a739b85bdf0738fbff4c55ead
--- /dev/null
+++ b/doc/source/administrator/impression/impressions.md
@@ -0,0 +1,207 @@
+# Impressions
+
+Le mode `Impressions` est une fonctionnalité de vMap qui permet d'imprimer une carte pour en générer un document PDF.
+
+Couplées aux notions de paramètres et de styles, les impressions sont personnalisables autant par leur contenu que par leur rendu.
+
+Elles offrent à l'administrateur 4 possibilités de personnalisation :
+
+- La mise en place de modèles : Pour concevoir et ajuster des modèles d'impression.
+- La mise en place de paramètres : Pour personnalisé le rendu final par des libellé propres à l'utilisateur
+- La mise en place de styles : Pour personnaliser le style de l'impression réalisée (logo, couleur...) en fonction de l'utilisateur qui est connecté
+- La mise en place d'échelles d'impression : Pour permettre de réaliser des impressions à des échelles précises
+
+
+
+## Configuration générale
+
+Avant toute chose, pour qu'un utilisateur ait la possibilité d'imprimer sa carte, il faut :
+- Qu'il en possède les droits
+- Que l'administrateur ait ajouté le bouton d'impression sur la carte
+
+#### 1- Donner les droits d'impression aux utilisateurs
+
+Pour qu'un utilisateur ait les droits d'impression, il faut que son compte soit associé à un groupe qui possède au moins un modèle d'impression (cf. [Documentationdesgroupes](../rights/group.md)) [Documentation des groupes](http://documentation.veremes.net/vmap2/administrator/rights/group.html).
+
+#### 2- Ajouter le bouton d'impression sur la carte
+
+La seconde condition pour qu'un utilisateur puisse réaliser une impression, c'est que l'administrateur ait ajouté le bouton (cf. image ci-dessous) sur la carte. Cette fonctionnalité est paramétrable carte par carte afin de permettre à l'administrateur d'adapter son application en fonction des besoins..
+
+
+_<center>Icône de l'impression à ajouter dans la barre latérales ou inférieures de la carte.</center>_
+
+
+Exemple :
+
+
+
+
+## Modèles d'impression
+
+Les Modèles d'impression sont des templates utilisés pour obtenir le rendu principal de l'impression. Ils permettent de définir et ajuster la disposition, le contenu et le format des cartes imprimées en assurant une présentation cohérente et personnalisée selon les besoins spécifiques de l'utilisateur.
+
+Pour créer un modèle, cliquer sur `Ajouter` depuis le mode `Impressions` > ` Modèle d'impressions` et remplir l'ensemble des informations demandées par le formulaire (un nom, un format de page, une orientation, les groupes d'utilisateurs autorisés à utiliser ce modèle, ainsi qu'une définition HTML).
+
+Chaque modèle d'impression peut être personnalisé à partir de variable afin de récupérer les images de la carte, la légende, des informations sur l'utilisateur qui lance l'impression...
+
+Voici les différentes variable et balises utilisables dans les impressions :
+
+### 1- Variables / balises correspondant aux images
+
+3 balises sont disponibles :
+
+- `map_image` : Image de la carte. Balise à intégrer dans un élément `HTML` de type `img`.
+- `map_overview` : Image dde l'overview (mini carte). Balise à intégrer dans un élément `HTML` de type `img`.
+- `map_legend` : Image de la légende. Balise à intégrer dans un élément `HTML` de type `div`.
+
+Dans le cas d'une carte en comparaison, il est aussi possible de récupérer la carte et la légende comparée. Dans ce cas, les noms des balises sont un peu différents :
+
+- `map_image_compare_1` : Image de la carte de gauche. Balise à intégrer dans un élément `HTML` de type `img`.
+- `map_image_compare_2` : Image de la carte de droite. Balise à intégrer dans un élément `HTML` de type `img`.
+- `map_legend_compare` : Image de la légende de la carte de comparaison. Balise à intégrer dans un élément `HTML` de type `div`.
+
+Exemple permettant d'afficher l'image de la carte dans une impression (balise `map_image`) :
+
+Partie `HTML` :
+
+```
+<img id="map_image" class="map_image" src="images/transparent.png">
+```
+
+La taille de l'image est définie dans la partie CSS de la définition du modèle :
+
+```
+.map_image {
+ background-color: #D8D8D8 !important;
+ height: 22cm;
+ width: 14cm;
+ border: 1px solid black;
+}
+```
+
+Exemple permettant d'afficher la légende de la carte dans une impression (balise `map_image`) :
+
+Partie `HTML` :
+
+```
+<!-- Mode normal -->
+<div ng-if="!compare_mode" class="container" style="top: 5cm; left: 1.5cm;">
+ <label class="legend_headline">Légende</label><br>
+ <div id="map_legend" ng-if="map_legend">
+ <div ng-repeat="legendLayer in map_legend">
+ <div ng-repeat="legend in legendLayer.legendObjects" class="legend_object">
+ <div class="legend_layer_name">{{ legend.layerName }}</div><br>
+ <img ng-src="{{ legend.legendURL }}" class="legend_image" />
+ </div>
+ </div>
+ </div>
+</div>
+```
+
+```
+<!-- Mode comparaison -->
+<div ng-if="compare_mode" class="container" style="top: 5cm; left: 1.5cm;">
+ <div id="map_legend" ng-if="map_legend">
+ <label class="legend_headline">Légende 1</label>
+ <div ng-repeat="legendLayer in map_legend">
+ <div ng-repeat="legend in legendLayer.legendObjects" class="legend_object">
+ <div class="legend_layer_name">{{ legend.legendName }}</div>
+ <img ng-src="{{ legend.legendURL }}" class="legend_image" />
+ </div>
+ </div>
+ </div>
+ <div id="map_legend_compare" ng-if="map_legend_compare">
+ <label class="legend_headline">Légende 2</label>
+ <div ng-repeat="legendLayer in map_legend_compare">
+ <div ng-repeat="legend in legendLayer.legendObjects" class="legend_object">
+ <div class="legend_layer_name">{{ legend.legendName || legend.layerName }}</div>
+ <img ng-src="{{ legend.legendURL }}" class="legend_image" />
+ </div>
+ </div>
+ </div>
+</div>
+```
+
+Partie `CSS` :
+
+```
+.map_legend {
+ width: 3cm;
+ margin-top: 16px;
+}
+
+#map_legend_compare {
+ margin-top: 100px;
+}
+
+.map_legend_compare_mode {
+ width: 3cm;
+ margin-top: 16px;
+}
+```
+
+
+
+### 2- Autres variables disponibles
+
+En plus de pouvoir intégrer dynamiquement des images dans l'impression, vMap donne la possibilité d'intégrer de nombreuses valeurs faisant référence :
+- à l'utilisateur qui réalise l'impression
+- à des informations de la carte
+- ou encore à la date
+
+Ces informations doivent être ajoutées dans la définition `HTML` encadrées par des accolades (Exemple `{{date}}`) :
+
+- `map_scale` : échelle de la carte imprimée
+- `date` : date du jour
+- `date_hour` : date + heure du jour
+- `layer_sources` : sources des couches
+- `map_legend`: légende de la carte principale
+- `user_name` : nom de l”utilisateur
+- `user_login` : login de l”utilisateur
+- `user_company` : société de l”utilisateur
+- `user_department` : service de l”utilisateur
+- `user_email` : adresse mail de l”utilisateur
+- `user_id` : identifiant de l'utilisateur
+
+### 2- Directives Utilisables dans la définition modèle :
+
+- `ng-if="map_legend"` : Cette directive AngularJS conditionne l'affichage de la légende. Le contenu n'est affiché que si la variable `map_legend` existe et contient des données.
+- `ng-repeat="legendLayer in map_legend"` : Cette directive permet de parcourir chaque élément de la variable `map_legend`. Pour chaque élément (qui représente un calque de la légende), une nouvelle `<div>` est créée.
+- `ng-repeat="legend in legendLayer.legendObjects"` : À l'intérieur de chaque calque de légende, cette directive parcourt les objets de la légende (les éléments individuels à afficher). Pour chaque objet, une nouvelle `<div>` est créée avec la classe `legend_object`.
+- `{{ legend.layerName }}` : Cette interpolation affiche le nom du calque de la légende.
+- `ng-src="{{ legend.legendURL }}"` : Cette directive AngularJS lie dynamiquement l'URL de l'image de la légende à l'attribut `src` de la balise `<img>`. Cela permet d'afficher l'image correspondante à chaque élément de la légende.
+
+## Styles d'impression
+
+Le "style" d'impressions permettent à l'application de pouvoir définir un style différent pour chaque utilisateur.
+Configurés par l'administrateur et définis en HTML avec des balises de styles CSS, les styles surchargent ceux du modèle d'impression utilisé et peuvent, entre autres, impacter les couleurs, les espacements, un logo etc.
+
+
+
+### Exemple de modification du logo dans une impression
+
+Pour modifier le logo dans le header du modèle d'impression par défaut de vMap, nommé "Modèle par défaut", il faut tout d'abord identifier la balise contenant l'image à rendre variable en fonction de l'utilisateur qui est connecté. Cette balise peut être identifiée grâce à sa classe et celle-ci doit être unique.
+
+
+
+Une fois la balise détectée, créer un style d'impression en cliquant sur `Ajouter` depuis le mode `Impressions` > ` Style d'impressions` et remplir l'ensemble des informations demandées par le formulaire (un nom, les utilisateurs associés à ce style ainsi qu'une définition CSS).
+
+Dans l'exemple évoqué, celui de rendre variable le logo du modèle d'impression, voici un bout de code CSS, qui remplace le contenu de la balise `image` avec la classe `logo` par l'image en base 64 mentionnée en CSS.
+
+```
+<style>
+ .logo {
+ content: url('data:image/png;base64,...');
+ }
+</style>
+```
+
+Ce style va surcharger le logo existant dans le modèle d'impression par défaut avec la nouvelle image fournie.
+
+## Échelles
+
+L'outil d'impression de vMap inclut une liste d'échelles permettant aux utilisateurs d'imprimer une carte à une échelle bien précise.
+
+
+
+Cette liste d'échelle est paramétrable à partir du mode `Impressions` > `Echelles d'impression` de l'application vMap.
\ No newline at end of file
diff --git a/doc/source/administrator/index.rst b/doc/source/administrator/index.rst
index 35c909c64e97821788e17718be942245baa22830..0c623d012933b8f51212588bc75ffaf21d2c4c29 100644
--- a/doc/source/administrator/index.rst
+++ b/doc/source/administrator/index.rst
@@ -12,6 +12,7 @@ Il est conseillé aux administrateurs de consulter en premier la `Documentation
authentification/index.rst
rights/index.rst
+ impression/impressions.md
users.md
rapports/index.rst
configuration/index.rst
diff --git a/doc/source/images/administrator/impressions/ajouter_outil_impression_dans_la_carte.png b/doc/source/images/administrator/impressions/ajouter_outil_impression_dans_la_carte.png
new file mode 100644
index 0000000000000000000000000000000000000000..82b4e1d0131310e0d3d732402a50259b047f99e7
Binary files /dev/null and b/doc/source/images/administrator/impressions/ajouter_outil_impression_dans_la_carte.png differ
diff --git a/doc/source/images/administrator/impressions/echelles.png b/doc/source/images/administrator/impressions/echelles.png
new file mode 100644
index 0000000000000000000000000000000000000000..ed1194af82b961e2f031af73fb96120d764da474
Binary files /dev/null and b/doc/source/images/administrator/impressions/echelles.png differ
diff --git a/doc/source/images/administrator/impressions/exemple-boucle-map-legende.png b/doc/source/images/administrator/impressions/exemple-boucle-map-legende.png
new file mode 100644
index 0000000000000000000000000000000000000000..140940eee74988c89db7818108aa12b4152d985d
Binary files /dev/null and b/doc/source/images/administrator/impressions/exemple-boucle-map-legende.png differ
diff --git a/doc/source/images/administrator/impressions/html_logo.png b/doc/source/images/administrator/impressions/html_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..839b0dfc8f8ca290c51230859ea2308b3bd8e4a3
Binary files /dev/null and b/doc/source/images/administrator/impressions/html_logo.png differ
diff --git a/doc/source/images/administrator/impressions/icon_outil_impression.png b/doc/source/images/administrator/impressions/icon_outil_impression.png
new file mode 100644
index 0000000000000000000000000000000000000000..c60eee4a71722bb2ac528e84210a602cff8b3b2b
Binary files /dev/null and b/doc/source/images/administrator/impressions/icon_outil_impression.png differ
diff --git a/doc/source/images/administrator/impressions/mode_impressions.png b/doc/source/images/administrator/impressions/mode_impressions.png
new file mode 100644
index 0000000000000000000000000000000000000000..858d6ec60fb3d50217f03691cc3719204c4840a0
Binary files /dev/null and b/doc/source/images/administrator/impressions/mode_impressions.png differ
diff --git a/doc/source/images/administrator/impressions/selection_du_style_des_impressions.png b/doc/source/images/administrator/impressions/selection_du_style_des_impressions.png
new file mode 100644
index 0000000000000000000000000000000000000000..b98415fd7b89954ac61e99aae6e6acba467e6818
Binary files /dev/null and b/doc/source/images/administrator/impressions/selection_du_style_des_impressions.png differ
diff --git a/doc/source/images/installation/lancement_exe.jpg b/doc/source/images/installation/lancement_exe.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c1f78da7e850afd7f65d073328af69e9a06e8f75
Binary files /dev/null and b/doc/source/images/installation/lancement_exe.jpg differ
diff --git a/doc/source/installation/installation.md b/doc/source/installation/installation.md
index 91c6122f1f2fc4df750b5a4bb01430e90f2cdd29..1f9208295ec0242674d897bbbec261c696bf2af1 100644
--- a/doc/source/installation/installation.md
+++ b/doc/source/installation/installation.md
@@ -20,11 +20,11 @@ Les variables à modifier pour l’installation sont :
+-----------------------+--------------------------------------------------------------------------------------------------------+
| Variable | Description |
+=======================+========================================================================================================+
-| API_ALIAS | Alias pour accéder à l'API de vMap2 (par défaut : /rest) |
+| API_ALIAS | Alias pour accéder à l'API de vMap2 (par défaut : /rest) |
+-----------------------+--------------------------------------------------------------------------------------------------------+
-| APP_ALIAS | Alias pour accéder au client de vMap2 (par défaut : /vmap) |
+| APP_ALIAS | Alias pour accéder au client de vMap2 (par défaut : /vmap) |
+-----------------------+--------------------------------------------------------------------------------------------------------+
-| WMS_ALIAS | Alias pour accéder au Mapserver de vMap2 (par défaut : /mws) |
+| WMS_ALIAS | Alias pour accéder au Mapserver de vMap2 (par défaut : /mws) |
+-----------------------+--------------------------------------------------------------------------------------------------------+
| HTTPSERVER_PATH | Chemin jusqu'au répertoire d'Apache24 (C:/.../Apache24/conf pour Windows et /etc/apache2 pour linux) |
+-----------------------+--------------------------------------------------------------------------------------------------------+
@@ -40,13 +40,82 @@ Les variables à modifier pour l’installation sont :
+-----------------------+--------------------------------------------------------------------------------------------------------+
| POSTGRES_PASSWORD | Mot de passe du compte superutilisateur |
+-----------------------+--------------------------------------------------------------------------------------------------------+
-| SRID | Système de projection du modèles de données du module Cadastre (par défaut : 2154) |
+| SRID | Système de projection du modèle de données du module Cadastre (par défaut : 2154) |
+-----------------------+--------------------------------------------------------------------------------------------------------+
-| WMS_ALIAS | Alias pour accéder au service WMS (par défaut : /wms) |
+| WMS_ALIAS | Alias pour accéder au service WMS (par défaut : /wms) |
+-----------------------+--------------------------------------------------------------------------------------------------------+
```
+```{warning}
+Les valeurs par défaut du `dependencies.json` peuvent être différents des exemples ci-dessous en fonction du système d'exploitation (Linux ou Windows).
+```
+
+Au niveau du fichier `dependencies.json`, ces trois paramètres sont suceptibles de nécessiter une adaptation en fonction de vos alias Apache (par défaut, ceux-ci sont corrects) :
+
+```js
+{
+ "API_ALIAS": "/rest",
+ "APP_ALIAS": "/vmap",
+ ...
+ "WMS_ALIAS": "/wms",
+ ...
+}
+```
+
+Les clés, dans l'ordre, correspondent aux informations suivantes :
+
+- `API_ALIAS` : **Alias apache vers l'API.**
+- `APP_ALIAS` : **Alias apache vers l'application/client Angular.**
+- `WMS_ALIAS` : **Alias vers le service des flux WMS (Mapserver).**
+
+Il faut également adapter les chemins d'installation et le hostname de la machine :
+
+```js
+{
+ ...
+ "HOSTNAME": "",
+ "HTTPSERVER_PATH": "/etc/apache2",
+ "INSTALL_PATH": "/var/www/vmap",
+ ...
+}
+```
+
+Les clés, dans l'ordre, correspondent aux informations suivantes :
+
+- `HOSTNAME` : **Nom de la machine.**
+- `HTTPSERVER_PATH` : **Lien vers le dossier d'Appache.**
+- `INSTALL_PATH` : **Répertoire d'installation de vMap.**
+
+Ainsi que les informations du serveur Postgres, et de la base de données vMap :
+
+```js
+{
+ ...
+ "POSTGRES_DB": "vmap",
+ "POSTGRES_HOST": "dbhost",
+ "POSTGRES_PASSWORD": "dbpasswd",
+ "POSTGRES_PORT": 5432,
+ "POSTGRES_USER": "dbuser",
+ "SQL_DATA": {
+ "DB_NAME": "vmap",
+ "SRID": 2154
+ },
+ ...
+}
+```
+
+Les clés, dans l'ordre, correspondent aux informations suivantes :
+
+- `POSTGRES_DB` : **Base de données de l'application.**
+- `POSTGRES_HOST` : **IP/Nom DNS du serveur Postgres.**
+- `POSTGRES_PASSWORD` : **Mot de passe de l'utilisateur Postgres.**
+- `POSTGRES_PORT` : **Port de l'application Postgres sur le serveur.**
+- `POSTGRES_USER` : **Nom d'utilisateur de l'utilisateur Postgres.**
+- `SQL_DATA` : **Objet contenant les variables pour les requêtes SQL d'installation.**
+- `SQL_DATA -> DB_NAME` : **Nom de la base de données de l'application.**
+- `SQL_DATA -> SRID` : **Système de projection de la base.**
+
Dans la section **application** (tout en bas du fichier *dependencies.json*) il est possible de définir les utilisateurs qui seront créés lors de l'installation de vMap2 ainsi que leurs droits. Cela est défini dans le tableau **users**.
Dans l'exemple ci-dessous, un utilisateur admin (et son mot de passe mdpadmin) sera créé avec les provilèges vitis_user et vitis_admin.
@@ -90,6 +159,31 @@ L’installateur de vMap2 assure les opérations suivantes :
- Création d’un compte administrateur dans PostgreSQL
- Nettoyage des caches
+### Lancement de l'installeur sous Linux
+
+Pour lancer l'installation de vMap via le VAI sous Linux, il faut exécuter les commandes suivantes :
+
+```{warning}
+Le chemin dans la commande ci-dessous est à adapter.
+Le sudo n'est également peut-être pas nécessaire en fonction de votre configuration.
+```
+
+```bash
+sudo chmod +x <chemin jusqu'au zip>/vmap/installer
+sudo ./<chemin jusqu'au zip>/installer
+```
+
+### Lancement de l'installeur sous Windows
+
+Pour lancer l'installeur sous Windows, cliquer sur le fichier .exe suffit :
+
+
+
+Il est également possible de le lancer en ligne de commande via le chemin du fichier exe en ligne de commande :
+
+```batch
+<chemin de l'exe>/installer.exe
+```
Pour les distributions Linux exécuter les commandes suivantes une fois que l'installeur a été lancé :