PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Présentation
  • Mettre en place le groupware utilisateur sur une application mobile
  • Etape 1 : Installation du serveur HFSQL et du serveur réservé
  • Etape 2 : Activez le groupware utilisateur dans votre projet mobile
  • Etape 3 : Paramétrez les utilisateurs et les droits
  • Etape 4 : Testez l'application
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Groupware utilisateur Mobile (Android et iOS)
Présentation
WINDEV Mobile propose désormais un groupware utilisateur pour les applications Android et iOS.
Le principe d'utilisation est très simple :
  • Lors du lancement de l'application, un écran de connexion propose à l'utilisateur de s'identifier (avec possibilité de créer un nouveau compte).
  • A la validation de l'écran de connexion, l'application vérifie les informations de connexion en faisant une requête à un Webservice.
  • Si les informations de connexion sont correctes, l'utilisateur peut utiliser l'application avec les droits qui lui ont été accordés. Une base de données locale des droits est copiée sur le périphérique mobile, permettant une prochaine connexion, même en mode déconnecté.
Mettre en place le groupware utilisateur sur une application mobile
Pour mettre en place le groupware utilisateur dans une application mobile :
  1. Installez les éléments suivants :
    • un serveur HFSQL,
    • le serveur réservé, en demandant l'installation des modules pour le Groupware utilisateur mobile (WDBaaS).
  2. Activez le groupware utilisateur dans votre projet mobile et renseignez les différents paramètres demandés.
  3. Paramétrez les utilisateurs et les droits.
  4. Testez votre application.

Etape 1 : Installation du serveur HFSQL et du serveur réservé

Pour utiliser le groupware utilisateur mobile, il est nécessaire d'installer sur un poste :
  • Un serveur HFSQL.
  • Un serveur réservé pour le groupware utilisateur.
Remarques :
  • Le poste où est installé le serveur réservé doit être un serveur Web. Un serveur Web (IIS, Apache ou autre) doit être installé sur le poste.
  • Il est possible d'installer le serveur HFSQL et le serveur réservé sur deux postes différents.
  • Le serveur réservé peut être installé sur un serveur Web hébergeant également un serveur d'application WEBDEV.
Installation du serveur HFSQL :
Le programme d’installation du serveur HFSQL est disponible dans le package d'installation de WINDEV ou WINDEV Mobile. Si vous ne possédez pas ce package d'installation, l’installation du serveur HFSQL est également disponible sur le site de PC SOFT (http://www.pcsoft.fr).
Pour installer le serveur HFSQL depuis le package d'installation de WINDEV/WINDEV Mobile :
  1. Lancez le programme d’installation de WINDEV/WINDEV Mobile.
  2. Choisissez l’option "Installation du serveur HFSQL".
  3. Sélectionnez ensuite l’option "Installer ou mettre à jour un serveur HFSQL".
  4. Acceptez la licence.
  5. Choisissez la plateforme (option "Pour Windows sur cette machine").
  6. Si des serveurs HFSQL sont déjà installés sur le poste en cours, choisissez l’option "Installer un nouveau serveur".
  7. Sélectionnez le répertoire d’installation et indiquez le nom du serveur et le port. Par défaut, le port utilisé est 4900.
  8. Indiquez le nom et le mot de passe de l'utilisateur ayant les droits d'administration qui sera créé par défaut sur le serveur HFSQL. Par défaut, cet utilisateur est "Admin" sans mot de passe.
  9. Installez si nécessaire le Centre de Contrôle HFSQL si celui-ci n’est pas présent ou accessible depuis votre poste.
  10. L'assistant propose de paramétrer l'envoi de notifications afin de connaître les dysfonctionnements du serveur en tant réel. Sélectionnez l'option voulue.
  11. L'assistant propose d'activer l'authentification par Active Directory. Activez cette option si nécessaire.
  12. Validez (ou non) la participation à l'amélioration du produit installé en autorisant la collecte d'informations relatives à l'utilisation du produit. Cette collecte, facultative et anonyme, permet à PC SOFT d'améliorer les fonctionnalités du produit.
  13. L'installation est effectuée. Par défaut (si vous n'avez pas modifié les caractéristiques de l'administrateur), pour se connecter au serveur en mode administrateur, il faut utiliser l'utilisateur "Admin" sans mot de passe.
    Note : Pour des raisons évidentes de sécurité, pensez à changer le mot de passe de l’administrateur.
Installation du serveur réservé (WDBaaS)
Le serveur du Groupware Utilisateur est un serveur d'application WEBDEV réservé au groupware utilisateur.
Pour installer le serveur du groupware utilisateur :
  1. Lancez le pack d'installation du serveur réservé (fichier WX260PACKRSRV.exe disponible dans le sous-répertoire "Install\WDServeurR" du répertoire d'installation de WINDEV Mobile).
  2. Validez la licence.
  3. Sélectionnez le module à installer : "Installer les modules du groupware utilisateur mobile (WDBaaS)". Passez à l'étape suivante.
  4. Sélectionnez si nécessaire la version du serveur d'application réservé à installer (32 ou 64 bits). Passez à l'étape suivante.
  5. Sélectionnez le répertoire d'installation. Passez à l'étape suivante.
  6. Spécifiez les caractéristiques du serveur HFSQL utilisé pour le groupware utilisateur (installé précédemment) :
    • Nom du serveur HFSQL,
    • Port.
    • Nom et mot de passe de l'administrateur du Serveur HFSQL. Ces informations sont nécessaires pour configurer automatiquement la base de données du groupware utilisateur et l'utilisateur associé.
  7. Testez la connexion pour vérifier vos paramètres.
  8. Indiquez les paramètres spécifiques à la base de données utilisée par le groupware utilisateur :
    • le nom de la base de données dédiée au groupware utilisateur (GPU par défaut).
    • le nom de l'utilisateur administrateur du groupware utilisateur et son mot de passe.
  9. Cette base de données et son utilisateur vont être automatiquement créés.
  10. Passez à l'étape suivante.
  11. L'assistant vérifie si un serveur Web est présent sur le poste d'installation.
    • Si aucun serveur Web n'est installé sur le poste d'installation, l'assistant propose d'en installer un et de le configurer pour utiliser le serveur réservé pour le groupware utilisateur.
    • Si un serveur Web est présent sur le poste d'installation, l'assistant propose de le configurer pour utiliser le serveur réservé pour le groupware utilisateur.
  12. A la fin de l'installation, l'assistant affiche un récapitulatif de ce type :
    Pour vous connecter au serveur du groupware utilisateur mobile,
    utilisez les paramètres suivants :
    - Login : xxx
    - Mot de passe : xxxxx

    Pour information, les paramètres de la connexion HFSQL utilisée sont les suivants :
    - Serveur : xxx
    - Base de données : xxxx
    - Utilisateur : xxx - Mot de passe : xxx

    Le mot de passe des fichiers du groupware utilisateur est : xxxx
    Copiez et conservez ces informations. Ces login et mot de passe de connexion au serveur du groupware utilisateur mobile doivent être utilisés dans la fenêtre de paramétrage du groupware utilisateur dans votre projet WINDEV Mobile.
  13. Terminez l'assistant.
Remarque : Si le nom de la base de données est erroné, il est possible de relancer l'installation du serveur réservé pour le groupware utilisateur pour indiquer le nom correct de la base tout en conservant les identifiants.

Etape 2 : Activez le groupware utilisateur dans votre projet mobile

Pour activer le groupware utilisateur dans votre projet WINDEV Mobile :
  1. Ouvrez votre projet sous WINDEV Mobile.
  2. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Groupware Utilisateur".
  3. Dans la fenêtre qui s'affiche, sélectionnez si nécessaire l'onglet "Intégration" :
    • Activez le groupware utilisateur grâce aux options :
      • "Groupware utilisateur standard (conseillé)" : WINDEV Mobile se charge de tout. Il suffit de lancer l'application pour utiliser le groupware utilisateur.
      • "Groupware utilisateur personnalisé" : Tous les éléments du groupware utilisateur sont intégrés dans votre projet via un composant interne. Il est possible de personnaliser les différents éléments du groupware utilisateur. Cependant, les évolutions du produit ne seront pas intégrées.
    • Dans la zone "Serveur d'application du Groupware utilisateur (webservice et site d'administration)", indiquez le serveur à utiliser. Dans le cas d'un nouveau serveur, sélectionnez le type de serveur à utiliser :
      • Serveur local, réseau ou Internet avec le protocole utilisé. Saisissez le nom du serveur, l'utilisateur et le mot de passe. Ces informations vous ont été communiquées lors de l'installation du serveur réservé pour le groupware utilisateur.
      • Plateforme PCSCloud. Dans ce cas, indiquez les caractéristiques de votre plateforme PCSCloud. (Non disponible dans cette version).
    • Indiquez le type de déploiement utilisé :
      • Base unique par application : Ce mode de déploiement utilise une base de données unique pour les identifiants et les droits par application utilisant le groupware utilisateur. Ce mode de déploiement est conseillé pour un déploiement via le store.
      • Base partagée entre applications : Ce mode de déploiement utilise une base de données commune pour les identifiants et les droits du Groupware utilisateur. Ce mode de déploiement est conseillé pour un déploiement inter-entreprise.
    • Les URLs des sites d'administration sont automatiquement renseignées avec les renseignements spécifiés auparavant.
      ATTENTION : Les URL spécifiées ne fonctionneront qu'à la validation de la fenêtre de paramétrage du groupware utilisateur. En effet, lors de la validation de cette fenêtre, les modules installés avec le serveur d'application réservé sont automatiquement configurés.
  4. Dans l'onglet "Options", configurez :
    • Le type de lancement du Groupware utilisateur :
      • Lancement automatique : La fenêtre de login du groupware utilisateur est lancée avant toute autre fenêtre de l'application. Le code d'initialisation du projet est exécuté après l'ouverture et la validation de la fenêtre de login.
      • Lancement manuel : La fenêtre de login sera ouverte uniquement si la fonction gpwOuvre est utilisée. Cette option permet d'exécuter le code d'initialisation du projet par exemple, avant d'ouvrir la fenêtre de login. Cette option est intéressante par exemple dans le cas d'une application multilingue : une fenêtre peut être affichée pour demander la langue d'exécution de l'application.
    • Le mode de connexion des utilisateurs :
      • Afficher la fenêtre de connexion uniquement au premier lancement : La fenêtre de connexion sera affiché uniquement au premier lancement. Lors des exécutions suivantes, les informations saisies lors de la première connexion seront automatiquement réutilisées.
      • Authentification à chaque lancement : La fenêtre de connexion est affichée à chaque lancement. Dans ce cas, il est possible d'activer la vérification biométrique.
    • Le mode hors connexion : Le mode "Hors connexion" est le mode utilisé lorsque l'utilisateur ne peut pas utiliser le webservice d'identification. Dans ce mode, l'utilisateur précédemment connecté à l'application peut tout de même utiliser l'application. En effet, à chaque connexion avec identification, un fichier reprenant les caractéristiques de l'utilisateur et ses droits est copié localement. Il est possible de configurer le nombre de jours autorisés en mode hors connexion (0 par défaut).
    • La gestion des nouveaux utilisateurs : Il est possible d'autoriser les nouveaux utilisateurs à créer un compte (non autorisé par défaut).
  5. Dans l'onglet "Email", indiquez :
    • Les paramètres du serveur d'envoi des emails : Pour gérer l'inscription des utilisateurs et l'oubli de mots de passe, un email est envoyé aux utilisateurs. Pour cela, il est nécessaire d'indiquer les paramètres du serveur SMTP utilisé.
    • Les textes utilisés pour les emails envoyés lors de la validation de l'inscription et la gestion des mots de passe oubliés.
  6. Validez la fenêtre de gestion du groupware utilisateur.
Attention : Lors de la validation de la fenêtre du groupware utilisateur, les actions suivantes sont réalisées :
  • Ajout du composant interne contenant les fenêtres du groupware utilisateur (cas du groupware utilisateur personnalisé).
  • Déclaration de l'application en cours dans le serveur d'application réservé pour le groupware utilisateur.
  • Activation des sites de gestion des utilisateurs et de leurs droits.
  • Mise à jour du fichier XML contenant la description des fenêtres de l'application sur le serveur.
  • Définition d'un utilisateur par défaut, ayant pour login "superviseur" et pour mot de passe "superviseur".

Etape 3 : Paramétrez les utilisateurs et les droits

Pour paramétrer les utilisateurs et les droits :
  1. Lancez un site d'administration via un des liens présents dans l'onglet "Intégration" de la fenêtre de gestion du groupware utilisateur :
    • soit l'URL correspondant à l'application en exploitation. Les utilisateurs et les mots de passe définis seront utilisés lorsque l'application sera déployée.
    • soit l'URL correspondant au mode test. Les utilisateurs et les mots de passe définis seront utilisés lors d'un test sur le téléphone (Go de l'application).
  2. Connectez-vous au site d'administration. Utilisez le login login "superviseur" associé au mot de passe "superviseur".
  3. Vous pouvez définir les différents utilisateurs, leurs droits et leur mode de connexion.
Remarques :
  • Seul un utilisateur ayant l'option "Superviseur" peut accéder au site de gestion des utilisateurs et des droits.
  • Un bandeau spécifique permet de savoir si le site de gestion des utilisateurs et des droits est utilisé en mode test.
  • La liste des différentes fenêtres et les différents champs de l'application sont mis à jour sur le serveur (pour une utilisation dans la gestion des droits) lors des actions suivantes :
    • Validation de la fenêtre de paramétrage du groupware utilisateur.
    • Lancement de l'application en mode test.
    • Génération de l'application.
    Pour gérer une nouvelle fenêtre dans les droits des utilisateurs, il est donc nécessaire de générer l'application pour voir la fenêtre apparaître dans le site de gestion des droits.

Etape 4 : Testez l'application

Pour tester l'application :
  • Lancez le test de votre projet via les boutons d'accès rapide.
    • Sous Android, le test est réalisé via le simulateur ou sur votre mobile.
    • Sous iOS, le test est réalisé via le simulateur ou sur votre mobile via WMDEV.
  • Connectez-vous via le login et le mot de passe définis dans le site d'administration de test. L'application utilisera la base des utilisateurs et des droits de test.
Le déploiement de l'application est réalisé de la même façon que pour toutes les applications Android ou iOS. L'application déployée utilisera la base des utilisateurs et des droits de déploiement.
Remarque :
  • Lorsque l'application est lancée en test (Go en simulateur, ou émulateur Android, ou WMDev), la base des utilisateurs et des droits de test est automatiquement sélectionnée.
  • Après déploiement d'un APK sur un appareil ou dans un émulateur Android, la base des utilisateurs et des droits de production est automatiquement utilisée.
Pour modifier la base utilisée (base des utilisateurs et des droits de test ou de production) par programmation, utilisez :
  • un lancement manuel du groupware utilisateur (Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Groupware Utilisateur", puis dans l'onglet "Exécution", cliquez sur "Lancement manuel".
  • la fonction gpwOuvre.
Version minimum requise
  • Version 25
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire