Mise à jour depuis une version antérieure

arcOpole Studio
Version 3.1
Documentation d’installation
Mise à jour depuis une version antérieure
Site du programme arcOpole :
Auteur du document :
Version de la documentation :
Date de dernière mise à jour :
www.arcopole.fr
ESRI France
3.1.0.2
30/01/2014
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
I
I.1
INTRODUCTION
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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
Support conjoint des versions 10.0, 10.1 et 10.2 d’ArcGIS for Server


I.3.1.2
Paramétrage de rapports génériques ou spécifiques



I.3.1.3
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


I.3.2
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
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.
Côté utilisateur
I.3.2.1
Rapports génériques ou spécifiques sur les couches


I.3.2.2
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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 :

agslib-3.0-2012-06-06.swf
II.2.1.3
Anciennes librairies du serveur
Dans WEB-INF/libs, supprimez les fichiers suivants :








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
II.2.1.4
Fichiers des extensions
Dans
les
répertoires
studio/clients/clientFlashArcopole/extensions
studio/clients/arcopole_studio/extensions, supprimez le fichier suivant :

et
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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 name="connections">

<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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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 :

<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>

<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 :

<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>

<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\WEBINF\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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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 :



III.1
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.
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
arcOpole Studio v3.1 – Installation – Mise à jour d’une version antérieure
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

Download Report