arcopole Studio Version 3.1 Documentation d installation Mise à jour depuis une version antérieure Site du programme arcopole : www.arcopole.fr Auteur du document : ESRI France Version de la documentation : 3.1.0.2 Date de dernière mise à jour : 30/01/2014
Sommaire I Introduction... 3 I.1 Le programme arcopole... 3 I.2 Qu est-ce qu arcopole Studio?... 3 I.4 Quoi de neuf dans cette version d arcopole Studio?... 4 I.5 Contenu de ce document... 5 II Mise à jour depuis la version 3.0... 6 II.1 Sauvegarde de la version précédente... 6 II.2 Mise à jour de la webapp... 7 II.3 Vidage du cache des postes clients... 10 II.4 Vidage du cache Tomcat... 10 II.5 Mise à jour des applications SIG... 10 III Mise à jour depuis une version antérieure à la 3.0... 11 III.1 Sauvegarde de la version précédente... 11 III.2 Installation de la nouvelle version... 11 III.3 Vidage du cache des postes clients... 11 III.4 Récupération de la configuration précédente... 12 30/01/2014 Version doc. : 3.1.0.2 Page 2 sur 12
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. Dans cette aide à l utilisation des technologies Esri, plusieurs templates sont disponibles sur le site www.arcopole.fr. I.2 QU EST-CE QU ARCOPOLE STUDIO? ArcOpole Studio est un des templates disponibles sur le site www.arcopole.fr. Il s agit d un générateur d applications Flex pour ArcGIS 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 Identification Multicouche (IMC) Géotraitements (bêta) Rapports La documentation complète de ces extensions est disponible sur le site internet www.arcopole.fr 30/01/2014 Version doc. : 3.1.0.2 Page 3 sur 12
I.3 QUOI DE NEUF DANS CETTE VERSION D ARCOPOLE STUDIO? La version 3.1 d arcopole Studio est la première version qui supporte trois versions d ArcGIS for Server. Elle apporte également de nouvelles fonctionnalités de création de rapports génériques ou personnalisés et offre un premier niveau d intégration avec ArcGIS Online. I.3.1 Côté administrateur I.3.1.1 I.3.1.2 I.3.1.3 Support conjoint des versions 10.0, 10.1 et 10.2 d ArcGIS for Server ArcGIS for server 10.0, 10.1 et 10.2 peuvent être utilisés, La quasi-totalité des fonctionnalités sont disponibles sur les deux plateformes Paramétrage de rapports génériques ou spécifiques L extension Rapports permet de générer des rapports sur des sélections ou des identifications multicouches. Les rapports peuvent être des rapports de synthèses ou présentant le détail de chacun des objets sélectionnés Les logiciels OpenSource JasperReport et ireport sont utilisés (voir le tutoriel) Intégration avec ArcGIS Online Il est possible d accéder aux ressources Map Images et Tuiles d ArcGIS Online, directement depuis arcopole Studio, A chaque utilisateur arcopole, vous pouvez associer son nom d utilisateur dans ArcGIS Online. Si des ressources sécurisées sur ArcGIS Online sont utilisées pour construire une application, l utilisateur pourra ainsi en bénéficier dans le Client arcopole. I.3.2 Côté utilisateur I.3.2.1 I.3.2.2 Rapports génériques ou spécifiques sur les couches S ils sont paramétrés, les rapports génériques et spécifiques sont disponibles sur chacun des objets d une sélection, sur la sélection entière. Si plusieurs rapports sont disponibles, l utilisateur peut choisir celui qu il souhaite. Identification Multicouche (IMC) Il est maintenant possible d exporter le résultat d une identification multicouche soit vers Excel soit en PDF Les gabarits de rapports utilisés peuvent être soit génériques, soit spécifique à cette identification La liste complète des nouveautés, évolutions et corrections est disponible dans le fichier what s new.txt situé à la racine du téléchargement d arcopole Studio 3.1. 30/01/2014 Version doc. : 3.1.0.2 Page 4 sur 12
I.4 CONTENU DE CE DOCUMENT Vous trouverez dans ce document toutes les informations nécessaires à la mise à jour d arcopole Studio. La mise à jour d arcopole Studio est aisée si vous disposez de la version juste antérieure (3.0). Les pages suivantes vous guide dans cette mise à jour pas-à-pas. Si vous disposez d une version plus ancienne, vous devez réaliser une installation vierge puis y copier vos fichiers de configuration d applications. Les mêmes conventions que celles utilisées dans la documentation d installation sont conservées ici. 30/01/2014 Version doc. : 3.1.0.2 Page 5 sur 12
II MISE A JOUR DEPUIS LA VERSION 3.0 La mise à jour d arcopole Studio depuis la version précédente est possible depuis une version antérieure se fait manuellement. Les étapes suivantes devront être suivies : Note importante : cette procédure de mise à jour a été rédigée pour les utilisateurs d arcopole Studio qui dispose d une version standard de l outil. Si vous avez développé (ou fait développer) des fonctionnalités spécifiques, des extensions personnelles ou modifier l interface de l outil (skin), ne mettez pas à jour votre application sans voir validé techniquement que vos développement fonctionneront (création d une plateforme de test fortement conseillée). II.1 SAUVEGARDE DE LA VERSION PRECEDENTE Après avoir arrêté Tomcat, faites une sauvegarde complète du répertoire d installation de la version précédente d arcopole Studio ( \webapps\studio par défaut) en l archivant sous la forme d un fichier ZIP par exemple. Ne dupliquez pas simplement le répertoire en le laissant dans \webapps, cela aurait comme conséquence de déployer une nouvelle application Web. 30/01/2014 Version doc. : 3.1.0.2 Page 6 sur 12
II.2 MISE A JOUR DE LA WEBAPP L objectif de cette étape est de 1. supprimer les fichiers qui ont été mis à jour dans cette nouvelle version, 2. copier les nouveaux fichiers, 3. modifier légèrement la configuration pour profiter des nouveautés II.2.1 Suppression des anciens fichiers II.2.1.1 Ancienne page de login en Flex Supprimez le répertoire studio/clients/clientflasharcopolelogin. II.2.1.2 Anciennes librairies du client Dans les répertoires studio/clients/clientflasharcopole et studio/clients/arcopole_studio, supprimez les fichiers suivants : II.2.1.3 agslib-3.0-2012-06-06.swf Anciennes librairies du serveur Dans WEB-INF/libs, supprimez les fichiers suivants : II.2.1.4 arcopole-login-1.1-20130122.135418-28.jar orion-10.0.7-20130122.133157-32.jar orion-api-10.0.5-20130107.154630-4.jar orion-rest-10.0.8-20121017.162345-4.jar orionjsonparser-1.0.4-20121115.165706-3.jar restfmksrv-10.0.2-snapshot.jar servlet-api-2.4.jar soap-proxies-10.0.1.jar Fichiers des extensions Dans les répertoires studio/clients/clientflasharcopole/extensions et studio/clients/arcopole_studio/extensions, supprimez le fichier suivant : ExtensionCopyright.swf L extension Copyright est supprimée car l API Flex d ArcGIS Server prend maintenant nativement en charge les copyright des MapServices. Les extensions Cadastre et PLU ont fait l objet de mises à jour. Chacune de ces extensions dispose de sa propre documentation d installation que vous devez suivre pour leur mise à jour. Notez qu une nouvelle extension est maintenant disponible, il s agit de l extension Connecteur ADS Operis. Cette extension vous permet d établir un dialogue bi-directionnel entre les applications arcopole Studio et les logiciels ADS du groupe Operis (Droit de Cité ou Oxalis). Toutes les informations sur cette nouvelle extension sont disponibles sur cette page du site arcopole. II.2.2 Copie des nouveaux fichiers Copiez l ensemble des fichiers du répertoire «maj_depuis_3-0» dans la webapp existante et accepter tous les remplacements des fichiers existants. 30/01/2014 Version doc. : 3.1.0.2 Page 7 sur 12
II.2.3 Modification de fichier de configuration Attention lors des copier/coller depuis le fichier PDF. Il arrive que des espaces impromptus se glissent ou que des caractères soient tronqués pendant l opération. II.2.3.1 Modification de la configuration du serveur Il faut modifier les fichiers configuration-10.0.autoconf.xml, configuration-10.1.autoconf.xml et configuration.xml situés dans studio/web-inf pour y inclure les informations suivantes. Dans la section <override-classes>, ajouter les lignes suivantes : <override-class implementation-class="com.esrifrance.orion.connections.externalconnectionmanager" service-class="com.esrifrance.orion.connections.iexternalconnectionmanager" /> Cherchez la classe AGSFileOverRetryHandlerSecure et la remplacer par AGSFailoverRetryHandlerNoToken (dans configuration-10.0.autoconf.xml seulement) : <override-class service-class="com.esrifrance.orion.handlers.loadbalancer.iagsfailoverretryhandler" implementation-class="com.esrifrance.orion.handlers.loadbalancer.agsfailoverretryhandlernotoken" /> Juste après la balise </override-classes>, ajouter les lignes suivantes : <!-- Configuration des connexions externes --> <configuration name="connections"> <!-- Connexion à argisonline --> <connection name="agol" class="com.esrifrance.orion.connections.agol.agolconnection"> <http hosts="www.arcgis.com" scheme="http" /> </connection> </configuration> Dans la section <dispatcher>, ajouter les lignes suivantes : <urlfilter handler-class="com.esrifrance.orion.handlers.proxy.proxyexternalconnectionhandler" pattern="/proxy/{externalconnection}//.* /proxy//.*"> <handler-configuration> </handler-configuration> </urlfilter> 30/01/2014 Version doc. : 3.1.0.2 Page 8 sur 12
II.2.3.2 Configuration des modèles de rapports Il faut ajouter la configuration des modèles de rapports de l extension Identification multicouches et de l extension Rapports dans les fichiers models.xml des sous répertoires xslt et jasper du répertoire../rapports. Dans le fichier models.xml du répertoire xslt, ajouter : <!-- Extension Identification multi couches --> <Model name="identificationmulticouche" alias="rapport d'identification multi-couche" modeltype="multilayer" path="c:\program Files\Apache Software Foundation\Tomcat 6.0\webapps\studio\rapports\xslt\models\identification_multi_couche\identification_multi_couche.xsl"> </Model> <!-- Extension Rapport --> <Model name="generique" alias="rapport generique" modeltype="object" path="c:\program Files\Apache Software Foundation\Tomcat 6.0\webapps\studio\rapports\xslt\models\generique\generic.xsl"> </Model> et vérifier que le chemin absolu d accès au modèle de rapport est correct pour votre configuration serveur. Dans le fichier models.xml du répertoire jasper, ajouter : <!-- Extension Identification multi couches --> <Model name="identificationmulticouche" alias="rapport d'identification multi-couche" modeltype="multilayer" path="c:\program Files\Apache Software Foundation\Tomcat 6.0\webapps\studio\rapports\jasper\models\identification_multi_couche\identification_multi_couche_geometry.jasper"> </Model> <!-- Extension Rapport --> <Model name="generique" alias="rapport générique" modeltype="object" path="c:\program Files\Apache Software Foundation\Tomcat 6.0\webapps\studio\rapports\jasper\models\generique\Generique_MasterReport.jasper"> </Model> et vérifier que le chemin absolu d accès au modèle de rapport est correct pour votre configuration serveur. II.2.3.3 Modification de la configuration du l application studio Il faut modifier les fichiers client.xml et client.autoconf.xml situés dans le répertoire studio\web- INF\applications\TFA. Après la balise <services>, ajouter : <service id="agolservice"> <searchitems defaultfilter="owner:arcopolestudio and tags:basemap" limit="30"/> </service> Dans la section <service id="externallibrairiesloader">, si elle est présente, supprimer la ligne suivante : <module>extensions/extensioncopyright.swf</module> et ajouter : <module>extensions/extensionrapport.swf</module> 30/01/2014 Version doc. : 3.1.0.2 Page 9 sur 12
II.3 VIDAGE DU CACHE DES POSTES CLIENTS La mise à jour de l application nécessite que les fichiers qui ont été sauvegardés dans les caches des navigateurs soient mis à jour. Pour cela, il vous faut vider le cache de votre navigateur afin de provoquer le téléchargement de la nouvelle version des fichiers. Note : cette étape est à réaliser sur les postes de vos utilisateurs également II.4 VIDAGE DU CACHE TOMCAT Dans %TOMCAT%/work/Catalina/localhost/ supprimez le répertoire de votre application (studio par défaut). II.5 MISE A JOUR DES APPLICATIONS SIG Afin de mettre à jour les applications SIG que vous aviez précédemment créées, il vous suffit de les ouvrir dans arcopole Studio comme si vous souhaitiez les modifier et de les réenregistrer. ArcOpole Studio se chargera de mettre à jour le fichier de configuration de l application de manière ad hoc. Redémarrez Tomcat pour prendre en compte cette configuration. 30/01/2014 Version doc. : 3.1.0.2 Page 10 sur 12
III MISE A JOUR DEPUIS UNE VERSION ANTERIEURE A LA 3.0 La mise à jour depuis une version 2.2 ou antérieure nécessite de : sauvegarder votre version actuelle, installer la nouvelle version de zéro, Ensuite, pour les applications deux solutions se présentent : o Soit les recréer de toute pièce o Soit récupérer la configuration des applications que vous aviez créées. III.1 SAUVEGARDE DE LA VERSION PRECEDENTE Après avoir arrêté Tomcat, faites une sauvegarde complète du répertoire d installation de la version précédente d arcopole Studio ( \webapps\studio par défaut) en l archivant sous la forme d un fichier ZIP par exemple. Ne dupliquez pas simplement le répertoire en le laissant dans \webapps, cela aurait comme conséquence de déployer une nouvelle application Web. III.2 INSTALLATION DE LA NOUVELLE VERSION Pour connaître toutes les étapes de l installation de la nouvelle version, reportez-vous à la documentation d installation et de configuration. Pour valider votre installation, essayez de créer une ou deux applications et, une fois cela confirmé, passez à l étape suivante de la récupération des applications. III.3 VIDAGE DU CACHE DES POSTES CLIENTS La mise à jour de l application nécessite que les fichiers qui ont été sauvegardés dans les caches des navigateurs soient mis à jour. Pour cela, il vous faut vider le cache de votre navigateur afin de provoquer le téléchargement de la nouvelle version des fichiers. Note : cette étape sera à réaliser sur les postes de vos utilisateurs également 30/01/2014 Version doc. : 3.1.0.2 Page 11 sur 12
III.4 RECUPERATION DE LA CONFIGURATION PRECEDENTE III.4.1 Fichier des utilisateurs Le fichier des utilisateurs est le fichier \WEB-INF\orionConfig\repository_fmk.xml. Il vous faut : Archiver le fichier de la nouvelle installation, Copier votre ancien fichier à la place du nouveau III.4.2 Copie des applications III.4.2.1 Copie de la configuration Copiez le dossier correspondant à l application «monappli» situé dans le répertoire des applications (par exemple \ancienstudio\web-inf\applications) dans la nouvelle installation (par exemple webapps\nouveaustudio\web-inf\applications). III.4.2.2 Eventuellement : modification des fichiers de configuration Si la nouvelle version d arcopole Studio est installée sous la forme d une webapp différente (le nom du répertoire dans Tomcat est différent, par exemple avant \webapp\studio30 et maintenant \webapp\studio31), il vous faut rechercher et remplacer l ancien nom par le nouveau dans les fichiers suivants : \WEB-INF\applications\monAppli\client.xml \WEB-INF\applications\monAppli\configuration.xml Notez que si vous en avez profité pour changer de plateforme, il vous faut également adapter les noms des serveurs dans ces fichiers de configuration III.4.2.3 Ajout des droits d accès à l application Ouvrez le fichier \WEB-INF\orionConfig\repository_fmk.xml de l ancienne installation et recherchez la balise XML Resource contenant le nom de votre application. <Resource cn="application:\2f\2fmonappli"dn="cn=application:\2f\2ftestldap,ou=ressourcebasedn"> <Role name="userrole_gurvan"> <Right name="select">true</right> </Role> <Role name="grouprole_toutlemonde"> <Right name="select">true</right> </Role> </Resource> Copiez cette configuration dans le nouveau fichier repository_fmk.xml entre les balises <Applications> et </Applications>. Redémarrez Tomcat pour prendre en compte cette configuration. 30/01/2014 Version doc. : 3.1.0.2 Page 12 sur 12