Skip to content
This repository has been archived by the owner on Dec 18, 2024. It is now read-only.

Commit

Permalink
Mise à jour de la documentation suite à la mise en place de l'héberge…
Browse files Browse the repository at this point in the history
…ment du Widget qui ne nécessite plus d'installation
  • Loading branch information
leodarengosse committed Sep 20, 2023
1 parent e734604 commit 96a95d7
Show file tree
Hide file tree
Showing 14 changed files with 81 additions and 132 deletions.
Binary file modified assets/add_application_portal.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/add_application_wab_portal.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/admin_share_widget.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/paste_link_application.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/share_application_everyone.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/widget_WABDE_metadata_display.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 1 addition & 8 deletions fr/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,9 @@

## Installation et configuration

* [Installation du widget](installation-portal/installwidget.md)
* [Ajouter le widget au Portal](installation-portal/addwidgetportal.md)
* [Ajouter le widget à une application](installation-portal/addwidgetapplication.md)
* [Mettre à jour](installation-portal/update.md)

<!-- ### Dans le Web AppBuilder
* [Ajouter le widget](installation-wab/addwidget.md)
* [Configuration du proxy](installation-wab/configproxy.md)
* [Configuration du widget](installation-wab/configwidget.md) -->
* [Mises à jour](installation-portal/update.md)

## Utilisation

Expand Down
15 changes: 15 additions & 0 deletions fr/appendices/versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,21 @@

<!-- timeline -->

## 2.1.1 {#version211}

<br> Publiée en septembre 2023

* Hébergement du proxy par Isogeo pour faciliter les installations et automatiser les mises à jour
* Ajout à la carte des groupes de couche
* Refonte de l'affichage de la fiche détaillée
* Ajout d'un message d'erreur lorsque l'utilisateur n'a pas accès à une couche de service qu'il souhaite ajouter à la carte
* Ajout de la recherche par [pertinence](https://help.isogeo.com/admin/fr/features/inventory/search.html#pertinence)
* Corrections mineures

<!-- /timeline -->

<!-- timeline -->

## 2.0 {#version20}

<br> Publiée en novembre 2022
Expand Down
43 changes: 41 additions & 2 deletions fr/installation-portal/addwidgetapplication.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,47 @@
3. Créer une application à l'aide du WebAppBuilder ;
4. Ajouter le widget Isogeo dans l'onglet `Personnalisé`.
!["Ajouter le widget à une application"](../../assets/add_widget_application.png)
5. Il est possible d'éditer le fichier de configuration du widget directement depuis l'interface proposée par le Portal. La configuration s'appliquera uniquement à l'application.
5. Il est possible d'éditer le fichier de configuration du widget directement depuis l'interface proposée par le Portal. La configuration s'appliquera uniquement à l'application (cf. [Autres configurations possibles](#config)).
!["Ajouter le widget à une application"](../../assets/update_widget_configuration_inside_application.png)
6. Il est également possible de permettre l'ouverture du widget au démarrage de l'application en cochant la case suivante :

!["Ouvrir le widget automatiquement au démarrage de l'application"](../../assets/open_widget_at_starting.png)
!["Ouvrir le widget automatiquement au démarrage de l'application"](../../assets/open_widget_at_starting.png)

## Autres configurations possibles {#config}

Vous pouvez également modifier les paramètres suivants :

* apiUrl : url du proxy gérant les appels à l'api Isogeo (paramètre réservé à l'équipe Isogeo)
* useUrlSecrets : si le paramètre est à `true`, alors le Widget appelera le proxy hébergé par Isogeo (paramètre réservé à l'équipe Isogeo)
* share : identifiant du partage en cas d'utilisation d'un proxy local (paramètre réservé à l'équipe Isogeo)
* token : identifiant du token de sécurité en cas d'utilisation d'un proxy local (paramètre réservé à l'équipe Isogeo)
* link : lien vers la page de présentation du Widget sur le site officiel d'Isogeo
* resultSymbol : Symbole de type polygone au format ESRI Json
* resultSymbolPoint: Symbole de type point (donneés ne contenant pas d’emprise) au format ESRI Json
* popupWidth : largeur de la popup pour les métadonnées (400 pour les autres couches)
* popupMoveLeft : Décalage de la popup (pour les modèles d’applications nécessitant un décalage)
* wfsMode : "snapshot" (requête initiale uniquement) ou "ondemand" (requête à chaque déplacement, mais non
compatible avec tout les flux WFS)
* wfsMaxFeatures : Nombre maximal d’entités récupérées dans un flux wfs (1000 par défaut)
* relationGeo : Relation géographique pour les recherches par emprise
* errorMessageTime : Temps d'affichage du message d'erreur (3000 ms par défaut)
* dataset-only : Si le paramètre est à `true`, seules les fiches rasters, vecteurs et tabulaires non-géographiques seront proposées. Sinon les fiches de service et les fiches ressources seront également proposées dans la recherche
* tabLayers : Afficher l'onglet Couches
* tabContexts : Afficher l'onglet Contexte
* openFiltersAtStart : Déplier tous les filtres à l'ouverture du Widget
* filterKeyword : Afficher le filtre sur les mots-clés
* filterOwner : Afficher le filtre sur le propriétaire
* filterThematic : Afficher le filtre sur les thématiques
* filterTheme : Afficher le filtre sur les thèmes Inspire
* filterFormat : Afficher le filtre sur les formats
* filterGeo : Afficher le filtre sur l'étendue de la carte
* filterSelection : Afficher le filtre sur une zone dessinée
* filterView : Afficher le filtre sur les données visualisables
* filterDownload : Afficher le filtre sur les données téléchargeables
* footer : Afficher le pied de page
* useMetadataName : Afficher le nom de la métadonnée comme nom du service/de la couche (dans les widgets *Legende* et *Liste des couches*) ou le nom ArcGIS Server par défaut.
* filterDomain : Afficher le filtre sur les domaines
* domains : Indiquer la liste des [thématiques](https://help.isogeo.com/admin/fr/features/admin/group_themes.html) que vous souhaitez afficher dans le filtre *Domaines* (s'il est activé) et non dans le filtre *Thématiques*. Indiquer les termes entre guillements et les séparer par des virgules.


> NB : Pour information, le portail chargera automatiquement la configuration saisie dans le fichier `catalog/config.json` à chaque ajout du widget dans une nouvelle application Web AppBuilder. Dans une application existante, il faut vérifier que l'utilisateur n'a pas modifié la configuration directement depuis le Portal (cf. [Ajouter le widget à une application Web AppBuilder](/installation-portal/addwidgetapplication.md))
26 changes: 14 additions & 12 deletions fr/installation-portal/addwidgetportal.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,19 @@
# Ajouter le Widget à Portal

1. Se connecter au Portal en tant qu'administrateur ;
2. Aller dans l'onglet `Contenu` ;
3. Créer un dossier Widget Isogeo, si besoin ;
4. Ajouter un élément, une application ;
!["Ajouter une application à Portal"](../../assets/add_application_portal.png)
5. Choisir une extension d’application (AppBuilder) ;
6. Renseigner l'URL : `https://mon-serveur/catalog/manifest.json` ;
7. Renseigner le nom : `Catalogue Isogeo ;
8. Renseigner une balise : `Isogeo`;
!["Ajouter une application Web App Builder"](../../assets/add_application_wab_portal.png)
9. Valider ;
10. Partager l'élément avec tout le monde ou à un groupe particulier selon le public visé.
1. Créer un [partage](https://help.isogeo.com/admin/fr/features/admin/shares.html) à l'application `Widget Web AppBuilder` sur la plateforme d'administration
2. Copier l'url du Widget comme sur la capture ci-dessous
!["Récupération de l'url du Widget"](../../assets/admin_share_widget.png)
3. Se connecter au Portal en tant qu'administrateur ;
4. Aller dans l'onglet `Contenu` ;
5. Cliquer sur `+Nouvel élément` puis `Application` ; !["Ajouter une application à Portal"](../../assets/add_application_portal.png)
6. Choisir le 4ème type d'application et coller l'url récupérée à l'étape 1 ; !["Type d'application"](../../assets/paste_link_application.png)
7. Renseigner le nom : `Widget Isogeo` ;
8. Renseigner un dossier : `Isogeo` ;
9. Renseigner des balises : `Widget`, `Catalogue`, `Isogeo` ;
10. Renseigner un résumé, par exemple : `Widget permettant la consultation du catalogue de métadonnées Isogeo et l'ajout de ces données à la carte.` ;!["Description de l'application"](../../assets/add_application_wab_portal.png)
11. Enregistrer ;
12. Partager l'élément avec tout le monde ou à un groupe particulier selon le public visé.
!["Partager l'application"](../../assets/share_application_everyone.png)


> NB : L'url du Widget contenant l'idendifiant du partage correspondant dans Isogeo : vous pouvez donc référencer de la même manière le Widget pour un autre partage afin d'avoir un Widget pour l'interne et un Widget pour le grand public par exemple.
63 changes: 0 additions & 63 deletions fr/installation-portal/installwidget.md

This file was deleted.

13 changes: 1 addition & 12 deletions fr/installation-portal/update.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,3 @@
# Mise à jour du Widget Isogeo

Pour mettre à jour le widget :

1. Ouvrir le dossier *catalog* du répertoire d'installation du Widget
2. Dupliquer dans un autre répertoire le fichier `config.json` pour conserver les paramètres de configuration de votre widget
3. Supprimer tous les fichiers
4. Coller les nouveaux fichiers
5. Editer le fichier `config.json`
6. Remplacer les paramètres par défaut par les paramètres de configuration de votre widget récupérés à l'étape 2
7. Vider le cache du navigateur
8. Ouvrir la page de l'application WAB contenant le widget Isogeo
9. Supprimer le widget
10. Ajouter à nouveau le Widget en vérifiant que les informations de configuration correspondent bien aux informations saisies à l'étape 6.
Le Widget étant hébergé par Isogeo, les mises à jour sont automatiques dès lors qu'une mise en production est effectuée par Isogeo. Néanmoins, il peut arriver qu'il faille vider son cache pour que la dernière version s'affiche.
36 changes: 5 additions & 31 deletions fr/prerequesites.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,47 +14,21 @@ Il est ensuite possible d’ajouter la donnée via les liens de visualisation do

## Prérequis {#prerequesites}

Le Widget étant hébergé par Isogeo, aucune installation sur un serveur Web n'est necessaire pour son fonctionnement.

### Isogeo {#isogeo}

* au moins un groupe de travail Isogeo ;
* au moins un catalogue contenant au moins une métadonnée de service, partagé à l'application ;
* des clés d'authentification oAuth2 auprès de l'API Isogeo ;

### Serveur {#server}

* Serveur Web configuré (Apache, IIS...)
* Certificat SSL valide

### Réseau {#network}

#### Liste blanche API Isogeo {#cross-domain-list}

L'URL de votre serveur Web doit être ajoutée à la liste blanche des URLS autorisées à contacter l'API Isogeo.
Par exemple, pour le [Widget de demo](https://carto.isogeo.net/widget_isogeo_webappbuilder_demo), nous avons autorisé les appels de https://carto.isogeo.net
Il faut donc nous fournir cette url en amont de l'installation.

#### Navigateur client {#client}

Les URL(s) suivantes doivent être accessibles sur le navigateur de l'utilisateur :

* https://id.api.isogeo.com/*
* https://v1.api.isogeo.com/*

Pour tester la communication, ouvrez les url(s) suivantes :

* https://v1.api.isogeo.com/about
* https://id.api.isogeo.com/about

Dans les deux cas, la version de l'API devrait s'afficher en JSON.
* au moins un catalogue contenant au moins une métadonnée de service, partagé à l'application Web AppBuilder;

### Logiciels {#softwares}

* ArcGIS Server > 10.6
* Portal for ArcGIS > 10.6
* Application générée avec le Web AppBuilder dans Portal ou déployée sur un serveur Web
* Application générée avec le Web AppBuilder dans Portal
* Utilisateur nommé Esri administrateur du Portal ou ayant les droits de création d'une extension d'application Web AppBuilder (nécéssaire pour l'installation)
* Services cartographiques publiés sur ArcGIS Server et recensés dans Isogeo (internes ou plublics)

### Arcopole Builder {#arcopole}

Le widget est également compatible avec [_arcOpole Builder_](https://www.arcopole.fr/generateur-applications-arcopole-builder.aspx). Vous pouvez suivre la [documentation officielle](https://www.arcopole.fr/aide/builder/v1.4/guides/utilisation/#!avance/AjouterWidgetTier/AjouterWidgetTier.md) pour ajouter le Widget à Arcopole.
Le widget est également compatible avec [_arcOpole Builder_](https://www.arcopole.fr/generateur-applications-arcopole-builder.aspx). Vous pouvez suivre la [documentation officielle](https://www.arcopole.fr/aide/builder/v1.4/guides/utilisation/#!avance/AjouterWidgetTier/AjouterWidgetTier.md) pour ajouter le Widget à Arcopole.
8 changes: 4 additions & 4 deletions fr/usage/metadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ Au clic sur un résultat, le résumé et l'emprise de la métadonnée s'affichen

![](../../assets/widget_metadata_link_search.png "Le résumé de la métadonnée s&rsquo;affiche au clic sur un résultat de recherche")

Un lien `Ouvrir la fiche détaillée` permet d'afficher la métadonnée complète dans une fenêtre modale.
Si au moins une couche de service est associée à la métadonnée, il est possible d'[ajouter la donnée à la carte](/usage/display.md).
Si au moins un lien de téléchargement est associé à la métadonnée, un bouton *Télécharger* s'affiche.

![](../../assets/widget_WABDE_metadata_display.png "Consulter la fiche de métadonnées détaillée")
Un lien `Ouvrir la fiche détaillée` permet d'afficher la métadonnée complète dans une fenêtre modale.

Si au moins une couche de service est associée à la métadonnée, il est possible d'[ajouter la donnée à la carte](/usage/display.md).
Si au moins un lien de téléchargement est associé à la métadonnée, un bouton *Télécharger* s'affiche.
![](../../assets/widget_WABDE_metadata_display.png "Consulter la fiche de métadonnées détaillée")

0 comments on commit 96a95d7

Please sign in to comment.