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
WINDEVWEBDEV - Code Serveur

Syntaxe du nouveau groupware utilisateur Masquer les détails

<Résultat> = gpwOuvre([<Répertoire des fichiers du groupware>])
<Résultat> : Constante de type Entier
Résultat de l'ouverture de la fenêtre/page de login.
gpwAnnulationL'utilisateur a cliqué sur le bouton "Annuler" de la fenêtre de login du Groupware.
gpwErreurUne erreur est survenue. Pour obtenir le détail, utilisez la fonction ErreurInfo.
gpwMotDePasseInvalideLe mot de passe n'est pas valide. Il ne correspond pas au mot de passe de l'utilisateur décrit dans la base de données du groupware.
gpwOkL'utilisateur est connecté.
gpwUtilisateurInconnuL'utilisateur n'est pas référencé dans la base de données du groupware utilisateur.
<Répertoire des fichiers du groupware> : Chaîne de caractères optionnelle
Ces fichiers de données permettent de gérer les utilisateurs et leurs droits. Par défaut, ces fichiers de données sont créés dans un sous-répertoire de votre projet (répertoire EXE\GPW_<Nom du projet>).
HFSQL Client/Serveur Par défaut, ces fichiers de données sont créés sur le serveur dans un sous-répertoire de votre base de donnée (database) : répertoire .\GPW_<Nom du projet>.

Si ce paramètre correspond à une chaîne vide ("") ou n'est pas spécifié, le répertoire utilisé sera le répertoire par défaut du groupware utilisateur.
HFSQL Client/Serveur Si ce paramètre correspond à un point ".", les fichiers de données du groupware utilisateur seront créés sur le serveur à la racine de la base de données (database).
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.
WINDEVWEBDEV - Code Serveur

Syntaxe de l'ancien groupware utilisateur (conservée par compatibilité) Masquer les détails

<Résultat> = gpwOuvre([<Répertoire du fichier des droits> [, <Répertoire des fichiers des utilisateurs>]])
<Résultat> : Constante de type Entier
Résultat de l'ouverture de la fenêtre/page de login.
gpwAnnulationL'utilisateur a cliqué sur le bouton "Annuler" de la fenêtre de login du Groupware.
gpwErreurUne erreur est survenue. Pour obtenir le détail, utilisez la fonction ErreurInfo.
gpwMotDePasseInvalideLe mot de passe n'est pas valide. Il ne correspond pas au mot de passe de l'utilisateur décrit dans la base de données du groupware.
gpwOkL'utilisateur est connecté.
gpwUtilisateurInconnuL'utilisateur n'est pas référencé dans la base de données du groupware utilisateur.
<Répertoire du fichier des droits> : Chaîne de caractères optionnelle
Ces fichiers de données permettent de gérer les droits des utilisateurs sur les différentes fenêtres de l'application. Ces fichiers sont propres à l'application. Par défaut, ces fichiers de données sont créés dans un sous-répertoire de votre projet (répertoire EXE\GPW_<Nom du projet>).
HFSQL Client/Serveur Par défaut, ces fichiers de données sont créés sur le serveur dans un sous-répertoire de votre base de donnée (database) : répertoire .\GPW_<Nom du projet>.

Si ce paramètre correspond à une chaîne vide ("") ou n'est pas spécifié, le répertoire utilisé sera le répertoire par défaut du groupware utilisateur.
HFSQL Client/Serveur Si ce paramètre correspond à un point ".", les fichiers de données du groupware utilisateur seront créés sur le serveur à la racine de la base de données (database).
<Répertoire des fichiers des utilisateurs> : Chaîne de caractères optionnelle
Ces fichiers de données peuvent être communs à plusieurs applications. Par défaut, ces fichiers de données sont créés dans un sous-répertoire de votre projet (répertoire EXE\GPW_<Nom du projet>). Il est possible de définir l'emplacement des fichiers communs du groupware utilisateur à plusieurs applications. Dans ce cas, il est nécessaire de préciser le chemin des fichiers de données à utiliser.
HFSQL Client/Serveur Par défaut, ces fichiers de données sont créés sur le serveur dans un sous-répertoire de votre base de donnée (database) : répertoire .\GPW_<Nom du projet>.

Si ce paramètre correspond à une chaîne vide ("") ou n'est pas spécifié, le répertoire utilisé sera le répertoire par défaut du groupware utilisateur.
HFSQL Client/Serveur Si ce paramètre correspond à un point ".", les fichiers de données du groupware utilisateur seront créés sur le serveur à la racine de la base de données (database).
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 lors d'une connexion à une session prélancée".
Classification Métier / UI : Code neutre
Composante : wd300gpu.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 : 01/07/2024

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