• Gestion des contextes à l'aide de cookies : la valeur des différentes variables est mémorisée sur le navigateur de l'utilisateur à l'aide d'un cookie. Ce mode de gestion a plusieurs inconvénients :
  • le navigateur de l'internaute doit gérer les cookies
  • la taille des cookies est limitée à 4 Ko
  • la sécurité des informations mémorisées dans le cookie n'est pas garantie.
• Gestion des contextes sur disque : la valeur des différentes variables est mémorisée sur le serveur dans un fichier. Un identifiant de contexte permet de récupérer le contexte mémorisé lors du retour du navigateur. Cet identifiant peut être soit mémorisé par cookie sur le poste de l'internaute, soit transmis sur l'URL. Cet identifiant garantit la sécurité des données mémorisées.

Pour mettre en place la gestion des contextes AWP par cookies :

1. Utilisez la fonction ConfigureContexteAWP pour spécifier le mode de gestion du contexte AWP. Il est conseillé d'utiliser cette fonction dans le traitement d'initialisation du projet. En effet, il est impossible de modifier le mode choisit lorsque la session a été commencée.
   Pour utiliser la gestion des contextes par cookies, la ligne de code suivante peut être utilisée :
   
   ConfigureContexteAWP(ctxCookie)
   
2. Utilisez la fonction DéclareContexteAWP pour mémoriser / récupérer la valeur des variables voulues. Il est conseillé d'utiliser cette fonction dans le code d'initialisation du projet (pour les variables du projet) et / ou dans le code d'initialisation des pages (pour les variables des pages). En règle générale, il faut utiliser cette fonction dans le traitement où sont déclarées et initialisées les variables.

• La fonction DéclareContexteAWP utilise les cookies HTTP. Si le navigateur utilisé sur le poste en cours ignore les cookies HTTP, les valeurs des variables ne sont pas restaurées.
• La taille totale des valeurs des différentes variables est limitée à environ 4ko. Si la taille de ces valeurs est trop importante, ces valeurs seront tronquées (variables manquante et/ou contenu tronqué).
• La fonction DéclareContexteAWP n'est pas recommandée pour les données sensibles (mot de passe de l'utilisateur par exemple). En effet, les données transitent par le navigateur. Il ne faut donc PAS utiliser cette fonction pour mémoriser la connexion d'un utilisateur par exemple.
• Si deux variables sauvées ont le même nom (par exemple une dans le projet et l'autre dans une page) seule la première variable est mémorisée.
• La fonction DéclareContexteAWP renvoie Faux si une des variables n'a pas été restaurée.
• Seules les variables passées à la fonction DéclareContexteAWP lors d'un affichage de page pourront être récupérées lors de l'affichage suivant. Les variables passées précédemment ne sont pas automatiquement sauvegardées une nouvelle fois.
• Seules les variables de type simple (entier, chaîne, ...) sont gérées.
• Un champ Upload multi-fichiers ne peut pas être utilisé avec des contextes AWP de type cookie.

Pour mettre en place la gestion des contextes AWP sur disque :

1. Utilisez la fonction ConfigureContexteAWP pour spécifier le mode de gestion du contexte AWP. Il est conseillé d'utiliser cette fonction dans le traitement d'initialisation du projet. En effet, il est impossible de modifier le mode choisi lorsque la session a été commencée.
   Pour utiliser la gestion des contextes sur disque, la ligne de code suivante peut être utilisée :
   
   ConfigureContexteAWP(ctxDisque)
   
   
   Remarque : La fonction ConfigureContexteAWP permet également de définir le mode de transmission de l'identifiant du contexte. Cet identifiant peut être transmis :
   • Par URL et cookie au premier lancement, puis dans le meilleur mode possible (par cookie si le navigateur accepte les cookies). C'est le mode utilisé par défaut.
   • Par cookie uniquement. Dans ce cas, le navigateur de l'internaute doit avoir la gestion des cookies activée sur son poste.
   • Par URL uniquement. Dans ce cas, l'identifiant apparaîtra toujours dans l'URL des pages.
2. Utilisez la fonction DéclareContexteAWP pour mémoriser les variables voulues. Il est conseillé d'utiliser cette fonction dans le code d'initialisation du projet (pour les variables du projet) et / ou dans le code d'initialisation des pages (pour les variables des pages). En règle générale, il faut utiliser cette fonction dans le traitement où sont déclarées et initialisées les variables.
   Remarques : Dans ce mode de fonctionnement :
   • La fonction DéclareContexteAWP utilise les contextes sur disque. Les valeurs des variables sont toujours restaurées.
   • La taille totale des valeurs des différentes variables n'est pas limitée.
   • La fonction DéclareContexteAWP peut être utilisée pour les données sensibles (mot de passe de l'utilisateur par exemple).
   • Si deux variables sauvées ont le même nom (par exemple une dans le projet et l'autre dans une page), les deux variables sont mémorisées indépendamment.
   • La fonction DéclareContexteAWP renvoie Faux si une des variables n'a pas été restaurée.
   • Toutes les variables passées à la fonction DéclareContexteAWP lors d'un affichage de page pourront être récupérées lors de l'affichage suivant. Les variables passées précédemment sont automatiquement sauvegardées une nouvelle fois.
   • Les variables de type simple (entier, chaîne, ...) sont gérées ainsi que les variables de type structure, classe, tableau ou tableau associatif. Ne sont pas gérés les tableaux fixes, les tableaux associatifs de structures locales, les membres globaux des classes.
   • Les champs Upload multi-fichiers peuvent être utilisés uniquement avec des contextes AWP sur disque.
3. Pour supprimer une variable spécifique du contexte, il est possible d'utiliser la fonction AnnuleContexteAWP.
4. La fonction IdentifiantContexteAWP permet de connaître l'identifiant de contexte d'une page AWP.