DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Groupware utilisateur
  • Comment utiliser la fonction gpwOuvre ?
  • Sessions prélancées
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
Ouvre la fenêtre ou la page de login du groupware utilisateur.
Remarque : Cette fonction est nécessaire uniquement si le groupware utilisateur a été intégré avec l'option "Lancement manuel". Si l'option "Lancement automatique" a été choisie, cette fonction est ignorée.
Exemple
// Ouvre la fenêtre de login du groupware utilisateur
nRes est un entier = gpwOuvre("c:\GpwUtilisateur")
// Si le login a échoué 
SI nRes <> gpwOk ALORS 
	SELON nRes 
		CAS gpwAnnulation : Info("Vous avez cliqué sur le bouton Annuler.")
		CAS gpwErreur : Erreur("Erreur à l'initialisation du groupware.")
		CAS gpwUtilisateurInconnu : Erreur("Utilisateur inconnu.")
		CAS gpwMotPasseInvalide : Erreur("Mot de passe invalide.")
	FIN 
	FinProgramme()
FIN 
// Récupération du prénom de l'utilisateur 
Prénom est une chaîne = gpwRecupInfoUtilisateur(gpwInfoPrénom)
Info("Bienvenue" + Prénom)
Syntaxe
AndroidiPhone/iPad

Syntaxe spécifique pour les applications Android et iOS Masquer les détails

gpwOuvre(<Procédure WLangage> [, <Base de données des utilisateurs>])
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage ("callback") appelée à la fermeture de la fenêtre de login.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Connexion> est un booléen)
Le paramètre <Connexion> est un booléen :
  • Vrai si l'utilisateur est connecté,
  • Faux si l'utilisateur n'est pas connecté.
<Base de données des utilisateurs> : Constante de type Entier
Base de données des utilisateurs et des droits à utiliser :
gpwBaseDéfautLa base de données des utilisateurs et des droits dépend du mode de lancement de l'application :
  • si l'application est lancée en mode GO (Go simulateur ou Go sur téléphone avec WMDev), la base de données des utilisateurs et des droits utilisée est la base de données de test.
  • si l'application est lancée depuis la version déployée sur l'appareil mobile, ou un émulateur Android, la base de données des utilisateurs et des droits utilisée est la base de données de production.
gpwBaseProductionForce l'utilisation de la base de données des utilisateurs et des droits de production quel que soit le mode de lancement de l'application.
gpwBaseTestForce l'utilisation de la base de données des utilisateurs et des droits de test quel que soit le mode de lancement de l'application.
Remarques

Comment utiliser la fonction gpwOuvre ?

La fonction gpwOuvre permet de personnaliser le lancement du groupware utilisateur. Il est ainsi possible d'effectuer plusieurs actions avant de lancer la fenêtre ou la page de connexion au groupware utilisateur : exécuter du code, lancer des fenêtres ou des pages, etc.
Un exemple d'utilisation de cette fonction : dans une application multilingue utilisant le groupware utilisateur, la première fenêtre/page de l'application permet de choisir la langue d'exécution. Il est donc nécessaire lors de la création de l'application :
  • de ne pas choisir le lancement automatique du groupware utilisateur lors de son intégration
  • d'ouvrir la fenêtre/page de choix des langues en première fenêtre de l'application, puis d'appeler la fenêtre/page de login grâce à la fonction gpwOuvre.
AndroidiPhone/iPad Si le groupware utilisateur est activé en mode "Lancement manuel", il est nécessaire d'effectuer les opérations suivantes :
  • Ne pas définir une première fenêtre du projet.
  • Appeler la fonction gpwOuvre dans l'événement "Initialisation" du projet.
  • Ouvrir la première fenêtre du projet depuis le code WLangage de la procédure passée en paramètre à la fonction gpwOuvre.

Sessions prélancées

Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "Initialisation du projet après connexion au site".
Classification Métier / UI : Code neutre
Composante : wd290gpu.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Erreur utilisation fonction
"Appeler la fonction gpwOuvre dans l'événement "Initialisation" du projet."
=> Contrairement à ce qui est indiqué dans la documentation, faire ça provoque une erreur dans Windev Mobile 26 ("Cette fonction est interdite dans le traitement d'initialisation du projet et e déclaration des collections de procédures et des classes")
erbl
20 oct. 2021

Dernière modification : 25/04/2024

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