Differenze tra le versioni di "Webservice"

Da wiki.maggioli.it.
Jump to navigation Jump to search
imported>Dtilocca
m (ha spostato Webservices a Webservice)
imported>Demos
(Redirect alla pagina Webservices)
 
(55 versioni intermedie di 3 utenti non mostrate)
Riga 1: Riga 1:
==Come si raggiunge un webservice==
#REDIRECT [[Webservices]]
Per l’invocazione del Web Service utilizzare la seguente sintassi:
http://<hostname>:<port>/client/services/<webservice>
dove:
<hostname>: è il nome del Web Server in cui viene installato il web service;
<port>: è la porta su cui è in ascolto il web service (porta di Tomcat); se la porta è quella standard HTTP, la 80, allora l’indicazione della porta può essere omessa;
<webservice>: è il Web Service vero e proprio che espone le funzionalità.
Per ottenere il WSDL del web service:
http://<hostname>:<port>/client/services/<webservice>?wsdl
 
/client/services/: è il percorso dell’applicazione web associata al web service.
 
Esempio di URL:
http://sicrawebappserver:50080/client/services/ProWSApi
 
==Definire un Alias==
Nel file ''sicraweb.server.config.xml'' presente nella cartella ''JBOSS_HOME\server\default\deploy\sicraweb.ear\server\signed-jars\conf.ig''
nella sezione ''<logon>'' inserire una sezione ''<alias ... />'' come riportato nel seguente esempio:
 
<code>
  <logon>
    <alias name=”suap@sicraweb” j2eeusername=”sicraweb” j2eepassword=”sicraweb” username=”suap” password=”suap”/>
    <alias name=”suap@sicraweb_test” j2eeusername=”sicraweb_test” j2eepassword=”sicraweb_test” username=”suap” password=”suap”/>
  </logon>
</code>
 
'''ATTENZIONE:'''
Controllare che nel file ''sicraweb.server.config.xml'' non esista già il tag ''<logon> </logon>''.
Se tale tag esiste, aggiungere i nuovi alias all’interno dei tag ''<logon> </logon>'' già presenti. Solitamente tali tag esistono per Anagrafe on line (AOL).
E’ molto importante che nel file, anche dopo le modifiche, esista un solo tag ''<logon>''.
 
In questo file di configurazione vanno configurate le credenziali da utilizzare per effettuare l'accesso tramite web service.
Creare i due alias, uno per l’ambiente di produzione ed uno per l’ambiente di test.
L’ alias name  è il nome con cui il software che chiama il WS e indica su quale database andare ad inserire le informazioni trasmesse.
Il j2eeusername e j2eepassword è la configurazione che viene data dai sistemisti in fase di installazione per identificare il database;
la si può recuperare dal file JNLP di avvio di SicraWeb nella seguente sezione (vedi dati evidenziati):
 
<code>
  <application-desc main-class="it.saga.pubblici.menu.MnuCFGMain">
    <argument>jboss: sicrawebappserver:50080:1099</argument>
    <argument>'''sicraweb'''</argument>
    <argument>'''sicraweb'''</argument>
  </application-desc>
</code>
 
NOTA: verificare SEMPRE che ci sia corrispondenza tra l’utente j2ee indicato nel JNLP di lancio di sicraweb e quello indicato nella sezione <logon>.
 
==Attivare un webservice==
Per attivare il web service è sufficiente aprire la maschera presente in GESTIONE -> CONFIGURAZIONE -> SISTEMA -> WEB SERVICES.
Se la voce di menù non è attiva, significa che l’utente che si sta usando è privo del permesso di configurazione dei Web Services:
 
foto permesso
 
Una volta aperta la maschera di configurazione dei WS
 
Selezionare il webservice desiderato che normalmente sarà in stato disattivato, contraddistinto quindi dall’icona foto icona blu .
Cliccando su tale pulsante viene attivato il WS (il messaggio chiede se si vuole fare il deploy).
Al termine del deploy, che normalmente impiega qualche istante, l’icona indicherà lo stato attivo del WS foto icona verde .
 
Per disattivare il WS cliccare sull’icona di stato attivo foto icona verde e dopo qualche istante il WS verrà disattivato.
 
'''N.B.''' L’attivazione del WS da un qualsiasi ambiente di sicraweb, attiva il WS anche per le altre installazioni. Di conseguenza il WS si può attivare indifferentemente loggandosi dall’ambiente di produzione o dall’ambiente di test.
 
==Verifica web service attivo==
Si può verificare se il web service è attivo aprendo un browser e digitando l’indirizzo
http://sicrawebappserver:50080/client/services/
si avrà un risultato del tipo
 
foto webservices attivi
 
==Links==
*[http://sicrawebhelp.saga.it/index.php/CmnFRMWebServiceAdmin '''Amministrazione Web Services''']

Versione attuale delle 10:41, 3 lug 2017

Reindirizza a: