Tutorial NOUTOnline

Comment utiliser le webservice de NOUTOnline.

Ouverture d'une session

Pour ouvrir une session, il faut utiliser l'opération GetTokenSession. Pour cela, il faut demander son identifiant et son mot de passe à l'utilisateur pour pouvoir calculer le UsernameToken.

Le serveur renvoi un token de session qu'il faut garder en mémoire car il sera nécessaire pour la totalité des requêtes suivantes.
L'entête ReturnType de cette requête est Identification.
L'entête ConnectedUser rappelle les informations sur l'utilisateur connecté.

Si l'identification échoue, une erreur d'identification est retournée. Les erreurs possibles sont :

D'autres erreurs ayant traits à la sécurité peuvent être retournées :

Pour une identification en mode extranet, l'identifiant et le mot de passe récoltés permettent de calculer le UsernameToken fils de ExtranetUser.
Le paramètre Form contient l'identifiant ou le libellé du formulaire qui contient les éléments sur lequel se fait l'extranet (exemple: client professionnel).
Le paramètre UsernameToken (fils de la balise GetTokenSession) est calculé à partir de l'identifiant et du mot de passe de l'utilisateur SIMAX auquel est associé l'extranet et qui donne les droits d'accès.
Ces dernières informations (formulaire, identifiant, mot de passe) peuvent être stockées dans un fichier de configuration.

Le token de session récolté devra être passé dans le Header de toutes les requêtes jusqu'à la fermeture de la session. L'entête à utiliser est SessionToken