▼
Scroll to page 2
of
112
• • • • • • • • • • • • • • • • • • • • • • • • • • • • FactoryLink 6.5.0 Guide de l’utilisateur de WebClient FactoryLink 6.5.0 / janvier / 1998 W • • • • ©Copyright 1984 - 1998 United States Data Corporation. Tous droits réservés. - NOTE Le présent manuel contient des informations confidentielles de la société United States Data Corporation, domiciliée dans l’Etat du Delaware. Ces informations sont protégées par la réglementation des Etats-Unis et les traités internationaux en matière de droit d’auteur et de secret commercial. Dans ce document, la société United States Data Corporation est parfois appelée « USDATA ». Les informations contenues dans ce document sont susceptibles d’être modifiées sans préavis et ne constituent en aucun cas un engagement de la part de United States Data Corporation (« USDATA »). Bien que les programmes logiciels décrits dans ce document (les « programmes logiciels ») soient conçus pour fonctionner en substance conformément aux indications données, USDATA ne prétend ni ne garantit en aucune façon que (a) les programmes logiciels fonctionneront autrement que sur la base des instructions d’exploitation les plus récentes fournies par USDATA, (b) les fonctions exécutées par les programmes logiciels répondront aux besoins de l’utilisateur ou fonctionneront dans les combinaisons sélectionnées par l’utilisateur ou une tierce personne, (c) le fonctionnement des programmes logiciels sera exempt de toute erreur en toutes circonstances, (d) tout défaut constaté dans un programme logiciel qui ne soit pas directement lié au fonctionnement de celui-ci tel que l’expose ce document sera corrigé, (e) le fonctionnement d’un programme logiciel ne sera pas interrompu pour de courtes périodes en raison d’un défaut de celui-ci ou à la suite d’une erreur commise par USDATA, ou que (f) les programmes logiciels donneront les résultats escomptés par l’utilisateur ou une tierce personne. Les programmes logiciels sont fournis dans le cadre d’une licence ou de tout autre contrat et ne peuvent être utilisés ou copiés que conformément aux termes du contrat applicable. Il est strictement interdit de copier un logiciel sur tout type de support en dehors de ceux expressément autorisés dans le contrat applicable. Aucune partie de ce manuel ne peut être reproduite ou transmise sous quelque forme ou par quelque moyen que ce soit, électronique ou mécanique, y compris par photocopie et enregistrement, quel que soit le but poursuivi, sans l’autorisation expresse et écrite de USDATA. Marques commerciales. USDATA et FactoryLink sont des marques déposées de United States Data Corporation. Open Software Bus est une marque déposée sous licence concédée à United States Data Corporation. Tous les autres noms de produits cités sont des marques ou des marques déposées de leurs détenteurs respectis. 2 / FactoryLink 6.5.0 / Guide de l’utilisateur de Webclient • • • • Table des matières Guide de l’utilisateur de WebClient Avant-propos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Structure du Guide de l’utilisateur de WebClient . . . . . . . . . . . . . . . . . . . . . . . . 7 Comment utiliser ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Pour obtenir de l’aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Aperçu du Guide de l’utilisateur WebClient . . . . . . . . . . . . . . . . . . . . . 11 1 Vue d’ensemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options d’accès et de sécurité . . . . . . . . . . . . . . . . . . . . . . . . . . Connexions à affichage seul . . . . . . . . . . . . . . . . . . . . . . . . . Connexions à contrôle total . . . . . . . . . . . . . . . . . . . . . . . . . . Connexions définies par l’utilisateur . . . . . . . . . . . . . . . . . . Attribution d’un type d’accès à des nœuds spécifiques. . . . . 2 ...... ...... ...... ...... ...... ...... ...... ...... ...... ...... ...... ...... . . . . . . 13 14 14 15 15 15 Installation de WebClient. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Installation de serveurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Installation client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Installation du navigateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 3 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Configuration de WebClient. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilitaire de préparation de l’application WebClient . . . . . . . . . . . . . . . . . . . Panneau liste des éléments du domaine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ajout de WebClient aux panneaux de configuration système . . . . . . . . . . . . . . Renseignement des panneaux de configuration WebClient . . . . . . . . . . . . . . . . 20 20 21 22 24 FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 3 • • • • Panneau Connexions WebClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Panneau Liste d’accès aux nœuds WebClient. . . . . . . . . . . . . . . . . . . . . . . . . . . Panneau Définition de la sécurité d’accès WebClient . . . . . . . . . . . . . . . . . . . . Panneau Liste des tags d’accès en écriture WebClient . . . . . . . . . . . . . . . . . . . Exemples de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Spécification de l’accès des utilisateurs distants à tous les nœuds . . . . . . . . Limitation de l’accés a des nœuds spécifiques . . . . . . . . . . . . . . . . . . . . . . . . Création d’un niveau d’accès personnalisé défini par l’utilisateur . . . . . . . . Configuration de réseau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modification du fichier de services TCP/IP . . . . . . . . . . . . . . . . . . . . . . . . . Informations à l’intention des utilisateurs expérimentés . . . . . . . . . . . . . . . . . Utilisation de WEBFILES.LST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilisation de VisualBasic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Exécution de WebClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Démarrage du serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Démarrage client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contrôles WebClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exécution de GRAPH comme un client spécialisé . . . . . . . . . . . . . . . . . . . . . . . Limites de la tâche Graph en mode autonome. . . . . . . . . . . . . . . . . . . . . . . . GRAPHSET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 39 40 44 47 48 49 Applications FactoryLink et WebClient . . . . . . . . . . . . . . . . . . . . . . . . . 51 Vue d’ensemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tags WebClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Considérations relatives à la conception de l’application FactoryLink . . . . . . Fonctionnalités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 25 28 30 32 33 33 33 34 34 34 37 37 38 51 51 52 52 56 Dépannage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Vue d’ensemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Diagramme de dépannage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Procédures de dépannage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . La tâche du serveur de connexion est-elle en cours d’exécution ? . . . . . . . . . 4 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient 57 57 59 59 Le nom du serveur et/ou l’adresse IP sont -ils corrects ? . . . . . . . . . . . . . . . . 61 Pouvez-vous utiliser la commande Ping avec le nom ou l’adresse IP du client ?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Pouvez-vous utiliser la commande Ping avec le nom ou l’adresse IP du serveur ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Pouvez-vous exécuter WCPING avec succès ? . . . . . . . . . . . . . . . . . . . . . . . . . 63 Augmentation des valeurs de time-out de la connexion WebClient . . . . . . . . . 64 Modification des valeurs de time-out pour les utilisateurs du navigateur . . 64 Modification des valeurs de time-out pour les utilisateurs de la tâche GRAPH (en mode autonome client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Dépannage général . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 WCPING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Messages d’erreur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Erreurs liées à la tâche Graphique distante . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Erreurs réseau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Erreurs liées aux tâches du serveur de connexion et du serveur de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 7 Pages HTML WebClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Création de pages HTML WebClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 8 Propriétés du contrôle ActiveX WebClient . . . . . . . . . . . . . . . . . . . . . . . 79 Vue d’ensemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Méthodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 79 79 85 91 Nombre de tags WebClient minimal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Vue d’ensemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 10 Commutateurs de ligne de commande WebClient . . . . . . . . . . . . . . . . 97 Vue d’ensemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Commutateurs de ligne de commande du serveur de connexion . . . . . . . . . . 98 FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 5 • • • • Rubriques de mise au point du serveur de connexion . . . . . . . . . . . . . . . . . . 99 Commutateurs de ligne de commande du serveur de données . . . . . . . . . . 100 Rubriques de mise au point du serveur de données . . . . . . . . . . . . . . . . . . . 101 Commutateurs de ligne de commande de la tâche Graphique . . . . . . . . . . . . 103 Commutateurs de réseau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Commutateurs de la tâche Graphique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Configurations exemple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 6 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • Avant-propos O BJECTIF Le WebClient de FactoryLink 6.5.0 permet aux utilisateurs de contrôler à distance les applications FactoryLink grâce au navigateur Microsoft Internet Explorer ou toute autre application active de ActiveX. Grâce à la technologie standard Internet, les informations concernant les applications sont diffusées via Internet ou intranet, permettant soit le contrôle complet des connexions bidirectionnelles, soit la sécurisation des connexions à affichage seul. Ce guide fournit les informations techniques néecessaires à l’installation, la configuration et l’administration de WebClient. PUBLIC Ce manuel s’adresse en particulier aux développeurs d’applications, programmeurs et administrateurs chargés de l’accès à WebClient pour les utilisateurs à distance des applications FactoryLink. De manière générale, ce manuel concerne : • L’ajout de WebClient à une application FactoryLink existante. • La création d’une nouvelle application FactoryLink incorporant la fonctionnalité WebClient. S TRUCTURE DU G UIDE DE L ’ UTILISATEUR DE W EB C LIENT Le Guide de l’utilisateur de WebClient fait partie des manuels complémentaires de la documentation FactoryLink. Pour connaître la structure de l’ensemble de la documentation, reportez-vous à l’avant-propos du document Principes de base. Ce manuel comprend dix chapitres : • Vue s’ensemble • Installation de WebClient • Configuration • Exécution de WebClient • Applications FactoryLink et WebClient • Dépannage • Pages HTML WebClient • Propriétés du contrôle ActiveX WebClient • Nombre de tags WebClient minimal • Commutateurs de ligne de commande WebClient FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 7 • • Comment utiliser ce manuel • • C OMMENT UTILISER CE MANUEL Les informations contenues dans ce manuel sont présentées de manière séquentielle par ordre d’exécution. Nous vous conseillons de lire l’ensemble de ce manuel afin de vous familiariser avec toute la procédure avant de développer votre application. … Aperçu Au début de ce manuel se trouve une section intitulée … Aperçu, qui vous indique rapidement où vous trouverez des informations nécessaires à l’exécution des opérations détaillées dans chaque chapitre grâce à des liens hypertextes. C ONVENTIONS Les informations contenues dans la documentation sont conformes aux directives publiées dans The Digital Technical Documentation Handbook de Schultz, Darrow, Kavanagh et Morse, Developing International User Information de Jones, Kennelly, Mueller, Sweezy, Thomas et Velez, ainsi qu’à des directives concernant le style propre à ce type d’entreprise. Ce manuel utilise les conventions suivantes : Convention Description … Les points de suspension horizontaux indiquent l’omission d’un élément dans un exemple. L’information a été omise car elle n’est pas importante pour le sujet traité. . . . Les points de suspension verticaux indiquent l’omission d’une information dans un format de commande ou d’exemple. L’information a été omise car elle n’est pas importante pour le sujet traité. Caractères en italique Les caractères en italique indiquent des variables fournies par l’utilisateur dans les exemples de commandes. Ils indiquent également des références à des documents spécifiques. 2QNKEG ¯ GURCEGOGPV HKZG La police à espacement fixe indique les noms de commandes, les exemples de codes ou une sortie. 8 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PREFACE Conventions Convention Description 2QNKEG ¯ GURCEGOGPV HKZG GP ITCU La police à espacement fixe en gras est utilisée dans les exemples de commandes pour indiquer les mots devant être tapés littéralement. Caractères sans sérif Les caractères sans sérif indiquent des noms de champs, de boutons et les touches du clavier. Caractères en bleu Les caractères en bleu sont utilisés dans les titres ainsi que pour attirer l’attention sur des informations contenues dans le texte. Appuyer sur nnnnn Cette commande indique une touche du clavier. Son nom apparaît en caractères sans sérif. Cliquer sur nnnnn Cette commande indique un bouton sur l’écran. Son nom apparaît en caractères sans sérif. Maj+F1 Le signe + indique que les touches doivent être enfoncées simultanément. Maj+F1 vous indique de maintenir la touche Maj enfoncée tout en appuyant sur une autre touche ou sur le bouton de la souris (indiqué ici par F1). Les autres combinaisons de touches sont présentées de la même manière. F1 F2 F3 L’espace entre les noms de touche indique qu’il faut appuyer sur la touche, puis la relâcher. La série de touches F1 F2 F3 vous indique d’appuyer et de relâcher F1, puis F2, puis F3. Les autres combinaisons de touches sont présentées de la même manière. Fichier>Ouvrir Le signe > indique une progression dans la séquence d’un menu. Fichier>Ouvrir indique que vous devez choisir Ouvrir dans le menu Fichier pour effectuer l’action requise. Les autres séquences de menu sont présentées de la même manière. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 9 • • Pour obtenir de l’aide • • Convention Description FLAPP\user\drw\mydrw.g Le signe \ indique la structure du répertoire du fichier. FLAPP\user\drw\mydrw.g indique que le fichier de dessin mydrw.g se trouve dans le sous-répertoire drw du sous-répertoire user correspondant au répertoire FLAPP. Les autres structures de répertoire sont présentées de la même manière. [] Les crochets indiquent un argument facultatif. Vous pouvez choisir toutes les options, une ou aucune. { } et | Les accolades indiquent un choix. Vous devez choisir l’un des éléments. La barre verticale sert à séparer les choix à l’intérieur des accolades. Exemple de syntaxe Voici l’exemple d’une syntaxe utilisant ces conventions : EQOOCPFG fichier_d’entrée [fichier_d’entrée…] {a|b} fichier_de sortie où EQOOCPFG fichier_d’entrée [fichier_d’entrée …] {a|b} fichier_de sortie P OUR est tapée telle qu’elle apparaît dans la syntaxe. indique une variable fournie par l’utilisateur. indique que l’utilisateur peut fournir optionnellement plusieurs noms de fichiers d’entrée, chaque nom étant séparé par un espace. indique que le a ou le b doit être défini comme un argument. indique que l’utilisateur doit spécifier un fichier de sortie. OBTENIR DE L ’ AIDE Contactez votre assistance technique en cas de problème. En outre, des fichiers d’aide sont inclus dans chaque panneau de configuration. Vous pouvez y accéder en cliquant sur Aide dans la barre de menus du panneau. 10 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Aperçu du Guide de l’utilisateur de WebClient Utilisation de WebClient Pour plus d’informations sur les étapes suivantes... Atteindre... 1. Un aperçu de WebClient Chapitre 1, « Vue d’ensemble » 2. Installation des composants de WebClient Chapitre 2, « Installation de WebClient » 3. Configuration de WebClient Chapitre 3, « Configuration » 4. Exécution de WebClient Chapitre 4, « Exécution de WebClient » 5. Modification des applications FactoryLink existantes pour WebClient Chapitre 5, « Applications FactoryLink et WebClient » 6. Dépannage de votre installation WebClient Chapitre 6, « Dépannage » 7. Création de pages HTML WebClient Chapitre 7, « Pages HTML WebClient » 8. Propriétés, méthodes et événements du contrôle ActiveX WebClient Chapitre 8, « Propriétés du contrôle ActiveX WebClient » 9. Le jeu de tags minimal WebClient Chapitre 9, « Nombre de tags WebClient minimal » FactoryLink ECS /Guide de l’utilisateur de WebClient / 11 • • • • Utilisation de WebClient 10. Commutateurs de ligne de commande et historisation de données WebClient 12 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient Chapitre 10, « Commutateurs de ligne de commande WebClient » • • • • Chapitre 1 Vue d’ensemble 1 Les applications FactoryLink 6.5.0 utilisent la tâche Graphique pour afficher des informations. Lorsque vous accédez à l’application, une seule instance de cette tâche est créée. WebClient s’ajoute à l’architecture FactoryLink, ce qui permet l’exécution de la tâche Graphique sur une station de travail ou un poste client distants. WebClient permet aux utilisateurs distants d’afficher toutes les fenêtres FactoryLink et de contrôler l’application s’ils disposent de toutes les autorisations requises pour le contrôle total. Lorsque le contrôle par l’utilisateur n’est pas nécessaire ou présente des risques, les droits définis pour les utilisateurs distants peuvent être limités à l’affichage seul, l’écriture dans la base de données temps réel leur étant alors interdite. Le programme client est constitué d’un contrôle ActiveX qui permet à la tâche Graphique d’afficher des informations dans le navigateur d’Internet Explorer de Microsoft. Pour démarrer le contrôle ActiveX et vous connecter au serveur, vous devez charger une page HTML standard contenant les codes requis. Une tâche FactoryLink est fournie avec le programme client ; elle permet la connexion à un serveur FactoryLink à partir d’un nœud distant et s’exécute hors du contrôle ActiveX ou d’une application conteneur telle qu’Internet Explorer. Côté serveur, deux tâches gèrent les fonctions associées à WebClient. Les tâches du serveur de connexion contrôlent les connexions WebClient à l’application : elles lancent des instances utilisateur pour les connexions entrantes et mettent fin aux connexions lorsque vous fermez WebClient. Au démarrage, le serveur de connexion démarre des instances de domaine USER pour chaque connexion WebClient configurée. Ces instances du serveur de données sont établies en mode inactif jusqu’à la connexion d’un utilisateur distant au serveur. Lorsqu’un utilisateur distant demande la connexion au serveur, le serveur de connexion active une instance de la tâche du serveur de données qui joue le rôle d’interface avec la base de données temps réel, exécute des fonctions de transfert de fichier et gère les opérations de sécurité de l’application. Selon l’utilisateur connecté, la tâche du serveur de données empêche également l’écriture sans autorisation dans la base de données temps réel. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 13 Vue d’ensemble I NTRODUCTION • VUE D’ENSEMBLE • Options d’accès et de sécurité • • Les tâches du serveur WebClient sont installées avec le système de base FactoryLink. Les composants côté client de WebClient peuvent être installés à partir du CD de distribution ou sur un réseau. Pour plus d’informations sur l’installation de ces composants, reportez-vous à la section « Installation client » du chapitre 2. Une fois installées, les tâches de serveur doivent être configurées. Pour en savoir plus sur la configuration de ces tâches, reportez-vous au chapitre 3, « Configuration ». Vous devez créer et charger une page HTML spéciale afin d’activer la connexion et de commencer à utiliser le contrôle ActiveX de WebClient pour accéder à votre application FactoryLink. Pour plus d’informations sur la création d’une page de démarrage HTML WebClient, reportez-vous au chapitre 7, « Pages HTML WebClient ». O PTIONS D ’ ACCÈS ET DE SÉCURITÉ WebClient fournit plusieurs options de configuration correspondant à divers niveaux de sécurité dans votre application FactoryLink. Ces options s’ajoutent aux mesures de sécurité standard intégrées à l’application, telles que les mots de passe du superviseur. La configuration et la mise en œuvre de ces niveaux de contrôle s’effectuent côté serveur. Connexions à affichage seul Les connexions WebClient à affichage seul fournissent le niveau de sécurité maximal pour les applications FactoryLink. Un utilisateur distant configuré en affichage seul peut écrire uniquement un petit ensemble de tags dans la base de données temps réel FactoryLink tel que configuré spécifiquement sur le serveur. Le développeur de l’application FactoryLink dispose d’une certaine souplesse pour la définition de l’ensemble de tags que les connexions à affichage seul peuvent écrire. L’utilisateur distant peut afficher l’application exactement comme un utilisateur local, c’est-à-dire modifier les fenêtres et naviguer dans différentes vues. Toutefois, le contrôle de l’application via les boutons, les curseurs, la saisie de texte et autres commandes, est limité. 14 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient VUE D’ENSEMBLE Options d’accès et de sécurité Connexions à contrôle total Connexions définies par l’utilisateur Vous pouvez établir des niveaux de contrôle en approfondissant la définition d’une connexion à contrôle total. Le gestionnaire de configuration vous permet de limiter les possibilités des utilisateurs pour l’écriture de tags dans la base de données temps réel. Pour ce faire, vous devez répertorier tous les tags accessibles par WebClient, ou plus largement, définir la capacité ou non de l’utilisateur à écrire les tags d’un domaine entier (USER ou SHARED). Attribution d’un type d’accès à des nœuds spécifiques Vous pouvez spécifier le type d’accès attribué à un nœud à l’aide d’une liste de nœuds établie par défaut ou définie spécifiquement. Des nœuds particuliers peuvent être affectés d’un accès en affichage seul, en contrôle total ou personnalisé par l’utilisateur ou bien être configurés comme inaccessibles. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 15 1 Vue d’ensemble Dans une connexion à contrôle total par défaut, vous pouvez accéder à toutes les fonctionnalités et tous les contrôles de l’application FactoryLink. Les utilisateurs distants à contrôle total peuvent modifier des points de définition, régler les contrôles et réagir aux alarmes comme s’ils étaient connectés sur le réseau local. • VUE D’ENSEMBLE • Options d’accès et de sécurité • • 16 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 2 Installation de WebClient Le présent chapitre décrit les procédures d’installation des composants de FactoryLink 6.5.0 WebClient. WebClient est installé comme une partie intégrante de FactoryLink version 6.0.4 ou toute version ultérieure. I NSTALLATION DE SERVEURS Les composants de WebClient font partie de l’installation élémentaire de FactoryLink. Les tâches des serveurs de connexion et de données sont automatiquement installées avec les fichiers élémentaires FactoryLink, si vous les avez acquis. Pour plus d’informations sur l’installation de FactoryLink, reportez-vous au Guide d’installation de Windows NT et Windows 95. CLIENT Exécutez les procédures suivantes pour installer le programme client WebClient sur une station de travail : 1 Copiez le fichier de programme WEBCLIENT.EXE sur votre disque dur local. 2 Exécutez WEBCLIENT.EXE. Pour ce faire, localisez ce fichier dans l’Explorateur Windows et cliquez deux fois sur son nom, ou cliquez sur Démarrer>Exécuter dans la barre des tâches et saisissez YGDENKGPVGZG en ligne de commande dans la boîte de dialogue Exécuter. 3 Suivez les instructions affichées par le programme d’installation. 4 Une fois l’installation achevée, vous pouvez supprimer WEBCLIENT.EXE de votre disque dur. Une fois l’installation du programme WebClient achevée, exécutez Internet Explorer de Microsoft et connectez-vous au serveur afin d’accéder à l’application FactoryLink en chargeant des pages HTML contenant les codes appropriés pour le démarrage du contrôle ActiveX et l’établissement de la connexion. Pour charger la page HTML WebClient par défaut, cliquez sur l’icône Start WebClient dans le groupe de programmes WebClient. Pour plus d’informations sur la création de ces pages HTML, reportez-vous au chapitre 7, « Pages HTML WebClient ». FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 17 Installation de WebClient I NSTALLATION 2 • INSTALLATION DE WEBCLIENT • Installation du navigateur • • I NSTALLATION DU NAVIGATEUR WebClient utilise la version standard d’Internet Explorer de Microsoft ; aucune modification ou personnalisation n’est nécessaire pour le fonctionnement avec WebClient. Si Internet Explorer n’est pas déjà installé sur votre poste, installez-le à l’aide du CD-ROM distribué. Ce dernier inclut les versions correspondant à Windows NT et Windows 95. Exécutez les étapes suivantes pour installer le navigateur : 1 Dans la barre des tâches, cliquez sur Démarrer>Exécuter et entrez le chemin d’accès et le nom de fichier suivants dans la zone Ouvrir : Sous Windows NT - =&?>9'$%.06>/5+'/06':' Sous Windows 95 - =&?>9'$%.06>/5+'/':' où [D] désigne la lettre d’unité de votre lecteur de CD-ROM. 2 Suivez les instructions affichées pour installer Internet Explorer. 18 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 3 Configuration Le présent chapitre fournit des instructions sur la configuration des tâches WebClient dans FactoryLink. Les deux sujets suivants sont les points principaux de ce chapitre : • configuration et définition des types d’accès à distance et des niveaux de sécurité correspondants mis en œuvre à l’aide du gestionnaire de configuration FactoryLink. • configuration du réseau. 3 Configuration FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 19 • CONFIGURATION • Configuration de WebClient • • C ONFIGURATION DE WEB C LIENT Utilitaire de préparation de l’application WebClient Utilisez l’utilitaire de préparation de l’application WebClient EXAYECRRGZG pour vous aider à préparer votre application FactoryLink en vue de son exécution avec WebClient. Cet utilitaire simplifie le processus de configuration de votre application en exécutant les fonctions suivantes : • Vérifie/ajoute la tâche du serveur de connexion au domaine SHARED de la table système. • Vérifie/ajoute la tâche du serveur de données au domaine USER de la table système. • Vérifie/ajoute la tâche Graph au domaine USER de la table système. • Définit l’indicateur de tâche pour la tâche RUNMGR dans le domaine USER par la valeur FR. • Configure le panneau Connexions WebClient pour une connexion WebClient. • Configure la sécurité d’accès à affichage seul avec le nombre minimum de tags graphiques requis. • Configure la sécurité d’accès à contrôle total avec attribution de privilèges d’écriture aux domaines USER et SHARED. • Ajoute des entrées au fichier de services TCP/IP pour la prise en charge d’une connexion WebClient. L’utilisation de l’utilitaire n’est pas requise mais recommandée. L’utilitaire considère que la commande FLCONV a mis à jour la base de données globale. Remarque : pour que vous puissiez utiliser l’utilitaire de conversion deWebClient, toute application FactoryLink existante doit être convertie en application FactoryLink version 6.0.3 ou suivante. Pour plus d’informations sur l’utilisation de FLCONV pour la mise à jour de votre application, reportez-vous au manuel Principes de base de FactoryLink. Exécutez les étapes suivantes pour démarrer l’utilitaire : 1 Cliquez sur Démarrer>Exécuter dans la barre des tâches Windows. 2 Entrez ](.+0-_>DKP>EXAYECRR ](.#22_ en ligne de commande, où {FLINK} {FLAPP} correspond au chemin d’accès à l’installation de FactoryLink correspond au chemin d’accès à votre application. 20 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Panneau liste des éléments du domaine L’utilitaire exécute la configuration initiale en renseignant les panneaux du gestionnaire de configuration avec les valeurs par défaut pour une connexion WebClient distante. Aucune autre configuration n’est requise pour une installation élémentaire (un utilisateur distant, une sécurité d’accès par défaut). Pour configurer FactoryLink pour des connexions distantes supplémentaires, la liste des éléments du domaine doit être modifiée, les panneaux Connexions WebClient doivent être renseignés et des entrées supplémentaires doivent être ajoutées au fichier de services TCP/IP. P ANNEAU LISTE DES ÉLÉMENTS DU DOMAINE Vous devez modifier la liste des éléments du domaine pour qu’elle corresponde au nombre de connexions WebClient que vous avez acquises. Exécutez les étapes suivantes pour configurer le panneau Liste des éléments du domaine : 1 Démarrez le gestionnaire de configuration et sélectionnez Vue>Liste domaines pour afficher le panneau Liste des éléments du domaine. 3 au nombre de connexions WebClient que vous établissez. Il correspond aux utilisateurs distants et à une instance permettant d’exécuter la tâche Graphique sur le serveur. Par exemple, si vous déterminez la configuration pour cinq connexions WebClient simultanées, entrez la valeur dans cette zone. 3 Cliquez sur Entrée pour enregistrer ces informations. 4 Cliquez sur Quitter pour revenir au menu principal. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 21 Configuration 2 Changez le nombre d’instances utilisateur de telle sorte qu’il soit supérieur de 1 • CONFIGURATION • Ajout de WebClient aux panneaux de configuration système • • A JOUT DE W EB C LIENT AUX PANNEAUX DE CONFIGURATION SYSTÈME Comme pour toute autre tâche FactoryLink, les tâches des serveurs de données et de connexion WebClient doivent être saisies dans les panneaux d’informations de configuration système, dans le gestionnaire de configuration. Pour ce faire, la méthode la plus simple consiste à utiliser l’utilitaire CV_WCAPP.EXE (voir « Utilitaire de préparation de l’application WebClient » page 20). Ce dernier saisit toutes les informations nécessaires dans les panneaux d’informations de configuration système et définit le minimum d’informations requises dans les panneaux de configuration WebClient. Si vous souhaitez renseigner ces panneaux manuellement, reportez-vous au manuel Principes de base de FactoryLink pour obtenir la description complète de la procédure. La liste ci-dessous indique les valeurs par défaut requises pour la configuration du serveur de connexion et du serveur de données pour la table. Remarque : ces valeurs sont celles entrées par CV_WCAPP.EXE. Dans les exemples ci-dessous, [n] représente le compteur d’une tâche particulière, où les tâches sont numérotées et commencent par zéro. Informations de configuration système du serveur de connexion Domaine Indicateur SHARED FR Nom tâche CONNSRV Description WebClient(R) Connection Server Déclencheur de démarrage TASKSTART_S[n] Etat de la tâche TASKSTATUS_S[n] Message tâche TASKMESSAGE_S[n] Etat affichage TASKDSTATUS_S[n] Nom affichage Description affichage Ordre de lancement Priorité Fichier exécutable TASKNAME_S[n] TASKDESC_S[n] 1 201 bin\connsrv 22 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Ajout de WebClient aux panneaux de configuration système Informations de configuration système du serveur de données Domaine Indicateur USER FH Nom tâche DATASRV Description Data Server Déclencheur de démarrage TASKSTART_U[n] Etat de la tâche TASKSTART_U[n] Message tâche TASKMESSAGE_U[n] Etat affichage Nom affichage Description affichage Ordre de lancement Priorité Fichier exécutable TASKDSTATUS_U[n] TASKNAME_U[n] TASKDESC_U[n] 1 201 bin\datasrv 3 Configuration FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 23 • CONFIGURATION • Renseignement des panneaux de configuration WebClient • • R ENSEIGNEMENT DES PANNEAUX DE CONFIGURATION W EB C LIENT Vous devez configurer WebClient à l’aide des quatre panneaux de saisie fournis par le gestionnaire de configuration. Ces panneaux permettent de définir le nombre et le type des connexions distantes, de définir l’accès à des nœuds spécifiques et de déterminer les tags spécifiques pouvant être écrits par les types d’accès définis par l’utilisateur. Choisissez Services WebClient dans le menu principal du gestionnaire de configuration pour afficher ces quatre panneauxWebClient. 24 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Panneau Connexions WebClient P ANNEAU C ONNEXIONS W EB C LIENT Le panneau Connexions WebClient contient les informations de configuration élémentaires requises pour autoriser les connexions client distantes à l’application FactoryLink. Les informations saisies dans ce panneau s’appliquent aux domaines USER et SHARED. Exécutez les étapes suivantes pour configurer le panneau Connexions WebClient : 1 Cliquez deux fois sur Services WebClient dans le menu principal du gestionnaire de configuration pour afficher ce panneau. 2 Spécifiez les informations suivantes. Nombre maximal de connexions Permet d’indiquer le nombre maximal d’utilisateurs WebClient distants pouvant accéder simultanément à l’application. Ce champ numérique obligatoire doit indiquer une valeur comprise entre 1 et 50. Dans le cas d’une configuration élémentaire, entrez le nombre de connexions client distantes souhaité et cliquez sur Entrée. Nom de service du serveur de connexions Permet d’indiquer le nom de service du serveur de connexions tel que défini dans le fichier de services. Ce champ de type caractère obligatoire peut contenir 16 caractères. FLCONNSRVC est saisi par défaut. Sauf nécessité, il est conseillé de conserver cette valeur par défaut. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 25 3 Configuration Il permet de définir le nombre d’instances utilisateur à appeler. Ce nombre est généralement inférieur de 1 au nombre d’instances utilisateur entrées dans la liste des éléments du domaine (voir l’étape 2 de la section « Renseignement des panneaux de configuration WebClient »). L’instance utilisateur supplémentaire est destinée à une tâche Graphe locale. • CONFIGURATION • Panneau Connexions WebClient • • Vous devez effectuer une entrée dans le fichier de services TCP/IP pour ce nom. Reportez-vous à la section « Modification du fichier de services TCP/IP », page 34, pour plus d’informations sur la modification du fichier de services. Préfixe du nom et service {FLUSER} WebClient Sécurité d’accès par défaut Permet d’indiquer le préfixe du nom d’utilisateur pour les instances de domaine USER lancées. Par exemple, en utilisant l’entrée par défaut FLDATASRVC, le premier lancement crée le nom de service/utilisateur FLDATASRVC001. Ce champ obligatoire est limité à 12 caractères. Sauf nécessité, il est conseillé de conserver la valeur par défaut. Permet d’indiquer le type d’accès par défaut pour les connexions WebClient lorsque les nœuds ne sont pas répertoriés dans le panneau de sécurité de nœud WebClient (voir ci-dessous). Quatre valeurs sont admises dans ce champ obligatoire : NO_ACCESS (Aucun accès) Aucun accès à l’application (connexion refusée). VIEW_ONLY (Affichage seul) Lecture de tous les tags ; écriture de 76 tags au maximum. Ces tags sont spécialement répertoriés dans la définition d’accès correspondante. FULL_CONTROL (Contrôle total) Lecture de tous les tags ; écriture des tags conformément à la définition d’accès FULL_CONTROL. Par défaut, l’accès en écriture est autorisé pour tous les tags partagés et utilisateur. <défini par l’utilisateur> Chaîne saisie par l’utilisateur faisant référence à un type de sécurité d’accès personnalisé. Plusieurs types d’accès personnalisés définis par l’utilisateur peuvent exister. Ils sont définis dans le panneau Définition de la sécurité d’accès WebClient (voir page 30). Le niveau d’accès défini par défaut est FULL_CONTROL. 26 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Panneau Connexions WebClient Description du service WebClient Brève description de l’application/serveur FactoryLink concerné(e). Cette description est disponible pour le contrôle ActiveX WebClient en tant que propriété LocationName et peut être visualisée par l’utilisateur distant. Ce champ est limité à 32 caractères ; la description par défaut est Service WebClient FactoryLink. 3 Cliquez sur Entrée pour enregistrer les informations. 4 Cliquez sur Quitter pour revenir au menu principal ou cliquez sur Suiv. pour configurer la Liste d’accès aux nœuds WebClient facultative (voir page 28). 3 Configuration FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 27 • CONFIGURATION • Panneau Liste d’accès aux nœuds WebClient • • P ANNEAU L ISTE D ’ ACCÈS AUX NŒUDS W EB C LIENT Le panneau Liste d’accès aux nœuds WebClient détermine la sécurité de l’application FactoryLink en fonction du nom d’hôte du nœud distant. Les nœuds non répertoriés sont connectés tel que défini dans le champ Sécurité d’accès par défaut du panneau Connexions WebClient. Le contenu de ce panneau s’applique à tous les domaines. Ce panneau doit être configuré après le panneau Connexions WebClient (voir page 25). Exécutez les étapes suivantes pour configurer le panneau Liste d’accès aux nœuds WebClient : 1 Dans le panneau Connexions WebClient, cliquez sur Suiv. pour afficher la Liste d’accès aux nœuds WebClient. 2 Spécifiez les informations suivantes pour l’ensemble des nœuds distants que vous configurez : Nom du nœud de la connexion à distance Champ obligatoire de type caractères indiquant un nom de nœud distant ou une adresse IP pour lesquels un paramètre de sécurité explicite est défini. Sécurité d’accès Champ associant un type spécifique d’accès pour le nœud distant. NO_ACCESS (Aucun accès) Aucun accès à l’application (connexion refusée). VIEW_ONLY (Affichage seul) Lecture de tous les tags ; écriture de 76 tags au maximum. Ces tags sont spécialement répertoriés dans la définition d’accès correspondante. 28 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Panneau Liste d’accès aux nœuds WebClient FULL_CONTROL (Contrôle total) Lecture de tous les tags ; écriture des tags conformément à la définition d’accès FULL_CONTROL. Par défaut, l’accès en écriture est autorisé pour tous les tags partagés et utilisateur. <défini par l’utilisateur> Chaîne saisie par l’utilisateur faisant référence à un type de sécurité d’accès personnalisé. Plusieurs types d’accès personnalisés définis par l’utilisateur peuvent exister. Ils sont définis dans le panneau Définition de la sécurité d’accès WebClient (voir page 30). Le niveau d’accès par défaut est FULL_CONTROL. 3 Cliquez sur Entrée pour enregistrer ces informations. 4 Cliquez sur Quitter pour revenir au menu principal ou cliquez sur Suiv. pour configurer le panneau facultatif Définition de la sécurité d’accès WebClient. 3 Configuration FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 29 • CONFIGURATION • Panneau Définition de la sécurité d’accès WebClient • • P ANNEAU D ÉFINITION DE LA SÉCURITÉ D ’ ACCÈS W EB C LIENT La définition de sécurité d’accès WebClient explicite les connexions à affichage seul, à contrôle total et à sécurité d’accès personnalisée. Par défaut, la table contient deux lignes : • Une ligne définissant l’accès à affichage seul (VIEW_ONLY) • Une ligne définissant l’accès à contrôle total (FULL_CONTROL). Remarque : ce panneau doit être configuré dans le domaine USER. Dans le cas de l’accès à affichage seul, les seules entrées valides pour les privilèges en écriture dans les domaines USER et SHARED sont NO (NON). Les valeurs par défaut pour l’accès à contrôle total sont YES (OUI) et YES (OUI). Vous pouvez définir vos propres types d’accès, en attribuant à chacun des privilèges uniques d’écriture dans un domaine et des listes de tags. Les types d’accès utilisateur sont considérées comme des connexions à contrôle total dans la licence du logiciel. Ce panneau doit être configuré après le panneau Liste d’accès aux nœuds WebClient (voir page 28). Exécutez les étapes suivantes pour configurer le panneau Définition de la sécurité d’accès WebClient : 1 Assurez-vous que le domaine courant sélectionné dans la liste Sélection du domaine du gestionnaire de configuration est USER. 2 Dans le panneau Liste d’accès aux nœuds WebClient, cliquez sur Suiv. pour afficher le panneau Définition de la sécurité d’accès WebClient : 30 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Panneau Définition de la sécurité d’accès WebClient 3 Spécifiez les informations suivantes : Sécurité d’accès Permet de sélectionner le type de sécurité d’accès en cours de définition. Les entrées pour ce champ sont limitées aux suivantes : VIEW_ONLY Lecture de tous les tags ; écritures des tags tel que répertoriés dans le panneau Liste des tags d’accès en écriture WebClient. FULL_CONTROL Lecture de tous les tags ; écriture des tags par définition de leur type d’accès. <défini par l’utilisateur> Chaîne entrée par l’utilisateur pour les types de sécurité d’accès personnalisé. Limité à 16 caractères. Autoriser les écritures de tag du domaine USER Requiert une entrée de type booléen (YES (OUI) ou NO (NON)) pour définir si le type d’accès correspondant autorise l’écriture de tags du domaine USER. Autoriser les écritures de tag du domaine SHARED Requiert une entrée de type booléen (YES (OUI) ou NO (NON)) pour définir si le type d’accès correspondant autorise l’écriture de tags du domaine SHARED. 4 Cliquez sur Entrée pour enregistrer ces informations. 5 Cliquez sur Quitter pour revenir au menu principal ou cliquez sur Suiv. pour configurer le panneau facultatif Liste des tags d’accès en écriture WebClient. 3 Configuration FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 31 • CONFIGURATION • Panneau Liste des tags d’accès en écriture WebClient • • P ANNEAU L ISTE DES TAGS D ’ ACCÈS EN ÉCRITURE WEB C LIENT Le panneau Liste des tags d’accès en écriture WebClient répertorie explicitement les tags sur lesquels une connexion distante peut écrire. Ce panneau est directement lié au type de sécurité d’accès courant sélectionné dans le panneau Définition de la sécurité d’accès WebClient. Ce panneau doit être configuré dans le domaine USER. Pour une configuration totalement fonctionnelle, ce panneau doit contenir, au minimum, les tags requis pour l’exploitation d’une tâche Graphique élémentaire (voir « Nombre de tags WebClient minimal » page 95). Outre cet ensemble minimal de 12 tags, vous pouvez ajouter des tags, jusqu’à un maximum de 76, que les utilisateurs distants peuvent écrire. Remarque : lorsque les champs Autoriser les écritures de tag du domaine USER ou Autoriser les écritures de tag du domaine SHARED sont définis par la valeur YES (OUI) dans le panneau précédent, il n’est pas nécessaire de répertorier des tags pour le domaine correspondant dans le présent panneau. Ce panneau doit être configuré après le panneau Définition de la sécurité d’accès WebClient (voir page 30). 1 Assurez-vous que le domaine courant sélectionné dans la liste Sélection du domaine du gestionnaire de configuration est USER. 2 Dans le panneau Liste d’accès aux nœuds WebClient, cliquez sur Suiv. pour afficher le panneau Définition de la sécurité d’accès WebClient : 32 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Exemples de configuration 3 Spécifiez les informations suivantes : TAG accessible en écriture Description du Tag E XEMPLES Champ obligatoire indiquant le nom du tag qu’une connexion distante peut écrire. Contient la description du tag entré dans le champ TAG accessible en écriture, identique à celle fournie dans la base de données objet. Ce champ est automatiquement renseigné. DE CONFIGURATION Les paragraphes ci-dessous présentent des configurations de sécurité et d’accès caractéristiques et décrivent les entrées requises pour les définir. Spécification de l’accès des utilisateurs distants à tous les nœuds Pour activer l’accès distant à partir de tout nœud du réseau tout en le limitant à l’affichage seul, il suffit de renseigner le premier panneau uniquement, Connexions WebClient. Pour configurer TOUS les utilisateurs distants avec l’accès en affichage seul, la valeur VIEW_ONLY c doit s’afficher dans la colonne Sécurité d’accès par défaut. De même, pour autoriser l’accès en contrôle total pour tous les utilisateurs distants, le champ Sécurité d’accès par défaut doit indiquer FULL_CONTROL (Contrôle total). Les colonnes restantes de ce panneau doivent être configurées, mais aucune autre information n’est requise dans les panneaux facultatifs. Limitation de l’accés à des nœuds spécifiques Pour limiter l’accès distant à votre application FactoryLink à des nœuds spécifiques du réseau, il suffit de fournir des informations complémentaires dans deux des panneaux WebClient du gestionnaire de configuration. Dans la Liste d’accès aux nœuds WebClient, entrez les adresses IP ou les noms d’hôte de tous les nœuds auxquels vous souhaitez autoriser l’accès. Dans la deuxième colonne, entrez le type d’accès (VIEW_ONLY (Affichage seul), FULL_CONTROL (Contrôle total) ou accès personnalisé défini par l’utilisateur) autorisé pour le nœud correspondant. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 33 Configuration Dans le panneau Connexions WebClient, le champ Sécurité d’accès par défaut doit indiquer la valeur NO_ACCESS (Aucun accès) ; elle signifie que l’accès à tout nœud du réseau est refusé, à l’exception des nœuds répertoriés dans le deuxième panneau, Liste d’accès aux nœuds WebClient. 3 • CONFIGURATION • Configuration de réseau • • Création d’un niveau d’accès personnalisé défini par l’utilisateur Il se peut que vous vouliez définir un accès limité pour certains ou tous les utilisateurs distants. Par exemple, vous souhaitez autoriser l’accès à certains contrôles et en désactiver d’autres. Dans ce cas, vous devez créer un niveau d’accès personnalisé défini par l’utilisateur. Pour le convertir en niveau d’accès par défaut, entrez son nom (16 caractères au maximum) dans la colonne Sécurité d’accès par défaut du panneau Connexions WebClient. Pour l’associer à un nœud spécifique sur le réseau, entrez son nom dans la colonne Sécurité d’accès de la Liste d’accès aux nœuds WebClient. Pour chaque niveau d’accès personnalisé, vous devez déterminer spécifiquement les tags de la base de données temps réel FactoryLink pouvant être manipulés, lesquels déterminent à leur tour la fonctionnalité dont disposent les utilisateurs pour ce niveau d’accès. Ces tags doivent être ensuite répertoriés dans le panneau Liste des tags d’accès en écriture WebClient. Si le champ Autoriser les écritures de tag du domaine USER a la valeur NO (NON), tous les tags requis pour l’exploitation de la tâche Graphique élémentaire doivent être entrés. Ensuite, tout tag supplémentaire à manipuler pour activer le niveau d’accès souhaité doit être ajouté. Tous les types d’accès définis par l’utilisateur sont considérés à contrôle total pour les termes de la licence. C ONFIGURATION DE RÉSEAU Pour permettre le fonctionnement de WebClient sur votre réseau, le fichier de services TCP/IP stocké sur le serveur où s’exécute l’application FactoryLink doit être modifié et les ports appropriés doivent être ouverts. Modification du fichier de services TCP/IP L’emplacement du fichier de services TCP/IP varie en fonction du système d’exploitation. Sous Windows NT, il est situé dans le sous-dossier \system32\drivers\etc\ sous le dossier principal Windows (c:\windows, c:\win ou proche). Sous Windows 95, il se trouve dans le dossier principal Windows, c:\windows, c:\win, c:\win95 ou proche. Le fichier de services est un fichier ASCII éditable sous n’importe quel éditeur de texte. Attention : soyez prudent lors de la modification du fichier de services. Toute erreur dans le fichier peut entraîner une panne de WebClient ou de toute autre ressource liée au réseau. 34 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Configuration de réseau Dans le fichier de services TCP/IP, ajoutez le(s) nom(s) attribué(s) à chaque service WebClient s’exécutant sur le nœud. La tâche du serveur de connexion FactoryLink doit contenir une entrée et chaque instance de la tâche du serveur de données doit être associée à des entrées. Par exemple, si vous disposez d’une licence pour cinq connexions WebClient simultanées, le fichier de services doit contenir une entrée pour le serveur de connexion et cinq entrées pour le serveur de données. Reportez-vous à la documentation appropriée pour obtenir plus d’informations sur la configuration des services. Il est possible d’exécuter plusieurs applications serveur WebClient sur un poste disposant des ressources système suffisantes. Chaque application FactoryLink doit disposer d’un ensemble d’entrées de services séparé, associées à des noms et à des numéros de port uniques. Chaque instance de WebClient doit utiliser un nom de service unique lorsque plusieurs applications exécutant WebClient existent sur un nœud. Le format des entrées du fichier de services est indiqué ci-dessous. Notez que tout commentaire dans ce fichier doit être précédé du caractère . SERVICE num_port alias où Spécification en majuscules du nom attribué au service s’exécutant sur le nœud. Ce nom peut contenir de 1 à 16 caractères et doit être unique pour chaque service défini pour un seul nœud. Dans le cas du serveur de connexion, le nom par défaut est FLCONNSRVC. Ceux du serveur de données sont FLDATASRVC001, FLDATASRVC002, et ainsi de suite pour chaque connexion WebClient distante acquise sous licence. num_port Numéro unique attribué pour référencer le numéro de port pour le protocole TCP/IP. Ce numéro doit être unique pour chaque service défini pour un seul nœud. Il est recommandé d’utiliser le numéro 6096 pour le serveur de connexion ; pour le serveur de données, utilisez des ports à numéros consécutifs en commençant par 6097. Cependant, vous pouvez utiliser tout autre numéro tant qu’il ne crée pas de conflit avec d’autres services. alias Spécification en minuscules du nom attribué au service s’exécutant sur le nœud. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 35 3 Configuration SERVICE • CONFIGURATION • Informations à l’intention des utilisateurs expérimentés • • Par exemple, l’extrait suivant d’un fichier de services identifie les services sur une installation dont la licence accorde cinq connexions WebClient simultanées utilisant les valeurs par défaut suivantes : (.%100548% VER HNEQPPUTXE (.&#6#548% VER HNFCVCUTXE (.&#6#548% VER HNFCVCUTXE (.&#6#548% VER HNFCVCUTXE (.&#6#548% VER HNFCVCUTXE (.&#6#548% VER HNFCVCUTXE I NFORMATIONS À L ’ INTENTION DES UTILISATEURS EXPÉRIMENTÉS Les informations suivantes sont fournies pour les utilisateurs avancés et ne s’appliquent pas forcément pour une installation élémentaire. Utilisation de WEBFILES.LST Dans certaines applications FactoryLink, il peut être souhaitable ou nécessaire de transférer des fichiers supplémentaires (tels que des fichiers d’aide) au client lors de l’initialisation. Pour ce faire, créez un fichier texte nommé WEBFILES.LST et placez-le dans le dossier {FLAPP}. Remarque : pour créer rapidement le fichier WEBFILES.LST, copiez le fichier du même nom situé dans le dossier WebClient\bin d’une installation client et modifiez-le afin d’ajouter les fichiers que souhaitez transférer. Répertoriez les fichiers à transférer, avec leur chemin relatif au dossier {FLAPP}. Listez un fichier par ligne. Les caractères génériques sont autorisés et vous pouvez ajouter tout commentaire dans le fichier si la ligne correspondante est précédée du caractère #. L’exemple ci-dessous illustre la structure du fichier WEBFILES.LST : (CEVQT[.KPM 9GD%NKGPV 4 5CORNG 9'$(+.'5.56 #RRNKECVKQP (KNGU HQT &QYPNQCF WUGT>EV>IAPFKUREV WUGT>EV>INQDCNEV UJCTGF>EV>INQDCNEV EV>FQOCKPEV 36 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient CONFIGURATION Informations à l’intention des utilisateurs expérimentés EV>QDLGEVEV WUGT>EV>IEQPHKIEV EV>IENCUUGUEV EV>WENCUUGUEV OUI>ITCRJVZV WUGT>FTY> IE F WUGT>FTY> I F WUGT>FTY> RNE F WUGT>FTY> DOR F Remarque : le commutateur -d indiqué dans le fichier est transféré sur demande. Cela ne s’applique qu’aux graphiques et non aux fichiers utilisateur personnalisés. WEBCLIENT.OCX Le contrôle OCX WebClient peut être utilisé dans des applications autres qu’Internet Explorer. Cependant, vous devez noter que ce contrôle nécessite des fichiers supplémentaires. Utilisez le programme d’installation de WebClient (WEBCLIENT.EXE) pour installer ce contrôle pour une utilisation avec d’autres applications. Utilisation de VisualBasic Un fichier nommé WCCONST.BAS dans le dossier WebClient\Sample HTML définit des constantes pour plusieurs propriétés, événements et méthodes. Vous pouvez ajouter ce fichier à un projet VisualBasic de façon que ces constantes soient utilisées à la place de valeurs numériques. Vous pouvez également copier le contenu de ce fichier dans un module existant. 3 Configuration FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 37 • CONFIGURATION • Informations à l’intention des utilisateurs expérimentés • • 38 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 4 Exécution de WebClient 4 D ÉMARRAGE DU SERVEUR Si elles sont correctement configurées, les tâches du serveur associées à WebClient démarrent automatiquement lorsque l’application FactoryLink commence à s’exécuter. La liste ci-dessous récapitule rapidement les étapes nécessaires de préparation de l’installation du serveur FactoryLink en vue de son utilisation avec WebClient. 1 Installation. Considérant que vous avez acheté l’option WebClient et correctement défini votre séquence de configuration à l’installation, les tâches du serveur de connexion et du serveur de données sont automatiquement ajoutées comme une partie intégrante de votre installation FactoryLink élémentaire. 2 Conversion de votre application FactoryLink. Si vous mettez à jour votre version de FactoryLink et que vous ajoutez WebClient à une version existante de FactoryLink, vous devez utiliser l’utilitaire FLCONV pour convertir l’application en la version 6.0.4. Pour plus d’informations sur FLCONV, reportez-vous au manuel Principes de base de FactoryLink. 3 Analyse de votre application. Le mode de fonctionnement des applications sur des postes clients distants peut varier. Il est possible que vous souhaitiez modifier votre application pour exploiter au mieux les fonctionnalités apportées par WebClient. Pour plus d’informations, reportez-vous au chapitre 3, « Applications FactoryLink et WebClient ». FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 39 Exécution de WebClient Vous trouverez dans le présent chapitre des informations sur le fonctionnement d’une installation WebClient. Avant d’exécuter WebClient, vous devez terminer l’installation (chapitre 2) et la configuration (chapitre 3) du serveur et des clients. De plus, il peut s’avérer nécessaire d’apporter certaines modifications à votre application FactoryLink pour qu’elle fonctionne correctement. Pour en savoir plus, reportez-vous au chapitre 3, « Applications FactoryLink et WebClient ». • EXÉCUTION DE WEBCLIENT • Démarrage client • • 4 Ajout des tâches WebClient à la configuration système. La tâche du serveur de connexion doit être ajoutée à la configuration système dans le domaine SHARED et la tâche du serveur de données dans le domaine USER. Si vous avez déjà exécuté CV_WCAPP.EXE, ces opérations ont été effectuées. Reportez-vous à la section « Ajout de WebClient aux panneaux de configuration système » page 22. 5 Modification de la liste des éléments du domaine. Vous devez modifier le nombre d’instances utilisateur en fonction du nombre de licences WebClient dont vous disposez. Reportez-vous à la section « Panneau liste des éléments du domaine » page 21. 6 Configuration des panneaux Connexions WebClient. Ces panneaux vous permettent d’entrer des informations relatives aux types d’accès par défaut, à l’accès spécifique de certains nœuds et à l’écriture de tags spécifiques. La méthode la plus appropriée au démarrage consiste à utiliser l’utilitaire CV_WCAPP.EXE. Reportez-vous à la section « Renseignement des panneaux de configuration WebClient » page 24. 7 Modification du fichier de services TCP/IP Vous devez ajouter des entrées liées à WebClient dans le fichier TCP/IP. Reportez-vous à la section « Modification du fichier de services TCP/IP » page 34. 8 Vérification de l’accès réseau des clients. Vérifiez que vos utilisateurs distants disposent de l’accès nécessaire au serveur sur le réseau. Le cas échéant, adressez-vous à votre administrateur de réseau pour vérifier que le firewall est correctement configuré et autorise la connexion des clients. Une fois ces étapes exécutées, votre serveur FactoryLink est prêt à recevoir les utilisateurs distants, lors de l’exécution de l’application. D ÉMARRAGE CLIENT Une fois WebClient installé et configuré sur le poste client, vous devez utiliser Internet Explorer pour charger la page de démarrage de votre application FactoryLink. La liste ci-dessous récapitule rapidement les étapes de préparation de l’installation en vue de l’utilisation avec WebClient. 1 Installation. Si l’on considère que vous exécutez WebClient sous Internet Explorer, vous devez utiliser WEBCLIENT.EXE pour installer la tâche Graph distante sur le poste client. Reportez-vous au chapitre 2, « Installation de WebClient ». 40 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient EXÉCUTION DE WEBCLIENT Démarrage client 2 Installation d’Internet Explorer. Si Internet Explorer n’est pas déjà installé, vous pouvez l’installer à partir du CD de distribution (voir « Installation du navigateur » page 18). En revanche, si vous disposez d’une version d’Internet Explorer (version 3.02 ou suivantes) sur votre machine, utilisez-la. Il est possible que votre administrateur FactoryLink ait déjà créé une page de démarrage HTML personnalisée contenant le code requis pour la connexion à votre serveur. Dans le cas contraire, vous pouvez vous inspirer des exemples fournis avec l’installation WebClient pour créer votre propre page. Vous devez connaître le nom d’hôte ou l’adresse IP et le numéro de port de votre serveur. Pour plus d’informations, reportez-vous au chapitre 7, « Pages HTML WebClient ». Une fois ces étapes exécutées et le serveur FactoryLink configuré et démarré, établissez la connexion en chargeant la page de démarrage HTML. Cette page peut être stockée sur votre disque dur local, sur un disque partagé sur le réseau, sur un serveur d’entreprise Intranet ou sur un serveur Internet. Exécutez la procédure suivante pour charger la page de démarrage pour votre installation WebClient : 1 Démarrez Internet Explorer. 2 Chargez la page de démarrage à l’aide de l’une des méthodes suivantes : • Cliquez sur Fichier>Ouvrir et entrez le chemin d’accès et le nom de fichier de votre page de démarrage HTML. • Entrez l’URL de votre page de démarrage HTML dans la zone Adresse. • Cliquez sur un lien à votre page HTML à partir d’une autre page. Votre administrateur système peut avoir établi un emplacement central pour la gestion de l’accès à distance. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 41 Exécution de WebClient 3 Obtention ou création d’une page de démarrage HTML. 4 • EXÉCUTION DE WEBCLIENT • Démarrage client • • Internet Explorer charge la page, en activant le contrôle WebClient. Ce dernier apparaît en grisé dans la page et établit une connexion au serveur. Fenêtre Contrôle ActiveX 42 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient EXÉCUTION DE WEBCLIENT Démarrage client Une fois la connexion établie, un intervalle de plusieurs secondes peut s’écouler, au cours duquel les fichiers initiaux de l’application FactoryLink sont transférés via le réseau. Une fois les fichiers transférés, l’application FactoryLink s’affiche dans la fenêtre WebClient comme suit : 4 Exécution de WebClient Cet exemple présente des zones de saisie de texte destinées à la modification du serveur et des ports, ce qui vous permet de vous connecter à une autre application sans modifier la page HTML sous-jacente. Pour plus d’informations, reportez-vous au chapitre 7, « Pages HTML WebClient ». FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 43 • EXÉCUTION DE WEBCLIENT • Contrôles WebClient • • C ONTRÔLES WEB C LIENT L’accès au menu des contrôles WebClient s’effectue en cliquant sur le bouton droit de la souris dans la fenêtre du contrôle ActiveX WebClient. Remarque : le menu de contrôles est disponible uniquement lorsque WebClient n’est pas connecté à un serveur. Si vous devez accéder à ce menu alors que vous êtes connecté, fermez votre tâche Graph à l’aide du gestionnaire d’exploitation de votre application FactoryLink. Pour plus d’informations, reportez-vous au manuel Principes de base de FactoryLink. Vous disposez des options suivantes. Naviguer Affiche la boîte de dialogue Naviguer. Entrez le nom d’un autre serveur. Cliquez sur OK pour que WebClient établisse la connexion au serveur spécifié dans la zone de texte. 44 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient EXÉCUTION DE WEBCLIENT Contrôles WebClient Propriétés Affiche la boîte de dialogue Propriétés de FactoryLink ECS WebClient. 4 Exécution de WebClient Les options suivantes sont disponibles : Paramètres graphiques Sous Paramètres graphiques, vous pouvez entrer les commutateurs de ligne de commande pour modifier le mode de fonctionnement de WebClient, y compris l’activation des opérations d’historisation. Si le champ Paramètres graphiques est laissé en blanc, les valeurs définies pour la tâche Graph sur le serveur sont prises en compte par défaut. Il est conseillé de laisser ce champ vide, sauf motif particulier. Pour plus d’informations, reportez-vous au chapitre 10, « Commutateurs de ligne de commande WebClient ». Répertoire cache-mémoire La zone Répertoire cache-mémoire permet à l’utilisateur de modifier l’emplacement du répertoire cache-mémoire WebClient. Le répertoire par défaut de ce cache est WebClient c:\Program Files\WebClient\cache. En cas de spécification d’un répertoire différent, assurez-vous qu’il n’est utilisé que pour des fichiers cache WebClient. Vous devez disposer de droits en écriture sur ce répertoire et vous ne pouvez pas spécifier le répertoire racine sur une unité. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 45 • EXÉCUTION DE WEBCLIENT • Contrôles WebClient • • Port La zone Port permet à l’utilisateur de spécifier un port par défaut différent. La valeur de ce port est utilisée lorsqu’aucune autre n’est indiquée dans la propriété LocationURL ou dans la méthode Naviguer, ou bien en ligne de commande lors de l’exécution de la tâche Graph en mode autonome. Cette valeur correspond à l’entrée du fichier de services définie pour la tâche du serveur de connexion sur le serveur FactoryLink. Pour plus d’informations, reportez-vous à la section « Modification du fichier de services TCP/IP » page 34. Débit La zone Débit autorise l’utilisateur à modifier le débit de mise à jour des tags côté client. Cette valeur est exprimée en millisecondes, de telle sorte qu’une entrée égale à 100 correspond à la mise à jour des valeurs de tag tous les dixièmes de seconde. Augmenter cette valeur permet de diminuer la charge réseau par la réduction du débit d’interrogation, mais entraîne une baisse de la fréquence des mises à jour pour l’utilisateur distant. Par défaut Permet d’enregistrer les valeurs courantes pour les appliquer à toutes les connexions. Restaurer Permet de restaurer les valeurs par défaut précédentes de tous les paramètres. Effacer le cache-mémoire A propos Supprime tous les fichiers et sous-répertoires dans le cache WebClient. Affiche les informations de version à propos du contrôle ActiveX WebClient. 46 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient EXÉCUTION DE WEBCLIENT Exécution de GRAPH comme un client spécialisé E XÉCUTION DE GRAPH COMME UN CLIENT SPÉCIALISÉ Pour lancer GRAPH en mode autonome, cliquez sur Démarrer>Exécuter à partir de la barre des tâches Windows et entrez GRAPH dans la zone Ouvrir de la boîte de dialogue Exécuter. Remarque : GRAPH.EXE est situé dans le répertoire bin WebClient, généralement non spécifié dans le chemin d’accès ; vous devez donc spécifier le chemin d’accès complet, y compris la lettre d’unité. La syntaxe d’exécution de GRAPH est la suivante : ITCRJ JPQOPWFFKUVCPV=RQTV? Deux paramètres sont utilisés avec GRAPH : le paramètre PQOPWFFKUVCPV correspondant au nom d’hôte ou à l’adresse IP du serveur et le paramètre RQTV correspondant au port défini pour la tâche du serveur de connexion FactoryLink dans le fichier de services, sur le serveur. Pour plus d’informations, reportez-vous à la section « Modification du fichier de services TCP/IP » au chapitre 3, « Configuration ». Lorsqu’aucun port n’est spécifié, le port par défaut est utilisé. Remarque : vous pouvez créer une icône de raccourci sur le bureau Windows pour simplifier l’exécution de WebClient en tant que client spécialisé. Pour obtenir des instructions concernant la création de raccourcis, reportez-vous à l’aide de Windows. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 47 4 Exécution de WebClient Une version spéciale de la tâche Graphique FactoryLink est fournie avec WebClient, pour être exécutée comme un client spécialisé. Dans ce mode, la tâche Graphique FactoryLink s’exécute comme une application autonome sur le bureau et non dans une application conteneur telle qu’Internet Explorer. • EXÉCUTION DE WEBCLIENT • Exécution de GRAPH comme un client spécialisé • • Limites de la tâche Graph en mode autonome L’exécution de GRAPH présente des différences fonctionnelles par rapport à l’utilisation du contrôle ActiveX sous Internet Explorer : • Il est impossible d’utiliser les propriétés, les événements et les méthodes, sauf ceux accessibles à l’aide de l’utilitaire GRAPHSET. Pour plus d’informations, reportez-vous à la section « GRAPHSET » page 49. • Les modifications de propriété apportées à l’aide de GRAPHSET lors d’une connexion active ne sont pas appliquées tant que GRAPH n’a pas été redémarrée. • L’application FactoryLink doit fournir un mécanisme d’arrêt du domaine USER en vue de fermer l’application sur le poste client. Pour plus d’informations, reportez-vous au manuel Principes de base de FactoryLink. A la différence de la version ActiveX, il n’existe aucun mécanisme de fermeture de la tâche GRAPH lors de son exécution en mode autonome. • Aucune fonctionnalité intégrée de suppression des fichiers cache n’est prévue. Vous pouvez effectuer cette opération manuellement en cliquant deux fois sur l’icône de suppression du cache dans le groupe de programmes WebClient. 48 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient EXÉCUTION DE WEBCLIENT Exécution de GRAPH comme un client spécialisé GRAPHSET Comme GRAPH, GRAPHSET doit être exécuté à partir de la ligne de commande. Remarque : GRAPHSET.EXE est situé dans le répertoire binWebClient, généralement non spécifié dans le chemin d’accès ; vous devez donc spécifier le chemin d’accès complet, y compris la lettre d’unité. Cliquez sur Démarrer-Exécuter dans la barre des tâches Windows et entrez ITCRJUGV dans la zone Ouvrir de la boîte de dialogue Exécuter pour afficher la boîte de dialogue FactoryLink 6.5.0 Graphics Setup. Remarque : vous pouvez créer une icône de raccourci sur le bureau Windows pour simplifier l’exécution de WebClient en tant que client spécialisé. Pour obtenir des instructions concernant la création de raccourcis, reportez-vous à l’aide de Windows. Les entrées pour Paramètres graphiques, Répertoire cache-mémoire, Port et Débit sont les mêmes que pour le contrôle ActiveX. Pour obtenir des informations détaillées sur ces paramètres, reportez-vous à la description de Propriétés dans « Contrôles WebClient » page 44. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 49 4 Exécution de WebClient L’utilitaire GRAPHSET vous permet de modifier les propriétés graphiques lorsque vous lancez l’exécutable graph.exe autonome distant. GRAPHSET appelle la même boîte de dialogue que celle permettant de modifier les propriétés pour WebClient ; toute valeur entrée devient alors une valeur par défaut pour WebClient connecté au réseau s’il s’exécute en même temps que l’exécutable graphique autonome. • EXÉCUTION DE WEBCLIENT • Exécution de GRAPH comme un client spécialisé • • 50 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 5 Applications FactoryLink et WebClient VUE D ’ ENSEMBLE Vous trouverez dans le présent chapitre des informations destinées aux développeurs d’applications FactoryLink. Il est conseillé à toute personne développant une nouvelle application FactoryLink ou modifiant une application existante afin d’exploiter les fonctionnalités de WebClient de prendre connaissance des informations fournies dans les paragraphes ci-dessous. TAGS W EB C LIENT 5 Table 5-1 Tags WebClient utiles Nom de tag Domaine Type Description CONNSRVACTIVE SHARED ANALOG Nombre d’utilisateurs distants actuellement connectés au serveur FactoryLink. CONNSRVTOTAL SHARED ANALOG Nombre total d’instances de la tâche du serveur de connexion disponible pour les connexions distantes. GRAPHCONNTYPE USER ANALOG Type de connexion. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 51 Applications FactoryLink et WebClient FactoryLink dispose de trois tags système utiles sous WebClient. Le tableau ci-dessous fournit des informations sur ces tags. • APPLICATIONS FACTORYLINK ET WEBCLIENT • Considérations relatives à la conception de l’application FactoryLink • • GRAPHCONNTYPE peut prendre cinq valeurs différentes : C ONSIDÉRATIONS F ACTORY L INK 0 Inactif 1 Connexion locale, à contrôle total (FULL_CONTROL) 2 Connexion locale, à affichage seul (VIEW_ONLY). (Non mis en œuvre actuellement.) 3 Connexion distante, à affichage seul (VIEW_ONLY) 4 Connexion distante, à contrôle total (FULL_CONTROL) ou à type de sécurité d’accès défini par l’utilisateur RELATIVES À LA CONCEPTION DE L ’ APPLICATION WebClient permet aux utilisateurs d’accéder à une application FactoryLink sur un réseau mettant en œuvre la technologie Internet standard. Bien que WebClient fournisse essentiellement les mêmes fonctionnalités que celles dont bénéficie un utilisateur local, il présente des limites. En effet, certaines fonctionnalités liées à Power VB, à la sécurité et à d’autres fonctions FactoryLink sont quelque peu limitées. La conception de l’application FactoryLink est également susceptible d’affecter la performance. Les paragraphes ci-dessous fournissent des informations générales sur le mode de conception ou de modification des applications FactoryLink en vue de l’exploitation optimale des possibilités uniques de WebClient. Fonctionnalités Tandis que WebClient fournit des possibilités de contrôle et de surveillance d’une application FactoryLink par un utilisateur distant, un grand nombre de tâches et de fonctions FactoryLink existent uniquement du côté serveur. Les paragraphes ci-dessous présentent des informations relatives à ces tâches. Généralités Lorsque l’accès à une application FactoryLink est de type à affichage seul, les utilisateurs distants ne sont autorisés à écrire que les tags spécifiquement répertoriés dans le panneau Liste des tags d’accès en écriture WebClient. Toutefois, tous les tags peuvent être lus. Selon la configuration de votre application, il peut être nécessaire d’autoriser l’écriture de tags supplémentaires pour exploiter les fonctionnalités élémentaires. 52 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient APPLICATIONS FACTORYLINK ET WEBCLIENT Considérations relatives à la conception de l’application FactoryLink Par exemple, vos actions d’animation sont susceptible d’affecter le dessin des fenêtres et la navigation. L’action d’animation DRW ou TOP est disponible pour les utilisateurs distants. Si l’action d’animation est SET pour le tag de dessin de la fenêtre, les utilisateurs distants ne sont pas autorisés à écrire ce tag, sauf autorisation fournie dans le panneau Liste des tags d’accès en écriture. Si vous voulez autoriser l’écriture de tags de contrôle utilisés par la consultation base de données, vous devez répertorier ces derniers spécifiquement dans le panneau précédemment mentionné. De même, si vous voulez autoriser l’écriture de tags de contrôle utilisés par une animation de graphique, vous devez également les répertorier spécifiquement dans ce panneau. Vous pouvez également autoriser l’écriture de tags de contrôle d’activation de fenêtre tel que défini dans Attributs de fenêtre, dans l’Editeur d’applications. 5 Gestionnaire de fenêtres Les fenêtres secondaires s’ouvrent sur le bureau, hors de l’application conteneur. Il arrive fréquemment qu’elles s’ouvrent derrière la fenêtre Internet Explorer, ce qui peut entraîner une certaine confusion de l’utilisateur. Dans ce cas, vous devez manipuler les fenêtres pour visualiser l’application. Pour obtenir des résultats optimaux avec WebClient, il est préférable que votre application ne recoure qu’à une fenêtre primaire. L’utilisation de fenêtres secondaires devrait être limitée à des fenêtres dynamiques ou d’état. Power VB Dans le cas d’un utilisateur distant WebClient, la totalité du code Power VB est exécutée localement à l’extrémité client de la connexion ; par conséquent, les fonctionnalités d’accès aux fichiers ou d’exécution des appels de DLL ne peuvent pas accéder aux ressources sur le serveur. Si vous devez accéder aux fichiers situés dans le répertoire {FLAPP} (par exemple, à des fichiers d’aide), vous pouvez les ajouter au fichier WEBFILES.LST. Pour plus d’informations, reportez-vous à la section « Utilisation de WEBFILES.LST » page 36. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 53 Applications FactoryLink et WebClient Notez que seule la première fenêtre dessinée s’affiche sous Internet Explorer. La première fenêtre est déterminée par la valeur spécifiée dans le panneau Gestionnaire de fenêtres du Gestionnaire de configuration. La taille et l’emplacement de cette fenêtre sont contrôlés par l’application conteneur, généralement Internet Explorer. • APPLICATIONS FACTORYLINK ET WEBCLIENT • Considérations relatives à la conception de l’application FactoryLink • • Persistance La persistance pour les tags du domaine USER n’est pas mise en œuvre dans le cas des connexions WebClient, car la persistance est associée à chaque instance USER. Etant donné que les instances USER WebClient sont gérées dynamiquement par la tâche du serveur de connexion, aucune méthode de corrélation des données sauvegardées avec un utilisateur particulier n’est disponible. Gestionnaire de fichiers FactoryLink Bien que la tâche du gestionnaire de fichiers FactoryLink soit accessible par un nœud distant, elle permet uniquement de visualiser les données disponibles. Les opérations de fichiers sont effectuées sur le serveur, ce qui signifie qu’un fichier visualisé sur un nœud distant continue de résider sur le serveur. Gestionnaire d’impression FactoryLink La tâche du gestionnaire d’impression s’exécute sur le serveur ; toutes les opérations d’impression doivent être lancées sur une imprimante reliée au serveur. Les utilisateurs distants peuvent déclencher des opérations d’impression, mais la sortie demeure liée au serveur. Générateur de rapports Comme pour le gestionnaire d’impression, la tâche du générateur de rapports s’exécute sur le serveur. La génération de rapports peut être déclenchée par des utilisateurs distants, mais les fichiers de rapports résident sur le serveur. Opérations de base de données Toutes les opérations de base de données sont effectuées sur le serveur. Les utilisateurs distants peuvent accéder aux bases de données uniquement en écrivant sur des tags FactoryLink. Cela concerne les tâches de consultation, de consignation et d’historique base de données. Accès OLE/DDE Les applications FactoryLink utilisant la technologie OLE ou DDE ne peuvent pas accéder à des ressources sur un nœud distant. 54 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient APPLICATIONS FACTORYLINK ET WEBCLIENT Considérations relatives à la conception de l’application FactoryLink Sécurité L’ensemble des actions d’authentification de sécurité d’accès s’effectue côté client. Toutefois, la configuration et la modification de ces opérations liées à la sécurité ne peuvent être réalisées qu’au niveau du serveur. Tout changement des configurations de sécurité est mis à jour dynamiquement sur les nœuds distants. Si votre application FactoryLink utilise la sécurité au niveau système et les mots de passe Windows NT, tout dessin ou toute fenêtre protégés par mot de passe deviennent indisponibles pour un utilisateur distant. Il est recommandé d’utiliser la sécurité FactoryLink lors de l’utilisation de WebClient. Contrôles WebClient multiples Vous ne pouvez pas imbriquer deux contrôles WebClient dans une seule page HTML ou dans une seule instance d’une application conteneur ActiveX. Vous pouvez exploiter simultanément deux instances de l’application conteneur, chacune disposant d’une connexion WebClient. 5 Divers bordure, le bouton d’agrandissement, la barre de titre et le menu système sont ignorés lorsque les fenêtres sont affichées dans une application conteneur. En effet, cette application contrôle le dimensionnement et le positionnement des fenêtres. • Le contrôle ActiveX WebClient est activé dans une page HTML standard, statique ; par conséquent, la fenêtre affichée dans la page HTML ne peut pas être redimensionnée dynamiquement sous Internet Explorer. • Les combinaisons de touches réservées à l’application conteneur ne sont pas transmises à l’application FactoryLink. Par exemple, les affectations des touches F1, F5 et Echap sous Internet Explorer ne sont pas envoyées à l’application ; ces touches ne sont donc pas disponibles pour les animations par bouton ou par touche. • Le moniteur d’exploitation (RTMON) et d’autres tâches FactoryLink personnalisées utilisant des graphiques non FactoryLink ne peuvent pas être utilisés avec WebClient sur le poste client. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 55 Applications FactoryLink et WebClient • Les attributs de fenêtre FactoryLink, tels que le dimensionnement de la • APPLICATIONS FACTORYLINK ET WEBCLIENT • Considérations relatives à la conception de l’application FactoryLink • • Performance Un certain nombre de facteurs ont des conséquences sur la performance d’affichage des graphiques distants par WebClient. La vitesse de la connexion réseau est le facteur le plus significatif concernant l’accès à une application FactoryLink par des utilisateurs distants. Nombre de facteurs ont des effets sur la vitesse de connexion. Pour obtenir des résultats optimaux, assurez-vous que votre système distant répond aux exigences minimales concernant la vitesse du modem, la vitesse du processeur central (CPU) et la capacité de mémoire. En cas d’insatisfaction, adressez-vous à votre administrateur système ou à votre fournisseur de services pour obtenir des suggestions concernant l’amélioration de la vitesse de connexion. L’autre facteur significatif est lié à la conception même de l’application FactoryLink. En effet, les applications utilisant un grand nombre de fenêtres ne produisent pas les mêmes performances que celles utilisant un nombre de fenêtres moins élevé. Plus particulièrement, le fait d’ouvrir plusieurs fenêtres simultanément diminue la performance. Le chargement d’une nouvelle fenêtre requiert la transmission d’un plus grand nombre de données que le simple remplacement d’un dessin dans une fenêtre FactoryLink existante. Idéalement, votre application FactoryLink devrait être conçue pour afficher une seule fenêtre primaire. Les fenêtres secondaires devraient être limitées aux fenêtres dynamiques ou d’état. Le nombre de tags représentés sur un dessin donné affecte également la performance. Les animations, et particulièrement les graphiques, qui requièrent un grand nombre de tags fréquemment mis à jour, entraînent l’augmentation du nombre de données à transmettre. Généralement, toute modification d’une application FactoryLink permettant de réduire le nombre de tags affichés sur un écran donné améliore la performance pour les utilisateurs WebClient distants. Dans le cas des applications FactoryLink existantes, il peut être impossible d’effectuer des modifications importantes destinées spécifiquement à l’exploitation de WebClient. Une autre solution consiste à créer des dessins ou des vues supplémentaires permettant de visualiser les informations différemment. Vous pouvez alors concevoir ces nouveaux éléments pour WebClient et améliorer ainsi la performance. 56 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 6 Dépannage VUE D ’ ENSEMBLE Vous trouverez dans le présent chapitre des procédures de dépannage de WebClient. La majorité des problèmes rencontrés à l’installation de WebClient sont liés au réseau. Pour cette raison, il est recommandé d’impliquer le service chargé du traitement et de la gestion de l’information dans ce processus. Les procédures décrites dans ce chapitre ne sont pas exhaustives mais décrivent les erreurs les plus courantes. D IAGRAMME DE DÉPANNAGE Vous trouverez ci-dessous un diagramme de flux destiné à faciliter le dépannage de votre installation WebClient. Ce diagramme est basé sur l’hypothèse que vous avez installé WebClient et n’avez pas pu vous connecter depuis un terminal distant. 6 Dépannage FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 57 • DÉPANNAGE • Diagramme de dépannage • • DEBUT La tâche du serveur de connexion est-elle en cours d’exécution ? Non Vérifiez que les tâches WebClient sont installées et que WebClient est activé (page 20). Configurez l’application pour WebClient (page 20). Oui Le nom du serveur est-il correct ? Non Corrigez le nom du serveur dans le fichier de services TCP/IP (page 34). Oui Pouvez-vous utiliser la commande Ping avec le nom ou l’adresse IP du client ? Non Ajoutez le nom du serveur et/ou l’adresse IP dans le fichier DNS, WINS ou Hosts (page 62). Oui Pouvez-vous utiliser la commande Ping avec le nom ou l’adresse IP du serveur ? Non Ajoutez le nom du client et/ou l’adresse IP au fichier DNS, WINS ou Hosts (page 62). Oui Pouvez-vous exécuter WCPING avec succès ? Non Oui Augmentez les valeurs de délai et essayez de nouveau (page 64). 58 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient Vérifiez les entrées du fichier de services TCP/IP (page 34). Vérifiez le nombre de clients correct défini dans le gestionnaire de configuration (page 21). DÉPANNAGE Procédures de dépannage P ROCÉDURES DE DÉPANNAGE La tâche du serveur de connexion est-elle en cours d’exécution ? La tâche du serveur de connexion se trouve dans le gestionnaire d’exploitation du domaine SHARED. Cette tâche assure la fourniture des connexions d’utilisateurs WebClient au serveur FactoryLink et doit être en cours d’exécution pour que les utilisateurs distants puissent se connecter au serveur. Pour vérifier que la tâche du serveur de connexion s’exécute, accédez au serveur et naviguez au sein de l’application FactoryLink jusqu’au dessin du gestionnaire d’exploitation du domaine SHARED. Remarque : cet écran peut être protégé par mot de passe, son accès étant autorisé par l’accord de privilèges d’administrateur. Une coche verte placée en regard du nom de tâche (recherchez CONNSRV) indique que la tâche est en cours d’exécution. Si une erreur est signalée dans la tâche (par une croix rouge “X”), reportez-vous à la section « Messages d’erreur » page 70 et suivez les instructions correspondantes. La tâche du serveur de données ne doit pas être en cours d’exécution dans le cas de l’utilisateur de la console. La tâche du serveur de données est démarrée automatiquement pour tous les autres domaines USER ne s’exécutant pas sur la console. 6 Dépannage FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 59 • DÉPANNAGE • Procédures de dépannage • • Si le serveur de connexion n’est pas en cours d’exécution, vous devez commencer par vérifier qu’il a bien été installé et configuré. Ouvrez le gestionnaire de configuration FactoryLink et vérifiez que l’entrée Services WebClient est répertoriée dans la liste des tâches. Si ce n’est pas le cas, il se peut que vous deviez exécuter l’utilitaire CV_WCAPP afin de configurer votre application pour WebClient. Pour plus d’informations, reportez-vous à la section « Utilitaire de préparation de l’application WebClient » page 20. 60 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Procédures de dépannage Le nom du serveur et/ou l’adresse IP sont -ils corrects ? L’une des erreurs les plus courantes lors de la connexion de WebClient au réseau est due à la spécification d’un nom de serveur ou d’une adresse IP erronés correspondant au nom de nœud TCP/IP du serveur. Vous déterminez le nom de nœud en consultant les propriétés de configuration du réseau dans le Panneau de configuration Windows. Cliquez sur Démarrer > Paramètres > Panneau de configuration > Réseau pour accéder à la page Identification : 6 Le champ Nom d’ordinateur : affiche le nom du nœud à utiliser par les utilisateurs distants pour l’accès au serveur FactoryLink. Remarque : vous devez disposer des droits d’accès d’administrateur au poste serveur FactoryLink 6.5.0 pour rechercher le nom de nœud TCP/IP du serveur. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 61 Dépannage Pour plus d’informations sur la modification du nom de serveur dans le fichier de services TCP/IP, reportez-vous à la section « Configuration de réseau » page 34. • DÉPANNAGE • Procédures de dépannage • • Pouvez-vous utiliser la commande Ping avec le nom ou l’adresse IP du client ? L’utilitaire ping est installé avec le réseau du système d’exploitation. La commande Ping est exécutée en ligne de commande : 2KPI 0QOPWFUGTXGWT Lorsqu’une commande ping aboutit, elle retourne des paquets de données ; dans le cas contraire, un time-out est renvoyé. L’ordinateur client doit pouvoir reconnaître le serveur par son nom ou par l’adresse IP. L’utilitaire ping permet de tester cette aptitude. La recherche d’un nom de nœud sur le réseau prend parfois plus d’une minute. Les délais d’attente que connaît la commande ping se répercutent dans le time-out de WebClient. Si l’utilitaire ping ne parvient pas à localiser le serveur, reportez-vous à la section « Augmentation des valeurs de time-out de la connexion WebClient » page 64 et augmentez les valeurs de time-out pour le client. Si cette opération ne suffit pas pour résoudre le problème, adressez-vous à votre administrateur de réseau pour vous assurer que le nom de serveur est répertorié dans le fichier DNS, WINS et/ou hosts. Remarque : le fichier hosts est un fichier texte semblable au fichier de services réseau. Sous Windows NT, ce fichier est généralement stocké dans le dossier c:\WINNT\SYSTEM32\DRIVERS\ETC\. Sous Windows 95, il se trouve dans le dossier Windows. Pouvez-vous utiliser la commande Ping avec le nom ou l’adresse IP du serveur ? L’utilitaire ping est installé avec le réseau du système d’exploitation. La commande Ping est exécutée en ligne de commande : 2KPI 0QOPWFENKGPV Lorsqu’une commande ping aboutit, elle retourne des paquets de données ; dans le cas contraire, un time-out est renvoyé. Une connexion WebClient créant deux chemins TCP/IP indépendants, chaque ordinateur doit pouvoir reconnaître l’autre par son nom. L’utilitaire ping permet de tester cette aptitude. 62 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Procédures de dépannage La recherche d’un nom de nœud sur le réseau prend parfois plus d’une minute. Les délais d’attente que connaît la commande ping se répercutent dans le time-out de WebClient. Si l’utilitaire ping ne parvient pas à localiser le serveur, adressez-vous à votre administrateur de réseau pour vous assurer que le nom de serveur est répertorié dans le fichier DNS, WINS et/ou hosts. Remarque : le fichier hosts est un fichier texte semblable au fichier de services réseau. Sous Windows NT, ce fichier est généralement stocké dans le dossier c:\WINNT\SYSTEM32\DRIVERS\ETC\. Sous Windows 95, il se trouve dans le dossier Windows. Pouvez-vous exécuter WCPING avec succès ? L’utilitaire wcping est exécuté de la même manière que l’utilitaire ping standard en vue de tester la capacité de l’utilisateur distant à se connecter au serveur : %>2TQITCO HKNGU>9GD%NKGPV>DKP>YERKPI 0QOPWFUGTXGWT5QEMGV L’utilitaire wcping est différent de ping par le fait qu’il établit réellement la connexion au serveur afin de tester toutes les communications. Pour plus d’informations, reportez-vous à la section « WCPING » page 69. Si wcping ne parvient pas établir la connexion au serveur, il se peut que votre fichier de services réseau contienne des entrées incorrectes. Le numéro de socket correspond au numéro attribué au serveur de connexion. Le numéro de service par défaut est 6096, utilisé par l’utilitaire cv_wcapp. Pour plus d’informations, reportez-vous à la section « Modification du fichier de services TCP/IP » du Chapitre 3, « Configuration ». Par ailleurs, vérifiez que votre serveur WebClient est correctement configuré en fonction du nombre d’utilisateurs distants spécifiés dans le panneau Liste des éléments du domaine. Pour plus d’informations, reportez-vous à la section « Panneau liste des éléments du domaine » page 21. Pour plus d’informations sur l’augmentation des valeurs de time-out, reportez-vous à la section « Augmentation des valeurs de time-out de la connexion WebClient » page 64. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 63 Dépannage Lorsque l’utilitaire wcping fonctionne, WebClient doit être connecté. Si ce n’est pas le cas, il est possible que votre connexion soit soumise à un délai d’attente avant l’achèvement du transfert de données initial. 6 • DÉPANNAGE • Augmentation des valeurs de time-out de la connexion WebClient • • A UGMENTATION W EB C LIENT DES VALEURS DE TIME - OUT DE LA CONNEXION En conditions normales, il n’est pas nécessaire de modifier les valeurs de time-out par défaut de WebClient. Toutefois, l’augmentation de ces valeurs par les utilisateurs distants peut être requise dans les situations suivantes : • Connexions par modem • Connexions par satellite • Réseaux d’entreprise très étendus • Serveurs DNS ou WINS lents • Réseaux complexes à ponts, routeurs ou pivots multiples. Les paragraphes ci-dessous fournissent des instructions relatives à l’augmentation des valeurs de time-out pour WebClient dans le cas du fonctionnement dans Internet Explorer ou de l’utilisation de la tâche GRAPH en mode autonome client. Modification des valeurs de time-out pour les utilisateurs du navigateur Exécutez les étapes suivantes pour augmenter les valeurs de time-out lorsque vous utilisez WebClient dans Internet Explorer : 1 Reportez-vous à la section « Contrôles WebClient » page 44 pour obtenir des instructions concernant l’accès à la boîte de dialogue Propriétés de FactoryLink ECS WebClient : 64 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Augmentation des valeurs de time-out de la connexion WebClient 2 Dans le champ Paramètres, ajoutez les paramètres suivants (sans espace) : POT Le paramètre -r permet d’augmenter la valeur de time-out de la connexion de 5 secondes (par défaut) à 30 secondes. Le paramètre -m augmente le time-out de transfert de données (une fois la connexion établie) de 15 secondes (par défaut) à 30 secondes. 3 Cliquez sur OK. Modification des valeurs de time-out pour les utilisateurs de la tâche GRAPH (en mode autonome client) Exécutez les étapes suivantes pour augmenter les valeurs de time-out lorsque vous utilisez WebClient comme client autonome : 1 Reportez-vous à la section « GRAPHSET » page 49 pour obtenir des instructions sur l’accès à la boîte de dialogue FactoryLink ECS Graphics Setup : 6 2 Dans le champ Paramètres, ajoutez les paramètres suivants (sans espace) : Le paramètre -r permet d’augmenter la valeur de time-out de la connexion de 5 secondes (par défaut) à 30 secondes. Le paramètre -m augmente le time-out de transfert de données (une fois la connexion établie) de 15 secondes (par défaut) à 30 secondes. 3 Cliquez sur OK. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 65 Dépannage POT • DÉPANNAGE • Dépannage général • • D ÉPANNAGE GÉNÉRAL Impossible de charger WebClient dans Explorer • Si Internet Explorer n’affiche rien après le chargement de la page de démarrage HTML, l’espace disque disponible est peut-être insuffisant. Lorsque WebClient se connecte au serveur, il charge des données qui doivent être placées en mémoire cache sur le disque dur local. • Si le contrôle ActiveX WebClient ne s’affiche pas dans Internet Explorer, vérifiez que cette application conteneur est configurée pour les contrôles ActiveX. Sélectionnez Affichage-Options et cliquez sur l’onglet Sécurité pour afficher la feuille de propriétés Sécurité. Vérifiez que l’option Activer les contrôles ActiveX et Plug-ins est cochée. • Si vous ne parvenez pas à vous connecter au serveur FactoryLink à l’aide de WebClient dans Internet Explorer, testez la connexion en utilisant l’utilitaire GRAPH en mode autonome. Si la connexion est établie, cela signifie que le problème provient de la configuration d’Internet Explorer. Pour plus 66 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Dépannage général d’informations, reportez-vous à la section « Exécution de GRAPH comme un client spécialisé » page 47. • Si les problèmes de connexion persistent, il se peut que votre installation ne soit pas correctement configurée avec le firewall protégeant le serveur FactoryLink. Dans ce cas, adressez-vous à votre administrateur système. Le service d’assistance clientèle peut également vous fournir des informations complémentaires sur la configuration des firewalls, de la sécurité et des connexions. • D’autres fonctionnalités sur votre page HTML peuvent utiliser VBScript. En cas de mauvais fonctionnement de ces dernières, vérifiez que l’option Exécuter les scripts ActiveX est cochée. Impossible de réaliser le nombre de connexions prévu Si vous pouvez établir au moins une connexion WebClient mais pas le nombre souhaité, exécutez les procédures suivantes : 1 Naviguez dans votre application FactoryLink pour accéder à l’écran du gestionnaire d’exploitation. 2 Cliquez sur le bouton RTMON pour démarrer le moniteur d’exploitation. 3 Dans le menu du moniteur d’exploitation, sélectionnez Options>Surveiller pour afficher la liste de surveillance du moniteur FactoryLink : 6 Dépannage FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 67 • DÉPANNAGE • Dépannage général • • 4 Dans la liste de surveillance du moniteur FactoryLink, sélectionnez Options>Ajouter variables de surveillance et entrez %100548616#. dans la boîte de dialogue pour vérifier le nombre total de connexions courantes configurées. Ce nombre doit être égal au nombre de connexions FactoryLink sous licence. Remarque : si ce nombre est correct, cela signifie que le problème ne provient pas de la configuration WebClient. S’il est incorrect, effectuez la procédure ci-dessous. 5 Ouvrez le gestionnaire de configuration FactoryLink et sélectionnez les services WebClient pour afficher le panneau Connexions WebClient : 6 Vérifiez que le nombre de connexions maximal est correct. 7 Dans le gestionnaire de configuration FactoryLink, sélectionnez Vue>Liste domaines dans le menu principal afin d’afficher la Liste des éléments du domaine : 68 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE WCPING 8 Vérifiez que le nombre d’instances utilisateur (# INST) entré est correct. Remarque : le nombre d’instances utilisateur doit être supérieur de 1 au nombre total de connexions WebClient sous licence. 9 Pour plus d’informations sur la modification du fichier de services TCP/IP, reportez-vous à la section « Modification du fichier de services TCP/IP » page 34. Vérifiez que le nombre d’entrées FLDATASRVC dans ce fichier est identique au nombre de connexions WebClient sous licence. WCPING L’utilitaire WCPING tente d’établir la connexion au serveur. Il affiche des informations relatives au serveur lorsque la connexion aboutit et un message d’erreur lorsqu’elle échoue. Utilisez WCPING lorsque vous ne parvenez pas à vous connecter au serveur et souhaitez vérifier qu’il est en cours d’exécution. La syntaxe de ligne de commande est la suivante : YERKPI PQOUGTXGWT =PWO¾TQ FG RQTV?QRVKQPU où PQOUGTXGWT Correspond au nom ou à l’adresse IP du serveur auquel vous vous connectez. PWO¾TQ FG RQTV Désigne le numéro de port du serveur. Si le port n’est pas spécifié, le numéro par défaut est pris en compte. QRVKQPU Tout paramètre de réseau utilisé pour GRAPH (voir au Chapitre 10, « Commutateurs de ligne de commande WebClient »). 6 Dépannage FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 69 • DÉPANNAGE • Messages d’erreur • • M ESSAGES D ’ ERREUR Lorsqu’un problème survient dans une connexion WebClient, un message d’erreur est affiché à l’intention de l’utilisateur distant. Les erreurs sont classées en trois catégories : • Erreurs réseau • Erreurs liées à la tâche Graphique distante • Erreurs liées au serveur de connexion/serveur de données. Les paragraphes ci-dessous répertorient les messages d’erreur et décrivent la cause des erreurs et les mesures correctives. Erreurs liées à la tâche Graphique distante Connexion refusée. Dépassement du nombre de licences des connexions à contrôle total. Cause : le nombre de clients connectés autorisés en contrôle total atteint la limite des licences accordées. Vous ne pouvez pas résoudre ce problème à distance. Action : achetez des licences de connexions à contrôle total supplémentaires auprès de votre vendeur. Connexion refusée. Dépassement du nombre de licences des connexions à affichage seul. Cause : le nombre de clients connectés autorisés en affichage seul atteint la limite des licences accordées. Vous ne pouvez pas résoudre ce problème à distance. Action : achetez des licences de connexions à affichage seul supplémentaires auprès de votre vendeur. Connexion refusée. Les privilèges d’accès de l’hôte sont insuffisants. Cause : l’accès du client est refusé : le gestionnaire de configuration FactoryLink a configuré le type de sécurité pour cet hôte par la valeur NO_ACCESS (aucun accès autorisé). Vous ne pouvez pas résoudre ce problème à distance. Action : adressez-vous à l’administrateur FactoryLink pour modifier le type d’accès attribué à votre système hôte. 70 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Messages d’erreur Time-out sur tentative de connexion. <nom hôte> <port> Cause : la combinaison <nom hôte> <port> demandée ne répond pas. Les entrées <nom hôte> <port> sont peut-être incorrectes ou la connexion réseau est lente. Action : vérifiez que la tâche du serveur de connexion est en cours d’exécution sur le serveur FactoryLink. Augmentez la valeur de time-out de la connexion à l’aide du paramètre -r et essayez de nouveau. Pour plus d’informations, reportez-vous à la section « Vue d’ensemble » page 98. Version client incompatible. Connexion refusée. <version client> Cause : la version client n’est pas compatible avec la version serveur. Action : mettez à jour l’une des deux versions, ou les deux, pour rendre les versions compatibles. Mémoire épuisée. Cause : mémoire RAM insuffisante sur le poste client. Action : vérifiez les ressources système. Erreur de création de fichier. <nom de fichier> Cause : échec de la création de fichier sur le poste client. Action : vérifiez la capacité de mémoire cache sur le disque du poste client. Déplacez ou supprimez des fichiers pour libérer de l’espace. Vérifiez les autorisations de fichiers sur le poste client. Erreur de lecture de fichier. <nom de fichier> Erreur de lecture des statistiques du fichier. <nom de fichier> Erreur d’ouverture du fichier. <nom de fichier> Action : vérifiez les autorisations de fichiers sur le serveur. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 71 Dépannage Cause : impossible d’ouvrir <nom de fichier> sur le serveur. Vous ne pouvez pas résoudre ce problème à distance. 6 • DÉPANNAGE • Messages d’erreur • • Erreur de définition de la date du fichier. <nom de fichier> Cause : échec de définition de la date du fichier. Action : vérifiez les droits d’écriture du fichier/répertoire dans le répertoire cache-mémoire. Erreur d’écriture dans le fichier. <nom du fichier> Cause : échec de l’écriture du fichier sur le poste client. Action : vérifiez la capacité de mémoire cache sur le disque du poste client. Déplacez ou supprimez des fichiers pour libérer de l’espace. Impossible d’établir une connexion. Cause : le nom d’hôte spécifié n’est pas reconnu. Action : vérifiez le nom d’hôte. Impossible d’activer le client réseau. Cause : impossible d’établir la connexion. Action : vérifiez la syntaxe du nom d’hôte et du port. Vérifiez l’installation TCP/IP. Erreurs réseau Outre les messages précédents, plusieurs erreurs réseau peuvent donner lieu à l’affichage de messages d’erreur. Les raisons de l’échec d’une transaction de réseau sont multiples. Le message d’erreur suivant s’affiche pour ce type d’erreur : Echec de transaction réseau <message joint décrivant la cause de l’erreur> Les messages suivants décrivent des causes d’erreurs et le cas échéant, les actions à effectuer pour les corriger. Mémoire épuisée Cause : le client ne peut pas allouer suffisamment de mémoire. Action : fermez toutes les applications d’arrière-plan inutiles et essayez de nouveau. 72 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Messages d’erreur Connexion de session interrompue à distance. Identificateur de connexion NUL. La connexion risque d’être perdue. Echec de la tentative d’envoi de paquet. La connexion risque d’être perdue. Cause : la connexion au serveur a été perdue, en raison d’un arrêt anormal du serveur ou à des erreurs sur le réseau. Action : tentez de vous reconnecter. Time-out sur retour de paquet pour l’appel de procédure distant. Cause : le serveur n’a pas répondu à la demande dans le temps spécifié. Action : essayez de nouveau d’établir la connexion. Si nécessaire, augmentez la valeur du commutateur de ligne de commande -m (voir au Chapitre 10, « Commutateurs de ligne de commande WebClient »). Les messages d’erreur ci-dessous sont généralement associés à des transactions de réseau dont l’échec est dû à des problèmes de connexion réseau. Adressez-vous à votre administrateur de réseau ou à votre fournisseur de services pour vérifier la qualité de la connexion de réseau. Message de réseau endommagé. Aucune signature de début. Message de réseau endommagé. Aucune signature de fin. Message de réseau endommagé. En-tête incorrect. Message de réseau endommagé. Valeur de l’élément message tronquée. Message de réseau endommagé. Tentative de définition d’un élément du message réseau sur un type incorrect. Les autres messages ont trait à des défaillances que vous ne pouvez pas résoudre à distance généralement. Lorsqu’il est possible de déterminer la cause de l’erreur, les explications suivantes sont jointes au message d’erreur Echec de transaction réseau. Signalez au service d’assistance clientèle les messages d’erreur suivants afin de faciliter le diagnostic du problème : FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 73 Dépannage Message joint décrivant la cause de l’erreur "Echec de transaction réseau" interne Erreur interne de service de données/client. Aucune session ouverte. Exécution de RPC ConnectInfo( ) requise avant tout autre RPC. ID de procédure distante inconnue reçu par le service de données. Erreur interne de transfert de fichier. Type de tag incorrect dans les param. de la fonction. Erreur interne de transfert de fichier. 6 • DÉPANNAGE • Messages d’erreur • • Argument incorrect donné à la fonction FTP. Echec de transaction réseau. ID RPC de transfert de fichier inconnu reçu. Erreur interne de fournisseur de service/client. Argument incorrect donné à la fonction fournisseur. Aucune session ouverte. ID de procédure distante inconnue reçu par le fournisseur de service. Erreur réseau interne. Paramètre incorrect donné à la fonction réseau. Echec de l’exportation du message réseau. Zone tampon cible trop petite. Discordance de type lors de l’obtention de l’élément message réseau. Discordance de nombres lors de l’obtention de l’élément message réseau. L’élément message réseau requis est introuvable. Erreur réseau interne. Paramètre incorrect donné à la fonction réseau. Réception d’un paquet réseau formé Ill. Contenu du paquet réseau reçu manquant. Paquet réseau inconnu reçu. Le contenu du paquet réseau reçu est inconnu. Time-out sur retour de paquet pour l’appel de procédure distant. Erreur réseau interne.... Erreurs liées aux tâches du serveur de connexion et du serveur de données Fichier CT introuvable Cause : le fichier CT associé aux tâches WebClient sur le serveur FactoryLink est introuvable. Ce problème est généralement dû à une configuration incorrecte sur le serveur. Vous ne pouvez pas résoudre ce problème à distance. Action : vérifiez la configuration des panneaux WebClient dans le gestionnaire de configuration FactoryLink et exécutez l’utilitaire EVIGP . 74 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient DÉPANNAGE Messages d’erreur Impossible d’ouvrir le fichier journal Cause : impossible d’ouvrir le fichier journal en écriture ou impossible de créer le chemin d’accès au fichier. Vous ne pouvez pas résoudre ce problème à distance. Action : vérifiez la validité du chemin : {FLAPP}\{FLNAME}\{FLDOMAIN}\{FLUSER}\log. Si un fichier journal existe déjà, essayez de le déplacer ou de le supprimer. Erreur d’initialisation de la boîte aux lettres Cause : le tag de boîte aux lettres n’est pas défini. Cela indique que l’application FactoryLink n’a peut-être pas été convertie de façon à mettre en œuvre WebClient. Vous ne pouvez pas résoudre ce problème à distance. Action : convertissez l’application à l’aide de “FLCONV” et “CV_WCAPP” (voir le Chapitre 3, « Configuration »). Erreur d’initialisation du réseau Cause : l’initialisation du réseau a échoué. Vous ne pouvez pas résoudre ce problème à distance. Action : vérifiez le nom de service du réseau dans le panneau du gestionnaire de configuration FactoryLink et dans le fichier de services TCP (voir le Chapitre 3, « Configuration »). Total de connexions sous licence dépassé de <nombre>. Cause : le nombre de connexions configurées est supérieur à <nombre>, qui correspond à la somme des licences pour les connexions à contrôle total et à affichage seul. Seules <nombre> connexions sont activées. Panneau FLCM non configuré Cause : le panneau Services WebClient du gestionnaire de configuration FactoryLink n’est pas configuré. Vous ne pouvez pas résoudre ce problème à distance. Action : configurez ce panneau (voir le Chapitre 3, « Configuration »). FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 75 Dépannage Action : réduisez le nombre de connexions configurées dans le gestionnaire de configuration FactoryLink (voir le Chapitre 3, « Configuration »). 6 • DÉPANNAGE • Messages d’erreur • • Taille d’enregistrement CT incorrecte. Cause : les enregistrements du fichier CT ne sont pas au format attendu. Action : exécutez EVIGP YGDAENPV et recherchez les erreurs, ou supprimez web_clnt.ct et régénérez les tables ct. Aucune connexion sous licence. Cause : votre configuration FactoryLink n’autorise aucune connexion WebClient. Vous ne pouvez pas résoudre ce problème à distance. Action : adressez-vous à votre vendeur pour acheter des licences de connexions WebClient. Tâche non achetée ; il manque le bit de séquence de configuration. Cause : la tâche WebClient n’a pas été achetée. Vous ne pouvez pas résoudre ce problème à distance. Action : adressez-vous à votre vendeur. Tags trop nombreux pour affichage seul. Tags supplémentaires ignorés. Cause : plus de 76 tags sont définis dans la Liste des tags d’accès en écriture pour le type de connexion à affichage seul, VIEW_ONLY. Seuls les 76 premiers tags sont accessibles en écriture. Vous ne pouvez pas résoudre ce problème à distance. Action : réduisez le nombre de tags de la liste. Impossible d’activer le client réseau. Cause : impossible d’établir une connexion. Action : vérifiez le nom d’hôte et le numéro de port. Nom de sécurité non défini dans le panneau. Cause : un nom de sécurité non défini est utilisé. Action : définissez un nouveau nom de sécurité dans le troisième panneau WebClient dans le domaine utilisateur. 76 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 7 Pages HTML WebClient 7 DE PAGES HTML W EB C LIENT Pour activer le contrôle ActiveX permettant d’accéder à une application FactoryLink à l’aide de WebClient, l’utilisateur distant doit charger une page HTML créée précédemment et contenant les codes requis. Les paragraphes ci-dessous fournissent des informations relatives à la création de pages HTML WebClient. Certains programmes d’édition HTML disposent d’outils qui simplifient l’insertion du code correspondant aux contrôles ActiveX. Microsoft a créé ActiveX Control Pad, utilitaire Windows gratuit d’assistance pour l’ajout du code requis, disponible sur le site web de Microsoft. Le code suivant est nécessaire à la mise en œuvre d’une connexion WebClient élémentaire : JVON DQF[ QDLGEV KF9GD%NKGPV ENCUUKF%.5+&$'&'&$&#('$% YKFVJ JGKIJV 2#4#/ 0#/'.QECVKQP74. 8#.7'OQPUGTXGWT QDLGEV DQF[ JVON Les informations correspondant à « classid » sont spécifiques à la machine utilisée et proviennent de la base de registres Windows. Vous pouvez modifier les valeurs de largeur et de hauteur à votre gré. Le paramètre LocationURL doit correspondre au nom d’hôte de votre serveur WebClient. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 77 Pages HTML WebClient C RÉATION • PAGES HTML WEBCLIENT • Création de pages HTML WebClient • • L’installation WebClient côté client comprend des pages exemple HTML qui peuvent servir de base pour la création de votre propre page. L’exemple suivant représente une page caractéristique. Cette page utilise le code HTML et VBScript et procure ainsi des possibilités fonctionnelles supplémentaires. Si vous souhaitez vous connecter à plusieurs serveurs et applications FactoryLink, sélectionnez-les dans cette page. L’utilisateur n’est plus obligé de modifier le code HTML pour modifier l’URL du serveur ; il lui suffit d’entrer l’URL et le port dans les zones de saisie correspondantes sur cette page et de cliquer dans la zone de connexion. Pour plus de détails, utilisez votre éditeur HTML ou votre éditeur de texte pour afficher le code source des exemples fournis dans le répertoire Sample HTML de votre installation WebClient. 78 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 8 Propriétés du contrôle ActiveX WebClient VUE D ’ ENSEMBLE Le contrôle ActiveX WebClient respecte les normes Microsoft correspondantes. Vous pouvez l’insérer dans toute application compatible avec ActiveX, incluant les programmes créés à l’aide de Visual Basic Microsoft. La section suivante présente la liste des propriétés, des méthodes et des événements liés au contrôle. P ROPRIÉTÉS 8 Propriété AccessSecurityName Syntaxe Eléments Renvoie une chaîne contenant le nom du groupe de sécurité d’accès associé à la connexion courante. objet.AccessSecurityName objet Requis. Objet WebClient. Propriété Busy Description Syntaxe Eléments Renvoie une valeur booléenne indiquant si le contrôle WebClient est occupé, c’est-à-dire en cours de connexion à un serveur ou de traitement de message dans des fenêtres. objet.Busy objet Requis. Objet WebClient. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 79 Propriétés du contrôle ActiveX WebClient Description • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Propriété CacheDirectory Description Syntaxe Eléments Renvoie ou définit une valeur contenant le chemin pour le répertoire cache-mémoire courant. Ce répertoire permet de stocker les données d’application pour des connexions distantes. objet.CacheDirectory [= répertoire cache] objet Requis. Objet WebClient. répertoire cache Facultatif. Chaîne contenant le répertoire de stockage des données mises en mémoire cache. Remarque : la modification de cette propriété n’affecte pas les paramètres par défaut et n’entraîne pas l’effacement du répertoire précédent. Ce paramètre ne peut pas être modifié une fois la connexion établie. Propriété Connected Description Syntaxe Eléments Renvoie une valeur booléenne indiquant si le contrôle WebClient est connecté à un serveur. objet.Connected objet Requis. Objet WebClient. Propriété ConnectType Description Syntaxe Eléments Valeurs Renvoie un nombre entier indiquant le type de connexion établie avec le serveur. objet.ConnectType objet Requis. Objet WebClient. NOT_CONNECTED 0 CONNECT_REMOTE_VIEWONLY 3 CONNECT_REMOTE_FULL 4 80 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés Propriété DrawingName Description Syntaxe Eléments Renvoie une chaîne contenant le nom du dessin courant affiché dans la fenêtre WebClient. Une chaîne vide est retournée si aucun dessin n’est affiché. objet.DrawingName objet Requis. Objet WebClient. Propriété Error Description Syntaxe Eléments Renvoie une chaîne contenant la dernière erreur survenue. Cette valeur est définie après que l’événement Error ou NetworkError soit survenu. objet.Error objet Requis. Objet WebClient. Description Syntaxe Eléments Renvoie ou définit une valeur contenant les paramètres de ligne de commande utilisés par WebClient. objet.GraphParameters [= paramètres graphiques] objet Requis. Objet WebClient. paramètres graphiques Facultatif. Chaîne contenant les paramètres normalement utilisés comme options de ligne de commande pour la tâche Graphique FactoryLink. Voir « Commutateurs de ligne de commande WebClient » page 97. Propriété Height Description Renvoie ou définit la dimension verticale, en pixels, de la fenêtre de délimitation contenant le contrôle WebClient. Syntaxe objet.Height [= hauteur] Eléments objet Requis. Objet WebClient. hauteur Facultatif. Nombre entier long indiquant la dimension verticale de la fenêtre de délimitation, en pixels. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 81 Propriétés du contrôle ActiveX WebClient Propriété GraphParameters 8 • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Propriété HWND Description Syntaxe Eléments Renvoie la poignée de la fenêtre principale WebClient. objet.HWND objet Requis. Objet WebClient. Propriété Left (sans objet dans Internet Explorer) Description Syntaxe Eléments Renvoie ou définit la distance entre le bord gauche du contrôle WebClient et le bord gauche de son conteneur. objet.Left [= distance] objet Requis. Objet WebClient. distance Facultatif. Expression à nombre entier long indiquant la distance. Propriété LocationName Description Syntaxe Eléments Renvoie une chaîne contenant le nom de la ressource actuellement affichée par WebClient. Elle correspond à la valeur de description du service WebClient spécifiée dans le panneau Connexions WebClient du gestionnaire de configuration FactoryLink. objet.LocationName objet Requis. Objet WebClient. Propriété LocationURL Description Syntaxe Eléments Renvoie une chaîne contenant l’URL du serveur auquel WebClient est actuellement connecté. Voir la méthode Navigate relative au format de l’URL. objet.LocationURL objet Requis. Objet WebClient. 82 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés Propriété Name Description Syntaxe Eléments Renvoie une chaîne donnant comme résultat le nom du contrôle WebClient. objet.Name objet Requis. Objet WebClient. Propriété Port Description Syntaxe Eléments Renvoie ou définit une chaîne contenant le port TCP courant utilisé pour les connexions distantes. objet.Port [= port] objet Requis. Objet WebClient. Propriété Rate Description Syntaxe Eléments Renvoie ou définit une valeur indiquant le temps de sommeil entre les requêtes de la base de données temps réel. objet.Rate [= Délai] objet Requis. Objet WebClient. Délai Facultatif. Le temps de sommeil est exprimé en millisecondes. Propriété Status Description Syntaxe Eléments Renvoie une chaîne contenant l’état courant du contrôle WebClient. Voir l’événement StatusChanged pour connaître les valeurs de chaîne valides. objet.Status objet Requis. Objet WebClient. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 83 8 Propriétés du contrôle ActiveX WebClient port Facultatif. Port TCP utilisé pour les connexions distantes. Remarque : la modification de cette propriété n’affecte pas les paramètres par défaut. Ce paramètre ne peut pas être modifié une fois la connexion établie. • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Propriété Top (sans objet dans Internet Explorer) Description Syntaxe Eléments Renvoie ou définit la distance entre le bord supérieur du contrôle WebClient et le bord supérieur de son conteneur. objet.Top [= distance] objet Requis. Objet WebClient. distance Facultatif. Expression à nombre entier long indiquant la distance. Propriété UserMenuEnabled Description Syntaxe Eléments Renvoie ou définit une valeur booléenne indiquant si le menu contextuel (accès par le bouton droit de la souris) est activé. objet.UserMenuEnabled [= valeur] objet Requis. Objet WebClient. valeur Facultatif. Expression booléenne indiquant l’état activé du menu contextuel WebClient. Si la valeur True est spécifiée, le menu s’affiche en mode non connecté et le bouton droit de la souris est activé dans la fenêtre du contrôle. Si False est spécifié, le menu ne s’affiche pas. Propriété Visible (sans objet dans Internet Explorer) Description Syntaxe Eléments Renvoie ou définit une valeur indiquant si le contrôle WebClient est visible ou non. objet.Visible [= valeur] objet Requis. Objet WebClient. valeur Facultatif. Expression booléenne indiquant l’état visible du contrôle WebClient. Si la valeur True est spécifiée, la fenêtre est visible ; si False est spécifié, elle est cachée. 84 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés Propriété Width Description Syntaxe Eléments Renvoie ou définit la dimension horizontale, en pixels, de la fenêtre de délimitation contenant le contrôle WebClient. objet.Width [= largeur] objet Requis. Objet WebClient. largeur Facultatif. Nombre entier long indiquant la dimension horizontale de la fenêtre de délimitation, en pixels. Propriété WindowTitle Description Syntaxe Eléments Renvoie une chaîne contenant le titre de la fenêtre courante affichée dans le contrôle ActiveX WebClient. objet.WindowTitle Voir aussi l’événement « Evénement TitleChange ». E10 Evénement BeforeNavigate Description Syntaxe Eléments Survient lorsque WebClient est sur le point de se connecter à un site différent ; cela peut se produire suite à un processus d’automatisation externe ou à une initialisation avec spécification de l’URL. Le conteneur a la possibilité d’annuler la navigation en attente. Private Sub objet_BeforeNavigate (ByVal URL As String, Annuler As Boolean) objet Requis. Objet WebClient. URL Chaîne donnant comme résultat l’URL vers lequel le client navigue. Voir la méthode relative au format d’URL. Annuler Valeur booléenne que le conteneur peut définir par True pour annuler la navigation ou par False pour autoriser à poursuivre. Voir aussi la méthode « Méthode Navigate » et l’événement « Evénement NavigateComplete ». FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 85 Propriétés du contrôle ActiveX WebClient objet Requis. Objet WebClient. 8 • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Evénement DrawingChange Description Syntaxe Eléments Survient lorsque le dessin affiché dans le contrôle WebClient change. Notez que cela s’applique uniquement à la fenêtre affichée dans le contrôle ActiveX WebClient, et non à des fenêtres secondaires affichées hors de l’application conteneur. Private Sub objet_DrawingChange (Nom As String) objet Requis. Objet WebClient. Nom Chaîne contenant le nom du nouveau dessin. Evénement Error Description Syntaxe Eléments Survient lorsque le contrôle détecte une erreur interne. Private Sub objet_Error (Numéro As Integer Description As String Scode As Error Source As String FichierAide As String ContexteAide As Long AnnulerAffichage As Boolean) objet Requis. Objet WebClient. Numéro Numéro de l’erreur détectée. Description Chaîne contenant la description de l’erreur. Scode Valeur contenant des informations détaillées relatives à la méthode ou à la fonction d’interface ayant détecté l’erreur. Source Chaîne contenant une description de la méthode ou de la fonction d’interface ayant détecté l’erreur. FichierAide Chaîne contenant le chemin d’accès à un fichier d’aide Windows et contenant des informations d’aide détaillées. ContexteAide Contexte de l’erreur dans le fichier d’aide. 86 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés AnnulerAffichage Valeur booléenne que le conteneur peut définir par True pour afficher le message d’erreur par défaut du contrôle ou par False pour annuler l’affichage. Evénement NavigateComplete Description Syntaxe Eléments Survient lorsque le client a atteint un nouvel emplacement. Private Sub objet_NavigateComplete (ByVal URL As String) objet Requis. Objet WebClient. URL Chaîne donnant comme résultat l’URL vers lequel le client navigue. Voir la méthode Navigate relative au format d’URL. Voir aussi Navigate, BeforeNavigate. Description Syntaxe Eléments Survient lorsque la couche réseau détecte une erreur. Private Sub objet_NetworkError (ByVal Message As String ByVal Niveau As Integer AnnulerAffichage As Boolean) objet Requis. Objet WebClient. Message Chaîne contenant l’erreur détectée par la couche réseau. Niveau Niveau d’erreur détecté. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 87 Propriétés du contrôle ActiveX WebClient Evénement NetworkError 8 • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Constante Valeur Description ERROR_LEVEL_FATAL -3 Une erreur fatale est survenue. L’application va être fermée. ERROR_LEVEL_ERROR -2 Une erreur est survenue. Il se peut que l’application soit fermée. ERROR_LEVEL_WARN -1 L’erreur n’est sans doute pas fatale. L’exécution de l’application devrait se poursuivre normalement. ERROR_LEVEL_INFO 0 L’erreur est signalée à titre informatif uniquement. AnnulerAffichage Valeur booléenne que le conteneur peut définir par True pour afficher le message d’erreur par défaut du contrôle ou par False pour annuler l’affichage. Evénement Quit Description Syntaxe Eléments Survient lorsque la méthode Quit est appelée. Private Sub objet_Quit (Annuler As Boolean) objet Requis. Objet WebClient. Annuler Valeur booléenne que le conteneur peut définir par True pour annuler l’opération Quit ou par False pour autoriser à poursuivre. Voir aussi « Evénement Quit ». 88 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés Evénement StateChange Description Syntaxe Eléments Survient lorsque l’état du contrôle change. Private Sub objet_StateChange (Etat As Integer) objet Requis. Objet WebClient. Etat Nouvel état du contrôle. Constante STATE_STOPPED Valeu r 0 Description Le contrôle est inactif. Aucune connexion n’est établie. 1 Le contrôle tente d’établir la connexion au serveur. STATE_STARTING 2 Une connexion est établie et les données initiales sont extraites. STATE_RUNNING 3 La connexion est établie et le contrôle est actif. STATE_STOPPING 4 Le contrôle tente de déconnecter le serveur courant. Evénement StatusChange Description Syntaxe Eléments Survient lorsque l’état du contrôle change. Private Sub objet_StatusChange (ByVal Etat As String) objet Requis. Objet WebClient. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 89 Propriétés du contrôle ActiveX WebClient STATE_CONNECTING 8 • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Etat Chaîne contenant le texte du nouvel état de WebClient. Les chaînes d’état sont les suivantes : Connexion à <nom de serveur> Connecté à <nom de serveur> Obtention du fichier de démarrage (x sur y) : nom de fichier où x représente un compteur à incrémentation et y le nombre total de fichiers de démarrage en cours de transfert Obtention du fichier : <nom de fichier> Exécution Déconnexion du serveur Non connecté Voir également « Propriété Status ». Evénement Stop Description Syntaxe Eléments Survient avant que WebClient ne traite la méthode Stop. Private Sub objet_Stop (Annuler As Boolean) objet Requis. Objet WebClient. Annuler Valeur booléenne que le conteneur peut définir par True pour annuler l’opération d’arrêt Stop ou par False pour autoriser à poursuivre. Voir également « Evénement Stop ». Evénement TitleChange Description Syntaxe Eléments Survient lorsque le texte du titre de la fenêtre de contrôle change ou devient accessible. Private Sub objet_TitleChange (ByVal Titre As String) objet Requis. Objet WebClient. Titre Chaîne contenant le nouveau titre de la fenêtre du contrôle. Voir aussi « Propriété WindowTitle ». 90 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés Méthodes Méthode ClearCache Description Supprime les fichiers et les répertoires de la mémoire cache par défaut. Remarque : vous ne pouvez pas utiliser cette méthode lorsque vous êtes connecté à un serveur. Syntaxe objet.ClearCache Invite Eléments objet Requis. Objet WebClient. Invite Requis. Valeur booléenne indiquant si le contrôle doit inviter à supprimer le cache. Si la valeur spécifiée est True, le contrôle affiche un message Oui/Non demandant si le cache doit être effacé ; si False est spécifié, le cache est immédiatement effacé. 8 Voir aussi « Propriété CacheDirectory ». Description Syntaxe Eléments Permet de naviguer (i.e. connecte) jusqu’au serveur identifié par l’URL. En cas de connexion active lors de l’appel de cette méthode, cette connexion est fermée. objet.Navigate URL objet Requis. Objet WebClient. URL Chaîne donnant comme résultat l’URL de la ressource à afficher. Le format de l’URL pour Graph est le suivant : [NomHôte] [:Service] Nom Hôte est le nom ou l’adresse IP d’une machine exécutant les processus du serveur WebClient. Service Facultatif. Numéro de port défini dans le fichier hôte du système. Voir aussi « Evénement NavigateComplete », « Méthode Navigate ». FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 91 Propriétés du contrôle ActiveX WebClient Méthode Navigate • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • Méthode Quit Description Syntaxe Eléments Arrête toute communication et déconnecte du serveur. objet.Quit objet Requis. Objet WebClient. Voir aussi « Méthode Refresh2 », « Méthode Navigate ». Méthode Refresh Description Syntaxe Eléments Redessine le contenu du dessin courant. objet.Refresh objet Requis. Objet WebClient. Voir aussi « Méthode Refresh2 », « Evénement Stop ». Méthode Refresh2 Description Redessine le contenu du dessin courant. Contrairement à la méthode Refresh, la présente méthode contient un paramètre spécifiant le niveau de rafraîchissement. Syntaxe objet.Refresh2 [Niveau] Eléments objet Requis. Objet WebClient. Niveau Facultatif. Constante ou valeur indiquant le niveau de rafraîchissement. Elle peut prendre l’une des valeurs suivantes : Constante Vale ur Description REFRESH_NORMAL 0 Rend la fenêtre indisponible pour la redessiner. Redémarre l’horloge de la base de données temps réel si elle s’est arrêtée. REFRESH_RESTART 1 Rétablit la connexion au serveur et exécute les actions REFRESH_NORMAL. Voir aussi « Evénement Stop », « Méthode Refresh ». 92 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT Propriétés Méthode Stop Description Syntaxe Eléments Arrête la mise à jour du dessin ou une opération de navigation Navigate interne à un processus. objet.Stop objet Requis. Objet WebClient. Voir aussi « Méthode Refresh », « Méthode Navigate ». 8 Propriétés du contrôle ActiveX WebClient FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 93 • PROPRIÉTÉS DU CONTRÔLE ACTIVEX WEBCLIENT • Propriétés • • 94 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient • • • • Chapitre 9 Nombre de tags WebClient minimal VUE D ’ ENSEMBLE Le présent chapitre répertorie l’ensemble de tags minimal devant être configuré pour écriture par un client autorisé en affichage seul afin de garantir une bonne exploitation des fonctionnalités. Table 9-1 Nombre de tags WebClient minimal ID de tag Domain e Type Description/Valeurs FLOPERATOR_U USER MESSAGE Opérateur de l’application. FLSECEVENT_U USER MESSAGE Evénement de sécurité de l’application. FLSECEVENTUSER_U USER MESSAGE Nom d’utilisateur pour un événement de sécurité de l’application. GRAPHCONNTYPE USER ANALOG Connexion de la tâche Graph et type de sécurité. GRAPHMBX_U USER MAILBOX Mailbox d’entrée de la tâche Graphique. USER MAILBOX Mailbox d’entrée de la tâche Graphique SPC. SPRGMBX_U USER MAILBOX Mailbox d’entrée de la tâche Graphique SPR. TASKSTART_U[ ] USER DIGITAL Déclencheur de démarrage de la tâche Utilisateur. TASKSTATUS_U[ ] USER DIGITAL Valeur d’état de la tâche Utilisateur. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 95 Nombre de tags WebClient minimal SPCGMBX_U 9 • NOMBRE DE TAGS WEBCLIENT MINIMAL • Vue d’ensemble • • Table 9-1 Nombre de tags WebClient minimal ID de tag Domain e Type Description/Valeurs TASKMESSAGE_U[ ] USER MESSAGE Message de la tâche Utilisateur. TASKDSTATUS_U[ ] USER MESSAGE Message d’affichage d’état de la tâche Utilisateur. TOPWINDOW_U USER MESSAGE Nom de fenêtre d’avant-plan en cours. TRENDMBX_U USER MAILBOX 96 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient Boîte aux lettres de données de tendances. • • • • Chapitre 10 Les commutateurs de ligne de commande permettent de modifier le mode de fonctionnement de WebClient. Ces commutateurs sont répartis en trois catégories : • Commutateurs de la tâche du serveur de connexion • Commutateurs de la tâche du serveur de données • Commutateurs de la tâche Graphique ou de WebClient Vous trouverez dans les paragraphes ci-dessous la syntaxe et les arguments des commutateurs, ainsi que des exemples de configuration des commutateurs en vue de l’historisation des erreurs. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 97 10 Commutateurs de ligne de commande WebClient Commutateurs de ligne de commande WebClient • COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT • Vue d’ensemble • • VUE D ’ ENSEMBLE Les commutateurs de la tâche Graphique sont spécifiés côté client dans la boîte de dialogue Propriétés WebClient ou à l’aide de GRAPHSET.EXE pour la tâche Graphique en mode autonome. Ces paramètres s’ajoutent à tout commutateur défini pour la tâche GRAPH dans le panneau Informations de configuration système FactoryLink. Les commutateurs du serveur de connexion et du serveur de données sont spécifiés dans la colonne Arguments de programme du panneau Informations de configuration système dans le gestionnaire de configuration FactoryLink. Deux commutateurs de ligne de commande primaires activent l’historisation pour les tâches WebClient. D’autres commutateurs contrôlent le mode de gestion du fichier journal et déterminent si les informations consignées incluent l’horodatage. Les informations liées à la connexion et à la déconnexion de nœuds distants, aux transferts de fichiers, aux données de tâche, etc., peuvent être capturées et affichées à votre intention ou enregistrées dans un fichier journal. Vous pouvez vous intéresser à un aspect particulier d’une opération WebClient en spécifiant une rubrique. Les rubriques disponibles incluent le fournisseur de service, la connexion/déconnexion, le service de données, le service de transfert de fichier, le service de noyau, les services réseau, les appels de procédures distants, les instances USER et les couches tâche. Vous pouvez également spécifier le niveau de détail de l’historisation des données. Cinq niveaux de détail différents sont disponibles, depuis les messages d’erreur simples aux captures de données complètes. Commutateurs de ligne de commande du serveur de connexion Les commutateurs sont spécifiés dans la colonne Arguments de programme du panneau Informations de configuration système dans le gestionnaire de configuration FactoryLink. Les paragraphes ci-dessous décrivent la fonction et la syntaxe des commutateurs de ligne de commande du serveur de connexion. Les commutateurs de ligne de commande ne font pas la distinction entre majuscules et minuscules. 98 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT Vue d’ensemble Active l’historisation des informations liées à la rubrique <X>. -i<n> Définit le temps d’inactivité maximal d’une connexion par <n> secondes. Cette valeur spécifie l’intervalle maximal pendant lequel les tâches du serveur de connexion ou du serveur de données attendent avant de fermer une connexion inactive. Par défaut, ce délai est de 180 secondes. -l Ecrit les informations d’historisation dans le fichier journal. -m<n> Définit l’intervalle maximal pour un seul transfert de données, où <n> correspond au nombre de secondes maximal. Par défaut, le délai est de 5 secondes. -n<n> Définit le nombre maximal de sessions ou connexions WebClient. Par défaut, ce nombre est de 32. -r<n> Période de réitération. Ce paramètre définit l’intervalle de temps maximal (en secondes) pendant lequel le contrôle ActiveX WebClient tente d’établir la connexion au serveur. Par défaut, cet intervalle est de 15 secondes. Si votre connexion distante est lente et que vous connaissez des problèmes de connexion, vous pouvez essayer d’augmenter cette valeur. -v Insère un horodatage dans chaque message. -w<#> Boucle le fichier journal tous les <#> messages. -y<#> Ferme et rouvre le fichier journal tous les <#> messages. Rubriques de mise au point du serveur de connexion Le commutateur -d peut être configuré de façon à traiter des rubriques particulières. Pour cela, vous devez ajouter les paramètres de rubrique suivants : C N<a|…|z><#> Connexion/déconnexion -nom de nœud distant/adresse, sécurité, refus. Mise au point de la couche NSI (actuellement, rubrique située au niveau de la couche tâche). Vous pouvez également spécifier une rubrique dans la couche NSI à l’aide de la lettre suivant le N. O Mise au point de la couche classe NSI (actuellement, rubrique également située au niveau de la couche tâche). R Mise au point de l’appel de procédure distant (RPC)/couche réseau. U Instance utilisateur (disponibilité, connexion, sortie de la notification, lancement de RUNMGR). Les autres lettres n’ont pas été définies et n’ont pas de signification particulière. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 99 10 Commutateurs de ligne de commande WebClient -d<X> • COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT • Vue d’ensemble • • Commutateurs de ligne de commande du serveur de données Les commutateurs sont spécifiés dans la colonne Arguments de programme du panneau Informations de configuration système dans le gestionnaire de configuration FactoryLink. Chaque commutateur de ligne de commande commence par un trait d’union suivi d’un indicateur (différents indicateurs fournis ci-dessous), suivi ensuite directement de la chaîne ou du numéro (pas d’espace de séparation). Les options sont spécifiées dans la colonne Arguments de programme du panneau Informations de configuration système dans le gestionnaire de configuration FactoryLink. -b<n> Définit la taille de la zone tampon de réception et d’envoi du socket TCP/IP par <n> octets (par défaut : 16 Ko). -d<X> Active l’historisation des informations relatives à la rubrique <X>. -i<n> -l Définit le temps d’inactivité maximal d’une connexion par <n> secondes. Cette valeur spécifie l’intervalle maximal pendant lequel les tâches du serveur de connexion ou du serveur de données attendent avant de fermer une connexion inactive. Par défaut, ce délai est de 180 secondes. Ecrit les informations d’historisation dans le fichier journal. -m<n> Définit l’intervalle maximal pour un seul transfert de données, où <n> correspond au nombre de secondes maximal. Par défaut, le délai est de 5 secondes. -n<n> Définit le nombre maximal de sessions ou connexions WebClient. Par défaut, ce nombre est de 32. -t<n> Définit le délai d’attente maximal de sortie des tâches distantes lors de l’arrêt, où <n> représente l’intervalle en secondes. -v Insère un horodatage dans chaque message. -w<#> Boucle le fichier journal tous les <#> messages. -y<#> Ferme et rouvre le fichier journal tous les <#> messages. 100 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT Vue d’ensemble Rubriques de mise au point du serveur de données B Fournisseur de service. C Connexion/déconnexion -nom de nœud distant/adresse, sécurité, refus. D Service de données (appels RPC incluant le nom de service et de fonction et les valeurs retournées ; spécifique de la tâche du serveur de données et de la tâche Graphique distante). K Service de noyau (spécifique de la tâche du serveur de données et de la tâche Graphique distante). N Mise au point de la couche réseau NSI O Mise au point de la couche classe NSI (actuellement, rubrique également située au niveau de la couche tâche). R Mise au point de l’appel de procédure distant (RPC)/couche réseau. U Instance utilisateur (disponibilité, connexion, sortie de la notification, lancement de RUNMGR). T Couche tâche (initialisation de la boîte aux lettres IPC, services réseau, chargement Ct, arrêt, etc.). Les autres lettres n’ont pas été définies et n’ont pas de signification particulière. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 101 10 Commutateurs de ligne de commande WebClient Le commutateur -d peut être configuré de façon à traiter des rubriques particulières. Pour cela, vous devez ajouter les paramètres de rubrique suivants : • COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT • Vue d’ensemble • • Pour chaque rubrique, des niveaux sont définis. En règle générale, les niveaux d’historisation suivants sont associés aux niveaux de chaque rubrique : 1 Erreurs 2 Avertissements 3 Appels de fonction 4 Codes retour 5 Vidage de paramètres Le niveau 1 de la rubrique C correspond à l’exception qui historise également les informations de connexion applicables telles que le nom de nœud distant, le numéro de port, la sécurité, l’aboutissement ou l’échec de la connexion ainsi que le motif de l’échec (par exemple, toutes les données de serveur sont en cours d’utilisation, l’hôte n’est pas accessible, le numéro de port est erroné). Normalement, les fichiers journaux des tâches du serveur de données et du serveur de connexion sont ouverts en mode ajout, sauf si le commutateur -w<#> a été spécifié. Si tel est le cas, les fichiers journaux ne sont pas ajoutés. 102 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT Commutateurs de ligne de commande de la tâche Graphique C OMMUTATEURS DE LIGNE DE COMMANDE DE LA TÂCHE G RAPHIQUE Commutateurs de réseau Remarque : les commutateurs de ligne de commande pour la tâche Graphique doivent être précédés du commutateur -n, saisis en minuscules et séparés par des virgules sans espace. Il est recommandé de ne pas utiliser les commutateurs de réseau suivants en conditions normales : -b<n> Définit la taille de la zone tampon de réception et d’envoi du socket TCP/IP par <n> kilo-octets (Ko). La taille par défaut est de 16 Ko. -d<X> Affiche les informations d’historisation relatives à la rubrique <X> dans une fenêtre séparée. -l Ecrit les informations d’historisation dans le fichier journal. -m<n> Définit l’intervalle maximal pour un seul transfert de données, où <n> correspond au nombre de secondes maximal. Par défaut, le délai est de 5 secondes. -n<n> Définit le nombre maximal de sessions ou connexions WebClient. Par défaut, ce nombre est de 32. -r<n> Période de réitération. Ce paramètre définit l’intervalle de temps maximal (en secondes) pendant lequel le contrôle ActiveX WebClient tente d’établir la connexion au serveur. Par défaut, cet intervalle est de 15 secondes. Si votre connexion distante est lente et que vous connaissez des problèmes de connexion, vous pouvez essayer d’augmenter cette valeur. -v Insère un horodatage dans chaque message. Le commutateur -d peut être configuré de façon à traiter des rubriques particulières. Pour cela, vous devez ajouter les paramètres de rubrique suivants : C Connexion/déconnexion -nom de nœud distant/adresse, sécurité, refus. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 103 10 Commutateurs de ligne de commande WebClient Certains commutateurs de ligne de commande permettent de configurer le mode de fonctionnement de la tâche Graphique WebClient distante sur le client ; ils s’ajoutent aux commutateurs définis pour la tâche GRAPH dans le panneau Informations de configuration système FactoryLink. La boîte de dialogue des propriétés WebClient permet d’activer ces commutateurs. Pour plus d’informations, reportez-vous à la section « Exécution de WebClient » page 39. • COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT • Configurations exemple • • F Service de transfert de fichiers (spécifique de la tâche du serveur de données et de la tâche Graphique distante). K Service de noyau (spécifique de la tâche du serveur de données et de la tâche Graphique distante). N<a|…|z><#> Mise au point de la couche NSI (actuellement, rubrique située au niveau de la couche tâche). Vous pouvez également spécifier une rubrique dans la couche NSI à l’aide de la lettre suivant le N. O Mise au point de la couche classe NSI (actuellement, rubrique également située au niveau de la couche tâche). R Mise au point de l’appel de procédure distant (RPC)/couche réseau. Commutateurs de la tâche Graphique Les commutateurs de ligne de commande ci-dessous sont liés spécifiquement à la tâche Graphique et contrôlent son mode d’exécution. Pour plus d’informations, reportez-vous au manuel Principes de base de FactoryLink. -o1 C ONFIGURATIONS Commutateurs d’exploitation graphiques. Redessine les objets statiques. (Lettre “o”). -P Redessine les symboles de l’arrière-plan. -T Utilise la valeur animée de l’objet. EXEMPLE Serveur de connexion -dc1 -l -v Ce commutateur de mise au point est l’un des plus utiles au niveau du serveur de connexion. Il permet d’historiser la version des serveurs de connexion et de données, le nombre de connexions autorisées, les demandes de connexion à partir de chaque hôte, la sécurité hôte, l’aboutissement ou l’échec de la connexion et le motif de l’échec (par exemple, aucun privilège d’accès n’est défini pour l’hôte, aucun serveur n’est disponible, le nombre de connexions total a été dépassé, la version est incompatible). 104 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT Configurations exemple -dr2 -l -dt2 -l Autre commutateur utile pour l’historisation des erreurs spécifiques de la tâche. Il permet d’historiser les erreurs et les avertissements associés au chargement des fichiers CT, aux tags de boîte aux lettres manquants, aux erreurs de lecture de boîte aux lettres, aux erreurs d’initialisation et aux erreurs d’arrêt de tâche. -dN1 -l Utile pour l’historisation de toutes les erreurs de couche réseau (NSI). Ce commutateur fournit des informations détaillées lorsque les commutateurs précédents n’ont pas permis de diagnostiquer le problème. Il se peut que vous ayez besoin d’une combinaison de commutateurs adaptée à vos besoins, telle que : -dc1 -dt2 -l -v -dc1 -dr2 -l -v -dc1 -dt2 -dr2 -l -v0 Attention : même si vous pouvez spécifier un niveau de détail compris entre 1 et 5, nous vous recommandons de spécifier un niveau compris entre 1 et 3. En effet, l’utilisation de niveaux d’historisation plus élevés entraîne la génération d’un plus grand nombre de messages et éventuellement l’occupation de la totalité de l’espace disque disponible. Cela s’applique tout particulièrement lorsque la rubrique R est spécifiée. Serveur de données -dc1 -l -v Historise les erreurs survenues durant la connexion à la tâche GRAPH distante. Ces informations comprennent la demande de connexion depuis l’hôte, la sécurité de l’hôte, l’aboutissement ou l’échec de la connexion et le motif de l’échec (par exemple, aucun accès n’est défini pour l’hôte, la version est incompatible), la déconnexion de la session, le time-out de la session et l’échec du socket d’écoute. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 105 10 Commutateurs de ligne de commande WebClient Utile pour l’historisation des messages d’erreur réseau. Ce commutateur permet d’historiser les erreurs et les avertissements comprenant les erreurs d’envoi et de réception de messages réseau, les erreurs d’informations d’en-tête de message, les erreurs de signature, les erreurs d’importation et d’exportation de messages, la non correspondance des types de messages et les erreurs liées aux session nulles. • COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT • Configurations exemple • • -dd2 -l Historise les erreurs et les avertissements comprenant le groupement et le dégroupement des messages RPC, l’envoi de messages RPC inconnus et les échecs RPC. Tout échec RPC est historisé avec le nom de service (service de données, de fichiers ou de noyau), le nom RPC, la chaîne d’erreur et le nom de l’hôte. -dk2 -l Historise les erreurs et les avertissements pour les services de noyau. Elles comprennent les erreurs de création d’une session noyau, la signature d’utilisateur incorrecte et l’échec d’appels de noyau. Tout échec d’appel de noyau est historisé avec le numéro de l’erreur FactoryLink retourné par Fl_errno( ). -df2 -l Historise les erreurs et les avertissements pour le service de fichiers. Elles comprennent la signature d’utilisateur incorrecte et les échecs d’opérations de fichiers. Tout échec de demande de service de fichiers est historisé avec le nom RPC et la chaîne d’erreur, ce qui inclut les erreurs résultant de l’échec de l’ouverture, de l’accès et de la lecture de fichier, de la vérification du chemin d’accès au fichier et des allocations de tampon en lecture. Historise le nom de fichier et le message d’erreur système résultant de l’un des échecs énumérés ci-dessus. -dr2 -l Commutateur utile dans le cas des messages d’erreur réseau. Permet d’historiser les erreurs et les avertissements comprenant les erreurs d’envoi et de réception de messages réseau, les erreurs d’informations d’en-tête de message, les erreurs de signature, les erreurs d’importation et d’exportation de messages, la non correspondance des types de messages et les erreurs liées aux session nulles. -dt2 -l Commutateur utile pour l’historisation des erreurs spécifiques de la tâche. Il permet d’historiser les erreurs et les avertissements associés au chargement des fichiers CT, aux tags de boîte aux lettres manquants, aux erreurs de lecture de boîte aux lettres, aux erreurs d’initialisation et aux erreurs d’arrêt de tâche. -dN1 -l Utile pour l’historisation de toutes les erreurs de couche réseau (NSI). Ce commutateur fournit des informations détaillées lorsque les commutateurs précédents n’ont pas permis de diagnostiquer le problème. 106 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT Configurations exemple Il se peut que vous ayez besoin d’une combinaison de commutateurs adaptée à vos besoins, telle que : 10 -dd2 -dt2 -l -v -dt2 -dd2 -df2 -l -v -dc1 -dd2 -dn1 -l -v Tâche Graph distante : Remarque : les commutateurs de ligne de commande pour la tâche Graph distante doivent commencer par -n, suivi de commutateurs séparés par une virgule. -dc1,-l,-v Historise les erreurs durant la connexion aux serveurs de connexion et de données. Ces informations comprennent la demande de connexion depuis l’hôte, l’aboutissement ou l’échec de la connexion et le motif de l’échec (par exemple, aucun accès n’est défini pour l’hôte, la version est incompatible), la déconnexion de la session, le time-out de la session et l’échec du socket d’écoute. -dd2,-l Historise les erreurs et les avertissements comprenant le groupement et le dégroupement des messages de données RPC, les échecs RPC et les échecs d’envoi RPC. Tout échec RPC est historisé avec le nom de service (service de données, de fichiers ou de noyau), le nom RPC (appel de fonction courant), la chaîne d’erreur et le code d’erreur. -dr2,-l Utile pour l’historisation des messages d’erreur réseau. Ce commutateur permet d’historiser les erreurs et les avertissements comprenant les erreurs d’envoi et de réception de messages réseau, les erreurs d’informations d’en-tête de message, les erreurs de signature, les erreurs d’importation et d’exportation de messages, la non correspondance des types de messages et les erreurs liées aux session nulles. -dN1,-l Utile pour l’historisation de toutes les erreurs de couche réseau (NSI). Ce commutateur fournit des informations détaillées lorsque les commutateurs précédents n’ont pas permis de diagnostiquer le problème. FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient / 107 Commutateurs de ligne de commande WebClient -dd2 -dk2 -l -v • COMMUTATEURS DE LIGNE DE COMMANDE WEBCLIENT • Configurations exemple • • Il se peut que vous ayez besoin d’une combinaison de commutateurs adaptée à vos besoins, telle que : -n-dd2,-dc1,-l,-v -n-dd2,-l,-v -n-dC2,-dd2,-l,-v -n-dc1,-dd2,-dn1,-l,-v 108 / FactoryLink 6.5.0 / Guide de l’utilisateur de WebClient Index A Accès à un nœud 15 défini par l’utilisateur, création 34 limitation 33 refusé par défaut 26 Adresse IP, définition de WCPING 69 Affichage seul association avec un nœud spécifique 28 défini par défaut 26 définition 31 description 14 Alias 35 Application FactoryLink 43 Applications FactoryLink 51–52, 54, 56 multiples 35 B Boîte de dialogue Graphics Setup 49 C Client installation 17 spécialisé 47 Commutateurs de ligne de commande 97 configurations exemple 104 serveur de connexion 98 serveur de données 100 tâche Graphique 103 Configuration 20 Configuration de réseau 34 Connexions 14 Connexions WebClient 33–34 Contrôle ActiveX, événements BeforeNavigate 85 DrawingChange 86 Error 86 NavigateComplete 87 NetworkError 87 Quit 88 StateChange 89 StatusChange 89 Stop 90 TitleChange 90 Contrôle ActiveX, méthodes 91 ClearCache 91 Navigate 91 Quit 92 Refresh 92 Refresh2 92 Stop 93 Contrôle ActiveX, propriété AccessSecurityName 79 Busy 79 CacheDirectory 80 Connected 80 ConnectType 80 DrawingName 81 GraphParameters 81 Index I-109 Height 81 HWND 82 Left 82 LocationName 82 LocationURL 82 Name 83 Port 83 Rate 83 Status 83 Top 84 UserMenuEnabled 84 Visible 84 WindowTitle 85 Contrôle total association à un nœud spécifique 29 défini par défaut 26 définition 31 description 15 Contrôles WebClient 44 Contrôles WebClient multiples 55 cv 20 CV_WCAPP.EXE 75 D Débit 46, 49 Définition par l’utilisateur, description 15 Dépannage 66 E Effacer le cache-mémoire 46 Ensemble de tags minimal 32 Evénement BeforeNavigate 85 DrawingChange 86 Error 86 NavigateComplete 87 I-110 FactoryLink 6.5.0 NetworkError 87 Quit 88 StateChange 89 StatusChange 89 Stop 90 TitleChange 90 Exemples de configuration 33 F Fichier de services 21, 26, 34 format 35 TCP/IP 21, 26, 34 Fichier de services TCP/IP 34 Firewalls 67 FLCONNSRVC 25 FLCONV 20 FLCONV.BAT 75 FLOPERATOR_U 95 FLSECEVENT_U 95 FLSECEVENTUSER_U 95 G Générateur de rapports 54 Gestionnaire d’impression FactoryLink 54 Gestionnaire de configuration 21, 24, 33, 53, 98 Gestionnaire de fichiers FactoryLink 54 GRAPH 47, 98 GRAPHCONNTYPE 52, 95 GRAPHMBX_U 95 GRAPHSET 48–49 GRAPHSET.EXE 98 H Historisation des données 98 HTML 55, 67, 77 pages de démarrage 40 pages exemple 78 I Informations à l’intention des utilisateurs expérimentés 36 Installation côté client 17 côté serveur 17 Internet Explorer 18 navigateur 18 Instances utilisateur 21 Internet Explorer 17, 41, 47, 53, 55, 66 configuration de la sécurité 66 Introduction 13 L Liste d’accès aux nœuds WebClient 28, 33–34 Liste des éléments du domaine 21 M Messages d’erreur 70 Méthode ClearCache 91 Navigate 91 Quit 92 Refresh 92 Refresh2 92 Stop 93 Méthodes, contrôle ActiveX 91 Moniteur d’exploitation 55 MSIE302M95 18 MSIE302MNT 18 N Navigateur, installation 18 Nœud définition 28 refus d’accès 28 Nom 25 Nombre maximal de connexions 25 Noms de nœuds distants 28 O OLE 54 Opérations de base de données 54 Options 14 P Page de démarrage 40, 66 HTML 66 Panneau 25 Panneau de sécurité de nœud WebClient 26 Paramètres graphiques 49 Performance 56 Période de réitération 99 Persistance 54 Port 46, 49 fichier de services 35 spécification de WCPING 69 Power VB 53 Propriété AccessSecurityName 79 Busy 79 CacheDirectory 80 Connected 80 ConnectType 80 DrawingName 81 Error 81 Index I-111 GraphParameters 81 Height 81 HWND 82 Left 82 Location URL 82 LocationName 82 Name 83 Rate 83 Status 83 Top 84 UserMenuEnable 84 Visible 84 Width 85 WindowTitle 85 Propriétés, contrôle ActiveX Error 81 Width 85 R Répertoire cache 45 Répertoire cache-mémoire 49 RTMON 55 Rubriques de mise au point 99 S Sécurité 55 Sécurité d’accès par défaut 33 Serveur de connexion 35, 70, 74, 97 Serveur de données 35, 70, 74, 97 Services WebClient 24 SPCGMBX_U 95 SPRGMBX_U 95 Suppression du cache 48 I-112 FactoryLink 6.5.0 T Tags 51, 56, 95 TASKDSTATUS_U 96 TASKMESSAGE_U 96 TASKSTART_U 95 TASKSTATUS_U 95 TOPWINDOW_U 96 TRENDMBX_U 96 Types d’accès affichage seul par défaut 26 contrôle total par défaut 26 création d’accès personnalisé 34 défini par l’utilisateur par défaut 26 défini par l’utilisateur pour un nœud spécifique 29 par défaut 26 personnalisé par défaut 26 personnalisé, pour un nœud spécifique 29 V VBScript 67, 78 VisualBasic 37 W WCCONST.BAS 37 WCPING 69 WEBCLIENT 17 WebClient, liste des tags d’accès en écriture 32, 52 WEBCLIENT.EXE 37 WEBCLIENT.OCX 37 WEBFILES.LST 36, 53 Windows 95 18, 34 Windows NT 18, 34, 55