1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
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 directement dans l'interface du greffon SIG via l'onglet *Aide*.
L'interconnection avec Ishtar n'est pas activée par défaut. Si cette fonctionnalité est nécessaire, il faut s'assurer auprès de l'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 dans l'onglet « Paramètres ».
.. figure:: _static/greffon-interface-qgis-01.png
:align: center
Configuration du dépôt
Au niveau des dépôts 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 sur la zone grisée copie l'information 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.
|
