PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Nouveauté WEBDEV 24 !
  • Présentation
  • Interface de l'administrateur WEBDEV
  • Caractéristiques des connexions en cours
  • Sites installés
  • Webservices installés
  • Configuration générale
  • Options avancées
  • Installations/Comptes
  • Journaux
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
2. L'administrateur WEBDEV en pratique
Chapitre précédentSommaireChapitre suivant
Présentation
L’administrateur WEBDEV est un module permettant de gérer les sites WEBDEV dynamiques (de type Session ou AWP).
Lors du développement d'un site WEBDEV dynamique, l'administrateur permet principalement de :
  • tester le site grâce à la page de test.
  • régler les paramètres de connexion au site pour vos tests : temps de déconnexion, ...
  • supprimer directement les connexions de test en cours .
  • changer le serveur Web utilisé pour vos tests.
  • effectuer un diagnostic en cas de problème lors du lancement d'un site WEBDEV.
  • ...
En déploiement, deux types d'administrateur WEBDEV existent :
  • l'administrateur WEBDEV Déploiement qui permet à l'hébergeur de gérer les sites WEBDEV dynamiques installés sur un serveur Web.
  • l'administrateur WEBDEV Distant qui permet au gestionnaire de site de gérer ses sites WEBDEV dynamiques à distance depuis n'importe quel poste.
Ce chapitre présente uniquement l'administrateur WEBDEV Développement.
Pour plus de détails sur les outils de déploiement, consultez leur aide.
Lancement de l'administrateur WEBDEV
Pour lancer l'administrateur WEBDEV Développement :
  • depuis WEBDEV version Développement : sous le volet "Outils", dans le groupe "Utilitaires Web", cliquez sur "WDAdmin".
  • sélectionnez l'option "Programmes .. WEBDEV 24 .. Administrateur WEBDEV" depuis le menu "Démarrer".
L'administrateur WEBDEV est lancé automatiquement au premier test du site.
L'administrateur peut ensuite être laissé en tâche de fond.
Par défaut, l'administrateur WEBDEV autorise dix connexions simultanées à un même site WEBDEV dynamique (icône GO).
Interface de l'administrateur WEBDEV
L'administrateur WEBDEV se présente sous la forme d'une fenêtre comportant plusieurs onglets :
  • Onglet "Connexions".
  • Onglet "Sites" et onglet "Webservices".
  • Onglet "Configuration".
  • Onglet "Avancé".
  • Onglet "Installations/Comptes".
  • Onglet "Journaux".

Caractéristiques des connexions en cours

L'onglet "Connexions" fournit diverses informations à propos des connexions en cours. Ces informations peuvent être consultées à tout moment sur le serveur :
  • Le Nombre de connexions en cours indique le nombre de connexions totales aux sites WEBDEV dynamiques gérés par l'administrateur.
  • Le Tableau des connexions en cours indique pour chaque connexion :
    • l'identifiant de la connexion,
    • le site concerné par la connexion,
    • l'identité du client connecté. En utilisation réelle, le client est identifié par son adresse IP ou son adresse Internet,
    • le temps actuel de connexion,
    • le temps d'inactivité de la connexion.
  • Rafraîchissement automatique : cette option permet de rafraîchir automatiquement les données affichées.
    L'onglet "Connexions" permet également de :
  • Arrêter une connexion en cours :
    Sélectionnez une des connexions et cliquez sur "Déconnecter".
  • Stopper toutes les connexions en cours et fermer l'administrateur : cliquez sur "Déconnecter Tous".

Sites installés

L'onglet "Sites" fournit des informations concernant les sites WEBDEV dynamiques installés sur le poste.
L'onglet "Sites" liste les différents sites WEBDEV dynamiques installés sur le poste et gérés par l'administrateur WEBDEV. Pour chaque site, les informations suivantes sont affichées dans un tableau :
  • le nom du site.
  • le répertoire complet d'installation du site sur le poste.
  • le nom du fichier "projet" correspondant.
  • l'état du site (bloqué ou non). Il est possible de cocher la case pour bloquer directement l'accès au site pendant la mise à jour du site.
  • le nombre de tâches planifiées utilisées par le site.
    L'onglet "Sites" permet aussi de :
  • Supprimer le site sélectionné dans le tableau.
    Il s'agit uniquement de supprimer le site de l'administrateur : le site WEBDEV sera toujours présent sur le disque.
  • Rafraîchir l'affichage des sites présents dans le tableau.
    Ce rafraîchissement permet de vérifier la présence d'un site dans l'administrateur après son installation.
  • Ajouter un site dans le tableau.
  • Paramétrer individuellement les sites présents sur le poste.
    Par défaut, la configuration prise en compte est celle de l'onglet "Configuration".
    Il est également possible de créer une configuration spécifique pour le site sélectionné (bouton "Paramètres").
    Cette configuration concerne le nombre de connexions autorisées, la durée d'inactivité autorisée et le blocage éventuel du site pour une mise à jour. Pour plus de détails sur ces paramètres, consultez l'onglet "Configuration".
    Pour valider immédiatement le nouveau paramétrage, appuyez sur le bouton "Appliquer".
    Il est également possible de gérer les tâches planifiées associées au site sélectionné (bouton "Tâches planifiées"). Ce paramétrage est disponible uniquement lorsque le site est déployé.
  • Tester directement les sites installés sur le poste (uniquement en version de développement) :
Sélectionnez le site puis cliquez sur "Tester".

Webservices installés

L'onglet "Webservices" fournit des informations concernant les Webservices WEBDEV dynamiques installés sur le poste.
L'onglet "Webservices" liste les différents Webservices WEBDEV dynamiques installés sur le poste et gérés par l'administrateur WEBDEV. Pour chaque Webservice, les informations suivantes sont affichées dans un tableau :
  • le nom du Webservice.
  • le répertoire complet d'installation du Webservice sur le poste.
  • le nom du fichier "projet" correspondant.
  • l'état du Webservice (bloqué ou non). Il est possible de cocher la case pour bloquer directement l'accès au Webservice pendant sa mise à jour.
  • le nombre de tâches planifiées utilisées par le Webservice.
    L'onglet "Webservices" permet aussi de :
  • Supprimer le Webservice sélectionné dans le tableau.
    Il s'agit uniquement de supprimer le Webservice de l'administrateur : le Webservice WEBDEV sera toujours présent sur le disque.
  • Rafraîchir l'affichage des Webservices présents dans le tableau.
    Ce rafraîchissement permet de vérifier la présence d'un Webservice dans l'administrateur après son installation.
  • Ajouter un Webservice dans le tableau.
  • Paramétrer individuellement les Webservices présents sur le poste.
    Par défaut, la configuration prise en compte est celle de l'onglet "Configuration".
    Il est également possible de créer une configuration spécifique pour le Webservice sélectionné (bouton "Paramètres").
    Cette configuration concerne le nombre de connexions autorisées, la durée d'inactivité autorisée et le blocage éventuel du Webservice pour une mise à jour. Pour plus de détails sur ces paramètres, consultez l'onglet "Configuration".
    Pour valider immédiatement le nouveau paramétrage, appuyez sur le bouton "Appliquer".
    Il est également possible de gérer les tâches planifiées associées au Webservice sélectionné (bouton "Tâches planifiées"). Ce paramétrage est disponible uniquement lorsque le Webservice est déployé.

Configuration générale

La configuration générale correspond aux différentes options de connexion par défaut pour les sites WEBDEV présents sur le serveur et gérés par l'administrateur.
L'onglet "Configuration" permet de :
  • Paramétrer les connexions.
  • Paramétrer les sessions et les requêtes.
  • Gérer le fichier journal pour obtenir les statistiques de fréquentation.
  • Gérer le débogage à distance.
    Le paramétrage des connexions est réalisé par les options suivantes :
  • Nombre maximum de connexions sur le serveur :
    Nombre maximum de connexions simultanées autorisées pour l'ensemble des sites gérés par l'administrateur (une connexion = un internaute).
  • Nombre maximum de connexions sur un site :
    Nombre maximum de connexions simultanées autorisées pour chaque site géré par l'administrateur. Ce nombre peut être modifié pour chaque site dans l'onglet "Sites".
  • Nombre maximum de connexions d'un utilisateur sur un site :
    Nombre maximum de connexions simultanées autorisées pour un même internaute sur chaque site géré par l'administrateur.
    Si ce paramètre est égal à zéro, l'internaute essayant de se connecter simultanément à un même site, sera automatiquement déconnecté puis reconnecté.
    Si ce paramètre est supérieur à zéro, un message d'erreur apparaîtra automatiquement au bout des x connexions simultanées.
    Ce nombre peut être modifié pour chaque site (onglet "Sites").
    L'option "Une seule connexion recyclée automatiquement" permet de limiter la connexion d'un utilisateur à une connexion. La même connexion sera réutilisée.
    Le paramétrage des sessions et des requêtes est réalisé par les options suivantes :
  • Déconnecter les utilisateurs inactifs depuis :
    Il s'agit du temps maximum de connexions autorisées sans action de la part de l'internaute. Si ce temps est dépassé, l'internaute est automatiquement déconnecté et un message d'erreur est affiché.
    Ce nombre peut être modifié pour chaque site dans l'onglet "Sites".
  • Durée des contextes AWP :
    Durée de validité des contextes AWP. Dès que la durée indiquée est écoulée et si aucune nouvelle requête n'a été effectuée, le fichier des contextes est supprimé.
  • Durée des contextes Webservices :
    Durée de validité des contextes correspondants aux Webservices.
  • Durée maximum d'une requête :
    Temps maximum d'attente autorisé entre le déclenchement d'une action par l'internaute (par un bouton ou un lien) et l'affichage de la réponse. Si ce temps est dépassé, une page d'erreur est affichée, mais l'internaute n'est pas déconnecté.
  • Durée maximum d'une tâche :
    Permet de limiter la durée d'exécution d'une tâche planifiée ou d'une tâche différée WEBDEV. Si la tâche dépasse cette durée, elle sera automatiquement arrêtée.
  • Autoriser les sessions prélancées :
    Permet de gérer les sessions prélancées sur le serveur d'application WEBDEV. Cette option permet d'optimiser le temps de connexion aux sites et Webservices WEBDEV présents sur le serveur. Pour plus de détails, consultez l'aide en ligne.
L'administrateur WEBDEV permet de générer un fichier journal spécifique permettant de suivre les statistiques de fréquentation.
  • Générer un fichier journal pour les statistiques de fréquentation (.log) :
    Permet de générer un fichier journal (extension ".LOG") pour visualiser les statistiques de fréquentation des sites WEBDEV à l'aide de WDStatistiques. Pour plus de détails sur WDStatistiques, consultez l'aide de WDStatistiques.
  • Enregistrer dans le fichier global et dans le fichier de chaque application :
    Cette option permet d'enregistrer les statistiques à la fois dans le fichier journal de l'application et dans le fichier journal du serveur. En effet, si le fichier journal est défini à la fois au niveau du serveur et au niveau des applications (onglet "Sites"), des informations peuvent être "perdues".
Remarque : Si le fichier journal est activé, il est possible de visualiser le journal des erreurs dans l'onglet "Journaux" de l'administrateur.
Gérer le débogage à distance
L'administrateur WEBDEV permet d'autoriser ou non le débogage à distance des sites WEBDEV dynamiques.
Si le débogage à distance est autorisé, les paramètres suivants doivent être spécifiés :
  • Port principal (27 271 par défaut).
  • Plage des ports des sessions (entre 27 282 et 27 289 par défaut).
Le bouton "Par défaut" permet de rétablir les valeurs par défaut.

Options avancées

L'onglet "Avancé" permet de :
  • Choisir un des serveurs Web installés sur le poste en cours pour exécuter les sites WEBDEV.
  • Effectuer un diagnostic de configuration du poste en cours.
  • Spécifier le nom ou l'adresse IP du poste en cours.
  • Afficher sous le navigateur une page permettant de lancer tous les sites WEBDEV installés sur le poste en cours.
  • Gérer la recherche des pages périmées.
  • Gérer les impressions.
  • Gérer les messages d'erreur.
  • Gérer les emails en mode asynchrone.
  • Gérer les sockets serveur.
  • Autoriser ou non certaines fonctions spécifiques.
  • Interdire le changement d'IP en cours de navigation.
  • Interdire l'accès aux identifiants de contexte AWP depuis Javascript.
Serveur utilisé
Le bouton "Serveur" permet de choisir un des serveurs WEB installés sur le poste en cours pour exécuter les sites WEBDEV. Attention : Ce serveur sera utilisé pour tous les sites dynamiques WEBDEV installés sur ce poste.
Si le serveur utilisé n'est pas présent dans cette liste, choisissez "Autre". Il faudra alors configurer manuellement le serveur Web utilisé. Pour plus de détails sur la configuration de serveurs spécifiques, consultez l'aide en ligne.
Diagnostic
Le bouton "Diagnostic" permet d'effectuer une vérification de la configuration du poste en cours. Ce diagnostic permet de vérifier :
  • si le protocole TCP/IP est installé
  • si un serveur Web (serveur HTTP) est lancé
  • si le gestionnaire de protocole AWP est correctement configuré
  • si les exécutables WEBDEV nécessaires sont présents.
Si une de ces conditions n'est pas remplie, les sites WEBDEV dynamiques ne pourront pas fonctionner.
Pour plus de détails, consultez l'aide en ligne.
Nom ou adresse IP du poste en cours
L'administrateur WEBDEV permet de spécifier un nom ou une adresse IP pour désigner un poste spécifique. Il est également possible de spécifier le numéro de port. Par exemple : localhost:8080.
Ce poste sera utilisé :
  • lors de l'utilisation du bouton "Diagnostic".
  • lors de l'utilisation du bouton "Page de test".
  • lors du test d'un site, d'une page, d'un état, ... depuis l'éditeur WEBDEV (icône "GO").
Test
Le bouton "Page de test" permet d'afficher sous le navigateur une page permettant de lancer chacun des sites WEBDEV dynamiques et des Webservices WEBDEV dynamiques installés sur ce poste.
Pour plus de détails sur les tests d'un site WEBDEV, consultez le chapitre 5. Test d'un site en pratique.
Recherche des pages périmées
Cette option permet d'activer et de paramétrer la recherche des pages périmées sur les sites WEBDEV gérés par le serveur d'application WEBDEV.
Imprimante utilisée par défaut (site intranet uniquement)
Le bouton "Impressions" permet de sélectionner l'imprimante utilisée par défaut lors d'une impression directe sur une imprimante locale ou réseau du serveur Web.
Messages d'erreur
Le bouton "Erreurs" affiche les différentes erreurs pouvant être affichées dans le navigateur de l'internaute. Il est possible de personnaliser le message d'erreur ou encore la page HTML où l'erreur est affichée.
Spooler de mails
Si l'option "Désactiver le spooler de mail" est décochée, vos sites pourront envoyer des emails sans bloquer l'exécution des différents traitements (mode asynchrone).
Il est également nécessaire d'activer le mode asynchrone à l'ouverture de la session d'emails (à l'aide de la fonction EmailOuvreSessionSMTP ou EmailOuvreSession).
Si le mode asynchrone est activé, tous les emails à envoyer seront transmis à un "Spooler". Les emails sont ainsi mis en file d'attente avant d'être envoyés. L'exécution des fonctions Email n'est alors plus bloquante pour le reste du programme. La fonction EmailEtat permet de connaître l'état d'un email.
Remarque : Si l'administrateur WEBDEV est fermé, le spooler d'emails est vidé : les emails en attente ne sont pas envoyés et sont enlevés du spooler.
Si vous cochez l'option "Désactiver le spooler de mail" alors que des emails sont en attente, ces emails ne seront pas perdus : l'administrateur continue de les envoyer, mais aucun nouveau mail ne sera accepté par le spooler.
Attention : Le mode asynchrone est utilisable uniquement lors de l'ouverture d'une session sur un serveur SMTP (fonction EmailOuvreSessionSMTP pour l'envoi d'emails ou fonction EmailOuvreSession). Ce mode est ignoré dans tous les autres cas.
Sockets
Si l'option "Autoriser les sockets serveur" est cochée, vos sites pourront manipuler les sockets du serveur (à l'aide des fonctions Socketxxx du WLangage).
Interdire le changement d'IP en cours de navigation
Si cette option est cochée, l'adresse IP associée à la session ne peut pas changer en cours de navigation. Il est ainsi possible d'empêcher les attaques du type "vol de session" (attaque consistant à se faire passer pour un utilisateur légitime connecté au serveur).
Interdire l'accès aux identifiants de contexte AWP depuis JavaScript
Dans un site AWP, le contexte du site est stocké sur le serveur. L'identifiant de ce contexte est transmis et mémorisé dans le navigateur par l'intermédiaire d'un cookie.
Si l'option "Interdire l'accès aux identifiants de contexte AWP depuis JavaScript" est cochée, les cookies utilisés seront de type "HTTPOnly", type ne pouvant pas être lu depuis du code Javascript. Ce mode protège contre les attaques de type XSS (Cross-Site scripting).
Par défaut, l'accès aux identifiants de contexte AWP depuis Javascript est interdit.
Gérer les fonctions fCopieFichierRépertoireWeb et fSupprimeFichierRépertoireWeb
L'option "Autoriser les fCopieFichierRépertoireWeb et fSupprimeFichierRépertoireWeb" doit être cochée si ces fonctions sont utilisées dans le site Web.
Ces fonctions permettent notamment de mettre dans le répertoire des images du site des images présentes dans le répertoire des données (cas par exemple d'images uploadées puis mises à disposition pour les internautes utilisant le site).
Attention : La copie est prise en charge par l'administrateur de WEBDEV sur le serveur (WD240ADMIN.EXE). Le compte Windows qui l'exécute doit disposer de droits suffisants sur l'emplacement cible de la copie.

Installations/Comptes

L'onglet "Installations/Comptes" permet de :
  • Configurer le serveur pour les installations et les mises à jour de site.
  • Gérer le journal des installations.
  • Gérer les comptes WEBDEV.
Installation / Mise à jour
Ces options sont accessibles en version déploiement. Elles permettent à l'hébergeur de permettre et de paramétrer les installations et mises à jour de sites à distance.
L'option "Bloquer le serveur (pour une mise à jour)" permet de simplifier la mise à jour d'un site, en interdisant toute connexion d'un nouvel utilisateur. A chaque essai d'une nouvelle connexion à un des sites présent sur le serveur, l'internaute reçoit un message l'informant de l'indisponibilité momentanée du site et lui demandant de réessayer plus tard. Les utilisateurs déjà connectés peuvent continuer d'utiliser le site WEBDEV en cours.

Journaux

L'onglet “Journaux” permet de visualiser le détail des journaux sur une période donnée.
Attention : Pour utiliser cette fonctionnalité, les journaux doivent avoir été activés pour le site. Les journaux peuvent être activés :
  • dans l'onglet “Configuration” pour gérer un journal général,
  • dans l'onglet “Sites” (bouton “Paramètres”) et dans l'onglet “Webservices” (bouton “Paramètres”) pour gérer un journal spécifique.
L'activation du journal des statistiques entraîne automatiquement la création du journal des erreurs.
Chapitre précédentSommaireChapitre suivant
Version minimum requise
  • Version 24
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire