diff options
| -rw-r--r-- | docs/misc/HOWTO-SYNDICATION.md | 36 | ||||
| -rw-r--r-- | docs/misc/images/HOWTO-SYNDICATION-11.png | bin | 52032 -> 78551 bytes | |||
| -rw-r--r-- | docs/misc/images/HOWTO-SYNDICATION-12.png | bin | 0 -> 52032 bytes | |||
| -rw-r--r-- | docs/misc/images/HOWTO-SYNDICATION-13.png | bin | 0 -> 25415 bytes | |||
| -rw-r--r-- | docs/misc/images/HOWTO-SYNDICATION-14.png | bin | 0 -> 18841 bytes |
5 files changed, 31 insertions, 5 deletions
diff --git a/docs/misc/HOWTO-SYNDICATION.md b/docs/misc/HOWTO-SYNDICATION.md index 070407af7..5dd960937 100644 --- a/docs/misc/HOWTO-SYNDICATION.md +++ b/docs/misc/HOWTO-SYNDICATION.md @@ -11,11 +11,15 @@ L'instance qui partage des données (dite « hôte ») doit paramétrer : - 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 - Accès distant ». + L'instance qui consulte les données (dite « cliente ») doit paramétrer : - le serveur « hôte » qui fourni 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. 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 « API - Recherche ». + Pour illustrer une syndication de données, nous allons prendre l'exemple suivant : L'instance Charente-Maritime veut partager un ensemble de données avec l'instance Nouvelle-Aquitaine. @@ -81,7 +85,7 @@ Le formulaire doit rempli en deux fois. On se contente d'abord de choisir le typ Valider avec le bouton « Enregistrer et continuer les modifications ». -Une fois ce premier enregsitrement, l'aide disponible sous le champ « Clé » liste les différentes clés correspondant au contenu que l'on souhaite filtrer. +Une fois ce premier enregistrement, l'aide disponible sous le champ « Clé » liste les différentes clés correspondant au contenu que l'on souhaite filtrer.  @@ -110,13 +114,35 @@ Une fois la source externe créée il est nécessaire de récupérer les listes  -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 ainsi que les suivantes sont à ré-effectuer. +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 ainsi que les suivantes sont à effectuer de nouveau. -### Générer le document de correspondance +### 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 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 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 »). +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 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 »).  -### Éditer le document de correspondance
\ No newline at end of file +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 l'élément manquant dans la liste. + + + +Une fois ces modifications faites, enregistrement le document et déposez-le sur le serveur sur la source externe concernée. + + + +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. + + + +### Utiliser la syndication + +Depuis un compte explicitement désigné comme pouvant accepter la syndication, éditer son profil pour accepter les sources externes souhaitées. + + + +Attention : il est conseillé de créer un profil explicitement dédié à la consultation des données externes. En effet, les appels multiples à un serveur externe sont à même de provoquer des lenteurs. + +Une fois la source externe validée, un nouvel onglet est disponible sur le tableau de recherche. Le nombre indiqué dans le badge indique le nombre de résultat de la recherche actuelle. + + diff --git a/docs/misc/images/HOWTO-SYNDICATION-11.png b/docs/misc/images/HOWTO-SYNDICATION-11.png Binary files differindex 504006ce6..af717ce6e 100644 --- a/docs/misc/images/HOWTO-SYNDICATION-11.png +++ b/docs/misc/images/HOWTO-SYNDICATION-11.png diff --git a/docs/misc/images/HOWTO-SYNDICATION-12.png b/docs/misc/images/HOWTO-SYNDICATION-12.png Binary files differnew file mode 100644 index 000000000..504006ce6 --- /dev/null +++ b/docs/misc/images/HOWTO-SYNDICATION-12.png diff --git a/docs/misc/images/HOWTO-SYNDICATION-13.png b/docs/misc/images/HOWTO-SYNDICATION-13.png Binary files differnew file mode 100644 index 000000000..d599df951 --- /dev/null +++ b/docs/misc/images/HOWTO-SYNDICATION-13.png diff --git a/docs/misc/images/HOWTO-SYNDICATION-14.png b/docs/misc/images/HOWTO-SYNDICATION-14.png Binary files differnew file mode 100644 index 000000000..13366ac33 --- /dev/null +++ b/docs/misc/images/HOWTO-SYNDICATION-14.png |
