📝 french documentation for QGIS plugin

15 files changed, 146 insertions, 0 deletions

diff --git a/docs/fr/source/_static/01.png b/docs/fr/source/_static/01.png
new file mode 100644
index 000000000..95150a401
--- /dev/null
+++ b/docs/fr/source/_static/01.png
diff --git a/docs/fr/source/_static/02.png b/docs/fr/source/_static/02.png
new file mode 100644
index 000000000..3c3906b3f
--- /dev/null
+++ b/docs/fr/source/_static/02.png
diff --git a/docs/fr/source/_static/03.png b/docs/fr/source/_static/03.png
new file mode 100644
index 000000000..133ca3ee7
--- /dev/null
+++ b/docs/fr/source/_static/03.png
diff --git a/docs/fr/source/_static/04.png b/docs/fr/source/_static/04.png
new file mode 100644
index 000000000..4af0b366c
--- /dev/null
+++ b/docs/fr/source/_static/04.png
diff --git a/docs/fr/source/_static/05.png b/docs/fr/source/_static/05.png
new file mode 100644
index 000000000..de429ebc0
--- /dev/null
+++ b/docs/fr/source/_static/05.png
diff --git a/docs/fr/source/_static/greffon-interface-qgis-01.png b/docs/fr/source/_static/greffon-interface-qgis-01.png
new file mode 100644
index 000000000..4d066ef6c
--- /dev/null
+++ b/docs/fr/source/_static/greffon-interface-qgis-01.png
diff --git a/docs/fr/source/_static/greffon-interface-qgis-02.png b/docs/fr/source/_static/greffon-interface-qgis-02.png
new file mode 100644
index 000000000..41acb02c4
--- /dev/null
+++ b/docs/fr/source/_static/greffon-interface-qgis-02.png
diff --git a/docs/fr/source/_static/greffon-qgis-1.png b/docs/fr/source/_static/greffon-qgis-1.png
new file mode 100644
index 000000000..201e1976b
--- /dev/null
+++ b/docs/fr/source/_static/greffon-qgis-1.png
diff --git a/docs/fr/source/_static/greffon-qgis-2.png b/docs/fr/source/_static/greffon-qgis-2.png
new file mode 100644
index 000000000..d44812554
--- /dev/null
+++ b/docs/fr/source/_static/greffon-qgis-2.png
diff --git a/docs/fr/source/_static/greffon-qgis-3.png b/docs/fr/source/_static/greffon-qgis-3.png
new file mode 100644
index 000000000..86d2e7e99
--- /dev/null
+++ b/docs/fr/source/_static/greffon-qgis-3.png
diff --git a/docs/fr/source/_static/greffon-qgis-4.png b/docs/fr/source/_static/greffon-qgis-4.png
new file mode 100644
index 000000000..a30589954
--- /dev/null
+++ b/docs/fr/source/_static/greffon-qgis-4.png
diff --git a/docs/fr/source/_static/greffon-qgis-5.png b/docs/fr/source/_static/greffon-qgis-5.png
new file mode 100644
index 000000000..0647060ed
--- /dev/null
+++ b/docs/fr/source/_static/greffon-qgis-5.png
diff --git a/docs/fr/source/_static/greffon-qgis-6.png b/docs/fr/source/_static/greffon-qgis-6.png
new file mode 100644
index 000000000..8ecbc29ac
--- /dev/null
+++ b/docs/fr/source/_static/greffon-qgis-6.png
diff --git a/docs/fr/source/annexe-6-greffon-qgis.rst b/docs/fr/source/annexe-6-greffon-qgis.rst
new file mode 100644
index 000000000..50defc9cd
--- /dev/null
+++ b/docs/fr/source/annexe-6-greffon-qgis.rst
@@ -0,0 +1,145 @@
+.. -*- coding: utf-8 -*-
+
+.. _annexe-6-greffon-qgis:
+
+======================================
+Annexe 6 - Utilisation du greffon QGIS
+======================================
+
+:Auteurs: Étienne Loks
+:Date: 2025-11-25
+:Copyright: CC-BY 3.0
+
+----------------------------------
+
+.. |01| image:: _static/01.png
+.. |02| image:: _static/02.png
+.. |03| image:: _static/03.png
+.. |04| image:: _static/04.png
+.. |05| image:: _static/05.png
+
+
+Connecteur Ishtar
+=================
+
+Ce greffon permet d'interconnecter Ishtar avec des projets SIG.
+
+La documentation ci-dessous est en partie disponible directements dans l'interface du greffon SIG via l'onglet *Aide*.
+
+L'interconnection avec Ishtar n'est pas activée par défaut, si vous avez besoin de cette fonctionnalité assurez vous auprès de votre administrateur fonctionnel Ishtar que la fonctionnalité a bien été paramétrée dans le profil d'instance Ishtar.
+
+
+.. note:: Une connexion réseau est nécessaire pour synchroniser les données avec Ishtar, mais le greffon a été conçu pour permettre le travail hors ligne tout en assurant la traçabilité des mises à jour effectuées dans la base de données Ishtar.
+
+
+Installation du greffon
+-----------------------
+
+Pour installer le greffon, il est nécessaire d'ajouter la source de données Iggdrasil dans vos dépôts QGIS.
+
+Pour cela, aller dans « Extensions > Installer gérer les extensions » puis l'onglet « Paramètres ».
+
+.. figure:: _static/greffon-interface-qgis-01.png
+    :align: center
+
+    Configuration du dépôt
+
+
+Au niveau des dépôt d'extensions, cliquer sur le bouton « Ajouter », renseigner un nom explicite (tel que « Dépôt Ishtar ») et renseigner l'adresse : `https://plugins.iggdrasil.net/plugins.xml`.
+
+.. figure:: _static/greffon-interface-qgis-02.png
+    :align: center
+
+    Installation de l'extension
+
+Ensuite aller à l'onglet « Non installées », taper `Ishtar` dans la zone de recherche, sélectionner l'extension puis cliquer sur le bouton « Ajouter l'extension ».
+
+
+Paramétrage des connexions
+--------------------------
+
+.. figure:: _static/greffon-qgis-1.png
+    :align: center
+
+    Interface principale du greffon
+
+Les connexions sont des instances Ishtar accessibles avec les autorisations associées à votre compte.
+
+Trois boutons explicites sont disponibles :
+
+- |01| *Nouveau* : Créer une nouvelle connexion. Voir « Ajouter une nouvelle connexion » pour plus de détails.
+- |02| *Connexion* : Sélectionner la connexion affichée et obtenez les sources de données disponibles.
+- |03| *Supprimer* : Supprimer la configuration de la connexion affichée. Attention, les couches utilisant cette connexion ne pourront plus se synchroniser avec Ishtar.
+
+.. note:: Les informations de connexion sont stockées sur votre installation QGIS. Ces paramétrages peuvent être protégés par un mot de passe maître (cf. la documentation QGIS).
+
+
+Ajouter une nouvelle connexion
+++++++++++++++++++++++++++++++
+
+.. figure:: _static/greffon-qgis-2.png
+    :align: center
+
+    Menu d'accès à l'ajout de connexion
+
+Pour créer une connexion, vous devez obtenir l'adresse Web de votre instance Ishtar et un code fourni par Ishtar. Pour cela, après l'apparition de la fenêtre d'ajout de connexion, aller dans l'interface Ishtar  et cliquer dans l'entrée de menu « Connexions SIG ».
+
+.. figure:: _static/greffon-qgis-3.png
+    :align: center
+
+    Ajout de connexion dans QGIS
+
+Ensuite reporter l'adresse Web de l'instance Ishtar et le code depuis l'interface Ishtar (un simple clic mets dans le presse-papier) vers le greffon.
+
+Par défaut, la connexion est nommée avec l'adresse Web de l'instance Ishtar, vous pouvez la modifier pour quelque chose de plus explicite si nécessaire.
+
+
+Utilisation des sources de données
+----------------------------------
+
+.. figure:: _static/greffon-qgis-4.png
+    :align: center
+
+    Interface principale du greffon
+
+Les types de sources de données sont fournis par l'instance Ishtar. Du point de vue d'Ishtar, une source de données est un importeur avec une configuration spécifique définie afin de synchroniser la couche QGIS.
+
+Pour chaque type de source de données, une correspondance entre la couche et les données Ishtar est établie.
+
+Cinq boutons sont disponibles :
+
+- |01| *Nouveau* : Créer une nouvelle source de données. Voir « Ajouter une nouvelle source de données » pour plus de détails.
+- |02| *Import* : Effacer toutes les entités de cette couche et les (ré-)importer depuis Ishtar. Avertissement : toutes les modifications apportées dans QGIS seront écrasées.
+- |03| *Nouvelles entités* : Importer uniquement les nouveaux éléments depuis Ishtar.
+- |04| *Nouvelles entités/MàJ* :Importer les nouvelles entités et mettre à jour les attributs des entités existantes depuis Ishtar. Pour les entités existantes, la géométrie n'est pas modifiée, mais tous les attributs sont réinitialisés.
+- |05| *Export* : Exporter les données mises à jour vers Ishtar. Un import est créé dans Ishtar avec la possibilité de le lancer automatiquement depuis QGIS.
+
+
+Ajout d'une nouvelle source de données
+++++++++++++++++++++++++++++++++++++++
+
+.. figure:: _static/greffon-qgis-5.png
+    :align: center
+
+    Fenêtre d'ajout de sources de données
+
+Tout d'abord, pour créer une nouvelle source de données, vous devez filtrer les données à l'aide d'une requête. La requête de recherche utilise des mots-clés provenant d'Ishtar. Nous vous recommandons de ne pas utiliser la recherche ouverte pour cette requête afin de cibler précisément les données recherchées. Cette requête est très importante, vous devez bien la réfléchir afin de travailler avec un ensemble de données pertinent : testez-la d'abord dans l'interface Ishtar.
+
+Ensuite recopier la requête dans le champ texte « Requête » |01|, puis lancer l'« Aperçu » |02|. Vérifier les données affichées (seules les 50 premières lignes de résultat sont affichées).
+
+Une fois la requête définie, vous avez deux possibilités :
+
+- *Créer une nouvelle couche* : Créer une nouvelle couche dans un géopackage nouveau ou existant. Il est nécessaire de définir le chemin d'accès du géopackage nouveau/existant |03| et le nom de la table |04| qui correspondra aussi au nom de la couche dans votre projet.
+- *Choisir une couche existante* |05| : Vous pouvez choisir une couche existante dans votre projet actuel. Après avoir choisi cette couche, une fenêtre est ouverte pour établir une correspondance entre les champs de la couche existante et chaque champ attendus par la source de données Ishtar.
+
+.. figure:: _static/greffon-qgis-6.png
+    :align: center
+
+    Fenêtre de correspondance
+
+.. note:: Si votre projet contient une couche Ishtar non configurée (provenant par exemple d'un autre utilisateur Ishtar ou d'une connexion Ishtar supprimée), l'option « Choisir une couche existante » est appropriée pour configurer cette couche.
+
+Ouverture/fermeture de projets
+------------------------------
+
+Que cela soit lors de l'ouverture ou la fermeture d'un projet QGIS contenant des sources des données Ishtar, une synchronisation est proposée automatiquement, permettant ainsi de s'assurer que les données sont mis à jour à la fois sur son projet QGIS et dans la base de données d'Ishtar.
diff --git a/docs/fr/source/index.rst b/docs/fr/source/index.rst
index 917424f4e..800e1b560 100644
--- a/docs/fr/source/index.rst
+++ b/docs/fr/source/index.rst
@@ -40,6 +40,7 @@ Ces annexes sont à destination des utilisateurs ou des administrateurs applicat
    annexe-3-ex-flux-ope
    annexe-4-doc-normes
    annexe-5-module-operateur-preventif
+   annexe-6-greffon-qgis
 
 Annexes techniques
 ------------------