Utilizzo dei Servizi Web › Chiamata dei servizi Web › Modalità di chiamata dei metodi di accesso e di disconnessione da parte dei client

Modalità di chiamata dei metodi di accesso e di disconnessione da parte dei client

Quando si chiamano servizi Web con un client Java, un processo obbligatorio consiste nella chiamata dei metodi di accesso e disconnessione da parte dei client per ciascun servizio Web. Di seguito è riportato un processo tipico:

1. Il client utilizza un metodo per l'accesso e l'autenticazione.

   Ogni servizio Web dispone di una serie di metodi di accesso. Le applicazioni client possono utilizzare diversi metodi di accesso per eseguire l'autenticazione. Ad esempio, il metodo logIn utilizza gli stessi parametri della finestra di Accesso, ovvero ID utente, Password ed Unità di business.

   Per visualizzare le informazioni di parametro del metodo, firme comprese, utilizzare le risorse seguenti:

   • Documentazione API dei servizi Web
   • Interfaccia di amministrazione SOAP per distribuire o annullare la distribuzione dei servizi Web
2. Il sistema del catalogo autentica l'utente e ne determina il ruolo.

   Le chiamate di metodo successive valgono nell'ambito dei diritti di accesso dell'utente, come se l'utente avesse eseguito l'accesso all'interfaccia utente.

3. Il client procede come segue:
   • Dichiara il servizio che sta chiamando
   • Fornisce il nome del metodo e i parametri corrispondenti prima di iniziare la chiamata di procedura remota
   • Controlla nel file WSDL queste informazioni se sconosciute

     In genere, il client già possiede queste informazioni.

4. Il servizio Web restituisce un ID sessione. Tale ID sessione è un parametro obbligatorio che il client utilizza per le restanti chiamate di servizio Web. Poiché il protocollo di trasporto alla base può essere sia HTTP sia un altro protocollo, l'autenticazione utilizzerà il servizio Web comune logIn.

   È possibile condividere l'ID sessione attraverso i servizi Web. Ad esempio, è possibile utilizzare il metodo UserService logIn per ottenere un ID sessione. È quindi possibile utilizzare l'ID di sessione per la chiamata a un metodo di servizio Web dell'Unità di business.

5. La sessione termina quando si verifica una delle seguenti condizioni:
   • Il client richiama il metodo del servizio Web logOut.

     Dopo aver terminato il lavoro con un ID di sessione, è possibile richiamare il servizio Web logOut per terminare la sessione e rendere non più valido l'ID di sessione. Gestire le sessioni in maniera efficiente sfruttando questa procedura consentirà di ottenere le migliori prestazioni possibili.

   • Il client è inattivo per un periodo più lungo rispetto al valore di timeout della sessione.

     Il client può utilizzare l'ID sessione ripetutamente entro il periodo di timeout. Se la sessione scade, l'ID sessione non è valido.

     Per modificare il valore di timeout, aggiornare l'impostazione di configurazione di amministrazione denominata Impostazione predefinita utente: Timeout di sessione.

     Nota: per istruzioni sulla modifica delle impostazioni di configurazione, consultare la Guida all'implementazione.