Bloc de sauvegarde de l'état du programme SAUVEGARDE.
Remarque : Ce paragraphe n'est disponible que pour les programmes WADELIA Interactifs créés avec le support des boutons Précédent / Suivant du navigateur activé .
Le paragraphe SAUVEGARDE permet au développeur de sauvegarder manuellement les données constituant l'état d'un programme. La sauvegarde manuelle permet d'optimiser le processus de sauvegarde en sélectionnant les données pertinentes constituant l'état du programme.
L'optimisation peut, par exemple, constituer à :
- ne pas sauvegarder des variables temporaires ne servant qu'à une étape d'un calcul,
- ne sauvegarder que les données de la page Web courante si le programme manipule plusieurs pages.
Ce paragraphe est exécuté après le traitement de chaque événement Adélia réversible ou irréversible lié à la page.
Pour distinguer les traitements à effectuer en fonction de chaque événement traité, il est nécessaire d'utiliser les mots réservés *OBJ_ORIGINE et *EVT_ORIGINE. Ces mots réservés permettent respectivement de connaître le nom de l'objet ayant déclenché l'événement ainsi que le nom de l'événement qui vient d'être exécuté.
De plus, pour sauvegarder les données constituant l'état du programme, il est nécessaire d'utiliser l'ordre SAUVER_ETAT_PGM.
Remarque : Pour désactiver le mode de sauvegarde manuelle et activer la sauvegarde automatique il faut supprimer tous les paragraphes SAUVEGARDE du programme.
Cas particuliers :
-
- Lors de l'exécution d'un bloc GUIDE/FIN_GUIDE, *OBJ_ORIGINE a pour valeur le nom Adélia de la page courante et *EVT_ORIGINE à pour valeur le mot réservé *P_GUIDE,
-
- Lors de l'exécution d'un bloc RETOUR associé à une page, *OBJ_ORIGINE a pour valeur le nom Adélia de la page courante et *EVT_ORIGINE à pour valeur le mot réservé *P_RETOUR,
-
- Lors de l'exécution de l'ordre TRAITER seul sur une page, *OBJ_ORIGINE a pour valeur le nom Adélia de la page et *EVT_ORIGINE à pour valeur le mot réservé *P_TRAITER.
-
- Lors de l'exécution de l'ordre INITIALISER seul sur une page, *OBJ_ORIGINE a pour valeur le nom Adélia de la page et *EVT_ORIGINE a pour valeur le mot réservé *P_INIT,
-
- Lors de l'exécution conjointe des ordres INITIALISER et TRAITER sur une page, *OBJ_ORIGINE a pour valeur le nom Adélia de la page et *EVT_ORIGINE a pour valeur le mot réservé *P_INIT_TRAIT.
Exemple de traitement dans le bloc SAUVEGARDE de la page de nom Adélia ID_WPAGE1 :
si *OBJ_ORIGINE = 'ID_WPAGE1'
si *EVT_ORIGINE = *P_TRAITER
* Sauvegarder les variables du programme après l'appel à TRAITER ID_WPAGE1
sinon_si *EVT_ORIGINE = *P_RETOUR
* Sauvegarder les variables du programme après l'exécution du bloc RETOUR de la page ID_WPAGE1
fin
sinon_si *OBJ_ORIGINE = 'BTN_CREER'
* Sauvegarder les variables du programme suite à la création
sinon_si *OBJ_ORIGINE = 'CHS_NOM'
si *EVT_ORIGINE = 'ONCHANGE'
* Sauvegarder les variables du programme suite à la nouvelle saisie d'un nom
sinon_si *EVT_ORIGINE = 'ONFOCUS'
* Sauvegarder les variables du programme suite à la prise de focus du champ nom
sinon_si *EVT_ORIGINE = *P_GUIDE
* Sauvegarder les variables du programme après exécution du guide sur le champ CHS_NOM
fin
fin
Accéder au source
Positionne le curseur au début du bloc correspondant dans le source.
Supprimer
Supprime le source dans le paragraphe.