- Les étapes de la création de pattern RAD
- Quelles fenêtres doivent être créées ?
- Les fichiers à créer
- Différence Mobile et Smartphone
- Norme à suivre
- Les fenêtres fiche pour Mobile
- Présentation
- Créer une fenêtre fiche
- Cas des boutons d'impression
- Les fenêtres fiche pour Smartphone
- Présentation
- Créer une fenêtre fiche pour Smartphone
Créer les fenêtres Fiche d'un Pattern RAD WINDEV Mobile
Les étapes de la création de pattern RAD Quelles fenêtres 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. Une combo et un bouton Vision plus (ou une combo popup) doivent permettre de sélectionner un élément du fichier RADFichierA.
- Une fiche pour RADFichierC. Une combo et un bouton Vision plus (ou une combo popup) doivent 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 26. Ces règles sont une recommandation. Vous pouvez évidemment mettre en place et utiliser vos propres normes. Les fenêtres fiche pour Mobile Présentation Une fenêtre 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.
- Des champs Bouton permettant de réaliser des actions de base : "Valider" et si nécessaire "Imprimer".
- Des options de liaison permettant d'afficher par exemple les tables correspondantes (uniquement pour les fiches concernant RADFichierA et RADFichierB).
- Des champs Bouton de type Vision Plus permettant de sélectionner des éléments d'un autre fichier de données dans une fenêtre spécifique (uniquement pour les fiches concernant RADFichierB et RADFichierC).
Exemple de fenêtre Fiche pour le Pattern RAD Simple : Créer une fenêtre fiche Pour créer une fenêtre fiche : - Cliquez sur
 parmi les boutons d'accès rapide. - 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.
- 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 qui apparaît dans la fiche (quelques exemples : FEN_Fiche_RADFichierA, FEN_Fic_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 : Fiche de saisie").
- Enregistrez la fenêtre.
- Créez un superchamp dans la fenêtre : 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 fenêtre et définissez sa taille. Si tous les champs ne peuvent pas entrer dans la taille définie, des ascenseurs apparaîtront automatiquement.
- 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).
- 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").
- 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.
Remarque : Dans un pattern RAD Mobile, le bouton Annuler n'est pas présent pour ne pas surcharger les fenêtres. L'utilisateur utilise le bouton de fermeture de la fenêtre.
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"). - Cas du bouton de validation (bouton "OK" ou "Valider" par exemple).
Pour simplifier la gestion du bouton de validation, il est possible d'utiliser une action prédéfinie. Il est conseillé d'utiliser l'action "Fermeture de la fenêtre et renvoyer une valeur", avec l'option "Valeur renvoyée : la valeur spécifiée dans le code par ..ValeurRenvoyée".
Dans le code du bouton de validation, il est conseillé d'activer le gestion automatique des erreurs (Option "Si Erreur : ", avec le traitement automatique "Afficher l'erreur et retourner en saisie").
Le code du bouton de validation peut être par exemple (cas d'une fiche sur RADFichierA) :
// Lecture des informations saisies
EcranVersFichier()
// 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
// Valeur de retour de la fenêtre
MaFenêtre..ValeurRenvoyée = Vrai
- Saisissez le code d'initialisation de la fenêtre : Voici un exemple :
// Impression du bon de commande
NomFichier = fRepDonnées() + [fSep()] + ChaîneConstruit("BDC_%1.PDF", NuméroCommande)
iDestination(iPDFGénérique, NomFichier)
iImprimeEtat(ETAT_BonDeCommande, NuméroCommande, NuméroCommande)
// Test de l'existence du fichier
SI fFichierExiste(NomFichier) = Faux ALORS
Erreur("Le fichier PDF n'a pas été généré")
RETOUR
FIN
// Confirmation pour afficher le PDF
SI OuiNon(Oui, "Afficher le bon de commande généré (format PDF) ?") = Oui ALORS
// Affichage du bon de commande généré
LanceAppliAssociée(NomFichier)
SINON
iImprimePDF(NomFichier)
FIN
Ce code permet d'afficher la valeur des enregistrements dans la fiche et de renvoyer une valeur. - Ajoutez si nécessaire les options de menu de liaison.
- 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 (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 :
- "Details" pour les états de type fiche,
- "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 fiche pour Smartphone Présentation Une fenêtre 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.
- D'options de menu permettant de réaliser des actions de base : Valider et Annuler.
- D'options de menu de liaison permettant d'afficher par exemple les tables correspondantes (uniquement pour les fiches concernant RADFichierA et RADFichierB).
- De boutons Vision Plus permettant de sélectionner des éléments d'un autre fichier dans une fenêtre spécifique (uniquement pour les fiches concernant RADFichierB et RADFichierC).
Exemple de fenêtre Fiche pour le Pattern RAD Simple Smartphone : Remarque : Le projet doit être configuré pour utiliser une plateforme Smartphone : - Affichez la fenêtre de description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
- Dans l'onglet "Projet", cliquez sur le bouton "Description de la plateforme".
Créer une fenêtre fiche pour Smartphone Pour créer une fenêtre fiche pour Smartphone : - Cliquez sur parmi les boutons d'accès rapide.
- 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.
- 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 fiche (quelques exemples : FEN_Fiche_RADFichierA, FEN_Fic_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 : Fiche").
- Enregistrez la fenêtre.
- Créez un superchamp dans la fenêtre : 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 fenêtre et définissez sa taille. Si tous les champs ne peuvent pas entrer dans la taille définie, des ascenseurs apparaîtront automatiquement.
- 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).
- 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").
- Modifiez le menu présent dans la fenêtre :
- Une option de menu doit permettre de valider la fenêtre.
- Une option de menu doit permettre d'accéder au fichier lié (par exemple accéder à RADFichierB depuis la fiche de RADFichierA)
- Une option de menu doit permettre de sortir de la fiche sans valider.
- Les options de menu doivent porter des noms spécifiques :
- MENUPRINCIPAL_xxxx pour les options principales.
- MENULIA_xxx pour les options de liaison.
- Cas de l'option de menu de validation.
Dans le code de l'option de menu de validation, il est conseillé d'activer le gestion automatique des erreurs (Option "Si Erreur : ", avec le traitement automatique "Afficher l'erreur et retourner en saisie").
Le code du bouton de validation peut être par exemple (cas d'une fiche sur RADFichierA) :
// Lecture des informations saisies
EcranVersFichier()
// 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
// Valeur de retour de la fenêtre
MaFenêtre..ValeurRenvoyée = Vrai
- Cas des options de liaison :
Depuis la fiche RADFichierA, il est possible par exemple d'avoir une option de liaison permettant d'afficher la table RADFichierB.
Depuis la fiche RADFichierB, il est possible par exemple d'avoir une option de liaison permettant d'afficher la fiche 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 Fiche 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)
- Cas de l'option "Annuler"
// Valeur de retour de la fenêtre
MaFenêtre..ValeurRenvoyée = Faux
// Fermeture de la fenêtre
Ferme()
- Saisissez le code d'initialisation de la fenêtre. Voici un exemple :
// Affichage des enregistrements
FichierVersEcran()
// Valeur de retour renvoyée par défaut
MaFenêtre..ValeurRenvoyée = Faux
Ce code permet d'afficher la valeur des enregistrements dans la fiche et de renvoyer une valeur. - Ajoutez si nécessaire les boutons Vision Plus (pour les fiches RADFichierB et RADFichierC).
|
|
|