9 Modalità di funzionamento di MOCLA

LOMBARDIA INFORMATICA S.p.A.
DRE/SIT
Mo.Cla
Installazione e modalità di utilizzo
Codice documento: Z1SICDRE02012/SDFMoClaManuale
Numero release:
2.2
Data di emissione: 09/04/2004
Approvaz.>
Nome
Resp. Dipartimento SIT
Guido De Carolis
Firma
Emissione>
Nome
Firma
Area 628
Paolo Tacchino
CRONOLOGIA DEI RELEASE:
Numero Data di
release emissione
Sintesi delle variazioni
2.0
29/10/2003
Prima emissione
2.1
15/12/2003
Seconda emissione
2.2
09/04/2004 Terza emissione
SOSTITUISCE E MODIFICA:
2.1
LIMITI DI UTILIZZO
Regione Lombardia
Indice
1 Introduzione............................................................................................................ 4
2 Installazione del Web Server Microsoft IIS ........................................................ 5
3 Installazione Web Server Apache......................................................................... 7
4 Installazione JAVA JDK ...................................................................................... 8
5 Installazione Application Server Java Tomcat ................................................. 10
6 Integrazione Tomcat – Apache ........................................................................... 13
7 Integrazione Tomcat - IIS ................................................................................... 15
8 Deployment della web application MOCLA ..................................................... 24
9 Modalità di funzionamento di MOCLA ............................................................ 28
10 Utilizzo mediante interfaccia Web: .................................................................... 29
10.1 Esplorazione Albero delle Classificazioni (index.jsp) ....................................................... 29
10.2 Visualizzazione dell’albero delle classificazioni in formato XML (index.jsp) .................. 30
10.3 Gestione dell’Albero delle Classificazioni (gestione.jsp) .................................................. 32
10.3.1 Gestione dell’Albero delle Classificazioni: Aggiungi (gestione.jsp)...................... 32
10.3.2 Gestione dell’Albero delle Classificazioni: Modifica (gestione.jsp) ...................... 33
10.3.3 Gestione dell’Albero delle Classificazioni: Rimuovi (gestione.jsp) ....................... 33
11 Mediante chiamata a URL Internet con parametri di richiesta. .................... 34
11.1 Restituzione delle informazioni associate ad un Albero di Classificazione in formato
XML in funzione del codice. ....................................................................................................... 34
11.2 Richiesta Assegnazione Codice di Classificazione da applicazioni esterne....................... 34
12 Mediante chiamata a metodi di un WebService ............................................... 35
12.1 Disponibilità di proxy class in linguaggio Java e VB/VBA ............................................... 35
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 3/35
1
Introduzione.
Scopo di questo documento è fornire le istruzioni per l’installazione di MOCLA.
La prima parte del documento si occupa della preparazione dell’ambiente per il deployment
dell’applicazione MOCLA. In particolare verranno fornite le istruzioni per l’installazione di
un Web Server Apache 2 o IIS 5.0 con il Servlet Engine Tomcat 4.
La seconda parte si occupa di mostrare le modalità di utilizzo dell’ applicazione sviluppata.
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
2 Installazione del Web Server Microsoft IIS
Seguire il percorso: Start Impostazioni Pannello di Controllo Installazione
Applicazioni e selezionare la voce sulla sinistra Installazione Componenti di Windows.
Dal menu Aggiungi Componenti di Windows verificare se IIS è stato già installato, altrimenti
selezionarlo
dopo aver installato il Servizio di IIS, anche nel caso in cui tale servizio sia già stato installato
verificare nella cartella Servizi(Start Impostazioni Pannello di Controllo Installazione
Applicazioni  Strumenti di Amministrazione Servizi) la presenza dei servizi evidenziati,
come nella figura.
-dalla lista dei Servizi NT
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 5/35
Eventualmente lanciare il Sistema di Aggiornamento di Windows (Windows Update).
Testare il funzionamento del web server (Start Impostazioni Pannello di Controllo
Installazione Applicazioni Gestione Servizi Internet), avviare il servizio .
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
3
Installazione Web Server Apache
OSS: Passo opzionale se si installa un ambiente di sviluppo/test (basta
tomcat 4.X)
NOTA: verifica se è stato installato in automatico IIS dal setup del Sistema
Operativo
Installare Apache 2.0.45_nossl
- Eventualmente installare MSI_installer se non già presente.
- Installare apache_2.0.45-win32-x86-no_ssl.msi.
- Configurare Apache editando il file http.conf
o # Port: The port to which the standalone server listens. Certain
firewall products must be configured before Apache can listen to a
specific port. Other running httpd servers will also interfere with
this port. Disable all firewall, security, and other services if you
encounter problems. To help diagnose problems use the Windows
NT command NETSTAT –a
Port 80
o Verificare il funzionamento digitando
URL=http://<nomeserver>:port/
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 7/35
4 Installazione JAVA JDK
- Installare JDK 1.4.0 o successive nella directory di installazione proposta
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
Verificare se l’installazione della J2sdk è stata registrata correttamente ( StartEseguicmd
lanciare il comando: ‘ java –version’)
- Settare la variabile d’ambiente JAVA_HOME alla directory di installazione di JDK
(Pannello di controllo  Sistema Avanzate)
Aggiungere JAVA_HOME al Path aggiungendo al valore variabile:
;%JAVA_HOME%\bin
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 9/35
5 Installazione Application Server Java Tomcat
Scaricare dal sito http://archive.apache.org/dist/jakarta/tomcat-4/ una versione di Tomcat ad
es: nella cartella:
http://archive.apache.org/dist/jakarta/tomcat-4/archive/v4.1.24/bin/
scaricare la 4.1.24: http://archive.apache.org/dist/jakarta/tomcat4/archive/v4.1.24/bin/jakarta-tomcat-4.1.24-LE-jdk14.exe
Lanciare l’installer
all’inizio visualizza quale JVM sta utilizzando.
Assicurarsi di attivare NT Service
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
Impostare un path senza spazi e caratteri particolari Es:
- impostare la porta di default alla 8080 (in questo modo non sarà necessario specificarla in
seguito nell’URL)
definire username :xxxxxx
password : xxxxx per la console di amministrazione
remota.
Settare le variabili d’ambiente CATALINA_HOME alla directory di installazione di Tomcat
(come è stato fatto per la variabile di ambiente JAVA_HOME).
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 11/35
- Testare il servizio Tomcat (servizi NT) Start e Stop del servizio (OSS: l’installer avvia già il
servizio)
Per verificare se Tomcat funziona correttamente:
far partire il servizio:
collegarsi a http://<nome_host> ( http://localhost:8080/)
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
6 Integrazione Tomcat – Apache
OSS: Passo richiesto solo se si è installato Apache
Modificare il file server.xml (C:\Tomcat 4.1\conf)
Disattivare http connector
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<!-<Connector className="org.apache.catalina.connector.http.HttpConnector"
port="8080" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="10" debug="0" connectionTimeout="60000"/>
-->
<!-- Note : To disable connection timeouts, set connectionTimeout value
to -1 -->
Verificare che sia attivo l’AJP 1.3 Connector on port 8009
<!-- Define an AJP 1.3 Connector on port 8009 -->
<Connector className="org.apache.ajp.tomcat4.Ajp13Connector"
port="8009" minProcessors="5" maxProcessors="75"
acceptCount="10" debug="0"/>
Creare una directory connector nella directory di installazione di tomcat e copiare:
mod_jk.dll (versione per tomcat3.3)
workers.properties
Settare workers.properties
workers.tomcat_home = "D:\Apache Tomcat 4.0"
#
# workers.java_home should point to your Java installation. Normally
# you should have a bin and lib directories beneath it.
#
workers.java_home = c:\j2sdk1.4.x ----NOTA: path dove è stato installato l’ambiente JAVA
2 SDK
Modificare il file di configurazione di Apache httpd.conf:
Inserire le seguenti righe:
#-----------------------------------------------------------------------------# : connector to TOMCAT
#
#-----------------------------------------------------------------------------LoadModule jk_module "C:/Tomcat 4.1/connector/mod_jk2-2.0.43.dll"
<IfModule mod_jk.c>
JkWorkersFile "C:/Tomcat 4.1/connector/workers.properties"
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 13/35
JkLogFile logs/mod_jk.log
JkLogLevel error
JkMount /*.jsp ajp13
JkMount /servlet/* ajp13
JkMount /examples/* ajp13
</IfModule>
Se c’è struts:
jkMount /*.do ajp13
Attivare Apache e verificare il funzionamento del connector: ad esempio
hhtp://www.miowebserver.it/examples/
Dovrebbero partire gli esempio di Tomcat.
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
7 Integrazione Tomcat - IIS
NOTA: i file di configurazione per IIS si trovano (connector_1.2.2)
Scaricare il seguente file http://jakarta.apache.org/builds/jakarta-tomcat-connectors/jk/...
/isapi_redirect.dll (160Kb)
isapi_redirect.dll - Copiare il file nella directory bin di Tomcat (versione 1.2.2)
worker.properties – (/apache/tomcat/connector/)
Editare il file workers.properties ed aggiornare le linee workers.java e workers.tomcat
(devono puntare alle directory di installazione )
# workers.properties #
# This file provides jk derived plugins with the needed information to
# connect to the different tomcat workers. Note that the distributed
# version of this file requires modification before it is usable by a
# plugin.
#
# As a general note, the characters $( and ) are used internally to define
# macros. Do not use them in your own configuration!!!
#
# Whenever you see a set of lines such as:
# x=value
# y=$(x)\something
#
# the final value for y will be value\something
#
# Normaly all you will need to do is un-comment and modify the first three
# properties, i.e. workers.tomcat_home, workers.java_home and ps.
# Most of the configuration is derived from these.
#
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 15/35
# When you are done updating workers.tomcat_home, workers.java_home and ps
# you should have 3 workers configured:
#
# - An ajp12 worker that connects to localhost:8007
# - An ajp13 worker that connects to localhost:8009
# - A jni inprocess worker.
# - A load balancer worker
#
# However by default the plugins will only use the ajp12 worker. To have
# the plugins use other workers you should modify the worker.list property.
#
#
# OPTIONS ( very important for jni mode )
#
# workers.tomcat_home should point to the location where you
# installed tomcat. This is where you have your conf, webapps and lib
# directories.
#
workers.tomcat_home=c:\Tomcat4.1
# workers.tomcat_home=/usr/local/tomcat
#
# workers.java_home should point to your Java installation. Normally
# you should have a bin and lib directories beneath it.
#
workers.java_home=C:\j2sdk1.4.0
# workers.java_home=/usr/java
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
#
# You should configure your environment slash... ps=\ on NT and / on UNIX
# and maybe something different elsewhere.
#
ps=\
# ps=/
#
#------ ADVANCED MODE -----------------------------------------------#--------------------------------------------------------------------#
#
#------ DEFAULT worket list -----------------------------------------#--------------------------------------------------------------------#
#
# The workers that your plugins should create and work with
#
# Add 'inprocess' if you want JNI connector
worker.list=ajp12, ajp13
# , inprocess
#
#------ DEFAULT ajp12 WORKER DEFINITION -----------------------------#---------------------------------------------------------------------
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 17/35
#
#
# Defining a worker named ajp12 and of type ajp12
# Note that the name and the type do not have to match.
#
worker.ajp12.port=8007
worker.ajp12.host=localhost
worker.ajp12.type=ajp12
#
# Specifies the load balance factor when used with
# a load balancing worker.
# Note:
# ----> lbfactor must be > 0
# ----> Low lbfactor means less work done by the worker.
worker.ajp12.lbfactor=1
#
#------ DEFAULT ajp13 WORKER DEFINITION -----------------------------#--------------------------------------------------------------------#
#
# Defining a worker named ajp13 and of type ajp13
# Note that the name and the type do not have to match.
#
worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
#
# Specifies the load balance factor when used with
# a load balancing worker.
# Note:
# ----> lbfactor must be > 0
# ----> Low lbfactor means less work done by the worker.
worker.ajp13.lbfactor=1
#
# Specify the size of the open connection cache.
#worker.ajp13.cachesize
#
#------ DEFAULT LOAD BALANCER WORKER DEFINITION ---------------------#--------------------------------------------------------------------#
#
# The loadbalancer (type lb) workers perform wighted round-robin
# load balancing with sticky sessions.
# Note:
# ----> If a worker dies, the load balancer will check its state
#
once in a while. Until then all work is redirected to peer
#
workers.
worker.loadbalancer.type=lb
worker.loadbalancer.balanced_workers=ajp12, ajp13
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 19/35
#
#------ DEFAULT JNI WORKER DEFINITION--------------------------------#--------------------------------------------------------------------#
#
# Defining a worker named inprocess and of type jni
# Note that the name and the type do not have to match.
#
worker.inprocess.type=jni
#
#------ CLASSPATH DEFINITION ----------------------------------------#--------------------------------------------------------------------#
#
# Additional class path components.
#
worker.inprocess.class_path=$(workers.tomcat_home)$(ps)lib$(ps)tomcat.jar
#
# Setting the command line for tomcat.
# Note: The cmd_line string may not contain spaces.
#
worker.inprocess.cmd_line=start
# Not needed, but can be customized.
#worker.inprocess.cmd_line=-config
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
#worker.inprocess.cmd_line=$(workers.tomcat_home)$(ps)conf$(ps)server.xml
#worker.inprocess.cmd_line=-home
#worker.inprocess.cmd_line=$(workers.tomcat_home)
#
# The JVM that we are about to use
#
# This is for Java2
#
# Windows
worker.inprocess.jvm_lib=$(workers.java_home)$(ps)jre$(ps)bin$(ps)classic$(ps)jvm.dll
# IBM JDK1.3
#worker.inprocess.jvm_lib=$(workers.java_home)$(ps)jre$(ps)bin$(ps)classic$(ps)libjvm.so
# Unix - Sun VM or blackdown
#worker.inprocess.jvm_lib=$(workers.java_home)$(ps)jre$(ps)lib$(ps)i386$(ps)classic$(ps)libjvm.so
#
# And this is for jdk1.1.X
#
#worker.inprocess.jvm_lib=$(workers.java_home)$(ps)bin$(ps)javai.dll
#
# Setting the place for the stdout and stderr of tomcat
#
worker.inprocess.stdout=$(workers.tomcat_home)$(ps)logs$(ps)inprocess.stdout
worker.inprocess.stderr=$(workers.tomcat_home)$(ps)logs$(ps)inprocess.stderr
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 21/35
#
# Setting the tomcat.home Java property
#
#worker.inprocess.sysprops=tomcat.home=$(workers.tomcat_home)
#
# Java system properties
#
# worker.inprocess.sysprops=java.compiler=NONE
# worker.inprocess.sysprops=myprop=mypropvalue
#
# Additional path components.
#
# worker.inprocess.ld_path=d:$(ps)SQLLIB$(ps)bin
#
editare il file server.xml (Tomcat4.1/conf) ed aggiungere le seguenti righe:
<Server port="8005" shutdown="SHUTDOWN" debug="0">
<Listener className="org.apache.ajp.tomcat4.config.IISConfig" append=”true” />
Creare una cartella in Tomcat4: “auto” (dove verranno creati i file uriworkermap.properties e
iis_redirect.reg)
Riavviare Tomcat.
Spostare file workers.properties e uriworkermap.properties in \conf
Modificare il file iis_redirect.reg in modo che i due file precedenti puntino alla cartella \conf
Ciccare due volte sul file iis_redirect.reg
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
Dalla console di amministrazione di IIS 5.0 creare una directory virtuale “jakarta” che punta
alla cartella contenente il file isapi_redirect.dll (attenzione alle maiuscole “jakarta” deve
coincidere con quello del file iis_redirect.reg)
Creare un filtro ISAPI dalla console di IIS
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 23/35
Riavviare IIS e controllare la freccia del filtro ISAPI (verde verso l’alto)
Modificare il file uriworkermap.properties:
###################################################################
# Auto generated configuration. Dated: Mon Apr 07 16:34:26 CEST 2003
###################################################################
#
# Default worker to be used through our mappings
#
default.worker=ajp13
/examples/*=ajp13
/examples/*.jsp=ajp13
/examples/servlet/*=ajp13
/servlet/*=ajp13
8 Deployment della web application MOCLA
Copiare il file MOCLA.war nella cartella <Tomcat>\webapps. Riavviare il servizio Tomcat,
dalla console di amministrazione dei Servizi.
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
Nella cartella webapps il file .war “esploso” da Tomcat avrà creato la cartella <MOCLA>. Nella
cartella <MOCLA>, spostarsi nella cartella <WEB-INF> ed aprire il file web.xml
<?xml version="1.0" encoding="windows-1252" ?>
<!DOCTYPE web-app (View Source for full doctype...)>
- <web-app>
<description>Empty web.xml file for Web Application</description>
- <context-param>
<param-name>jdbc</param-name>
<param-value>jdbc:oracle:thin:moloc/[email protected]:1521:orcl</param-value>
<description>Connessione al database per l'accesso ai dati!</description>
</context-param>
- <servlet>
<servlet-name>it.deltadator.qter.MOCLA.MOCLAWebService</servlet-name>
<servlet-class>oracle.j2ee.ws.StatelessJavaRpcWebService</servlet-class>
- <init-param>
<param-name>class-name</param-name>
<param-value>it.deltadator.qter.MOCLA.MOCLAWebService</param-value>
</init-param>
- <init-param>
<param-name>interface-name</param-name>
<param-value>it.deltadator.qter.MOCLA.IMOCLAWebService</param-value>
</init-param>
</servlet>
- <servlet-mapping>
<servlet-name>it.deltadator.qter.MOCLA.MOCLAWebService</servlet-name>
<url-pattern>/it.deltadator.qter.MOCLA.MOCLAWebService</url-pattern>
</servlet-mapping>
- <session-config>
<session-timeout>30</session-timeout>
</session-config>
- <mime-mapping>
<extension>html</extension>
<mime-type>text/html</mime-type>
</mime-mapping>
- <mime-mapping>
<extension>txt</extension>
<mime-type>text/plain</mime-type>
</mime-mapping>
- <welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>
Verificare che il tag JDBC relativo alla connessione con Oracle sia corretto come evidenziato
sopra. Qualora siano necessarie delle modifiche a tale file, dopo averlo salvato, è necessario
riavviare il servizio Tomcat.
La web application non ha un punto di ingresso predefinito per cui nel file web.xml il tag
<welcome-file> è lasciato di default ad index.jsp, modificando il nome di tale file si indica
all’application server Tomcat di partire con quella pagina qualora sia richiamato il solo contesto
della web application (ad.es. : http://www.miowebserver.it/MOCLA/).
Eventualmente spostare la web application da <webapps> ad una cartella <miawebapplication> e
modificare il file server.xml presente nella cartella in <Tomcat>\conf.
Dopo quest’ultima operazione ricordarsi di eliminare dalla cartella <webapps> di Tomcat sia il file
MOCLA.war che la cartella eventualmente creata dalla modalità di depolyment spiegata in
precedenza.
Per montare la Web Application, ora memorizzata in una posizione qualsiasi del File Sytem della
macchina, modificare il file server.xml della cartella <Tomcat>\conf.
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 25/35
+++++++++++++++++++++++++
MOCLA
+++++++++++++++++++++++++
<Context path="/mocla"
docBase="C:/test_clienti/radweb/www_application/MOCLA" crossContext="false"
debug="0" reloadable="true">
<Logger className="org.apache.catalina.logger.FileLogger"
prefix="QTER_MOCLA_log." suffix=".txt" timestamp="true"/> (questa riga serve a
creare un file di Log della applicazione)
</Context>
Dopo la modifica, salvare il file e riavviare Tomcat.
Per testare l’applicazione puntare ad esempio : http://www.miowebserver.it/mocla
Nel caso in cui si è installato il solo application server Tomcat :
http://localhost:8080/mocla
Altri parametri vanno settati nella cartella ‘param’ del percorso WEB-INF/classes/param della
Web Application.
Aprire il file ‘mocla_it.properties’
Ad esempio.
jdbcURL=jdbc:oracle:thin:moloc/[email protected]:1528:RG02
userID=davide
JdbcURL = indirizzo server DB Oracle
UserID = identificativo utilizzato dalla Web Application da lasciare di default.
Nota: le stesse modifiche vanno riportate nel file ‘moloc_en.properties’.
Dopo eventuali modifiche ai file di configurazione assicurarsi di riavviare il servizio Tomcat
per rendere effettive tali modifiche.
Script SQL
Nella cartella WEB-INF è presente una cartella scriptSQL per la generazione dello
schema del database.
Autenticazione MOCLA
Con questa versione di MOCLA l’accesso alle pagine di gestione verrà protetto da un
sistema di autenticazione.
Per il corretto funzionamento di tale sistema bisognerà settare correttamente alcuni
parametri del file di deployment web.xml.
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
<context-param>
<param-name>urlDataBase</param-name>
<param-value>jdbc:oracle:thin:@serveroracle:1521:gisorami</param-value>
<description>url per la connessione ad database</description>
</context-param>
<context-param>
<param-name>dataBaseLogin</param-name>
<param-value>login</param-value>
<description>login di accesso al database</description>
</context-param>
<context-param>
<param-name>dataBasePasswd</param-name>
<param-value>password</param-value>
<description>password di accesso al database</description>
</context-param>
<context-param>
<param-name>userRole</param-name>
<param-value>Admin</param-value>
<description>Ruolo Utente per la gestione di Mocla </description>
</context-param>
I parametri evidenziati in precedenza riguardano la connessione al database (DB)
contenente le informazioni per l’autenticazione(urlDataBase),la Login di accesso al
DB (dataBaseLogin),la Password di accesso al DB (dataBasePasswd),ed infine
al ruolo utente al quale si desidera accordare l’accesso alla gestione di
MOCLA (userRole).
Altre informazioni presenti sempre nel file web.xml permettono di indicare quali risorse ( in
questo caso pagine web) proteggere con il meccanismo di autenticazione di MOCLA.
<filter-mapping>
<filter-name>MoclaUserFilter</filter-name>
<url-pattern>/gestione.jsp</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>MoclaUserFilter</filter-name>
<url-pattern>/add.jsp</url-pattern>
</filter-mapping>
In questo caso il ‘filtro di autenticazione’ indica a quali pagine web di MOCLA verrà
applicato il meccanismo di autenticazione in modo da proteggerle da accessi non
autorizzati.
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 27/35
PARTE II
9 Modalità di funzionamento di MOCLA
L’accesso alle funzionalità di MOCLA viene effettuato secondo tre modalità:
Mediante interfaccia utente Web: ( pagine web : index.jsp , gestione.jsp )
2) Mediante chiamata a URL Internet con parametri di richiesta
Attraverso la chiamata ad URL di MOCLA con passaggio di parametri, come nell’esempio
che segue.
http://gisservertest:8080/mocla/index_xml2.jsp?code=XXXXXXXXXXX
3) Mediante chiamata a metodi di un WebService
Ad es. : RichiestaCodiceClassificazione(String DescrizioneCodice )  String CodClass
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
10 Utilizzo mediante interfaccia Web:
L’utilizzo di MOCLA tramite interfaccia web prevede l’accesso attraverso due pagine JSP.
1) index.jsp: per l’esplorazione dell’albero delle classificazioni ed il rilascio di un documento
in formato XML per la classificazione scelta.
2) gestione.jsp: per la gestione delle classificazioni mediante le funzioni Aggiungi, Modifica,
Rimuovi.
10.1 Esplorazione Albero delle Classificazioni (index.jsp)
Questa funzionalità permette di visualizzare l’Albero delle Classificazioni e individuare il
relativo codice associato a ciascuna foglia dell’albero.
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 29/35
10.2 Visualizzazione dell’albero delle classificazioni in formato XML (index.jsp)
Questa funzionalità permette di esplorare l’albero delle classificazioni e visualizzare il codice
associato. Il pulsante ‘Crea XML’ permette di visualizzare l’Albero attraverso un documento
in formato XML.
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 31/35
10.3 Gestione dell’Albero delle Classificazioni (gestione.jsp)
10.3.1 Gestione dell’Albero delle Classificazioni: Aggiungi (gestione.jsp)
Questa funzionalità permette di aggiungere un nuovo nodo all’Albero delle Classificazioni.
Per poter inserire un nuovo nodo posizionarsi sul ramo dell’albero scelto ed eseguire il
comando Aggiungi.
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
10.3.2 Gestione dell’Albero delle Classificazioni: Modifica (gestione.jsp)
Questa funzionalità permette di modificare un nodo. Posizionarsi sul nodo da editare e
utilizzare il comando Modifica.
10.3.3 Gestione dell’Albero delle Classificazioni: Rimuovi (gestione.jsp)
Questa funzionalità permette di eliminare un nuovo nodo all’Albero delle
Classificazioni.
Per poter eliminare un nodo posizionarsi sul ramo dell’albero scelto ed
eseguire il comando Elimina.
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 33/35
11 Mediante chiamata a URL Internet con parametri di richiesta.
11.1 Restituzione delle informazioni associate ad un Albero di Classificazione in
formato XML in funzione del codice.
Ad esempio:
http://gisservertest:8080/mocla/index_xml2.jsp?code=xxxxxxxxxxxxx
Pagina JSP: index_xml2.jsp
Parametri
code =xxxxx codice della classificazione per il quale si richiede la restituzione in formato
XML.
11.2 Richiesta Assegnazione Codice di Classificazione da applicazioni esterne
Per poter utilizzare MOCLA da applicazioni esterne in ambiente JSP bisogna integrare nella
propria applicazione la logica di comunicazione con MOCLA seguendo le istruzioni di
seguito:
Istruzioni per utilizzo MOCLA da altre applicazioni WEB jsp con notifica dell’URL chiamante.
- Copiare nella propria web application la cartella ext_client
- Modificare il file main_ext.jsp nella parte che riguarda il nome server di mocla e quello dell’applicazione chiamante
<!-=============================================================
Inserire URL server mocla e URL webapplication chiamante
<frame name="content"
src="http://<nomeserver>/moloc/ext/codice_loc_ext.jsp?returnURL=http://<thisWebappsURL>/ext_client/return_value.jsp" scrolling="auto"
noresize marginheight="0" marginwidth="12" target="_self">
=============================================================
-->
<frame name="content"
src="http://nomeservermocla/mocla/ext/index_ext.jsp?returnURL=http://nomeserverchiamante/mocla/ext_client/return_value.jsp" scrolling="auto"
noresize marginheight="0" marginwidth="12" target="_self">
- Copiare la cartella ext nella webapplication moloc
- Testare l'applicazione collegandosi alla propria webapplication nella cartella ext_client/index.jsp
Mo.Cla : installazione e modalità di utilizzo.
Z1SICDRE02012/SDFMoClaManuale - Rel. n°2.2
12 Mediante chiamata a metodi di un WebService
Per richieste operate da client generici mediante protocollo XML/SOAP sono disponibili i
seguenti metodi:
- creaXML(String CodiceClassificazione)  String XMLStream
- restituzioneAlberoClassificazioni()  String XMLStream
- richiestaCodiceClassificazione (String DescrizioneCodice)  String CodiceMoCla
- richiestaDescrizioneClassificazione(String CodiceMoCla)  String DescrizioneCodice
12.1 Disponibilità di proxy class in linguaggio Java e VB/VBA
Per semplificare la chiamata del WebService da parte di applicazioni client sono state
approntate delle proxy class, disponibili nei linguaggi Java e VB/VBA.
Le proxy class sono fornite con applicazioni pratiche di utilizzo (rispettivamente una
WebApplication JSP ed un documento di Word).
In particolare, nel caso di client VB/VBA, sarà necessario installare sulla macchina client la
libreria Microsoft SOAP ToolKit 3.0 e referenziarla nel progetto.
In ciascuno dei casi, Java o VB, sarà inoltre necessario configurare la proxy class in modo che
si riferisca al EndPoint del WebService che si vuole utilizzare (ad esempio
http://www.cartografia.regione.lombardia.it/mocla/services/MoclaWebService?wsdl )
Z1SICDRE02012/SDFMoClaManuale - Rel. n° 2.2
Mo.Cla : installazione e modalità di utilizzo.
pag. 35/35