DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Page / Pages et sites AWP
  • Présentation
  • Afficher une page AWP sans paramètre
  • Afficher une page AWP depuis une page WEBDEV
  • Afficher une page AWP dans un navigateur ou depuis n'importe quel site
  • Afficher une page AWP en lui passant des paramètres
  • Afficher une page AWP paramétrée depuis une page WEBDEV (depuis l'interface)
  • Afficher une page AWP paramétrée depuis une page WEBDEV (par programmation)
  • Afficher une page AWP dans un navigateur ou depuis n'importe quel site
  • Récupérer les paramètres passés à une page AWP
  • Récupérer les paramètres passés à la page
  • Récupération des paramètres dans le code de déclaration des globales de la page
  • Récupération des paramètres grâce à la fonction PageParamètre
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Une page AWP peut être affichée :
  • depuis une page statique ou une page en mode Session d'un site WEBDEV.
  • directement par une adresse saisie sous le navigateur.
  • depuis n'importe quelle page de n'importe quel site.
Cette page peut être affichée directement ou prendre en compte des paramètres.
Cette page d'aide présente :
Afficher une page AWP sans paramètre

Afficher une page AWP depuis une page WEBDEV

Une page AWP peut être affichée depuis une autre page WEBDEV :
  • directement depuis l'interface de la page : il suffit de sélectionner la page AWP à ouvrir dans la description du lien.
  • par programmation (en code serveur ou en code navigateur) grâce à la fonction PageAffiche :
    PageAffiche(PAGE_MaPage)
Remarque : En code navigateur, les pages AWP ne sont pas proposées lors de la saisie assistée.

Afficher une page AWP dans un navigateur ou depuis n'importe quel site

Pour afficher une page AWP depuis un navigateur ou directement depuis un site, il suffit d'utiliser la syntaxe suivante :
http://www.monsite.com/mapageAWP.awp
ou si la page se situe dans le répertoire MonRep :
http://www.monsite.com/MonRep/mapageAWP.awp
Afficher une page AWP en lui passant des paramètres

Afficher une page AWP paramétrée depuis une page WEBDEV (depuis l'interface)

Une page AWP avec paramètres peut être affichée depuis une autre page WEBDEV directement depuis l'interface de la page : il suffit d'indiquer la page AWP à ouvrir dans la description du lien. Le nom de la page doit alors être suivi des différents paramètres à passer.
Exemple : Lien vers MaPage.awp en lui passant des paramètres.
Dans la définition du lien :
  1. Cliquez sur le bouton "Autres actions", puis sélectionnez l'option "Autres actions : saisissez un lien".
  2. Indiquez la page à afficher suivie des paramètres nécessaires.
Remarque : Si le lien est de type "Aucun" (option "Opération sur les champs"), les paramètres doivent être nommés P1, P2, ..., P256.
PAGE_mapageAWP.awp?P1=Instruments&P2=350

Afficher une page AWP paramétrée depuis une page WEBDEV (par programmation)

WindowsLinux Code serveur : Pour afficher une page AWP paramétrée depuis une page WEBDEV par programmation, utilisez la fonction PageAffiche :
Chaque paramètre de la page correspond à un paramètre de la fonction PageAffiche.
// Affiche dans la page "MaPage.AWP", le 350ème élément 
// de la catégorie "Instruments"
PageAffiche(PAGE_MaPage, "Instruments", 350)

Afficher une page AWP dans un navigateur ou depuis n'importe quel site

Pour afficher une page AWP depuis un navigateur ou directement depuis un site et en lui passant des paramètres, il suffit d'utiliser la syntaxe suivante :
http://www.monsite.com/PAGE_mapage.awp?P1=Instruments&P2=350
Ce code affiche dans la page "PAGE_MaPage.AWP", le 350ème élément de la catégorie "Instruments".
Récupérer les paramètres passés à une page AWP

Récupérer les paramètres passés à la page

Plusieurs méthodes permettent de récupérer les paramètres passés à une page AWP :
  1. Récupération des paramètres dans le code de déclaration des globales de la page.
  2. Récupération des paramètres grâce à la fonction PageParamètre.

Récupération des paramètres dans le code de déclaration des globales de la page

Pour récupérer directement les paramètres passés à la page dans le code d'initialisation de la page, il suffit de déclarer une procédure dans ce traitement. Le nom de cette procédure doit être identique au nom de la page. Les paramètres de cette procédure correspondent aux paramètres à passer à la page (en respectant l'ordre des paramètres passés à la page). Ces paramètres peuvent être des chaînes, des réels ou des entiers.
Les paramètres récupérés dans le code de déclaration des globales de la page sont des chaînes de caractères.
Exemple :
  1. Code permettant d'afficher la page en lui passant des paramètres :
    // Affiche dans la page "MaPage.AWP", le 350ème élément 
    // de la catégorie "Instruments"
    PageAffiche(PAGE_MaPage, "Instruments", 350)
  2. Code permettant de récupérer les paramètres :
    // -- Déclaration globales de la page PAGE_MaPage // --
    PROCÉDURE PAGE_MaPage(Categorie="Jouets", ID="1")
    // Dans notre exemple : Categorie vaudra "Instruments"
    // ID vaudra "350"
Remarques :
  • Il est conseillé de donner une valeur par défaut aux paramètres définis dans le code de déclaration des globales de la page. Ces valeurs permettent de gérer le cas où la page est appelée sans paramètres.
  • Si la page est affichée depuis un code navigateur, le nom des paramètres utilisés dans le code de déclaration des globales doit être P1, ..., P256. Dans ce cas, la page ne doit pas contenir des champs ayant pour nom P1, P2, ..., P256.

Récupération des paramètres grâce à la fonction PageParamètre

La fonction PageParamètre permet de récupérer la valeur d'un des paramètres passés à la page :
Cas 1 : Récupération selon le nom du paramètre :
Par défaut, les paramètres sont automatiquement nommés par WEBDEV (P1, P2, ... , P256). Dans ce cas, la page ne doit pas contenir des champs ayant pour nom P1, P2, ..., P256.
Exemple :
  1. Code permettant d'afficher la page en lui passant des paramètres :
    // Affiche dans la page "MaPage.AWP", le 350ème élément 
    // de la catégorie "Instruments"
    PageAffiche(PAGE_MaPage, "Instruments", 350)
  2. Code permettant de récupérer les paramètres :
    // Récupération des paramètres
    CategorieRecherchée est une chaîne = PageParamètre("P1")
    IDRecherché est un entier = PageParamètre("P2")
Cas 2 : Récupération selon l'indice du paramètre :
  1. Code permettant d'afficher la page en lui passant des paramètres :
    // Affiche dans la page "MaPage.AWP", le 350ème élément 
    // de la catégorie "Instruments"
    PageAffiche(PAGE_MaPage, "Instruments", 350)
  2. Code permettant de récupérer les paramètres :
    // Récupération des paramètres
    CategorieRecherchée est une chaîne = PageParamètre(1) 
    // CategorieRecherchée = "P1=Instruments"
    CategorieRecherchée = Droite(Taille(CategorieRecherchée)-3)
    IDRecherché est un entier = PageParamètre(2)
    // IDRecherché = "P2=350"
    IDRecherché = Droite(Taille(IDRecherché)-3)
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale