PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Les étapes de la création de pattern RAD
  • Création des différentes fenêtres du pattern
  • Les fichiers à créer
  • Différence Mobile et Smartphone
  • Norme à suivre
  • Les fenêtres Table pour Mobile
  • Créer une fenêtre table pour Mobile
  • Cas des boutons d'impression
  • Les fenêtres Table pour Smartphone
  • Pour créer une fenêtre table pour Smartphone :
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 fenêtres Table du pattern RAD WINDEV Mobile
Les étapes de la création de pattern RAD
Les différentes étapes permettant de créer un Pattern RAD WINDEV Mobile sont les suivantes :
  1. Création du projet de type "Pattern RAD".
  2. Création des différentes fenêtres du pattern.
  3. Génération du Pattern RAD.
  4. Utilisation du Pattern RAD.
Création des différentes fenêtres du pattern

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 fenêtre de relation RADFichierB / RADFichierD.
Ces différents éléments doivent contenir des boutons de liaison. Il est également possible de fournir le menu général de l'application.

Différence Mobile et Smartphone

Concevoir une application pour Mobile et une application pour Smartphone sont deux choses différentes. En effet, sur un Smartphone, l'écran est plus petit, et un menu déroulant permet de valider ou non les écrans.
Cette différence se retrouve au niveau des patterns RAD. Cette page d'aide présente comment faire une fenêtre fiche pour Mobile et pour Smartphone.

Norme à suivre

Cette page d'aide présente différentes règles applicables à la conception des pages et des fenêtres du Pattern RAD. Ces règles ont été utilisées pour concevoir les différents Patterns livrés avec WINDEV Mobile 24.
Ces règles sont une recommandation. Vous pouvez évidemment mettre en place et utiliser vos propres normes.
Les fenêtres Table pour Mobile
Une fenêtre Table est constituée des éléments suivants :
  • Un champ Table : Cette table est une table fichier, avec fichier en accès direct.
  • De boutons permettant de réaliser des actions de base : "Ajouter", "Modifier", "Supprimer" et si nécessaire "Imprimer".
  • Des options de liaison permettant d'afficher par exemple les fiches correspondantes.
Exemple : Fenêtre Table sur le fichier RADFichierA du pattern Modèle Simple :

Créer une fenêtre table pour Mobile

Pour créer une fenêtre table pour Mobile :
  1. Sélectionnez l'option "Fichier .. Nouveau .. Fenêtre", puis l'option "Assistant fenêtre vierge". Dans l'assistant, conservez les options par défaut.Cliquez sur parmi les boutons d'accès rapide :
    • Dans la roue qui s'affiche, cliquez sur "Fenêtre". La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Fenêtre" puis sur "Fenêtre".
    • L'assistant de création d'une fenêtre se lance.
    • Sélectionnez l'option "Assistant".
    • Dans l'assistant, conservez les options par défaut.
  2. Dans la fenêtre de description, saisissez les informations suivantes :
    • Le nom de la fenêtre. Ce nom doit obligatoirement contenir le nom du fichier affiché dans la table (quelques exemples : FEN_Table_RADFichierA, FEN_Tab_RADFichierA, ...).
    • Le titre de la fenêtre. Si le titre doit afficher le nom du fichier, utilisez le nom du fichier "RADFichierXX" (par exemple "RADFichierA : Table de visualisation").
  3. Enregistrez la fenêtre.
  4. Créez dans la fenêtre un champ Table (option "Insertion .. Champ .. Table").Créez dans la fenêtre un champ Table : sous le volet "Création", dans le groupe "Données", déroulez "Table" et sélectionnez "Table (Verticale)".
  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 existante".
    • Sélectionnez le fichier de base de la table (par exemple RADFichierA).
    • Conservez la rubrique proposée ainsi que la clé de parcours.
    • Indiquez la source pour le remplissage : "Fichier avec accès direct (Sans limite)".
    • Validez le nom de la table.
  6. Positionnez le champ Table dans la fenêtre 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 fenêtre (bouton de validation, d'impression, de parcours, ...). Ces boutons peuvent avoir n'importe quel nom.
    Attention : si vous autorisez l'utilisateur à appliquer un gabarit aux fenêtres créées par le RAD, il est nécessaire de définir le type de bouton qui doit être utilisé par le gabarit. Cette information peut être définie dans le modifieur (Catégorie "Gabarit").
  8. Cas du bouton d'ajout (bouton Nouveau par exemple).
    Ce bouton peut par exemple permettre la saisie d'un nouvel enregistrement dans une fenêtre 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
    Ouvre(FEN_Fiche_RADFichierA)
    // Rafraîchissement de la table
    TableAffiche(TABLE_RADFichierA, taCourantEnreg)
  9. Cas du bouton de modification (bouton Modifier par exemple).
    Ce bouton peut par exemple permettre la modification d'un enregistrement dans une fenêtre 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
    Ouvre(FEN_Fiche_RADFichierA)
    // Rafraîchissement de la table
    TableAffiche(TABLE_RADFichierA, taCourantEnreg)
  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) :
    // Une ligne est-elle sélectionnée ?
    SI TableSelect(TABLE_RADFichierA) = -1 ALORS RETOUR

    // Demande confirmation de suppression
    SELON OuiNon("Supprimer l'enregistrement ?")
            CAS Oui
              // Suppression de l'enregistrement RADFichierA à partir de la table
              TableSupprime(TABLE_RADFichierA)
              // Positionnement sur l'enregistrement courant
              TableAffiche(TABLE_RADFichierA, taCourantEnreg)
             CAS Non
                    // Ne rien faire
    FIN

    Dans le code du bouton de suppression, il est conseillé d'activer le gestion automatique des erreurs (Option "Si Erreur : ", avec le traitement automatique "Afficher l'erreur et retourner en saisie").
  11. Ajoutez si nécessaire les menus de liaison.
  12. Ajoutez si nécessaire les boutons Vision Plus.

Cas des boutons d'impression

Un pattern RAD peut contenir des boutons permettant de lancer une impression. Le code de ces boutons (ou l'action prédéfinie associée) 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 de l'état "Détails" pour les états de type fiche et "Liste" pour les états de type table.
  • Ce nom doit être utilisé dans le code du bouton imprimer (ou dans l'action prédéfinie associée au bouton).
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 fenêtre de type "Fiche", l'état imprimé sera un état de type fiche. Si le bouton "Imprimer" est présent dans une fenêtre de type "Table", l'état imprimé sera un état de type Table.
Les fenêtres Table pour Smartphone
Une fenêtre Table est constituée des éléments suivants :
  • Une table : Cette table est une table fichier, avec fichier en accès direct.
  • Options de menu permettant de réaliser des actions de base : Ajouter, Modifier et Supprimer.
  • Options de menu de liaison permettant d'afficher par exemple les fiches correspondantes.
Exemple : Fenêtre Table sur le fichier RADFichierA du pattern Modèle Simple :

Pour créer une fenêtre table pour Smartphone :

  1. Sélectionnez l'option "Fichier .. Nouveau .. Fenêtre", puis l'option "Assistant fenêtre vierge". Dans l'assistant, conservez les options par défaut.Cliquez sur parmi les boutons d'accès rapide.
    • Dans la roue qui s'affiche, cliquez sur "Fenêtre". La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Fenêtre" puis sur "Fenêtre".
    • L'assistant de création d'une fenêtre se lance.
    • Sélectionnez l'option "Assistant".
    • Dans l'assistant, conservez les options par défaut.
  2. Dans la fenêtre de description, saisissez les informations suivantes :
    • Le nom de la fenêtre. Ce nom doit obligatoirement contenir le nom du fichier affiché dans la table (quelques exemples : FEN_Table_RADFichierA, FEN_Tab_RADFichierA, ...).
    • Le titre de la fenêtre. Si le titre doit afficher le nom du fichier, utilisez le nom du fichier "RADFichierXX" (par exemple "RADFichierA : Table de visualisation").
  3. Enregistrez la fenêtre.
  4. Créez dans la fenêtre un champ Table (option "Insertion .. Champ .. Table").Créez dans la fenêtre un champ Table : sous le volet "Création", dans le groupe "Données", déroulez "Table" et sélectionnez "Table (Verticale)".
  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 existante".
    • Sélectionnez le fichier de base de la table (par exemple RADFichierA).
    • Conservez la rubrique proposée ainsi que la clé de parcours.
    • Indiquez la source pour le remplissage : "Fichier avec accès direct (Sans limite)".
    • Validez le nom de la table.
  6. Positionnez le champ Table dans la fenêtre et définissez sa taille. Si nécessaire la colonne correspondant à l'identifiant peut être invisible.
  7. Modifiez le menu présent dans la fenêtre :
    • Des options de menu doivent permettre d'ajouter, de modifier ou de supprimer un élément.
    • Une option de menu doit permettre d'accéder au fichier lié (par exemple accéder à RADFichierB depuis la table de RADFichierA).
    • Une option de menu doit permettre de fermer la fenêtre.
  8. Les options de menu doivent porter des noms spécifiques :
  9. Cas de l'option d'ajout.
    Cette option peut par exemple permettre la saisie d'un nouvel enregistrement dans une fenêtre de type fiche. Le code de l'option Nouveau peut être par exemple :
    // Création d'un nouvel enregistrement
    HRAZ(RADFichierA)
    // Ouverture de la fiche du fichier RADFichierA en mode création
    Ouvre(FEN_Fiche_RADFichierA)
    // Rafraîchissement de la table
    TableAffiche(TABLE_RADFichierA, taCourantPremier)
  10. Cas de l'option de modification.
    Cette option peut par exemple permettre la modification d'un enregistrement dans une fenêtre de type fiche. Le code de l'option 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
    Ouvre(FEN_Fiche_RADFichierA)
    // Rafraîchissement de la table
    TableAffiche(TABLE_RADFichierA, taCourantBandeau)
  11. Cas de l'option de suppression.
    Cette option peut par exemple supprimer un enregistrement sélectionné dans la table. Le code de l'option Supprimer peut être par exemple (pour la table sur le fichier RADFichierA) :
    // Demande confirmation de suppression
    SELON OuiNon("Supprimer l'enregistrement ?")
            CAS Oui
              // Suppression de l'enregistrement RADFichierA à partir de la table
              TableSupprime(TABLE_RADFichierA)
              // Positionnement sur l'enregistrement courant
              TableAffiche(TABLE_RADFichierA, taCourantPremier)
             CAS Non
                    // Ne rien faire
    FIN

    Dans le code du bouton de suppression, il est conseillé d'activer le gestion automatique des erreurs (Option "Si Erreur : ", avec le traitement automatique "Afficher l'erreur et retourner en saisie").
  12. Cas des options de liaison :
    • Depuis la table RADFichierA, il est possible par exemple d'avoir une option de liaison permettant d'afficher la table RADFichierB.
    • Depuis la table RADFichierB, il est possible par exemple d'avoir une option de liaison permettant d'afficher la table RADFichierA, la table RADFichierC, et la fenêtre de relation.
Exemple de code permettant d'ouvrir la fenêtre Table RADFichierB à partir de la fenêtre table RADFichierA :
// Mise en place du filtre sur la clé de liaison
HFiltre(RADFichierB, IDRADFichierARel, RADFichierA.IDRADFichierA)
// Ouverture de la fenêtre table des RADFichierB
Ouvre(FEN_Table_RADFichierB)
// Désactivation du filtre
HDésactiveFiltre(RADFichierB)
Version minimum requise
  • Version 12
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire