arcopole Studio version 3.4

Transcription

1 arcopole Studio version 3.4 Documentation d installation et de configuration Site du programme arcopole : Auteur du document : Esri France Version de la documentation : Date de dernière mise à jour : 25/09/2015

2 Sommaire I Introduction... 3 I.1 Le programme arcopole... 3 I.2 Qu est-ce qu arcopole Studio?... 3 I.3 Nouveautés de cette version... 3 I.4 Contenu de ce document... 3 II Fonctionnement et prérequis clients... 4 II.1 ArcOpole Studio : application Web de configuration... 4 II.2 Client Flash arcopole : application Web SIG pour les utilisateurs finaux... 4 III Pré-requis Serveurs... 4 III.1 Convention de nommage... 4 III.2 Prérequis généraux... 5 III.3 Prérequis logiciels... 6 III.4 Prérequis sur les données... 6 III.5 Contenu du paquet... 6 IV Nouvelle installation... 7 IV.1 Déploiement... 8 IV.2 Configuration de l application IV.3 Configuration de l impression IV.4 Configuration des rapports IV.5 Configuration des statistiques d utilisation IV.6 Configuration de l assistant de saisie d une étendue d ouverture d une application IV.7 Installation des extensions V Lancement de l application V.1 Lancement de l application V.2 Page d accueil VI Tests et vérifications VI.1 Test de la connexion à ArcGIS Online VI.2 Test de l impression VI.3 Test des rapports /09/2015 Version doc. : Page 2 sur 39

3 I INTRODUCTION I.1 LE PROGRAMME ARCOPOLE Le programme arcopole, initiative lancée par Esri France, ambitionne de rassembler une communauté de professionnels des secteurs publics et privés et d animer des projets collaboratifs. L objectif est de mettre à disposition des «outils métiers» et «templates» (exemples de modèles de données, d applications et d'utilisations) pour répondre à certains besoins récurrents et simples des collectivités. Il doit vous permettre de tirer le meilleur parti des technologies SIG proposées par Esri. I.2 QU EST-CE QU ARCOPOLE STUDIO? ArcOpole Studio est un des templates disponibles sur le site Il s agit d un générateur d applications Flex pour ArcGIS for Server. ArcOpole Studio propose des interfaces modernes pour configurer des applications facilement et gérer des droits d accès par utilisateurs. En plus des fonctionnalités rendues disponibles dans le noyau d arcopole Studio, d autres sont proposées sous la forme d extensions. A l heure de la rédaction de ce document, les extensions disponibles sont les suivantes : Cadastre PLU Connecteur ADS Operis Localisation XY Identification Multicouche (IMC) Rapports Géotraitements (bêta) Cartographie des données décisionnelles Symbologie La documentation complète de ces extensions est disponible sur le site internet I.3 NOUVEAUTES DE CETTE VERSION La liste complète des nouveautés est disponible sur l espace contributif du programme arcopole. Si vous ne l avez pas encore fait, contactez l équipe arcopole pour accéder à cet espace d information et d échanges entre Collectivités. I.4 CONTENU DE CE DOCUMENT Vous trouverez dans ce document toutes les informations nécessaires à l installation d arcopole Studio. Si vous souhaitez mettre à jour depuis une version antérieure, nous vous invitons à consulter la documentation nommée «2 - arcopole Studio - Mise à jour d'une version antérieure». 25/09/2015 Version doc. : Page 3 sur 39

4 II FONCTIONNEMENT ET PREREQUIS CLIENTS ArcOpole Studio et le Client Flash arcopole sont des applications internet de type client riche (RIA) s'exécutant dans un composant Flash 11.1 au sein d'un navigateur internet. Ce client Flash communique avec un serveur hébergeant ArcGIS for Server 10 minimum et une application Java. II.1 ARCOPOLE STUDIO : APPLICATION WEB DE CONFIGURATION L'application sous Tomcat est publiée sous le nom "studio". Elle sera accédée par l administrateur du SIG via des URL du type Pour une utilisation confortable, nous vous conseillons une résolution d écran minimale de 1024x768 pixels. II.2 CLIENT FLASH ARCOPOLE : APPLICATION WEB SIG POUR LES UTILISATEURS FINAUX Le Client Flash arcopole se présente sous la forme d'un objet Flash compilé (SWF). Cet objet est inséré dans une page HTML et est ainsi téléchargé par les utilisateurs lors de l'aperçu de la page. L'ensemble des fichiers du client est stocké, dans le sous-répertoire /clients de l application web. Le client doit disposer d'un composant Flash 11.1 (Attention, les versions de Flash 9 et 10 ne sont plus supportées). Pour une utilisation confortable, nous vous conseillons les résolutions d écran suivantes : Jusqu à 4 fonctionnalités affichant des boutons de fonctions sur la droite de l interface : 768 pixels minimum en hauteur (ex : 1024x768). Au-delà de 4 fonctionnalités : 1024 pixels minimum en hauteur (ex : 1280x1024) III PRE-REQUIS SERVEURS III.1 CONVENTION DE NOMMAGE Voici la signification des noms utilisés dans le document : Serveur ArcGIS for Server : SrvAgs : le serveur sur lequel est installé ArcGIS for Server. PortAgs : le port sur lequel ArcGIS for Server permet un accès REST et SOAP. Il prend habituellement la valeur 6080 Un accès REST se fera donc sous la forme par exemple. Serveur arcopole : SrvArcOpole : le serveur sur lequel est déployé Tomcat et la webapp studio. PortArcOpole : le port sur lequel Tomcat écoute (8080 par défaut) Dans la majorité des cas, le serveur arcopole et le serveur ArcGIS for Server se trouvent sur la même machine physique. Dans ce cas, SrvAgs = SrvArcOpole, seuls les ports sont les différents. 25/09/2015 Version doc. : Page 4 sur 39

5 III.2 PREREQUIS GENERAUX Concernant ArcGIS for Server, vous devez maîtriser : l'installation d'arcgis for Server, la création de MapService, la création de cache de type «fused» et «exploded». l outil d administration de l'api REST et cette API pour pouvoir tester les MapService publiés. Concernant Tomcat, vous devez connaître : l'installation et la configuration Vous devez avoir les droits de lecture/écriture dans le répertoire webapps. Concernant le système d exploitation : Vous devez avoir les droits d administration De nombreux sites Internet offrent des tutoriaux si nécessaire. Note concernant la casse et l encodage : La casse : o ArcGIS for Server, selon sa version (Java/.Net) est sensible ou non aux majuscules/minuscules. Tomcat et l'environnement Java sont sensibles à la casse. Ainsi, «/arcopole» génèrera une erreur alors que «/arcopole» fonctionnera. Le lecteur prendra garde à RESPECTER les majuscules / minuscules. L encodage o Les fichiers XML sont pour certains encodés en UTF-8 (Encodage par défaut pour les fichiers d'origine Esri) ou ISO (Encodage par défaut français) Il est facile de générer des erreurs dans ces fichiers par erreur d'encodage ou mauvaise fermeture d'une balise XML. A chaque modification de fichier XML, le lecteur chargera le fichier dans Internet Explorer ou Mozilla Firefox pour vérifier que le fichier est correct. Dans le cas contraire, l'erreur serait difficile à retrouver. En cas de problème, un fichier de LOG est créé dans le répertoire WEB-INF/logs. Il est par défaut en "INFO", donc avec de nombreuses d'informations (configuration dans logs/log4j2.configuration). Il est conseillé de le laisser en INFO tant que les tests de bon fonctionnement n ont pas été terminés. Les autres niveaux de logs possibles sont TRACE, DEBUG, INFO, WARN, ERROR et FATAL. 25/09/2015 Version doc. : Page 5 sur 39

6 III.3 PREREQUIS LOGICIELS La/les machine(s) serveur(s) doit avoir les logiciels suivants installés et configurés: SrvAgs: arcopole Studio supporte les versions 10.1 à d ArcGIS for Server JAVA ou DOT NET : o 10.1, (*) en anglais o 10.1 SP1 ou sup, 10.2, , , 10.3, en anglais ou en français SrvArcopole : o JDK update 60 ou supérieur (**), Tomcat 6.0 ou 7.0 (*) L installation d ArcGIS for Server doit être faite en anglais pour les versions 10.1 sans SP ou antérieure. Si vous ne disposez que de la version française, il faut désinstaller le pack de localisation français d ArcGIS for Server. (**) Concernant le JDK : Le packaging de téléchargement du JDK proposé par défaut sur le site d ORACLE a changé et peut poser problème. Il faut veiller à télécharger un JDK 1.7 sans le serveur GlassFish (sur le site rubrique Downloads > Java for Developers > Java SE > Downloads > Java SE 7). A l heure de la rédaction de cette documentation, le nom exact du composant à télécharger est «Java SE Development Kit 7u71» et peut être téléchargé ici. III.4 PREREQUIS SUR LES DONNEES Vous devez disposer d un service de type "GeometryService" sur votre ArcGIS for Server. Si ce n est pas le cas, veuillez en créer un dans un répertoire ArcGIS for Server (folder). De plus, arcopole Studio ne permet d utiliser les données publiées sous la forme de services de cartes (MapServices) pour composer des applications. Les Services d entités (FeatureServices) sont également utilisés mais uniquement pour les opérations de mise à jour. Ces derniers ne peuvent pas être utilisés sans un MapService correspondant (ce qui n est jamais le cas avec ArcGIS for Server mais est possible sur ArcGIS Online). III.5 CONTENU DU PAQUET ArcOpole Studio ainsi que le Client Flash arcopole sont livrés sous forme d un fichier WAR (studio.war). Une configuration est nécessaire pour le bon fonctionnement du système. 25/09/2015 Version doc. : Page 6 sur 39

7 IV NOUVELLE INSTALLATION L installation et la configuration d arcopole Studio nécessitent de suivre les étapes suivantes : 25/09/2015 Version doc. : Page 7 sur 39

8 IV.1 DEPLOIEMENT IV.1.1 Déploiement d arcopole studio Il faut copier le fichier studio.war dans le répertoire \webapps de Tomcat. Lorsque vous démarrerez ce dernier, Tomcat va le décompresser et créer le répertoire associé au redémarrage de Tomcat. Vous devez absolument avoir les droits d écritures dans le répertoire Tomcat. Une fois le déploiement réalisé (un répertoire \webapps\studio a été créé), vous pouvez arrêter Tomcat. IV.1.2 Déploiement du géotraitement de rapports La fonctionnalité d export Excel et les fichiers PDF d export (hors impressions cartographiques, synthèses cadastrales et relevés de propriété) d arcopole studio utilisent un géotraitement nommé «Rapports». Tous les éléments nécessaires à l installation de ce dernier sont disponibles dans le répertoire \webapps\studio\rapports. Ce répertoire doit être lisible par Tomcat et ArcGIS for Server. Veillez à ce que l utilisateur exécutant ArcGIS for Server (arcgis par défaut) ait bien accès à ce répertoire. Vous trouverez trois dossiers à l intérieur : jasper : contient les modèles de rapport PDF xslt : contient les modèles d exports Excel toolbox : contient une boite à outil avec deux géotraitements préconfigurés. L utilisateur ArcGIS for Server doit avoir des droits étendus sur le répertoire des rapports. 25/09/2015 Version doc. : Page 8 sur 39

9 Publiez la boite à outil qui se trouve dans le répertoire \webapps\studio\rapports\toolbox à l aide d ArcCatalog dans un répertoire nommé «arcopole». Pour cela, suivez les étapes suivantes : 1. Ouvrez une connexion sur le répertoire \webapps\studio 2. Naviguez jusqu à la boite à outil rapports\toolbox\rapports.tbx. 3. Ouvrez la tâche «xslt» en faisant un clic-droit puis Ouvrir (Open) : Cliquez sur le bouton «Environnements» puis, dans la catégorie Espace de travail (workspace) définir la valeur du paramètre Espace de travail temporaire (Scratch Workspace) en indiquant le chemin d accès au répertoire arcgisoutput d ArcGIS for server. Par défaut ce répertoire est situé dans : C:\arcgisserver\directories\arcgisoutput. 25/09/2015 Version doc. : Page 9 sur 39

10 Validez les paramètres d environnement pour revenir à la fenêtre de paramétrage du géotraitement. Laissez les valeurs par défaut, ces dernières ne sont pas importantes, il n est pas nécessaire de les modifier. Cliquez sur le bouton «Ok» de l outil pour exécuter ce géotraitement. L exécution du géotraitement indique une erreur («The system cannot find the file specified» dans la fenêtre ci-dessus), cela est normal. Cliquez sur le bouton Fermer (Close) 4. Rejouez l étape n 3 avec la tâche «jasper» 5. Dans ArcCatalog, ouvrez le panneau de résultats (Menu Geotraitement > Resultats) et faites un clic-droit sur le résultat «xslt» puis > «Partager comme» (Share As) > «Service de géotraitement» (Geoprocessing service). 25/09/2015 Version doc. : Page 10 sur 39

11 Sélectionnez Publier un service (Publish a service) sauf si un service «Rapports» est déjà publié dans le répertoire «arcopole» auquel cas il faut choisir l option Ecraser un service existant (Overwrite an existing service). Saisissez le nom de «Rapports» comme nom du Service. Attention à la casse, en respectant les noms de service et de dossier de publication, la suite du paramétrage sera plus simple. 25/09/2015 Version doc. : Page 11 sur 39

12 Choisissez le dossier «arcopole» pour la publication (en utilisant un dossier existant ou bien en en créant un nouveau) Dans la fenêtre de récapitulation des caractéristiques du service de géotraitement, cliquez sur le bouton «Ajouter des résultats» (AddResult) et sélectionnez le résultat de l outil Jasper. Vérifier que le service «Rapports» contient bien les deux outils : xslt et jasper comme ci-dessous. 25/09/2015 Version doc. : Page 12 sur 39

13 Sélectionnez successivement chacun des items constituant les tâches XSLT et JASPER de manière à saisir la documentation attendue par ArcGIS for Server (cette documentation ne sera pas visible des utilisateurs finaux). Nous vous proposons ci-dessous des contenus mais n importe quelle chaine de caractère non-vide fait également l affaire : Item XSLT xmlcontent modelpath status content JASPER xmlcontent modelpath outputformat status content Description proposée Géotraitement de génération de rapports utilisant le moteur XSLT Contenu du fichier XML à transmettre au moteur de rapports Chemin d'accès au modèle de rapport à utiliser par le moteur de rapport Statut de la tâche Fichier résultat Géotraitement de génération de rapports utilisant le moteur Jasper Report Contenu du fichier XML à transmettre au moteur de rapports Chemin d'accès au modèle de rapport à utiliser par le moteur de rapport Format de fichier en sortie (PDF EXCEL) Statut de la tâche Fichier résultat Cliquez sur le bouton «Analyser» (Analyze) pour vérifier la validité des services. En cas d erreur, vérifier que tous les outils et leurs paramètres ont bien une description (champs obligatoires) Puis cliquez sur le bouton «Publier» (Publish). 6. Enfin, copiez les librairies Java dans le répertoire du géotraitement Copiez les fichiers \rapports\toolbox\xslt.jar et \rapports\toolbox\jasper.jar dans le répertoire arcgisinput du géotraitement, qui, par défaut, se trouve à l endroit suivant : C:\arcgisserver\directories\arcgissystem\arcgisinput\arcopole\Rapports.GPServer\extracted\v101 \toolbox Si vous avez modifié le nom du répertoire ou du service de géotraitement, adaptez le chemin en conséquence. 25/09/2015 Version doc. : Page 13 sur 39

14 IV.1.3 Installation des SOE pour ArcGIS for Server Il faut enregistrer les SOE en utilisant ArcGIS Manager. Pour cela, connectez-vous à ArcGIS for Server Manager avec l url : Allez sur l onglet «Site» pour ajouter les SOE qui se trouvent dans les répertoires suivants : \WEB-INF\configure\SOE\MXDData\ \WEB-INF\configure\SOE\MXDPrinter\ Une fois les SOE installés, ces derniers apparaissent comme des nouvelles capacités pour les services publiés avec ArcGIS for Server. Ces points seront revus plus loin mais pour information : La capacité SOEMxdData doit être activée seulement sur les MapServices pour lesquels vous souhaitez pouvoir récupérer les géosignets et la cardinalité des jointures. La capacité SOEMxdPrinter n a besoin d être activée que sur le service d impression arcopoleprint. 25/09/2015 Version doc. : Page 14 sur 39

15 IV.1.4 Publication du MapService pour l impression avec ArcGIS for Server L impression s appuie sur l utilisation un MapService. Avec ArcMap, ouvrez le le fichier \WEB-INF\configure\SOE\MXDPrinter\arcOpolePrint.mxd. Passez en «mode Données» puis publiez le MXD sous la forme d un MapService avec le nom «arcopoleprint» dans un répertoire nommé «arcopole». Lors de la publication, l analyse indique des warnings, ignorez les et publiez votre service tel quel. Définissez les paramètres du service (les valeurs par défaut peuvent convenir). N activez pas la capacité «SOE MxdPrinter» pour l instant, nous y reviendrons plus tard. 25/09/2015 Version doc. : Page 15 sur 39

16 IV.2 CONFIGURATION DE L APPLICATION Deux modes de configurations sont proposés : Configuration automatique (voir IV.2.1, page 16) : il s agit d un mode automatisé qui copie et modifie automatiquement les fichiers de configuration. Ce mode est bien adapté aux architectures simples. Configuration manuelle (voir IV.2.2, page 18) : décrivant une par une toutes les étapes de la configuration, ce mode est destiné aux installations d architectures avancées. Des exemples d architectures ainsi que la liste des valeurs correspondantes sont présentés dans le document nommé «9 arcopole Studio Annexe 7 Architectures» pour vous guider dans votre installation. IV.2.1 Configuration automatique Un outil de configuration automatique est fourni dans le dossier \WEB-INF\configure de l application web. Cet outil copie les fichiers xxxxx-version.autoconf.xml en xxxxx.xml tout en remplaçant un certain nombre de variables décrites dans le fichier configure.properties. IV Vérification du chemin du JDK Si votre variable d environnement PATH ne contient pas le JDK, éditez le fichier \WEB- INF\configure\configure.bat et modifiez la variable PATH (ligne 8) pour qu elle conduise bien vers le répertoire BIN de votre JDK. IV Saisie des informations Ensuite, la partie configuration commence vraiment. Cette étape consiste à saisir un certain nombre d informations dans le fichier \WEB-INF\configure\configure.properties. WEB_SERVER_HOST : nom d hôte de la machine Tomcat suivie du port utilisé par Tomcat (SrvArcopole:PortArcopole) WEB_SERVER_PROTOCOL : protocole d accès à Tomcat (http) WEBAPP_NAME : nom de l application web (studio) AGS_HOST : nom d hôte du serveur ArcGIS (SrvAgs) AGS_WEBAPI_HOSTS : noms d hôtes des serveurs web ArcGIS (SrvAgs:PortAgs) AGS_PROTOCOL : protocole d accès au serveur ArcGIS (http) AGS_USER : Utilisateur pour se connecter à ArcGIS for Server (AgsUser) AGS_PWD : Mot de passe associé à l utilisateur ci-dessus (AgsPwd) AGS_DOMAIN : Domaine NT auquel l'utilisateur appartient («NOM_DE_LA_MACHINE» pour un utilisateur local) AGS_OUTPUT* : chemin du répertoire arcgisoutput d ArcGIS for Server (AgsOutput) AGS_JOBS* : chemin du répertoire arcgisjobs d ArcGIS for Server (AgsJobs) Des exemples d architectures ainsi que la liste des valeurs correspondantes sont présentés dans le document nommé «9 arcopole Studio Annexe 7 Architectures» pour vous guider dans votre installation. 25/09/2015 Version doc. : Page 16 sur 39

17 Les informations relatives aux répertoires arcgisinput et arcgisjobs de votre ArcGIS for Server sont utilisées par la fonctionnalité de Rapport. Les paragraphes IV.4.1 et IV.4.2 décrivent comment configurer correctement ces paramètres en fonction de votre version d ArcGIS. *ATTENTION : pour les chemins de type Windows veillez à doubler les barres obliques inversées. Exemple : \\\\ma_machine\\chemin\\vers\\arcgisinput IV Lancement de la configuration automatique Exécuter le programme configure.bat (éventuellement «en tant qu administrateur» sur les dernières versions de Windows, voire depuis une ligne de commande si le fichier ant.bat n est pas trouvé). Le programme va écrire les fichiers de configuration suivants : Clients/arcopole_studio/config.xml Clients/clientFlashArcopole/config.xml WEB-INF/configuration.xml WEB-INF/applications/templateApplication.xml WEB-INF/applications/TFA/configuration.xml WEB-INF/applications/TFA/client.xml WEB-INF/orionConfig/PrintAuth.xml Ainsi que la page de test et le gabarit exemple d impression : test.jsp WEB-INF/printTemplates/GabaritExemple.mxd IV Finalisation de l étape Démarrer Tomcat puis poursuivre l installation au IV.2.3, page /09/2015 Version doc. : Page 17 sur 39

18 IV.2.2 Configuration manuelle Des exemples d architectures ainsi que la liste des valeurs correspondantes sont présentés dans le document nommé «9 arcopole Studio Annexe 7 Architectures» pour vous guider dans votre installation. IV Configuration serveur IV Configuration du serveur (WEB-INF/) Dans le répertoire \WEB-INF de votre webapp (studio), éditer le fichier configuration.xml Si celui-ci n existe pas, dupliquez configuration.autoconf.xml et renommez le nouveau fichier en configuration.xml. IV Variables d environnement obligatoires Dans le fichier \WEB-INF\configuration.xml, complétez les valeurs des variables dans l entête du fichier Server : nom d hôte et port de la machine Tomcat (SrvArcopole:PortArcopole) AgsHost : nom d hôte et port ArcGIS for Server (SrvAgs:PortAgs) AgsProtocol : protocol d accès à l API REST entre le serveur arcopole et le serveur ArcGIS AgsUser : Utilisateur pour se connecter à ArcGIS for Server AgsPassword : Mot de passe de l utilisateur qui se connecte à ArcGIS for Server WebAppName : Nom de l application déployée dans Tomcat dans le répertoire webapps (studio par défaut) orionhost : Adresse de la webapp suivi de /orion WebServerProtocol : Protocole d accès au serveur web. AgsJobs : Chemin d accès au répertoire arcgisjobs d ArcGIS for Server. AgsOutput : Chemin d accès au répertoire arcgisoutput d ArcGIS for Server. Exemple : <vars> <!-- Variables de configuration à remplir --> <var name="server" value="srvarcopole:portarcopole" /> <var name="agshosts" value="srvags:portags"/> <var name="webappname" value="studio" /> <var name="orionhost" value=" SrvArcopole:PortArcopole/studio/orion" /> <var name="webserverprotocol" value="http" /> <var name="agsuser" value="adminags" /> <var name="agspassword" value="adminags" /> <var name="agsdomain" value="." /> <var name="agsdcomhost" value="srvags" /> <var name="agsjobs" value="c:/arcgisserver/directories/arcgisjobs" /> <var name="agsoutput" value="c:/arcgisserver/directories/arcgisout" /> </vars> 25/09/2015 Version doc. : Page 18 sur 39

19 IV Variables d environnement optionnelles Quelques variables supplémentaires peuvent être nécessaires, en fonction de votre configuration. RepositoryFolder : Chemin du dossier où seront stockés les modèles d objets de couches (Infobulles, Fiches attributaires, Requêtes assistées ) 25/09/2015 Version doc. : Page 19 sur 39

20 IV Configuration du template d applications IV WEB-INF\applications\templateApplication.xml Un fichier similaire au fichier configuration.xml est localisé dans le répertoire \WEB- INF\applications de l application web, sous le nom templateapplication.xml. Ce dernier permet de générer la configuration serveur associée à la création d une nouvelle application. Si ce fichier n existe pas, dupliquez le fichier templateapplication.autoconf.xml et renommez le nouveau fichier en templateapplication.xml. Editer ce fichier et le configurer de la même manière que le précédent. Les variables et propriétés absentes de ce fichier par rapport au fichier de base ne doivent pas être ajoutées. IV WEB-INF\applications\_templateBase\client.xml Si le fichier \WEB-INF\applications\_templateBase\client.xml n existe pas, dupliquez le fichier client.autoconf.xml et renommez le nouveau fichier en client.xml. Dans le fichier client.xml, une seule variable est à configurer : orionhost qui correspond à l URL de la webapp suivi de /orion ( IV Configuration d arcopole Studio (WEB-INF/applications/TFA) Une application est déjà présente dans le répertoire \WEB-INF\applications : l application TFA. Cette configuration d application correspond à l application «arcopole studio» permettant de créer de nouvelles applications. Vous ne devez en aucun cas supprimer ce dossier. La configuration de deux fichiers (configuration.xml et client.xml) est nécessaire : IV Configuration.xml Un fichier similaire au fichier configuration.xml est localisé dans le répertoire \WEB- INF\applications\TFA de l application WEB. Ce dernier permet de générer la configuration serveur associée à la création de l application. Si ce fichier n existe pas, dupliquez configuration.autoconf.xml et renommez le nouveau fichier en configuration.xml. Editer ce fichier et le configurer de la même manière que le précédent. Les variables et propriétés absentes du fichier par rapport au fichier de base ne doivent pas être ajoutées. IV Client.xml Si le fichier client.xml n existe pas, dupliquez client.autoconf.xml et renommez le nouveau fichier en client.xml. Dans le fichier client.xml, une seule variable est à configurer : orionhost qui correspond à l URL de la webapp suivi de /orion ( 25/09/2015 Version doc. : Page 20 sur 39

21 IV Configuration des droits d accès à arcopole Studio (WEB-INF/orionconfig/repository_fmk.xml) Le fichier repository_fmk.xml contient entre autres la gestion des utilisateurs et des groupes, ainsi que les droits d accès aux applications. Pour un premier démarrage, ce fichier ne nécessite pas de paramétrage. Il contient un utilisateur admin (mot de passe arcopole) appartenant au groupe administrateur. Ce fichier est modifié par l application cliente «studio», mais peut être édité à la main (voir Annexe 2 pour plus de détails) IV Configuration du fichier d accès aux webservices pour l impression (WEB-INF/orionconfig/PrintAuth.xml) Les fonctionnalités d impression permettent à l utilisateur final de demander au serveur de réaliser une impression de sa carte comme s il utilisait ArcMap. Le fichier de configuration \WEB- INF\orionConfig\PrintAuth.xml. Ce fichier de configuration indique : Les paramètres de connexion à ArcGIS for Server Les identifiants et mots de passe nécessaires pour se connecter à certains services sécurisés. Si le fichier PrintAuth.xml n existe pas, dupliquez PrintAuth.autoconf.xml et renommez le nouveau fichier en PrintAuth.xml. IV Configuration pour l impression de données internes Pour éviter tout problème de droits, de proxy, etc., la configuration suivante doit être réalisée : Exemple de configuration : <service resturl="@orionhost@/studio/orion/arcgis/rest/services/" soapurl=" /> Cela indique à la fonctionnalité d impression que les requêtes REST peuvent être remplacées par des accès directs à ArcGIS for Server. IV Configuration pour l impression de services sécurisés Chaque service est configuré par une nouvelle ligne dans le fichier et renseigne : URL : L URL du service user : l identifiant du compte password : le mot de passe associé au compte. Exemple de configuration : <service URL=" user="myaccount" password="mypassword" /> 25/09/2015 Version doc. : Page 21 sur 39

22 IV Configuration client IV Configuration d arcopole Studio (studio\clients\arcopole_studio\config.xml) Si le fichier...\clients\arcopole_studio\config.xml n existe pas, dupliquez config.autoconf.xml et renommez le nouveau fichier en config.xml. Editer le fichier config.xml et remplacer le nom du serveur web, le port et le nom de la webapp pour les balises suivantes : «appclienturl», «loginpageurl», «logouturl», «proxyurl» et donnez éventuellement une valeur différente pour «logouttimer». Exemple de configuration : <configuration> ole/index.jsp </appclienturl> </loginpageurl> </logouturl> <logouttimer>15</logouttimer> <!-- In minutes -->... <proxyurl>@webserverprotocol@://srvarcopole:portarcopole/studio/proxy.jsp</proxy Url> </configuration> La valeur indiquée pour «proxyurl» est utilisée pour appeler les services WMS. La valeur indiquée pour «logouttimer» est utilisée pour indiquer le temps au bout duquel l administrateur qui n a pas effectué d action sur l application aura sa connexion au serveur rompue. Au bout du temps indiqué, un message s affichera et forcera l administrateur à se reconnecter. IV Configuration du Client Flash arcopole (studio\clients\clientflasharcopole\config.xml) Si le fichier...\clients\clientflasharcopole\config.xml n existe pas, dupliquez config.autoconf.xml et renommez le nouveau fichier en config.xml. Editer le fichier config.xml et remplacer le nom du serveur web, le port et le nom de la webapp pour les balises suivantes : «loginpageurl», «logouturl», «proxyurl» et donnez éventuellement une valeur différente pour «logouttimer» 25/09/2015 Version doc. : Page 22 sur 39

23 Exemple de configuration : <configuration>... </loginpageurl> </logouturl> <logouttimer>15</logouttimer> <!-- In minutes -->... <proxyurl>@webserverprotocol@:// SrvArcopole:PortArcopole/studio/proxy.jsp</proxyUrl> </configuration> La valeur indiquée pour «proxyurl» est utilisée pour appeler les services WMS. La valeur indiquée pour «logouttimer» est utilisée pour indiquer le temps au bout duquel l utilisateur qui n a pas effectué d action sur l application aura sa connexion au serveur rompue. Au bout du temps indiqué, un message s affichera et forcera l utilisateur à se reconnecter. IV Configuration de la page d accueil (studio\accueil.jsp) Il vous est possible de modifier la valeur «timeoutinterval» du fichier /accueil.jsp afin de modifier le délai d affichage du message de fin de la session. Cette valeur, en millisecondes, est par défault de 15 minutes. IV Finalisation de l étape Démarrer Tomcat puis poursuivre l installation au IV.2.3, page /09/2015 Version doc. : Page 23 sur 39

24 IV.2.3 Utilisation de services sécurisés ArcOpole Studio vous permet d accéder aux services sécurisés par token de votre ArcGIS for Server local. Si vous souhaitez utiliser ces services sécurisés dans des applications arcopole Studio, il est nécessaire de configurer les paramètres d authentification dans le fichier...\studio\web- INF\configuration.xml. Pour cela, il faut au préalable vérifier la configuration de l ArcGIS for Server : Dans ArcGIS Server Manager ( aller dans le menu Sécurité puis modifier les Propriétés des jetons. Par défaut la durée de vie des jetons persistants est de 1 jour, augmentez là (exemple : 365 jours) On peut vérifier la prise en compte de la nouvelle valeur en se connectant à ArcGIS Server Administrator Directory ( puis en navigant jusqu'à la ressource security > tokens. Puis il vous faut : Commenter la connexion au serveur ArcGIS non sécurisé et décommenter la connexion au serveur ArGIS Sécurisé utilisant la facade UniqueUserAGSTokenAuthFacade : <!-- Connexion au serveur ArcGIS --> <!--<connection name="ags0" class="com.esrifrance.orion.connections.ags.agsconnection"> <http hosts="${agshost}" scheme="${agsprotocol}" /> </connection>--> <!-- Connexion au serveur ArcGIS sécurisé --> <connection name="ags0" class="com.esrifrance.orion.connections.ags.agsconnection"> <facade class="com.esrifrance.orion.connections.auth2.token.uniqueuseragstokenauthfacade"> <auth user=" ${AgsUser}" password=" ${AgsPassword}"/> </facade> <http hosts=" ${AgsHost}" scheme=" ${AgsProtocol}" /> </connection> 25/09/2015 Version doc. : Page 24 sur 39

25 IV.2.4 Chargement de la configuration du serveur Par défaut, il est nécessaire de redémarrer Tomcat pour que les modifications effectuées dans le fichier..\studio\web-inf\configuration.xml soient prises en compte. Pour activer la prise en compte à chaud de ses modifications (sans redémarrage de Tomcat), il faut modifier le fichier..\studio\web-inf\web.xml. Ajouter le paramètre autoreload à la servlet RestFmkSrvServletEx : <servlet> <servlet-name>fmk</servlet-name> <servlet-class> com.esrifrance.restfmksrv.servlet.restfmksrvservletex </servlet-class> <init-param> <param-name>autoreload</param-name> <param-value>true</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> A la fin de la configuration, redémarrer Tomcat 25/09/2015 Version doc. : Page 25 sur 39

26 IV.3 CONFIGURATION DE L IMPRESSION IV.3.1 Utilisation de services sécurisés IV ArcGIS for Server local Si vous souhaitez utiliser des services sécurisés de votre ArcGIS for Server local dans des applications arcopole Studio, il est nécessaire de configurer les paramètres d authentification à ces services dans le fichier...\studio\web-inf\orionconfig\printauth.xml. Pour cela, il faut rajouter les paramètres user et password au niveau de la configuration pour l ArcGIS for Server local et les configurer avec le nom d utilisateur/mot de passe utilisé pour accéder au manager de votre ArcGIS for Server : <!-- configuration de l'impression pour connexion direct à l'ags local --> <service resturl=" soapurl= user="mon_utilisateur" password="mon_mot_de_passe" /> IV ArcGIS for Server externe Si vous souhaitez utiliser des services sécurisés d un ArcGIS for Server externe dans des applications arcopole Studio, il est nécessaire de configurer les paramètres d authentification à ces services dans le fichier...\studio\web-inf\orionconfig\printauth.xml. Pour cela, il faut décommenter les lignes ci-dessous et les configurer avec l url d accès au serveur et vos paramètres d authentification : <!-- autorisation pour AGS sécurisés --> <service url=" user="******" password="*********" /> <!-- configuration de l'impression pour connexion direct à l'ags local --> <service resturl=" soapurl=" /> <!-- configuration de l'impression pour connexion direct à des AGS sécurisés --> <service resturl=" soapurl=" /> IV.3.2 Prise en compte des filtres attributaires Si, dans arcopole Studio, vous utilisez la fonctionnalité de filtres attributaires sur des couches des services de l'arcgis for Server Local, il est nécessaire de modifier la configuration du service d impression pour les données internes (publiées sur l ArcGIS for Server Local) dans le fichier...\studio\web-inf\orionconfig\printauth.xml. 25/09/2015 Version doc. : Page 26 sur 39

27 Chaque service de votre ArcGIS for Server local accédé par arcopole Studio avec des filtres attributaires doit être configuré par une nouvelle ligne dans le fichier et renseigner : resturl : L url du service passant par le serveur arcopole. mxd : Chemin vers le fichier.mxd du service. <service resturl="@orionhost@/arcgis/rest/services/<folder>/<service>/mapserver" mxd="chemin_vers_mxd"/> Attention : - si votre ArcGIS for Server local est sécurisé, vous devrez aussi configurer les paramètres user et password pour chacune de ces lignes (comme décrit en IV.3.1.1) - ces lignes doivent être insérées avant les paramètres de connexion à votre serveur arcopole et ArcGIS for Server local : <!-- configuration de l'impression pour connexion direct à l'ags local --> <service resturl="@orionhost@/arcgis/rest/services/" soapurl=" /> Par exemple : <service resturl=" tre/mapserver" mxd="c:\data\cadastre.mxd"/> <service resturl=" apserver" mxd="c:\data\plu.mxd"/> <!-- configuration de l'impression pour connexion direct à l'ags local --> <service resturl=" soapurl=" /> 25/09/2015 Version doc. : Page 27 sur 39

28 IV.3.3 Finalisation du paramétrage Vous avez publié un service nommé «arcopoleprint» dans le répertoire «arcopole». Il va maintenant falloir paramétrer ce MapService pour qu il utilise la nouvelle capacité ajouté par le SOE MxdPrint. Pour cela, connectez-vous à ArcGIS for Server Manager, accédez au paramétrage de ce service et activez la capacité SOEMxdPrinter et paramétrez les propriétés suivantes : templates: \studio\web-inf\printtemplates (voir note ci-dessous) authentification: \studio\web-inf\orionconfig\printauth.xml (voir note ci-dessous) Note : Attention à bien renseigner le chemin d accès complet (en remplaçant le par le chemin d accès physique sur votre serveur, ex : C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\studio\...). Les autres propriétés peuvent être laissées vides. 25/09/2015 Version doc. : Page 28 sur 39

29 IV.4 CONFIGURATION DES RAPPORTS La fonctionnalité d export Excel de l outil de sélection d arcopole Studio utilise le service de géotraitement de rapports publié au paragraphe IV.1.2 (page 8) et plus précisément son moteur XSLT et le modèle resultat_selection.xsl. La fonctionnalité d export Excel et de rapport de l outil d identification multicouches utilise le moteurs XSLT et le modèle identification_multi_couche.xsl ; et le moteur JASPER et le modèle générique identification_multi_couche_geometry.jasper. La fonctionnalité de Rapports utilise le moteurs XSLT et le modèle generique.xsl ; et le moteur JASPER et le modèle générique Generique_MasterReport.jasper. IV.4.1 Configuration des moteurs de rapports Si vous avez conservé les noms du répertoire (arcopole) et du service de rapports (Rapports), vous pouvez passer au IV.4.2 page 30. Si vous avez modifié l un ou l autre, recherchez la configuration de «Rapports» dans le fichier...\studio\web-inf\configuration.xml (vers la fin du fichier). Recherchez les lignes suivantes et paramétrez les parties en rouge : <urlfilter handler-class="com.esrifrance.restfmksrv.handlers.arcopole.report.reporthandler" startwith="/report"> <handler-configuration> <engines> <engine name="jasper" tmppath="${agsinput}" geoprocessingurl="${orionhost}/arcgis/rest/services/arcopole/rapports/gpserver/jasper" modelxmlpath="${apppath}\rapports\jasper\models.xml" alias="ireport"/> <engine name="xslt" tmppath="${agsoutput}" geoprocessingurl="${orionhost}/arcgis/rest/services/arcopole/rapports/gpserver/xslt" modelxmlpath="${apppath}\rapports\xslt\models.xml" alias="xslt"/> </engines> </handler-configuration> </urlfilter> Dans l exemple précédent : tmppath : un dossier partagé entre ArcGIS for Server et Tomcat qui est le répertoire arcgisoutput d ArcGIS for Server. Vérifier l emplacement qui est défini dans la variable AgsOutput en début du fichier de configuration (voir dessous pour en trouver le chemin sur votre serveur). Tomcat va y écrire des fichiers qui devront être lus par ArcGIS for Server. Veillez à ce que les utilisateurs exécutant Tomcat et ArcGIS for Server y accèdent en lecture et écriture. 25/09/2015 Version doc. : Page 29 sur 39

30 geoprocessingurl : l URL REST de la tâche de géotraitement, à modifier éventuellement si vous avez changé le nom du géotraitement ou le répertoire de publication. modelxmlpath : chemin d accès au fichier models.xml correspondant au moteur de rapport (XSLT et JASPER). Répertoire arcgisoutput sur ArcGIS for Server : Par défaut ce répertoire est situé dans : C:\arcgisserver\directories\ arcgisoutput. IV.4.2 Configuration de la récupération des rapports Toujours dans le fichier...\studio\web-inf\configuration.xml, recherchez la configuration de «Chargement sécurisé par Token» (un peu au dessus de la partie précédente). Le chemin d accès au répertoire dans lequel les rapports seront générés est indiqué ci-dessous : <urlfilter startwith="/arcgisjobs" handler-class="com.esrifrance.restfmksrv.handlers.securedownload.sd"> <handler-configuration root_folder="${agsjobs}" > </handler-configuration> </urlfilter> L emplacement du root_folder est défini par la variable Agsjobs qui se trouve au début de fichier de configuration. Cette variable doit indiquer le chemin d accès au répertoire des «jobs» d ArcGIS for Server tel qu indiqué lors de la publication sur service de géotraitement. Vous pouvez trouver cette information à l endroit suivant : 25/09/2015 Version doc. : Page 30 sur 39

31 Répertoire arcgisjobs Dans ArcGIS for Server Manager, propriétés du service Rapports Une fois cela réalisé, redémarrez Tomcat IV.5 CONFIGURATION DES STATISTIQUES D UTILISATION Une configuration des logs d utilisation des applications arcopole est proposée par défaut. Si vous souhaitez modifier certains paramètres, éditez le fichier \WEB-INF\configuration.xml et retouchez le paramétrage des propriétés : Logfiledateformat : Fréquence de génération des logs. Par défaut : c est une fois par mois (yyyy-mm). Applicationlogfolder : Emplacement du fichier de log. Par défaut : c est dans "${AppPath}/WEB-INF/logs/UtilisationApplications" Applicationhostname : Nom du fichier de log. Par défaut, c est «UtilisationApplications». IV.6 CONFIGURATION DE L ASSISTANT DE SAISIE D UNE ETENDUE D OUVERTURE D UNE APPLICATION L assistant de saisie d une étendue peut vous proposer de zoomer sur des objets présents dans l un de vos MapServices. Editez le fichier \WEB-INF\applications\TFA\client.xml et indiquez l URL du MapService que vous souhaitez utiliser (le MapService Cadastre est souvent une bonne base) pour la variable p_mapservice. ATTENTION : l URL du MapService doit commencer par l URL de la webapp suivi de /orion suivi du chemin vers le MapService. 25/09/2015 Version doc. : Page 31 sur 39

32 OK : KO : <component id="extentwizard" p_basemap=" p_defaultextent="" p_mapservice=" " /> Les paramètres de cet assistant peuvent être modifiés selon vos besoins. Element XML Statut Valeurs possibles p_basemap Optionnel Url d un fond de plan p_mapservice Optionnel Url d un service de carte p_defaultextent Optionnel Série de coordonnées : Xmin,Ymin,Xmax,Y max,wkid Description URL du service tuilé (fond de plan avec cache) Ex : services/bdparcellaire/bdparcellaire_v10 _FRA_L93/MapServer?token=xxxx URL du service contenant les couches d étendues déjà existantes. Ce service doit être publié sur l ArcGIS for Server Local (accessible par Orion). Ex : /services/data/cadastre/mapserver Etendue initiale de la carte de l assistant de saisie. Les coordonnées sont séparées par une virgule. Ex: ,181992, ,182726,27563 Le séparateur décimal possible pour les coordonnées est le point. Pour plus d informations sur cette fonctionnalité, veuillez consulter la documentation en ligne : IV.7 INSTALLATION DES EXTENSIONS Les fonctionnalités natives d arcopole Studio peuvent être étendues par l utilisation d extensions. Ces extensions peuvent être développées par Esri France, mais aussi par toute personne disposant de compétences en développement Flex. Vous pouvez découvrir les extensions disponibles en vous rendant sur le site arcopole dans la rubrique Galerie des extensions. Les extensions fonctionnelles compatibles avec la version courante d arcopole Studio ont été téléchargées en même temps qu arcopole Studio lui-même et sont installées par défaut. Pour plus d information sur l installation des extensions, vous pouvez vous reporter à la documentation «Extension Standard - Installation.pdf» téléchargeable avec les extensions elles-mêmes (voir la galerie) 25/09/2015 Version doc. : Page 32 sur 39

33 Les extensions métiers, quant à elles, doivent être téléchargées séparément à partir du site internet. 25/09/2015 Version doc. : Page 33 sur 39

34 V LANCEMENT DE L APPLICATION V.1 LANCEMENT DE L APPLICATION V.2 PAGE D ACCUEIL La page d accueil est accessible à l adresse : (attention aux minuscules/majuscules ) Si vous n avez pas changé la gestion des utilisateurs, vous pouvez vous connecter avec l'identifiant admin (mot de passe arcopole). Vous serez alors redirigé vers arcopole Studio et pourrez créer vos premières applications. C est également à cette page que vos utilisateurs accèderont. Comme dans la copie d écran cidessus, vous aurez la possibilité de mettre certaines de vos applications accessibles sans authentification. Vos utilisateurs se connectant auront en plus accès aux applications sécurisées. Pour valider le bon fonctionnement, suivez les quelques tests et vérifications proposées cidessous. 25/09/2015 Version doc. : Page 34 sur 39

35 VI TESTS ET VERIFICATIONS VI.1 TEST DE LA CONNEXION A ARCGIS ONLINE Depuis arcopole Studio 3.1 il est possible d accéder à ArcGIS Online pour profiter des services publiés publiquement ou au sein de votre organisation. Pour pouvoir profiter de cette nouveauté il faut que votre serveur web Tomcat ait accès à Internet. VI.1.1 Test de la configuration Cette étape permet de tester la configuration de l accès à Internet et à ArcGIS Online depuis le serveur Tomcat (c est le serveur Tomcat qui va accéder à ArcGIS Online). La page de test est accessible à l adresse : Cliquez ensuite sur le lien «Tester l accès à ArcGIS Online». Vous devez obtenir le message suivant : VI.1.2 Résolution rapide des problèmes VI Pas d accès à internet L accès à internet est testé en essayant de récupérer le fichier à l URL suivante : Si ce fichier ne peut être récupéré, l accès à Internet ne fonctionne pas depuis le serveur. Veuillez consulter la procédure décrivant comment configurer Tomcat pour qu arcopole Studio puisse accéder aux services proposés par ArcGIS Online. VI Pas d accès à ArcGIS Online Si l accès à internet est bon mais pas l accès à ArcGIS Online, vérifiez avec votre Direction informatique que : La connexion en HTTPS est bien possible depuis votre serveur (firewall, règles de proxy, ) le site est bien autorisé pour votre serveur. Si Tomcat passe par un proxy pour accéder à Internet alors : 25/09/2015 Version doc. : Page 35 sur 39

36 si le proxy ne requiert pas d authentification : dans le fichier \WEB- INF\configuration.xml rajoutez le paramètre proxy à la connexion agol et paramétrez son host (ex : ) et son port (ex : 1256) puis redémarrez Tomcat. <!-- Connexion à ArcGIS Online --> <connection name="agol" class="com.esrifrance.orion.connections.agol.agolconnection"> <http hosts=" scheme="http" /> <proxy host="mon_proxy" port="mon_port_proxy"/> </connection> si le proxy requiert une authentification : cette architecture n est pas encore supportée actuellement. VI.2 TEST DE L IMPRESSION Créez une application et modifiez là. Dans l onglet «Fonctionnalités», ajoutez l impression à votre application. Un gabarit d impression doit apparaitre sous la fonctionnalité d impression : Si c est le cas, votre fonction d impression devrait fonctionner facilement, Si ce n est pas le cas, cela indique qu arcopole Studio n a pas pu récupérer la liste des gabarits. Pour créer vos propres gabarits d impression, consultez la documentation nommée «Annexe 3 - Création de gabarits d'impression» disponible sur la page des documentations d arcopole Studio. VI.2.1 Résolution rapide des problèmes VI Nom du service d impression Un nom par défaut est attendu par arcopole Studio pour le service d impression que vous avez publié au IV.1.4, page 15. Répertoire de publication du service : arcopole Nom du MapService : arcopoleprint et se trouve dans le répertoire «arcopole» Attention à la casse «arcopole/arcopoleprint» est différent de «arcopole/arcopoleprint» Nous vous conseillons de conservé le nom proposé par défaut. Donc si votre service n a pas le nom «arcopole/arcopoleprint», nous vous conseillons de reprendre la phase de publication de ce service. Si vous tenez à conserver un nom différent de celui proposé par défaut : Ouvrez le fichier \WEB-INF\configuration.xml Recherchez le terme «mxdprint» Modifiez le nom du répertoire et/ou du service indiqué comme indiqué ci-dessous Redémarrez Tomcat <urlfilter startwith="/mxdprint" handler-class="com.esrifrance.restfmksrv.handlers.print.mxd.printmxdhandler3"> 25/09/2015 Version doc. : Page 36 sur 39

37 <handler-configuration> <Redirect absoluteurl="/arcgis/rest/services/arcopole/arcopoleprint/mapserver/exts/soemxdprinter"/> </urlfilter> </handler-configuration> VI Activation et paramétrage du SOE Vérifiez si vous avez correctement activé et paramétré la capacité SOEMxdPrinter sur le MapService d impression. Pour cela, vérifiez le paramétrage indiqué au IV.3.3, page 28. Vérifiez également que l utilisateur qui execute les services ArcGIS peut accéder en lecture au répertoire indiqué dans la propriété Templates. VI Log du service d impression Consultez le log du service d impression dans le Manager d ArcGIS for Server. VI Impression d objets sélectionnés, de mesures, de géonotes ou de localisation XY Si des erreurs se produisent lors de l impression de nombreux objets sélectionnés sur la carte, de mesures, de géonotes ou de localisation XY, il peut être nécessaire de modifier certains points de configuration. Par défaut, le nombre d objets (sélection, mesures, geonotes, localisationxy) qui peuvent être imprimés est limité à 200. Vous pouvez modifier cette valeur maximum dans la configuration de votre application. Pour cela, ouvrez le fichier client.xml de votre application et modifier la valeur du paramètre «maxgraphicsallowed» du composant «MxdPrint» : <component id="mxdprint" maxgraphicsallowed="200" 25/09/2015 Version doc. : Page 37 sur 39

38 select_roles="grouprole_toutlemonde:true,grouprole_administrateurs:true" useadvancedgraphiclayerprint="true" useoptimizeprintmode="false"> NB : il est possible de supprimer cette limitation en mettant la valeur -1. L impression peut échouer si la configuration de votre plateforme ne permet pas l impression d un grand nombre de ces objets. Nous vous recommandons de consulter les logs du serveur arcopole et d adapter votre configuration en fonction de vos besoins d impression et des erreurs retournées par le serveur lors de l impression. Symptôme 1 : L impression d un document avec un très grand nombre d objets échoue (Par exemple : 1000 batiments sélectionnés). La requête /studio/orion/mxdprint/print envoyée au serveur arcopole retourne une erreur HTTP 500 (Internal Error). La requête /arcgis/rest/services/arcopole/arcopoleprint/mapserver/exts/soemxdprinter/print envoyée par le serveur arcopole à ArcGIS for Server retourne une erreur HTTP 200 avec l erreur 498 InvalidToken. Cette erreur est provoquée par la taille de la requête POST envoyée au serveur arcopole qui n est pas supportée par le serveur Tomcat. Il est nécessaire d augmenter la taille maximum de requête POST supportée par le serveur Tomcat. Pour cela, ouvrez le fichier..\apache-tomcat-x.0\conf\server.xml et modifiez la valeur de l attribut maxpostsize de tous les connectors (Par défaut, cette valeur est limitée à 2Mo). Par exemple : <Connector connectiontimeout="20000" port="8080" protocol="http/1.1" redirectport="8443" URIEncoding="UTF-8" maxpostsize="-1"/> <Connector port="8009" protocol="ajp/1.3" redirectport="8443" URIEncoding="UTF-8" maxpostsize="-1"/> Pour plus d information, reportez-vous à la documentation du serveur Tomcat : Symptôme 2 : L impression d un document avec un grand nombre de géonotes avec différentes symbologies échoue (Par exemple : 100 géonotes multi symboles). La requête /studio/orion/mxdprint/print envoyée au serveur arcopole retourne une erreur HTTP 500 (Internal Error). La requête /arcgis/rest/services/arcopole/arcopoleprint/mapserver/exts/soemxdprinter/print envoyée par le serveur arcopole à ArcGIS for Server retourne une erreur HTTP 200 avec l erreur Out Of memory error. Il est nécessaire d augmenter la mémoire allouée aux arcgissoc. Pour cela, ouvrez le fichier..\arcgis_home\framework\etc\machine-config.xml et modifiez la valeur du paramètre SOCMaxHeapSize. <SocMaxHeapSize>64</SocMaxHeapSize> Pour plus d information, reportez-vous au forum ESRI Symptôme 3 : Malgré les paramétrages précédents, l impression échoue toujours. La requête /studio/orion/mxdprint/print envoyée au serveur arcopole retourne une erreur HTTP 500 (Internal Error). La requête 25/09/2015 Version doc. : Page 38 sur 39

39 /arcgis/rest/services/arcopole/arcopoleprint/mapserver/exts/soemxdprinter/print envoyée par le serveur arcopole à ArcGIS for Server retourne une erreur HTTP 200 avec le message success=true. En analysant les trames HTTP, vous vous rendez compte que le serveur arcopole retourne l erreur http 500 avec d avoir reçu la réponse du SOE qui contient bien le résultat de l impression. Il est alors nécessaire d augmenter le request timeout du serveur arcopole. Pour cela, ouvrez le fichier de configuration du serveur arcopole..\studio \WEB-INF\configuration.xml et augmenter la valeur de la propriété orion.requestimeout. <!-- Time out d'une requete vers le serveur ArcGIS --> <property name="orion.requesttimeout" value="35000" /> VI.3 TEST DES RAPPORTS Créez une application avec n importe quel MapService ainsi que la fonctionnalité de Sélection. Lancez cette application, Sélectionnez manuellement des données dans une des couches disponibles et cliquez sur le bouton «Exporter le tableau dans Excel». Vous devez récupérer un fichier en retour de cet appel. Si tel n est pas le cas, reportez-vous à la documentation nommée «Corriger le problème "File not found" sur les rapports» disponible sur la page des documentations d arcopole Studio. 25/09/2015 Version doc. : Page 39 sur 39