PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Les étapes de la création de pattern RAD
  • Quelles pages doivent être créées ?
  • Les fichiers à créer
  • Norme à suivre
  • Les pages fiche
  • Présentation
  • Pour créer une page fiche :
  • Cas des boutons d'impression
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Créer les pages Fiche d'un 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 16.
Ces règles sont une recommandation. Vous pouvez évidemment mettre en place et utiliser vos propres normes.
Les pages fiche

Présentation

Une page fiche est constituée des éléments suivants :
  • Un superchamp : Ce superchamp contient les champs de la fiche à afficher. Ce superchamp est lié au fichier à afficher.
  • De boutons permettant de Valider ou d'Annuler (bouton de retour).
  • De boutons Vision Plus permettant de sélectionner des éléments d'un autre fichier dans une page spécifique (uniquement pour les fiches concernant RADFichierB et RADFichierC).
Remarque : Si le pattern utilise un menu, il est conseillé d'insérer ce menu dans le modèle de page utilisé par le pattern. Le menu sera ainsi accessible sur toutes les pages générées.
Exemple de page Fiche pour le Pattern Intranet :

Pour créer une page fiche :

  1. Sélectionnez l'option "Fichier .. Nouveau .. Page", puis l'option "Vierge". Vous pouvez sélectionner le modèle utilisé dans votre pattern.Cliquez sur parmi les boutons d'accès rapide.
    • Dans la roue qui s'affiche, cliquez sur "Page".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 fiche (quelques exemples : PAGE_Fiche_RADFichierA, PAGE_Fic_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 dans la page un superchamp (option "Insertion .. Spécial .. Superchamp"). Ce superchamp va afficher les champs de la fiche. Positionnez ce champ dans la page et définissez sa taille. Si tous les champs ne peuvent pas entrer dans la taille définie, des ascenseurs apparaîtront automatiquement.Créez dans la page un superchamp : sous le volet "Création", dans le groupe "Conteneurs", cliquez sur "Superchamp". Ce superchamp va afficher les champs de la fiche. Positionnez ce champ dans la page et définissez sa taille. Si tous les champs ne peuvent pas entrer dans la taille définie, des ascenseurs apparaîtront automatiquement.
  5. Dans la fenêtre de description du superchamp, indiquez le nom du superchamp. Ce nom doit être obligatoirement SC_Fiche (SC_ est le préfixe de la charte de programmation : il n'est pas nécessaire si vous n'utilisez pas de charte de programmation).
  6. Dans l'onglet "Contenu" de la fenêtre de description du superchamp, spécifiez :
    • le fichier parcouru : RADFichierXX (par exemple "RADFichierA").
    • la rubrique parcourue : IDRADFichierXX (par exemple "IDRADFichierA").
  7. Créez et positionnez les différents boutons de votre page : bouton de validation, bouton de retour à la page précédente. Ces boutons peuvent avoir n'importe quel nom.
  8. Cas du bouton de validation (bouton "OK" ou "Valider" par exemple).
    Dans le code du bouton de validation, 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)").
    Le code du bouton de validation peut être par exemple (cas d'une fiche sur RADFichierA) :
    // Lecture des informations saisies
    PageVersFichier()
    // S'il s'agit d'un nouvel enregistrement
    SI RADFichierA..NouvelEnregistrement = Vrai ALORS
    // On l'ajoute
    HAjoute(RADFichierA)
    SINON
    // On le modifie
    HModifie(RADFichierA)
    FIN
    // Retour à la page précédente
    SI PagePrécédente() = "" ALORS
    PageAffiche(PagePrécédente)
    SINON
    PageAffiche(PAGE_Accueil)
    FIN

    CAS ERREUR:
    Erreur("Une erreur est survenue pendant la validation.", HErreurInfo())
    RETOUR
  9. 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 être 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.
  10. Saisissez le code d'initialisation de la page. Voici un exemple :
    // Affichage des enregistrements
    FichierVersPage()

    Ce code permet d'afficher la valeur des enregistrements dans la fiche.
  11. Ajoutez si nécessaire les boutons Vision Plus (pour les fiches RADFichierB et RADFichierC).

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