gpwOuvre (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Groupware utilisateur

Comment utiliser la fonction gpwOuvre ?
Sessions prélancées

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

gpwOuvre (Fonction)

En anglais : gpwOpen

Non disponible

Non disponible avec ces types de connexion

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

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.
gpwAnnulation L'utilisateur a cliqué sur le bouton "Annuler" de la fenêtre de login du Groupware.
gpwErreur Une erreur est survenue. Pour obtenir le détail, utilisez la fonction ErreurInfo.
gpwMotDePasseInvalide Le 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.
gpwOk L'utilisateur est connecté.
gpwUtilisateurInconnu L'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>).
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.
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).

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éfaut La 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.
gpwBaseProduction Force 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.
gpwBaseTest Force 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.

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.
gpwAnnulation L'utilisateur a cliqué sur le bouton "Annuler" de la fenêtre de login du Groupware.
gpwErreur Une erreur est survenue. Pour obtenir le détail, utilisez la fonction ErreurInfo.
gpwMotDePasseInvalide Le 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.
gpwOk L'utilisateur est connecté.
gpwUtilisateurInconnu L'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>).
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.
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.
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.
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.

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

Voir Aussi

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