Procédure de passage au GEONIS server Interceptor – VertiGIS Support

Le GEONIS server Interceptor permet d'intercepter les demandes adressées aux services de cartes. La réponse du service de carte peut ainsi être adaptée en amont par des fonctionnalités spécifiques de GEONIS ce qui permet par exemple d'intégrer des valeurs de lookup dépendantes de la langue directement sur le service de carte lui-même. Ainsi, il n'est pas nécessaire de passer par le GEONIS Web Adaptor, l'architecture du système peut ainsi être simplifiée et le risque d'erreur réduit.

Les instructions ci-dessous décrivent, étape par étape, le passage à GEONIS server Interceptor. La procédure est valable aussi bien pour la mise à jour d'une ancienne installation que pour le remplacement d'une installation actuelle. Dans le cas d'une nouvelle installation complète, la procédure peut différer sur certains points.

Si vous ne l'avez pas déjà fait, nous vous recommandons d'installer ArcGIS Web Adaptor.

https://enterprise.arcgis.com/fr/server/latest/install/windows/about-the-arcgis-web-adaptor.htm

Procédure

Ajouter GEONIS server Interceptor dans ArcGIS Server Manager
Activer l'intercepteur pour tous les services de cartes qui utilisent des lookups et/ou des règles GEONIS. Ici, il est possible de filtrer les services de cartes avec le GEONIS MapServiceConnector. Pour cela, il faut activer "Fonctionnalités" dans les options de recherche :

Pour ces services de cartes, le GEONIS MapServiceConnector peut être désactivé et l'intercepteur GEONIS server activé.
Une fois que tous les services cartographiques ont été configurés, il faut désactiver le cache pour ces services :
1. Copier l'outil agsAdmin2.exe à partir de deploymenttup\utilities\agsAdmin sur le serveur GIS
2. Ouvrir la commande Windows (le cas échéant, en tant qu'administrateur)
3. Aller à l'emplacement où l'outil a été copié
4. Lancer le script de désactivation des caches avec l'appel suivant :
```
agsAdmin2.exe <arcgis_server> <arcgis_server_siteadmin> <admin_password> disablecache
```
Lors d'une mise à jour, actualiser GEONIS server SOE dans ArcGIS Server Manager
Désinstaller GEONIS Web Adaptor
Désinstaller GEONIS server UI
Réinstaller GEONIS server UI. Le setup proposera automatiquement le service de carte GEONISserverSOE comme point final GEONIS. Celui-ci doit éventuellement être adapté si le service se trouve dans un dossier.
Dans le WebSIG (WebOffice), toutes les URL des services de cartes doivent être adaptées. Le GEONIS Web Adaptor ne doit plus être utilisé comme point final. Cela peut être fait soit dans WebOffice Author, soit dans les XML du projet avec "Rechercher/Remplacer".

Exemple :
Ancien : https://<nom du serveur>/geonis/arcgis/rest/services/oberburg/oberburg_wat/MapServer
Nouveau : https://<nom du serveur>/arcgis/rest/services/oberburg/oberburg_wat/MapServer

Remarques importantes

Pour certaines architectures ou certains scénarios, il peut être nécessaire d'installer également GEONIS Web Adaptor. Un fonctionnement mixte est possible sans problème:

Opération mixte avec Web Adaptor et Interceptor

Si vous ne savez pas quel est le scénario le plus judicieux ou le plus réalisable, le support VertiGIS se fera un plaisir de vous aider.

Sécurité ArcGIS Server

Si la sécurité du serveur ArcGIS est utilisée pour sécuriser les services de cartes, des problèmes peuvent survenir lors de l'appel des rapports GEONIS comportant une carte. Pour contourner ce problème, il faut étendre manuellement la configuration de GEONIS server UI.

Important: Cette configuration est disponible à partir de GEONIS server 2022 Service Pack 1.

Dans le web.config sous C:\inetpub\wwwroot\GEONISserverUI2022, les lignes suivantes doivent être adaptées :

  <add key="tokenUrl" value="https://<servername>/arcgis/tokens/generateToken" /> 
  <add key="username" value="arcgis_user" /> 
  <add key="password" value="password123" />

Il est important que servername corresponde à l'URL du service de carte dans les rapports GEONIS.
passwordEncrypted est automatiquement saisi sous forme cryptée lors du premier appel d'un rapport et le mot de passe en texte clair est supprimé.

Dans configWO.js sous C:\inetpub\wwroot\GEONISserverUI2022\Report\config, la ligne 17 doit être adaptée :

  authentication: "arcgis",

Tous les autres paramètres, par ex. portalUrl ou serverUrl, ne doivent pas être modifiés. Ils ne sont pas nécessaires et sont ignorés tant qu'aucun clientId n'est saisi.

Cette configuration peut également être activée pour les autres modules (Attributeeditor, Datalist, etc.).

ArcGIS Enterprise

Si GEONIS server est utilisé avec ArcGIS Enterprise (Portal for ArcGIS), des problèmes peuvent survenir lorsqu'un utilisateur n'est pas connecté. Dans ce cas, il faut tenir compte du paragraphe suivant de la documentation :

Fenêtre de connexion au portail

Si GEONIS server et ArcGIS Enterprise avec Portal for ArcGIS sont déjà en service, les items de Portal for ArcGIS ont éventuellement été adaptés pour GEONIS Web Adaptor. Cette adaptation n'est plus nécessaire et doit être modifiée.

Ancien paramètre :