summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorValérie-Emma Leroux <valerie-emma.leroux@iggdrasil.net>2023-04-05 18:14:16 +0200
committerValérie-Emma Leroux <valerie-emma.leroux@iggdrasil.net>2023-04-05 18:14:16 +0200
commit623ef53f760c0ed9e33ceca2c317be01cb0d61a8 (patch)
tree0bab06cc65e3f3f9bf181053d4ae2bf3ca285b1a
parent1fe2cb7325ddf709d4fba58fa22f3604055f2083 (diff)
downloadIshtar-623ef53f760c0ed9e33ceca2c317be01cb0d61a8.tar.bz2
Ishtar-623ef53f760c0ed9e33ceca2c317be01cb0d61a8.zip
Editorial corrections to Technical Annex 6
-rw-r--r--docs/fr/source/annexe-tech-6-configuration-syndication.rst73
1 files changed, 36 insertions, 37 deletions
diff --git a/docs/fr/source/annexe-tech-6-configuration-syndication.rst b/docs/fr/source/annexe-tech-6-configuration-syndication.rst
index c51e68e34..80091234f 100644
--- a/docs/fr/source/annexe-tech-6-configuration-syndication.rst
+++ b/docs/fr/source/annexe-tech-6-configuration-syndication.rst
@@ -19,28 +19,28 @@ place cela.
Selon que l’on soit l’instance qui partage des données ou celle qui
consulte des données les enjeux sont différents :
-L’instance qui partage des données (dite « hôte ») doit paramétrer :
+L’instance qui partage des données (dite « source ») doit paramétrer :
-- les type de données à partager ;
-- les sous-ensemble de ces données à partager ;
+- les types de données à partager ;
+- les sous-ensembles de ces données à partager ;
- les attributs que l’on souhaite exposer / cacher ;
- à qui l’on va partager les données (nécessitant la création d’un
compte système avec un jeton d’accès et le paramétrage de l’adresse
IP du serveur vers lequel les données vont être envoyées).
-L’instance hôte est configurée en administration via les entrées « API -
+L’instance source est configurée en administration via les entrées « API -
Accès distant ».
-L’instance qui consulte les données (dite « cliente ») doit paramétrer :
+L’instance qui consulte les données (dite « destination ») doit paramétrer :
-- le serveur « hôte » qui fourni les données, son adresse web d’Ishtar
+- le serveur « source » qui fournit les données, son adresse web d’Ishtar
et un jeton d’accès ;
-- la correspondance entre les listes de vocabulaires contrôlés de son
- instance et les listes de vocabulaires contrôlés de l’instance hôte.
+- la correspondance entre les listes de vocabulaire contrôlé de son
+ instance et les listes de vocabulaire contrôlé de l’instance source.
Cette correspondance est nécessaire pour traduire les recherches par
critères de manière pertinente.
-L’instance cliente est configurée en administration via les entrées «
+L’instance destination est configurée en administration via les entrées «
API - Recherche ».
Pour illustrer une syndication de données, nous allons prendre l’exemple
@@ -49,12 +49,12 @@ suivant :
L’instance Charente-Maritime veut partager un ensemble de données avec
l’instance Nouvelle-Aquitaine.
-Le serveur dit « hôte » est celui de Charente-Maritime.
+Le serveur dit « source » est celui de Charente-Maritime.
-Le serveur dit « client » est celui de Nouvelle-Aquitaine.
+Le serveur dit « destination » est celui de Nouvelle-Aquitaine.
-Configuration du serveur hôte
-=============================
+Configuration du serveur source
+===============================
Cette configuration est à faire si vous souhaitez donner un accès en
lecture à vos données depuis une autre instance Ishtar. Dans notre
@@ -66,7 +66,7 @@ serveur de l’autre instance Ishtar.
Création d’un utilisateur système
---------------------------------
-Contrairement à la création d’utilisateur classique, on créé un
+Contrairement à la création d’utilisateur classique, on crée un
utilisateur système. Celui-ci n’aura pas accès à l’instance Ishtar
directement. Créer cet utilisateur en interface « Administration de base
de données » : « Authentification et autorisation > Utilisateurs > Ajout
@@ -91,11 +91,10 @@ la clé du jeton.
Par exemple sur la capture d’écran, la clé est
``a14b32f31029216da11621ba5ddb0431997ca61d``. Une fois la configuration
-terminée, cette clé sera à transmettre à l’administrateur de l’autre
-instance Ishtar.
+terminée, cette clé sera à transmettre à l’administrateur de l'instance Ishtar destination.
-Associer l’adresse IP du serveur client à l’utilisateur système
----------------------------------------------------------------
+Associer l’adresse IP du serveur destination à l’utilisateur système
+--------------------------------------------------------------------
Depuis « Ishtar - Commun > API - Accès distant - Utilisateurs > Ajout »,
on associe l’utilisateur système à l’adresse IP du serveur.
@@ -143,27 +142,27 @@ Sur cet exemple, on souhaite filtrer l’affichage de l’image principale.
Note : si l’on souhaite qu’aucune image ne soit affichée, il faut
ajouter chaque champ « image ».
-Configuration du serveur client
-===============================
+Configuration du serveur destination
+====================================
Cette configuration est à faire si vous souhaitez accéder à des données
d’une autre instance Ishtar depuis votre propre instance. Dans notre
exemple, il s’agit du serveur Nouvelle-Aquitaine.
Préalablement à cette configuration vous avez besoin du jeton
-d’authentification donné par le serveur hôte ainsi que l’adresse web
+d’authentification donné par le serveur source ainsi que l’adresse web
pour accéder à celui-ci.
Créer la source externe
-----------------------
-Cette source externe se créé en interface « Administration de base de
+Cette source externe se crée en interface « Administration de base de
données » : « Ishtar - Commun > API - Recherche - Sources externes >
Ajout ».
|image6|
-Sur le formulaire reprendre l’adresse web du serveur hôte ainsi que le
+Sur le formulaire reprendre l’adresse web du serveur source ainsi que le
jeton d’authentification qui vous a été fourni. Le nom renseigné doit
être explicite, il apparaîtra sur les écrans de recherche de
l’interface. On renseigne explicitement chaque utilisateur qui aura
@@ -173,8 +172,8 @@ Synchroniser les listes de vocabulaire contrôlées depuis la source
------------------------------------------------------------------
Une fois la source externe créée il est nécessaire de récupérer les
-listes de vocabulaire contrôlées de cette source (le serveur hôte). Pour
-cela, on se rends sur la page listant les sources externes : « Ishtar -
+listes de vocabulaire contrôlées de cette source (le serveur source). Pour
+cela, on se rend sur la page listant les sources externes : « Ishtar -
Commun > API - Recherche - Sources externes ». Sélectionner la source
externe concernée, l’action « Mettre à jour les types depuis la source »
et valider (le bouton « Aller »).
@@ -182,7 +181,7 @@ et valider (le bouton « Aller »).
|image7|
Cette action peut prendre un certain temps. Si des changements sont
-faits sur les listes de vocabulaires contrôlés sur la source cette étape
+faits sur les listes de vocabulaire contrôlé sur la source cette étape
ainsi que les suivantes sont à effectuer de nouveau.
Mettre à jour les correspondances
@@ -191,32 +190,32 @@ Mettre à jour les correspondances
Pour chaque liste de vocabulaire contrôlée, des correspondances sont
faites automatiquement entre les termes identiques. Lorsque deux
instances partagent la même langue et ont des cas d’utilisation
-semblable, une bonne partie des listes de vocabulaires sont mis en
+semblable, une bonne partie des listes de vocabulaire sont mises en
correspondance automatiquement. Afin de visualiser les correspondances
et de compléter les correspondances manquantes, on génère un document de
-correspondance. Celui est sous la forme d’un document tableur
+correspondance. Celui-ci se présente sous la forme d’un document tableur
LibreOffice. Pour cela, on reste sur la page listant les sources
externes : « Ishtar - Commun > API - Recherche - Sources externes ».
-Sélectionner la source externe concernée, l’action « Générer le document
-de correspondance » et valider (le bouton « Aller »).
+Sélectionner la source externe concernée et l’action « Générer le document
+de correspondance », valider (bouton « Aller »).
|image8|
Ouvrir le document généré avec LibreOffice et parcourir les différents
-onglets pour effectuer les éventuelles correspondances manquantes : là
-où des cellules sur la troisième colonne « Local » sont vides. Choisir
+onglets pour effectuer les éventuelles correspondances manquantes. Là
+où des cellules sur la troisième colonne « Local » sont vides, choisir
l’élément manquant dans la liste.
|image9|
-Une fois ces modifications faites, enregistrement le document et
-déposez-le sur le serveur sur la source externe concernée.
+Une fois ces modifications faites, enregistrer le document et
+le déposer sur le serveur sur la source externe concernée.
|image10|
-Enregistrez la source externe puis sélectionnez la source externe
-concernée, l’action « Mettre à jour les associations depuis un document
-de correspondance » et valider.
+Enregistrer la source externe puis sélectionner la source externe
+concernée et l’action « Mettre à jour les associations depuis un document
+de correspondance », valider.
|image11|