DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / RAD / Pattern RAD
  • Les étapes de la création de pattern RAD
  • Quelles pages doivent être créées ?
  • Les fichiers à créer
  • Norme à suivre
  • Les pages Table
  • Créer une page Table
  • Cas des boutons d'impression
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
Créer les pages Table du pattern RAD WEBDEV
Les étapes de la création de pattern RAD
Les différentes étapes permettant de créer un Pattern RAD WEBDEV sont les suivantes :
  1. Création du projet de type "Pattern RAD".
  2. Création des différentes pages du pattern.
  3. Génération du Pattern RAD.
  4. Utilisation du Pattern RAD.
Quelles pages doivent être créées ?

Les fichiers à créer

Rappel : Pour réaliser un pattern RAD permettant de faire un projet complet, les fichiers suivants sont nécessaires :
  • Une fiche pour RADFichierA.
  • Une fiche pour RADFichierB. Un bouton Vision plus (ou une combo popup) doit permettre de sélectionner un élément du fichier RADFichierA.
  • Une fiche pour RADFichierC. Un bouton Vision plus (ou une combo popup) doit permettre de sélectionner un élément du fichier RADFichierB.
  • Une table pour RADFichierA.
  • Une table pour RADFichierB.
  • Une table pour RADFichierC.
  • Une page de relation RADFichierB / RADFichierD.
Le menu général du site peut être inclus dans le modèle associé aux pages.

Norme à suivre

Cette page d'aide présente différentes règles applicables à la conception des pages du Pattern RAD. Ces règles ont été utilisées pour concevoir les différents Patterns livrés avec WEBDEV 2024.
Ces règles sont une recommandation. Vous pouvez évidemment mettre en place et utiliser vos propres normes.
Les pages Table
Une page Table est constituée des éléments suivants :
  • Une table : Cette table est une table fichier, avec fichier chargé en mémoire.
  • De boutons permettant de réaliser des actions de base : Nouveau, Modifier, Supprimer, Retour et si nécessaire Imprimer.
Exemple : Page Table sur le fichier RADFichierA du pattern Modèle Simple :

Créer une page Table

Pour créer une page Table :
  1. Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Page" puis sur "Page".
    • L'assistant de création d'une page se lance.
    • Sélectionnez "Vierge". Vous pouvez sélectionner le modèle utilisé dans votre pattern.
  2. Dans la fenêtre de description, saisissez le nom de la page. Ce nom doit obligatoirement contenir le nom du fichier affiché dans la table (quelques exemples : PAGE_Table_RADFichierA, PAGE_Tab_RADFichierA, ...).
    Remarque : Si vous voulez indiquer à l'utilisateur le nom du fichier en cours, utilisez le nom du fichier (RADFichierA par exemple) dans un libellé. Le terme RADFichierX sera automatiquement remplacé par le libellé du fichier décrit dans l'analyse.
  3. Enregistrez la page.
  4. Créez un champ Table dans la page : sous le volet "Création", dans le groupe "Données", déroulez "Table et Liste" et sélectionnez "Table".
  5. Dans l'assistant de création de table, indiquez les caractéristiques suivantes :
    • Sélectionnez l'option "Afficher les données d'un fichier ou d'une requête".
    • Sélectionnez le fichier de base de la table (par exemple RADFichierA).
    • Conservez la rubrique proposée ainsi que la clé de parcours.
    • Validez le nom de la table.
  6. Positionnez le champ Table dans la page et définissez sa taille. Si nécessaire la colonne correspondant à l'identifiant peut être invisible.
  7. Créez et positionnez les différents boutons de votre page (bouton de validation, de modification, de suppression, d'impression, de retour, ...). Ces boutons peuvent avoir n'importe quel nom.
  8. Cas du bouton d'ajout (bouton Nouveau par exemple).
    Ce bouton peut par exemple permettre la saisie d'un nouvel enregistrement dans une page de type fiche. Le code du bouton Nouveau peut être par exemple :
    // Création d'un nouvel enregistrement
    HRAZ(RADFichierA)
     
    // Ouverture de la fiche du fichier RADFichierA en mode création
    PageAffiche(PAGE_Fiche_RADFichierA)
  9. Cas du bouton de modification (bouton Modifier par exemple).
    Ce bouton peut par exemple permettre la modification d'un nouvel enregistrement dans une page de type fiche. Le code du bouton Modifier peut être par exemple :
    // Une ligne est-elle sélectionnée ?
    SI TableSelect(TABLE_RADFichierA) = -1 ALORS RETOUR
     
    // Ouverture de la fiche du fichier RADFichierA en mode modification
    PageAffiche(PAGE_Fiche_RADFichierA)
  10. Cas du bouton de suppression (bouton Supprimer par exemple).
    Ce bouton peut par exemple supprimer un enregistrement sélectionné dans la table.

    Le code du bouton Supprimer peut être par exemple (pour la table sur le fichier RADFichierA) :
    // Si la suppression est confirmée, suppression de la ligne de la table et de
    // l'enregistrement correspondant dans le fichier FichierA
    SI OuiNon("Voulez-vous vraiment supprimer l'enregistrement ?") ALORS
    // Suppression de l'enregistrement à partir de la table
    TableSupprime(TABLE_RADFichierA)
    // Positionnement sur l'enregistrement courant
    TableAffiche(TABLE_RADFichierA, taCourantPremier)
    FIN
     
    CAS ERREUR:
    Erreur("Une erreur est survenue pendant la suppression.", HErreurInfo())
    RETOUR

    Dans le code du bouton de suppression, il est conseillé d'activer le gestion automatique des erreurs (Option "Si Erreur : ", avec le traitement automatique "Exécuter le traitement d'erreur ("CAS ERREUR:" dans le code)").
  11. Cas du bouton de retour (bouton Retour par exemple).
    // Est-ce que l'on vient d'une page ?
    SI PagePrécédente() = "" ALORS
    // Oui, on affiche cette page
    PageAffiche(PagePrécédente())
    SINON
    // Non, on retourne à la page d'accueil
    PageAffiche(PAGE_Accueil)
    FIN

    Remarque : Ce code nécessite la présence dans le pattern RAD d'une page nommée "PAGE_Accueil". Cette page peut par exemple correspondre à la page d'accueil du site et contenir uniquement le menu général du site. Pour plus de détails, consultez Page de menu.

Cas des boutons d'impression

Un pattern RAD peut contenir des boutons permettant de lancer une impression. Le code de ces boutons doit permettre de lancer l'impression de l'état.
Il est nécessaire de créer les états dans le projet du pattern RAD :
  • Le nom de ces états doit contenir RADFichierX. Pour plus de lisibilité, il est conseillé d'utiliser dans le nom du formulaire "Fiche" ou "Table" pour identifier immédiatement le type de l'état.
  • Ce nom doit être utilisé dans le code du bouton imprimer :
    // Création d'un nom de fichier unique
    sFichier est une chaîne = fRepDonnées() + "\" + DateSys() + HeureSys() + ".pdf"
    // Impression de l'état dans un fichier PDF
    iDestination(iPDF, sFichier)
    // Génération de l'état
    iImprimeEtat(ETAT_Liste_RADFichierA)
    // Affichage de l'état au format PDF
    FichierAffiche(sFichier, "application/pdf")
    // Suppression du fichier
    fSupprime(sFichier)
ATTENTION : Il n'est pas nécessaire de personnaliser les états présents dans votre projet du Pattern RAD. En effet, lors de la génération, seul le nom de l'état sera conservé. Si le bouton "Imprimer" est présent dans une page de type "Fiche", l'état imprimé sera un état de type fiche. Si le bouton "Imprimer" est présent dans une page de type "Table", l'état imprimé sera un état de type Table.
Version minimum requise
  • Version 12
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 07/07/2023

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