Next Topic

Previous Topic

Book Contents

Authenticate

Obbligatorio per iniziare la sessione Web Service API VSA. Il SessionID restituito deve essere inviato con ogni metodo richiamato durante la sessione. Il SessionID è valido solo se ricevuto dalla stessa macchina da cui ha origine l'autenticazione.

Viene restituito un unico record dei campi seguenti.

SessionID

decimale

L'ID univoco di sessione assegnato a una connessione utente con l'URL destinazione.

Metodo

stringa

L'operazione che ha richiesto questa risposta.

TransactionID

decimale

L'ID messaggio univoco per questo messaggio.

ErrorMessage

stringa

Se vuota indica che non è presente nessun errore.

ErrorLocation

stringa

Se vuota indica che non è presente nessun errore.

Accesso automatico durante l'autenticazione

Quando ci si autentica tramite le API, si accede automaticamente anche a VSA. Se si è già collegati a VSA al momento dell'autenticazione, le 2 sessioni vengono sincronizzate.  In ogni caso il risultato è lo stesso: viene stabilita una sessione valida in entrambi i mondi.

VSA cerca il SessionID da 26 cifre delle API nell stringa di query di ogni pagina VSA. Quindi, se lo sviluppatore dell'applicazione deve reindirizzare a una pagina VSA, può ora raggiungere direttamente una pagina senza obbligare l'utente ad accedere nuovamente. La sintassi è:

URL?apiLogonGuid=12345678901234567890123456

Per esempio:

http://someServer:123/Systemtab/SomePage?apiLogonGuid=12345678901234567890123456&SomeVar=SomeValue

L'attività API mantiene aperta la sessione VSA. Tuttavia, poiché VSA non presume che ci sia sempre la necessità di una sessione API, l'attività VSA non mantiene attiva la sessione API.

Le API utilizzano lo stesso valore di timeout di VSA, che viene gestito tramite la pagina Sistema > Politica di accesso di VSA, ed ha un valore di sistema predefinito di 30 minuti.