Guide d'installation de NiceLabel Web Printing Rev-2019-11 ©NiceLabel 2019. www.nicelabel.fr 1 Contenu 1 Contenu 2 Architecture 2.1 Déploiement 2 4 4 2.1.1 Présentation 4 2.1.2 Scénarios d'installation 4 2.1.3 Suggestions sur la sécurité 5 2.2 Présentation 3 Listes de contrôle 9 10 3.1 Liste de contrôle avant installation 10 3.2 Liste de contrôle après installation 10 4 Spécifications système requises 5 Prérequis pour l'installation de Windows Server 13 14 5.1 Installation du serveur Web IIS 14 5.2 Configuration de Microsoft SQL Server 19 6 Installation du logiciel 24 6.1 Installation des composants du serveur 24 6.1.1 Installation du site Web Printing 24 6.1.2 Installation du site Web Printing en HTTPS/SSL 27 6.1.3 Installer les paramètres de ligne de commande 30 6.2 Installation de NiceLabel Web Client 31 6.2.1 Installation du Client Web pour l'utilisateur connecté (option par défaut) 31 6.2.2 Installation du Client Web pour tous les utilisateurs 33 6.3 Mettre à jour d'une version précédente 34 6.3.1 Mise à jour des composants du serveur 34 6.3.2 Mise à jour des composants du client 34 7 Licences 7.1 Limiter le nombre d'imprimantes autorisé pour les applications Web 35 35 8 Ajustage du logiciel 37 8.1 Personnalisation 37 8.1.1 Personnaliser la page de connexion www.nicelabel.fr 37 2 8.1.2 Personnalisation de la page Web Printing 37 8.1.3 Remplacer les connexions aux bases de données dans les applications Web partagées 38 8.2 Initialisation de la solution 39 8.2.1 Valeurs variables de départ liées à l'utilisateur 39 8.2.2 Initialisation des valeurs variables via une chaîne de requête de page Web. 39 8.3 Ouvrir le Client Web avec plusieurs applications partagées 40 8.4 Ouvrir des applications avec des valeurs prédéfinies 41 8.5 Modes d'ouverture de solution 41 9 Mode hors ligne 43 9.1 Activation du mode hors-ligne. 43 9.2 Changer la période de temps hors-ligne. 43 10 Authentification 45 10.1 Authentification par jeton 45 10.2 Authentification par formulaire 46 10.3 Authentification Windows 47 11 Problèmes 12 Support 50 51 12.1 Support en ligne 51 12.2 Demander une assistance technique 51 www.nicelabel.fr 3 2 Architecture 2.1 Déploiement 2.1.1 Présentation Le rôle de Control Center consiste à définir les utilisateurs Web Printing et à héberger leurs fichiers de solution. CONSEIL : Dans NiceLabel 2019, les fichiers de solution (avec extension .nsln) sont utilisés avec des étiquettes et/ou des formulaires. Des fichiers d'étiquettes seuls peuvent aussi être utilisés comme solution sans créer de formulaire. Dans ce cas, une boîte de dialogue Imprimer prédéfinie est utilisée pour l'impression d'étiquettes. Quand un utilisateur Web Printing se connecte au serveur, l'application (solution) démarre en utilisant l'application Web Client de NiceLabel. En principe, l'utilisateur Web Printing imprime des étiquettes contenant des données variables. Le modèle de l'étiquette sélectionnée prend les données fournies et les affiche dans l'aperçu du formulaire. Les étiquettes s'impriment avec les données sélectionnées. Les données proviennent habituellement d'une base de données Microsoft SQL hébergée dans l'informatique de l'entreprise. NOTE: Les sources de données ne sont pas limitées à SQL. Les données peuvent être mémorisées dans tous types de bases de données relationnelles. L'application exécutée sur le Client Web ne communique pas directement avec la base de données. Toutes les communications sont canalisées par le site Web Printing. Quand un enregistrement d'une base de données est requis, les applications envoient une requête au site Web Printing, qui la redirige vers le serveur de la base de données. La réponse repart en sens inverse. De la même manière, le site Web Printing enregistre les événements d'impression et mémorise les données dans la base de données. NOTE: Web Printing peut accéder aux bases de données en 32 bits même si le site Web Printing est exécuté en 64 bits. Web Printing fonctionne avec des bases de données en 32 bits via un service proxy de Web Printing. 2.1.2 Scénarios D'installation Suivant l'architecture de la solution et le matériel utilisé, les composants du serveur (NiceLabel Control Center, le site Web Printing et Microsoft SQL Server) peuvent être installés sur un seul ordinateur ou sur un système distinct. Ces deux options dépendent d'un certain nombre de facteurs : www.nicelabel.fr 4 l l l l l l Est-il possible d'installer l'application Web Printing dans l'infrastructure informatique de l'entreprise ? Si les règles de sécurité de l'entreprise empêchent de l'installer en local, Web Printing sera hébergé hors du réseau de l'entreprise. Dans ce cas, les bases de données concernées (celles qui servent à l'impression des étiquettes) sont copiées aussi dans l'environnement de l'hébergement. Est-ce que l'infrastructure de l'entreprise permet d'installer des composants serveur sur des serveurs dédiés ? Quels sont les utilisateurs Web Printing qui sont connectés au serveur ? Peut-on faire confiance aux utilisateurs par défaut (ex. : sont-ils utilisateurs du domaine ou personnel de l'entreprise) ou y a-t-il des personnes externes se connectant au serveur par Internet ? Est-ce que le Microsoft SQL Server existant est utilisable pour les données de Web Printing ou faut-il en installer un nouveau ? Est-ce que Web Printing va se connecter à la base de données de l'entreprise ? Si ce n'est pas le cas, les données existantes doivent être transférées sur un serveur Microsoft SQL dédié. Il faudra vérifier la synchronisation des bases de données. Est-ce que Web Printing est utilisé comme une application autonome avec son propre système de connexion, ou y a-t-il une autre application pour contrôler la connexion et intégrer Web Printing dans une page Web existante ? 2.1.3 Suggestions Sur La Sécurité Cet article donne des recommandations sur la manière de protéger les utilisateurs connectés et l'intégrité des données et de l'infrastructure. Dans la plupart des cas, le site Web Printing autorisera des utilisateurs externes à se connecter et imprimer des étiquettes, il sera donc exposé à Internet. Il ne faut révéler aucune information confidentielle à des personnes indésirables. La sécurité étant considérée comme la priorité la plus élevée, l'application doit être fiable et sérieuse, minimisant les risques d'atteinte à la sécurité. Le site Web Printing crypte les données de configuration importantes sur le disque et sécurise la communication avec les applications tournant dans l'explorateur. www.nicelabel.fr 5 Cependant, si la manière dont le produit Web Printing est développé et testé est importante, la manière de l'installer et de le mettre en action l'est aussi. Les bonnes pratiques de sécurité : l l l Installer régulièrement les mises à jour de sécurité de Microsoft Windows Update. Les mises à jour de l'IIS sont particulièrement importantes, puisque le site Web Printing est exposé à Internet. Paramétrer un pare-feu ou un proxy. N'ouvrir que les services et les ports qui doivent être ouverts au public comme le port 80 pour IIS. Limiter les droits d'accès au Stockage de documents. C'est un référentiel de fichier basé sur WebDAV qui tourne sur le même serveur que NiceLabel Control Center. Il héberge les fichiers de solution. Par défaut, tout le monde peut accéder au serveur de stockage sous \\server@8080\DavWWWRoot l l l l Installer le site Web Printing en DMZ (zone démilitarisée). Minimiser les dommages en cas de serveur compromis. Limiter les autorisations de l'utilisateur SQL. Le compte utilisateur de Microsoft SQL Server que le site Web Printing va utiliser pour se connecter à la base de données doit avoir uniquement accès à la base de données du Control Center (NiceAN par défaut). Si quelqu'un a accès à Microsoft SQL Server, il est limité à la base de données et les autres parties du Microsoft SQL Server ne sont pas accessibles avec ces droits d'utilisateur. Activer une authentification de l'utilisateur pour NiceLabel Control Center. Permettre seulement la connexion des administrateurs de confiance. Par défaut, toutes les personnes ayant des droits d'administrateur y ont accès. Paramétrer le site Web Printing pour qu'il ne soit accessible que par un lien sécurisé. Activer le protocole HTTPS/SSL pour que personne ne puisse écouter la communication entre l'utilisateur et le serveur. Pour plus de détails, voir le chapitre Installation du site Web Printing avec HTTPS/SSL. SCÉNARIO www.nicelabel.fr DESCRIPTION 6 Tous les composants du serveur sont installés sur un même serveur. Dans ce cas : l Soit il faut faire complètement confiance aux utilisateurs connectés. Le logiciel est installé dans le système informatique de l'entreprise – peut-être même sur le serveur Web existant. Le serveur Microsoft SQL existant peut héberger la base de données du Web Printing. Il faut garantir l'accès au site Web Printing pour les utilisateurs qui s'y connectent. l l l Control Center et le site Web Printing sont installés sur le même serveur, mais www.nicelabel.fr Si ces utilisateurs font partie du personnel interne de l'entreprise, ils ont sûrement déjà accès au site Web Printing. S'ils viennent de l'extérieur par Internet, configurer le pare-feu ou le proxy pour autoriser les connexions entrantes. Soit il est impossible de faire confiance aux utilisateurs connectés. Ne pas installer Web Printing sur l'infrastructure informatique de l'entreprise. Mais contacter plutôt un hébergeur et installer tous les composants hors du système informatique de l'entreprise. Si les utilisateurs de Web Printing ont besoin des bases de données de l'entreprise, il faut les rendre disponibles pour le site Web Printing. Microsoft SQL Server est installé sur un serveur distinct. Ce peut être soit un serveur Microsoft SQL existant, contenant déjà des bases de données, soit un nouveau serveur. Il faut un serveur Web et/ou un serveur Microsoft SQL très actifs, et utiliser les machines dédiées pour le Web et le traitement des données. 7 Tous les composants du serveur installés sur des serveurs séparés, le site Web Printing en DMZ. Dans ce cas, les installations doivent être réparties pour des raisons de performances (le serveur Web et le serveur Microsoft SQL tournant sur des serveurs séparés). De plus, le site Web Printing n'est pas installé sur l'infrastructure interne. Les utilisateurs externes d'Internet vont aller se connecter au serveur Web Printing – le serveur exposé à Internet ne répond pas aux normes de sécurité requises. Le serveur proxy/pare-feu peut être placé en tête du site Web Printing comme première ligne de défense. Pour effectuer une installation robuste du site Web Printing, le paramétrer en DMZ. C'est un sous-réseau physique ou logique qui rend le site Web Printing accessible aux utilisateurs externes (peu sûrs). Si une attaque réussit à toucher le serveur, elle n'aura accès qu'à l'équipement de la DMZ, pas au réseau de l'entreprise. Le site Web Printing doit avoir accès au réseau interne pour charger la solution et récupérer les données d'impression. Cela implique l'ouverture de la communication avec le serveur Microsoft SQL à l'arrière-plan (quelques ports dédiés ouverts). NOTE: Ce scénario de déploiement explique pourquoi le site Web Printing a besoin d'un nom d'utilisateur au niveau SQL pour se connecter à la base de données du Control Center (non un nom d'utilisateur au niveau du domaine). Si une attaque compromet la connexion au serveur SQL, elle ne récupérera que les identifiants de connexion à la base de données de Control Center, et aucun dommage ne sera causé aux autres bases de données et serveurs internes. Autres combinaisons D'autres combinaisons d'installation des serveurs sont possibles. Chaque composant du serveur peut être installé sur un serveur différent. Se souvenir seulement qu'ils ont besoin de règles de pare-feu ou de proxy pour se voir les uns les autres. l l www.nicelabel.fr Control Center doit avoir accès au serveur Microsoft SQL (Authentification Windows, utilisateurs Windows locaux de Control Center, (EPM_USER, EPM_DBADMIN) sont créés sur le serveur sur lequel Microsoft SQL Server est installé). Le site Web Printing doit avoir accès au serveur Microsoft SQL sur lequel la base de données de Control Center est installée (Utiliser l'authentification SQL pour que le site Web Printing puisse être installé hors du réseau ou du domaine de l'entreprise). 8 2.2 Présentation NiceLabel Web Printing est une solution client/serveur conçue principalement pour l'impression d'étiquettes avec codes à barres. NiceLabel Web Printing fait partie de la gamme de produits LMS de NiceLabel. Pour l'utiliser, il faut installer et activer Control Center. Côté client, PowerForms (un des produits de NiceLabel 2019) permet de créer des étiquettes et des solutions. NOTE: Pour plus d'informations sur la création d'étiquettes et le déploiement, voir l'article Déploiement. Côté serveur, Control Center et Web Printing tournent tous les deux comme des applications Web et distribuent les licences pour Web Printing et les applications d'impression. Toutes les activités d'impression sont collectées dans la base de données de Control Center. L'administrateur peut utiliser un explorateur Internet normal pour : l Gérer le Control Center l Gérer les licences l Accéder aux fichiers de la solution dans le référentiel de stockage sur Web (Stockage de documents) l Installer et gérer les utilisateurs de Web Printing l Assigner les solutions aux utilisateurs l Afficher l'historique d'impression de la solution Pour résumer, l'environnement Web Printing est composé des éléments ci-dessous : Tous ces composants sont ajoutés au produit Control Center existant. l Composant serveur : le site NiceLabel Web Printing. l Composant d'édition : NiceLabel Designer, niveau PowerForms. l Composant du client d'impression : installé sur chaque poste de travail qui imprime des étiquettes. www.nicelabel.fr 9 3 Listes de contrôle 3.1 Liste De Contrôle Avant Installation LISTE DE CONTRÔLE SERVEUR o Accès aux comptes Windows et au Système SQL avec les droits d'administrateur Pour installer le logiciel NiceLabel, il faut avoir tous les droits d'administrateur : 1. Sur le serveur Windows ayant le rôle IIS sur lequel le site Web de Control Center va être installé. 2. Sur le serveur SQL, pour pouvoir y ajouter la base de données du Control Center. L'utilisateur saisi doit avoir un rôle de propriétaire sur la base de données. Configuration de Microsoft SQL Server. o Respecter les prérequis pour le serveur Web IIS Voir Installation du serveur Web IIS pour les rôles du serveur Web à activer dans l'IIS. o Respecter les prérequis pour le Microsoft SQL Server NOTE: Cette étape n'est nécessaire que si vous n'installez pas le composant Web Printing sur le même ordinateur que Control Center. Liste des changements à apporter pour finaliser Microsoft SQL Server : l l l Activer un mode d'authentification mixte sur le serveur SQL : Authentification Windows et authentification SQL Server. Ajouter un nouvel utilisateur SQL. Appliquer les autorisations de sécurité pour le nouvel utilisateur SQL afin qu'il puisse accéder à la base de données du Control Center, dans laquelle les fichiers de la solution Web Printing sont stockés. 3.2 Liste De Contrôle Après Installation LISTE DE CONTRÔLE CLIENT www.nicelabel.fr 10 o Si un serveur proxy est utilisé, il faut exclure le trafic local du proxy Contourner le serveur Proxy pour les adresses locales, sinon le client ne récupérera pas la licence du NiceLabel Control Center, et n'aura donc pas accès aux fichiers du Stockage de documents. De ce fait, les fichiers du Stockage de documents seraient inaccessibles. Pour plus d'informations, voir Base de connaissances, article KB163. www.nicelabel.fr 11 o Ajouter Control Center aux sites de confiance En cas de problème pour utiliser NiceLabel Control Center, l'ajouter à la liste des sites de confiance dans l'explorateur Internet. www.nicelabel.fr 12 4 Spécifications système requises NOTE: Toujours vérifier les dernières configurations système requises sur cette page Web : https://www.nicelabel.com/products/specifications/system-requirements. NiceLabel 2019 l CPU : Intel ou processeur compatible x86 l Mémoire: 2 GB ou plus de RAM l Disque dur : 1 GB d'espace disque disponible l Systèmes d'exploitation Windows 32 ou 64 bits : Windows Server 2008 R2, Windows 7, Windows 8, Windows 8.1, Windows Server 2012, Windows Server 2012 R2, Windows 10, Windows Serveur 10, Windows Server 2016, Windows Server 2019 (Windows Server Core et Windows Nano Server ne sont pas compatibles) l Au moins un pilote d'imprimante installé sur l'ordinateur l Microsoft .NET Framework Version 4.5 l Écran : résolution de l'écran 1366×768 ou plus élevée l Pilotes d'imprimantes recommandés : pilote d'imprimante NiceLabel V5.1 ou supérieur Autre requis pour les composants de NiceLabel Control Center et NiceLabel PowerForms Web l l l l l l Système d'exploitation : Éditions « Home » du système d'exploitation Windows non compatibles Serveur de base de données : Microsoft SQL Server 2005, Microsoft SQL Server 2008, Microsoft SQL Server 2012, Microsoft SQL Server 2014, Microsoft SQL Server 2016 (L'édition Express des produits mentionnés ci-dessus est également supportée). IIS 7 ou plus récent Explorateurs recommandés : Internet Explorer 9+, Google Chrome (le dernier), Mozilla Firefox (le dernier) JavaScript pour l'explorateur Internet Pilote d'imprimante installé. La fonctionnalité d'aperçu des étiquettes nécessite qu'au moins un pilote d'imprimante soit installé sur le serveur du Control Center. www.nicelabel.fr 13 5 Prérequis pour l'installation de Windows Server 5.1 Installation Du Serveur Web IIS L'Internet Information Service (IIS) est le serveur Web de Microsoft. C'est un composant obligatoire pour exécuter le produit NiceLabel Web Printing. IIS se trouve sur le système d'exploitation Windows Server. Il suffit de l'activer et le configurer. NOTE: Si Web Printing est installé sur le même serveur que Control Center, sauter les étapes ci-dessous. L'installation de Control Center a déjà configuré les prérequis. Pour cela, procéder comme suit : 1. Se connecter au serveur Windows avec des droits d'administrateur local. 2. Lancer le Gestionnaire du serveur sur l'écran de Démarrage. 3. Cliquer sur Gérer puis cliquer sur Ajouter des rôles et fonctionnalités. www.nicelabel.fr 14 4. Sélectionner Installation basée sur un rôle ou une fonctionnalité. Cliquer sur Suivant. 5. Sélectionner un serveur local pour le pool de serveurs. Cliquer sur Suivant. 6. Dans les Rôles de serveur, activer l'option Serveur Web (IIS). Cliquer sur Ajouter des fonctionnalités. Cliquer sur Suivant. www.nicelabel.fr 15 7. Sélectionner Rôle de Serveur Web (IIS) > Services de rôle. Vérifier que les services de rôle suivants sont activés. Cliquer sur Suivant. Dans Fonctionnalités HTTP communes. l Document par défaut l Exploration des répertoires l Erreurs HTTP l Contenu statique Dans Intégrité et diagnostics : l Journalisation HTTP Dans Performance : l Compression de contenu statique Dans Sécurité : l Filtrage des demandes l Authentification de base l Authentification Windows Dans Développement d'applications : l .NET Extensibility 4.5 l ASP.NET 4.5 l CGI l Extensions ISAPI l Filtres ISAPI www.nicelabel.fr 16 Dans Outils de gestion : l Console de gestion d'IIS 8. Cliquer sur Installer. Cliquer sur Fermer quand l'installation est terminée. Avec Windows Server 2012 R2, il faut aussi installer la fonctionnalité HTTP-Activation .NET. Pour cela, procéder comme suit : 1. Se connecter au serveur Windows avec des droits d'administrateur local. 2. Lancer le Gestionnaire du serveur sur l'écran de Démarrage. 3. Cliquer sur Gérer puis cliquer sur Ajouter des rôles et fonctionnalités. www.nicelabel.fr 17 4. Sélectionner Installation basée sur un rôle ou une fonctionnalité. Cliquer sur Suivant. 5. Sélectionner un serveur local pour le pool de serveurs. Cliquer sur Suivant. 6. Cliquer sur Fonctionnalités dans la liste de choix à gauche. 7. Etendre les Fonctionnalités de .NET Framework 4.5. 8. Étendre les Services WCF. 9. Activer Activation HTTP. Cliquer sur Suivant. www.nicelabel.fr 18 10. Cliquer sur Installer. Cliquer sur Fermer. 5.2 Configuration De Microsoft SQL Server NOTE: Si Web Printing est installé sur le même serveur que Control Center, sauter les étapes ci-dessous. Web Printing utilisera les paramètres de connexion de la base de données à partir de Control Center. Web Printing fait partie de la gamme de produits NiceLabel LMS. Pour l'activer, il faut installer et activer NiceLabel Control Center. Les composants du serveur de NiceLabel Web Printing ont besoin d'un serveur Microsoft SQL pour stocker les informations concernant les utilisateurs, leurs solutions, les licences, les activités de Web Printing, etc... Le serveur Microsoft SQL a été déjà paramétré pour installer NiceLabel Control Center. NiceLabel Web Printing a seulement besoin d'accéder au serveur Microsoft SQL qui héberge la base de données (NiceAN par défaut) du Control Center. Cette base de données sert pour Control Center et pour le site Web Printing. Control Center accède à la base de données en utilisant l'authentification Windows alors que le site Web Printing y accède en utilisant l'authentification SQL. Avant de commencer l'installation du site de NiceLabel Web Printing, il faut ajouter un utilisateur SQL ayant suffisamment de droits pour accéder à la base de données du Control Center. Le site Web Printing se connectera à la base de données du Control Center avec cet utilisateur SQL. Pour créer un utilisateur SQL ayant assez de droits sur Microsoft SQL Server 2005, procéder comme suit : NOTE: Effectuer les mêmes étapes si vous disposez d'une autre version de Microsoft SQL Server supportée. www.nicelabel.fr 19 1. Exécuter SQL Server Management Studio pour gérer le serveur SQL. Il a dû être installé sur la machine en même temps que SQL Server ou sur toute autre machine autorisée à gérer le serveur SQL. En cas d'incertitude, contacter l'administrateur du système. 2. Saisir le nom exact du serveur, le type d'authentification et les identifiants de connexion. En cas d'incertitude, contacter l'administrateur du système. 3. Dans l'explorateur d'objet, étendre le Nom du serveur puis Sécurité puis Connexions. 4. Cliquer à droite sur Connexions puis sélectionner Nouvelle connexion. 5. Vous êtes sur la page Générale. Pour Identifiant, donner le nom d'utilisateur en cours. www.nicelabel.fr 20 6. Sélectionner Authentification SQL Server. 7. Donner le mot de passe du nouvel utilisateur. 8. Désactiver l'option Conserver l'expiration du mot de passe. Le mot de passe saisi ne pourra jamais expirer. 9. Désactiver l'option L'utilisateur doit changer de mot de passe à la prochaine connexion. 10. Définir la Base de données par défaut sur NiceAN ou autre – telle que définie lors de l'installation de Control Center. 11. Aller sur la page Rôles de serveur. 12. Vérifier que le rôle public est activé. 13. Aller sur la page Mappage de l'utilisateur. 14. Définir la base de données NiceAN ou autre – telle que définie lors de l'installation de Control Center. 15. Pour l'Appartenance au rôle de base de données pour : <selected database>, activer les options db_owner et public. www.nicelabel.fr 21 16. Cliquer sur OK. Puis vérifier que le serveur SQL permet à la fois la connexion du domaine Windows et celle de l'utilisateur SQL. 1. Dans l'explorateur d'objets, cliquer à droite sur le nom du serveur puis sélectionner Propriétés. 2. Sélectionner la page Sécurité. 3. Pour l'authentification du serveur, sélectionner Mode d'authentification SQL Server et Windows. Cela permettra d'utiliser les deux types d'authentification. 4. Cliquer sur OK. 5. Fermer l'application SQL Server Management Studio. Enfin, vérifier que SQL accepte la communication par le canal TCP/IP. www.nicelabel.fr 22 NOTE: Cette étape n'est requise que quand le SQL Server et IIS sont installés sur deux machines différentes. 1. Exécuter le Gestionnaire de configuration SQL Server sur la machine du Server Windows comportant SQL Server. 2. Étendre l'option Configuration du réseau SQL Server. 3. Sélectionner Protocoles pour <instance name>. 4. Dans le panneau de droite, sélectionner le protocole TCP/IP puis cliquer à droite et sélectionner Activer. NOTE: Pour plus d'informations sur l'interaction entre Microsoft SQL Server et NiceLabel, voir Déploiement. www.nicelabel.fr 23 6 Installation du logiciel 6.1 Installation Des Composants Du Serveur 6.1.1 Installation Du Site Web Printing Le site Web Printing est l'application Web sur laquelle se connectent les utilisateurs Web pour récupérer leur solution assignée. Consulter l'article Déploiement pour revoir les scénarios d'installation et le serveur à utiliser pour héberger l'application. Installer le site Web Printing sur le même ordinateur Windows que Control Center, ou l'installer sur un autre ordinateur Windows. NOTE: Il faut se connecter à l'ordinateur avec les droits d'administrateur pour effectuer l'installation du logiciel. Pour installer le site Web Printing, procéder comme suit : 1. Le site Web Printing va se connecter à la base de données du Control Center en utilisant l'authentification de l'utilisateur SQL. Avant de commencer l'installation, vérifier quels sont les identifiants de connexion de l'utilisateur SQL pour avoir les droits suffisants pour accéder à la base de données du Control Center. Cette information sera utile pendant l'installation. Configuration de Microsoft SQL Server. 2. Pour garantir une installation complète, fermer toutes les applications ouvertes avant d'installer le logiciel. 3. Télécharger le logiciel ou insérer le DVD NiceLabel dans le lecteur. L'installation de l'application Web Printing vérifie le contenu du package. NOTE: Si l'assistant ne démarre pas automatiquement, aller dans le répertoire principal du DVD et double-cliquer sur le fichier NiceLabelWebPrinting2019.exe. Avant que l'installation ne commence, l'assistant vérifie que les composants prérequis sont installés sur le serveur. l Microsoft IIS l Microsoft .NET Framework 4.5 www.nicelabel.fr 24 Si le composant .NET ne se trouve pas sur le système, l'assistant va l'installer avant de continuer. 4. Sélectionner la langue de l'installation dans le menu déroulant et cliquer sur OK. 5. Suivre les invites de l'assistant. 6. Définir les paramètres IIS pour le site Web Printing et la manière dont les utilisateurs vont accéder à la page : l Il peut être installé en répertoire virtuel sous le site Web par défaut et le nom du dossier virtuel peut être configuré. Par exemple, le site peut être accessible sous http://<server>/PowerFormsWeb. l Il peut être installé comme un nouveau site Web. Attention en fournissant le numéro du port. Vérifier que le port n'est pas utilisé par un autre service sur cet ordinateur. Par exemple, le site peut être accessible comme http://<server>:81/PowerFormsWeb si le port 81 est défini. l Pour que le site ait un nom convivial, définir les valeurs de l'entête de l'hôte. Par exemple, en l'appelant ‘mypowerformswebserver' et en définissant l'entête de l'hôte du site Web Printing, il répondra à l'adresse http://mypowerformswebserver. CONSEIL : Voir Base de connaissances NiceLabel, article KB200 pour plus d'informations sur les appellations conviviales. NOTE: Le site Web Printing peut être installé comme un nouveau site (1er niveau) ou comme un répertoire virtuel dans le site Web sélectionné (2ème niveau). Impossible de l'installer dans le 3ème niveau. l Activer le protocole HTTPS si vous souhaitez établir une connexion client-serveur sécurisée. Cette option définit automatiquement 443 comme numéro de port. NOTE: La liaison du site HTTPS et le certificat X.509 (SSL) doivent être ajoutés manuellement au site sélectionné sur le gestionnaire des SII. Détails disponibles dans cette section. www.nicelabel.fr 25 Cliquer sur Suivant. 7. Sélectionner le serveur Microsoft SQL sur lequel la base de données de NiceLabel Control Center est déjà installée. NOTE: Cette étape et les suivantes ne seront disponibles que lorsque vous installez le module Web Printing sur un autre ordinateur que le Control Center. Attention à bien mettre le bon nom SQL et le bon nom de l'instance. S'il est configuré avec une instance par défaut, le nom du serveur suffit. S'il est configuré avec des instances, mettre le nom du serveur et de l'instance dans la syntaxe server\instance, par exemple SERVERNAME\SQLEXPRESS. ATTENTION : La base de données NiceAN (ou autre) de Control Center DOIT déjà exister sur le serveur Microsoft SQL sélectionné. 8. Saisir les identifiants de connexion pour accéder à la base de données du Control Center sur Microsoft SQL Server. Mettre les références du compte SQL (pas du compte Windows). Le site Web Printing va se connecter à la base de données du Control Center comme utilisateur SQL. Voir « Déploiement » en page 3 pour plus de détails sur les connexions entre NiceLabel et le serveur SQL. Voir Configuration de Microsoft SQL Server pour savoir comment installer l'authentification de l'utilisateur sur Microsoft SQL Server. 9. Quand l'installation du site Web Printing est terminée, la case Exécuter Web Printing peut rester cochée. Cliquer sur le bouton Terminer et la page de Connexion au site Web Printing va s'ouvrir dans un explorateur. www.nicelabel.fr 26 6.1.2 Installation Du Site Web Printing En HTTPS/SSL En principe, le site Web Printing sera accessible pour un utilisateur Web Printing externe. Les utilisateurs se connecteront par Internet et non sur un réseau interne (de confiance). Comme les données échangées en ligne peuvent contenir des informations confidentielles, non seulement les identifiants de connexion mais aussi des données d'entreprise, il est vital de protéger le flux de données. Les données utilisées par Web Printing peuvent être cryptées en SSL et le site peut être accessible par protocole HTTPS. Au cours de l'installation du site Web Printing, il faut définir le répertoire virtuel et le site virtuel sur lesquels le site répondra aux requêtes. Mais une configuration normale non protégée peut être installée. Pour activer le protocole SSL dans Windows Server 2012 R2, procéder comme suit : NOTE: Effectuer les mêmes étapes si vous disposez d'un autre système d'exploitation Windows Server supporté. 1. Créer une Demande de signature de certificat (CSR) et commander le certificat chez un fournisseur de certificat. Après réception du certificat SSL, procéder comme suit : 2. Ouvrir le fichier .zip contenant le certificat. Enregistrer le fichier your_domain_ name.cer sur le bureau du serveur Web qu'il faut sécuriser. 3. Ouvrir le gestionnaire des IIS. 4. Cliquer sur le nom du serveur dans le champ des connexions IIS (côté gauche de la fenêtre). 5. Double-cliquer sur Certificat du serveur dans le groupe IIS au centre de la fenêtre. 6. Cliquer sur Terminer la demande de certificat... dans le champ des Actions sur le côté droit de la fenêtre. www.nicelabel.fr 27 7. Rechercher le fichier du certificat (.cer). Définir et saisir un nom convivial. Il fait partie du certificat lui-même, mais il est utilisé par l'administrateur du serveur pour distinguer facilement les certificats. Choisir la place du nouveau certificat dans les certificats personnels. 8. Cliquer sur OK pour installer le certificat sur le serveur. 9. Une fois le certificat SSL installé sur le serveur, assigner le certificat au site Web approprié utilisant IIS. 10. Sélectionner le serveur sur lequel le certificat a été installé dans le champ de connexions IIS. www.nicelabel.fr 28 11. Dans la fenêtre de liaison de site, cliquer sur Ajouter... La fenêtre Ajouter la liaison de site s'ouvre. 12. Sous Type, sélectionner https. L'adresse IP doit être celle du site ou Non assigné, et le port sur lequel le trafic sera sécurisé est en général le 443. 13. Cliquer sur OK. Le certificat SSL est installé. www.nicelabel.fr 29 13. Ouvrir l'explorateur Windows (ou tout autre gestionnaire de fichiers). 14. Aller sur le dossier du site NiceLabel Web Printing. Par défaut, ce dossier se trouve dans : c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\ 15. Créer une sauvegarde du fichier web.config existant ou le renommer. Conserver le fichier d'origine pour le cas où il faudrait revenir à la configuration d'origine. 16. Si vous n'avez pas activé le protocole HTTPS lors de l'installation, décommenter une ligne dans le fichier web.config pour l'activer. <!--<security mode="Transport" />--> 6.1.3 Installer Les Paramètres De Ligne De Commande L'installateur de NiceLabel est contrôlable par des paramètres de ligne de commande. NOTE: Attention à utiliser la syntaxe en majuscules comme dans l'explication. La plupart des paramètres sont utilisés sans la barre oblique d'entête, sauf deux exceptions: /s (pour installation silencieuse) et /l (pour logging). Pour réaliser une installation silencieuse, utiliser les lignes de commandes suivantes. C'est un mode d'installation dans lequel il n'y a pas à fournir d'informations pour l'installation et aucune boîte de dialogue ne s'ouvrira. Mais il faut donner les informations requises dans les lignes de commandes. NOTE: Les commandes ci-dessous ne marchent que quand elles sont utilisées avec le signe d'installation silencieuse /S. Paramètre Description /s Installation silencieuse. Aucune boîte de dialogue ne s'affiche. L'installateur travaille en arrière-plan. /l="folder_and_file_name" Enregistrer le processus d'installation sous le fichier donné. Vérifier que le compte utilisateur réalisant l'installation a les droits d'accès au dossier. SELECTEDSERVER Cette commande définit le nom du serveur SQL et éventuellement une instance. SELECTEDSERVER=ServerName\InstanceName DATABASENAME Cette commande définit le nom de la base de données pour Control Center. Nom par défaut : NiceAN www.nicelabel.fr 30 SQLUSER/ SQLPASSWORD Ces commandes définissent le nom et le mot de passe de l'utilisateur SQL pour installer la base de données du Control Center. L'utilisateur SQL configuré doit déjà exister dans le serveur SQL et doit avoir l'accès nécessaire à la base de données du Control Center. SQLUSER=sa SQLPASSWORD=saPassword 6.2 Installation De NiceLabel Web Client Avant de pouvoir commencer à travailler avec les applications Web partagées, installez le client Web Printing sur votre ordinateur. L'installation du Client Web est nécessaire avant d'utiliser les applications Web partagées pour la première fois. 6.2.1 Installation Du Client Web Pour L'utilisateur Connecté (option Par Défaut) Par défaut, le Client Web s'installe sur l'ordinateur de l'utilisateur actuellement connecté. Il s'agit de la méthode d'installation la plus commune qui n'exige pas de droits d'administrateur. Effectuer ces trois étapes : 1. Vous recevez un e-mail avec un lien vers l'application Web assignée. Le nom d'utilisateur et le mot de passe sont inclus dans cet e-mail. 2. Après avoir cliqué sur le lien, la page Web de l'application Web s'ouvre. Saisir le nom d'utilisateur et le mot de passe. 3. Vous allez être redirigé vers la page d'intro de NiceLabel Web Printing. Cliquer sur Lancer la solution d'impression pour ouvrir la solution assignée. www.nicelabel.fr 31 4. Si Web Client n'est pas encore installé, cliquer sur le lien "télécharger et installer le client d'abord". 5. Lancer le fichier d'installation téléchargé. Laisser la fenêtre de l'explorateur ouverte. 6. Sélectionner la langue d'installation. Cliquer sur OK. 7. La fenêtre de bienvenue de l'installateur NiceLabel Web Client apparaît. Cliquer sur Suivant. 8. Accepter les termes du contrat de licence. Cliquer sur Suivant. www.nicelabel.fr 32 9. La fenêtre Démarrer l'installation apparaît. Cliquer sur Installer. 10. Cliquer sur Fermer lorsque l'installation est terminée. 11. Revenir à l'étape 3. Cliquer sur Lancer la solution d'impression dans votre explorateur Web. Votre application Web s'ouvre dans une autre fenêtre. Après avoir effectué l'installation, vous trouverez le Client Web installé dans le dossier Users\AppData. 6.2.2 Installation Du Client Web Pour Tous Les Utilisateurs Vous pouvez aussi installer le Client Web pour tous les utilisateurs qui se connectent à l'ordinateur. Cette méthode d'installation n'exige pas de droits d'administrateur. EXEMP LE : C et t e mét hode d' ins t a lla t ion es t ut ile en ca s d' ut ilis a t ion de s er v eur s C it r ix. L' ins t a lla t ion pour t ous les ut ilis a t eur s v ous per met d' ins t a ller le C lient W eb une f ois s eulement , et de le pa r t a ger à t ous les ut ilis a t eur s . Pour installer le Client Web pour tous les utilisateurs, effectuer ces trois étapes : 1. Effectuer les étapes 1 à 4 ci-dessus. 2. Ouvrir l'invite de commande. 3. Aller au fichier d'installation NiceLabelWebClientSetup.exe du Client Web téléchargé sur votre système. 4. Exécuter la commande NiceLabelWebClientSetup.exe ALLUSERSINSTALL. Après avoir effectué l'installation pour tous les utilisateurs, vous trouverez le Client Web installé dans le dossier ProgramData. www.nicelabel.fr 33 6.3 Mettre À Jour D'une Version Précédente Pour mettre à jour NiceLabel Web Printing, il faut mettre à jour tous les composants. Installer la nouvelle version de tous les composants par-dessus les installations existantes sans les supprimer auparavant. En suivant ces instructions, toutes les préférences existantes, les données d'activation et les historiques seront conservés et seuls les fichiers de l'application seront remplacés par la nouvelle version. La mise à jour remplacera le fichier web.config existant, recréera le site et le pool d'applications dans le gestionnaire des IIS. Vous devrez les reconfigurer vous-même après la mise à jour si vous avez utilisé certains paramètres qui ne sont pas par défaut. 6.3.1 Mise À Jour Des Composants Du Serveur ATTENTION : Commencer par mettre à jour le Control Center puis le site Web Printing. Pour plus d'informations sur la mise à jour de Control Center, voir Guide d'installation de NiceLabel Control Center. Pour mettre à jour le site Web Printing, procéder comme suit : NOTE: Avant d'effectuer la mise à jour du site Web Printing, voir Base de connaissances, article KB230. 1. Aller sur le serveur Windows sur lequel le site Web Printing est installé. 2. Lancer l'installation de la nouvelle version du site Web Printing. Suivre les invites. La vieille version est d'abord désinstallée, puis la nouvelle version est mise en place. Le fichier de configuration existant est enregistré dans une sauvegarde, puis le nouveau fichier de configuration par défaut sera mis à la place. ATTENTION : Le statut du protocole HTTPS (activé ou désactivé) est automatiquement mémorisé à la fin de la mise à jour si vous installez correctement la version 2019.0 de NiceLabel Control Center. Si vous mettez à jour à partir d'anciennes versions, configurez le protocole HTTPS manuellement. Voir Installation du site Web Printing en HTTPS/SSL. 6.3.2 Mise À Jour Des Composants Du Client Pour cela, procéder comme suit : 1. Aller sur le poste de travail sur lequel les composants du client éditeur sont installés. 2. Lancer l'installation du NiceLabel Designer. Suivre les invites. La vieille version est d'abord désinstallée, puis la nouvelle version est mise en place. NOTE: Pour plus d'informations, voir le Guide d'installation de NiceLabel 2019. www.nicelabel.fr 34 7 Licences 7.1 Limiter Le Nombre D'imprimantes Autorisé Pour Les Applications Web Les utilisateurs connectés au site Web Printing qui impriment des étiquettes en utilisant les applications Web partagées doivent être ajoutés à une application Web et activés dans Control Center. Vous pouvez définir les utilisateurs Web Printing dans Control Center, mais ils peuvent seulement se connecter au site Web Printing lorsque vous les ajoutez aux applications Web partagées. Chaque application Web et ses utilisateurs autorisés peuvent utiliser une ou plusieurs imprimantes. Vous pouvez limiter le nombre d'imprimantes pour chaque application Web : Chaque imprimante assignée prend une licence. Pour définir le nombre d'imprimantes permis pour une application Web partagée : 1. Ouvrir le NiceLabel Control Center à l'adresse http://server/EPM. 2. Aller dans Applications > Applications Web et sélectionner une application. La fenêtre de configuration d'application Web s'ouvre. 3. Aller dans Paramètres utilisateur et définir Activer la limite d'imprimantes sur On. 4. Utiliser le Nombre d'imprimantes pour définir le nombre maximum d'imprimantes autorisé pour l'application Web sélectionnée. www.nicelabel.fr 35 5. Cliquer sur Enregistrer. www.nicelabel.fr 36 8 Ajustage du logiciel 8.1 Personnalisation Les informations contenues dans ce chapitre concernent les modifications apportées au fichier de configuration du site Web Printing : web.config. Si rien n'est modifié dans le chemin de l'installation, l'emplacement par défaut du fichier se trouve sur c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\. 8.1.1 Personnaliser La Page De Connexion Lorsque le formulaire d'authentification par défaut est utilisé, il est possible de personnaliser le contenu de la page de connexion. Il est possible de personnaliser : l Titre de la page de connexion. Son titre par défaut est 'Web Printing'. Pour le changer, ajouter le paramètre d'application suivant dans le fichier web.config : <appSettings> <add key="LoginTitle" value="Custom login page title"/> </appSettings> l Largeur de la page de connexion. Sa largeur par défaut est de 300 pixels. Vous pouvez utiliser le paramètre d'application suivant dans le fichier web.config pour la modifier : <appSettings> <add key="LoginWidth" value="500"/> </appSettings> l Texte d'instruction. Il est possible d'ajouter un texte d'instructions pour l'utilisateur de l'impression. Avec le paramètre d'application suivant dans le fichier web.config, il est possible de configurer le texte ou sa hauteur. <appSettings> <add key="LoginInstruction" value="Instructions for the user. This will be displayed below the title and above the login controls."/> <add key="LoginInstructionHeight" value="40"/> </appSettings> 8.1.2 Personnalisation De La Page Web Printing Personnaliser la page Web Printing en mettant une clé dans le fichier web.config, qui détermine le titre de la page qui s'affiche dans l'explorateur Internet. Son titre par défaut est 'Web Printing'. Il est modifiable en ajoutant le paramètre suivant dans le fichier web.config : <appSettings> <add key="WebPrintingPageTitle" value="Custom web printing page title"/> www.nicelabel.fr 37 </appSettings> 8.1.3 Remplacer Les Connexions Aux Bases De Données Dans Les Applications Web Partagées Dans certains cas, vous voudrez accéder aux bases de données locales à partir de vos applications Web partagées au lieu de récupérer les données dans les bases de données stockées dans votre Système de gestion de documents ou sur les serveurs de bases de données SQL. C'est un scénario ordinaire si vous testez vos applications Web partagées, ou prévoyez de migrer vos serveurs de bases de données. Web Printing vous permet de remplacer les connexions aux bases de données sans ouvrir et modifier les connexions aux bases de données dans vos étiquettes ou solutions partagées. La logique de remplacement de la chaîne de connexion à la base de données est définie dans le fichier DatabaseConnections.Config. Le fichier de configuration n'est pas installé avec Web Printing. Pour activer l'utilisation du fichier de configuration : 1. Créer un fichier XML en utilisant la structure suivante. <?xml version="1.0" encoding="UTF-8"?> <DatabaseConnectionReplacements> <Replacement> <From>Data Source=mySQLServer</From> <To>Data Source=NEW_mySQLServer</To> </Replacement> </DatabaseConnectionReplacements> Le fichier de configuration définit les paires source-destination (De-À) de la structure XML. L'élément <Remplacement> contient un élément <De> et un élément <À>. Au cours de l'exécution de l'application Web, la chaîne « De » est remplacée par la chaîne « À ». Il est possible de définir autant d'éléments de <Remplacement> que nécessaire. 2. Enregistrer votre fichier de configuration DatabaseConnections.Config dans le dossier où le Client Web du client est installé. L'emplacement par défaut est C:\Users\username\AppData\Local\NiceLabel\NiceLabelWebClient. l Après avoir enregistré le fichier de configuration, le Client Web se connecte toujours à l'autre base de données. NOTE: Si vous avez installé le Client Web pour tous les utilisateurs avec l'option de ligne de commande ALLUSERSINSTALL, enregistrer votre fichier de configuration dans le dossier suivant : c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\bin. Détails disponibles dans la section Installation du Client Web pour tous les utilisateurs. www.nicelabel.fr 38 8.2 Initialisation De La Solution Il est possible de paramétrer les données initiales des variables dans la solution quand les solutions sont ouvertes sur le site Web Printing Les variables peuvent être prédéfinies indépendamment sur le formulaire par défaut de chaque utilisateur. Une même solution est utilisable par différents utilisateurs avec des données initiales différentes. 8.2.1 Valeurs Variables De Départ Liées À L'utilisateur Dans certains cas, les valeurs des variables du formulaire sont différentes d'un utilisateur à un autre. Par exemple avec une même solution pour tous les fournisseurs, chacun d'entre eux ne doit voir que ses propres données. Chaque utilisateur Web Printing défini dans le Control Center dispose d'une propriété appelée Variable dans laquelle les valeurs variables peuvent être saisies dans la syntaxe suivante : "VAR1" = "First name" "VAR2" = "Last name" NOTE: Si le nom ou la valeur de la variable comportent un espace, il faut mettre la valeur entre crochets. Au chargement du formulaire, ces valeurs sont analysées et les variables définies. Dans l'exemple ci-dessus, la variable nommée VAR1 va prendre la valeur Prénom, et la variable VAR2 la valeur Nom. Quand des objets du formulaire sont connectés à ces variables, ils sont mis à jour automatiquement. 8.2.2 Initialisation Des Valeurs Variables Via Une Chaîne De Requête De Page Web. Les valeurs variables peuvent être ajoutées directement dans une chaîne de requête de page Web. Cette approche permet d'ajuster le site Web Printing en fournissant simplement une URL différente. Exemple d'URL : http://<server>/PowerFormsWeb/default.aspx?Variable=Var1=%22First%20name% 22&Variable=Var2=%22Last%20name%22 www.nicelabel.fr 39 8.3 Ouvrir Le Client Web Avec Plusieurs Applications Partagées Par défaut, chaque application Web partagée ouvre une nouvelle fenêtre dédiée après avoir cliqué sur Lancer la solution d'impression sur la page de connexion à Web Printing. Si plusieurs applications Web sont assignées, la fenêtre de sélection des applications s'ouvre. C'est là que vous sélectionnez les applications Web assignées que vous allez ouvrir. Vous pouvez personnaliser le comportement du Client Web NiceLabel pour charger instantanément l'application Web partagée sélectionnée en utilisant les paramètres de l'URL de l'application Web. Vous gagnez ainsi du temps en ouvrant la page des applications Web partagées et vous assurer que les utilisateurs avec lesquelles vous les partagez ouvrent toujours la bonne application. 1. Ouvrez votre navigateur Internet et saisissez l'adresse Web Printing standard dans la barre d'adresse. Par défaut, les applications Web partagées sont accessibles sur : https://<yourcontrolcenter>/powerformsweb (pour Control Centersur site) ou sur https://<yourlabelcloud>/print (pour Label Cloud). 2. Ajoutez le paramètre nicelabelwebclient:?server= en face de l'URL de Control Center. L' UR L es t dés or ma is : nicelabelwebclient:?server= https://yourlabelcloud.onnicelabel.com/print 3. Ajoutez le paramètre application= après l'URL. Ce paramètre indique quelle application partagée assignée doit s'ouvrir instantanément. Séparez le paramètre application= par le signe esperluette (&). « appname » est le nom de l'application que vous voulez ouvrir. L' UR L es t dés or ma is : nicelabelwebclient:?server=https://yourlabelcloud.onnicela bel.com/print &application=appname 4. Connectez-vous avec vos identifiants. l l Votre application Web s'ouvre en affichant l'étiquette avec les valeurs prédéfinies. Si plusieurs applications Web sont assignées, la fenêtre de sélection des applications s'ouvre, vous permettant de sélectionner et d'exécuter l'application Web demandée . NOTE: Vous pouvez associer plusieurs paramètres dans l'URL de l'application Web. Pour prédéfinir les valeurs des variables pour vos applications partagées en utilisant l'URL, lire la section Ouvrir des applications avec des valeurs prédéfinies NOTE: Séparez tous les paramètres dans la chaîne de requête de l'URL par le signe esperluette. www.nicelabel.fr 40 8.4 Ouvrir Des Applications Avec Des Valeurs Prédéfinies Le Client Web vous permet aussi de prédéfinir des valeurs variables pour les étiquettes dans vos applications Web. C'est ainsi que vous vous assurez que les utilisateurs avec lesquels vous partagez l'application Web impriment des étiquettes avec les bonnes valeurs. 1. Ouvrez votre navigateur Internet et saisissez l'adresse Web Printing standard dans la barre d'adresse. Par défaut, les applications Web partagées sont accessibles sur : https://<yourcontrolcenter>/powerformsweb (pour Control Centersur site) ou sur https://<yourlabelcloud>/print (pour Label Cloud). 2. Ajoutez le paramètre nicelabelwebclient:?server= en face de l'URL de Control Center. L' UR L es t dés or ma is : nicelabelwebclient:?server= https://yourlabelcloud.onnicelabel.com/print 3. Ajoutez les paramètres pour les variables avec les valeurs : variable=var_name=var_ value, où var_name est le nom de la variable, et var_value est la valeur que vous voulez prédéfinir pour votre étiquette. L' UR L es t dés or ma is : nicelabelwebclient:?server=https://yourlabelcloud.onnicela bel.com/print &variable=var_name=var_value 4. Connectez-vous avec vos identifiants. l NiceLabel Le Client Web s'ouvre avec l'application Web demandée affichant une étiquette contenant les valeurs prédéfinies. NOTE: Vous pouvez associer plusieurs paramètres dans l'URL de l'application Web. Pour ouvrir une application spécifique en utilisant l'URL, voir Ouvrir le Client Web avec plusieurs applications partagées NOTE: Séparez tous les paramètres dans la chaîne de requête de l'URL par le signe esperluette. 8.5 Modes D'ouverture De Solution Par défaut, chaque application Web partagée ouvre une nouvelle fenêtre dédiée après avoir cliqué sur Lancer la solution d'impression sur la page de connexion à Web Printing. Vous pouvez régler la façon dont les solutions d'impression s'adaptent à vos environnements de travail spécifiques. Il y a trois modes d'ouverture de solution possibles : www.nicelabel.fr 41 l Mode d'ouverture 0 : Mode par défaut. Ce mode ouvre la solution d'impression en tant qu'instance distincte du Client Web NiceLabel. Chaque solution s'ouvre dans une nouvelle fenêtre dédiée. Si vous n'avez pas encore modifié de mode jusqu'à maintenant ou si le paramètre openMode dans l'URL n'est pas présent, ce mode est actif. Pour réactiver le Mode d'ouverture 0, insérer openMode=0 ou openMode=newInstance. EXEMP LE : nicela belw ebclient 2019:?s er v er =ht t p:/ / <s er v er na me>/ P ow er For ms W eb& openMode=0& a ut hTok en=<t ok en cont ent > l Mode d'ouverture 1 : Mode de rechargement de la solution. La solution d'impression précédemment ouverte se recharge dans la même fenêtre. Pour activer ce mode, insérer openMode=1 ou openMode=existingInstance dans l'adresse du site Web Printing. EXEMP LE : nicela belw ebclient 2019:?s er v er =ht t p:/ / <s er v er na me>/ P ow er For ms W eb& openMode=1& a ut hTok en=<t ok en cont ent > CONSEIL : Utiliser le Mode d'ouverture 1 si vous voulez éviter de rouvrir la solution dans une nouvelle fenêtre. l Mode d'ouverture 2 : Mode de rechargement de la variable. Seules les valeurs variables sont rechargées. La solution reste inchangée, telle que présentée dans la fenêtre actuellement ouverte. Pour activer ce mode, insérer openMode=2 ou openMode=reloadVariables dans l'adresse du site Web Printing. EXEMP LE : nicela belw ebclient 2019:?s er v er =ht t p:/ / <s er v er na me>/ P ow er For ms W eb& openMode=2& a ut hTok en=<t ok en cont ent > CONSEIL : Le Mode d'ouverture 2 réinitialise les valeurs variables sur une solution d'impression ouverte. Utilisez-le pour obtenir les dernières valeurs si les modifications sont attendues au fil du temps. www.nicelabel.fr 42 9 Mode hors ligne L'accès à Internet et la disponibilité sont les problèmes - clés de la majorité des services essentiels tournant sur les serveurs Web. La disponibilité comporte deux problèmes potentiels : l La disponibilité du serveur l L'accès Internet du Client L'application NiceLabel Web Printing tourne comme un client appelé NiceLabel Web Client. Une connexion Internet active et nécessaire pour exécuter l'application en ligne. Mais Web Printing peut marcher aussi hors-ligne, donc l'application tourne même sans connexion Internet. Dans ce cas, l'application Web Printing est installée sur le disque local et tourne comme une application autonome. 9.1 Activation Du Mode Hors-ligne. Installer le client Web de NiceLabel Il sert de sauvegarde fiable pour toutes les fois où la connexion Internet tombe en empêchant l'accès au serveur. Le client hors-ligne charge la dernière version du formulaire, du masque et des données de l'étiquettes ( si connecté à une base de données). Si le client n'a pas d'accès à Internet, l'application ouvre le formulaire et le masque d'étiquette utilisés lors de la dernière session. Les données sont limitées à celles de la dernière table de base de données utilisée et au dernier lot de données demandées qui s'étaient affichées alors que le client était encore connecté à Internet. Web Printing enregistre toutes ses activités d'impression dans le Control Center. Le journal des événements d'impression est encore utilisable quand la connexion Internet tombe, et que le client hors ligne est utilisé pour imprimer. Quand le client se reconnecte à Internet et ouvre le client d'impression hors-ligne, l'activité d'impression écoulée est chargée sur le Control Center. 9.2 Changer La Période De Temps Hors-ligne. Par défaut, l'utilisateur peut lancer l'application en mode hors-ligne pendant maximum 24 heures. Pendant que l'utilisateur est en mode hors-ligne, les informations sur les événements d'impression continuent à être collectées et toutes les données sont conservées localement. Quand la connexion au Control Center est rétablie tous les journaux sont envoyés à NiceLabel Control Center. Les informations sur les événements d'impression ne sont pas perdues. Pour changer la durée de la période hors-ligne, procéder comme suit : 1. Se connecter au bureau du serveur Windows sur lequel le site Web Printing est installé. 2. Ouvrir le fichier web.config dans un traitement de texte. www.nicelabel.fr 43 3. Aller dans la section <appSettings></appSettings> pour insérer la clé suivante: <appSettings> <add key="OutOfBrowserOfflinePeriod" value="1"/> </appSettings> 4. Remplace la valeur 1 par le nombre de jours désiré. NOTE: Le maximum de jours hors-ligne est de 30 www.nicelabel.fr 44 10 Authentification Les informations de cet article concernent les modifications du fichier de configuration web.config pour le site Web Printing. NOTE: Si le chemin n'est pas modifié pendant l'installation, l'emplacement par défaut du fichier web.config est c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\. 10.1 Authentification Par Jeton Quand l'application Web existante tente d'utiliser le moteur d'impression de Web Printing, elle doit d'abord s'authentifier elle-même. Avec l'authentification par jeton, il n'y a pas besoin de mettre des données de l'utilisateur dans l'URL. L'application Web existante appelle un service d'authentification et passe l'identifiant et le mot de passe une seule fois. La réponse consiste en un jeton limité dans le temps, utilisé dans les paramètres de requête lors de la communication avec le Web Printing, afin de connaître le fichier de la solution (.NSLN) à utiliser. Le Web Service IntegrationService prend en charge la méthode GetLoginToken. Cette méthode accepte le nom d'utilisateur et le mot de passe en tant que paramètres d'entrée et fournit le jeton (GUID) en tant que paramètre de sortie. Web Service http://server/PowerFormsWeb/AuthenticationService/IntegrationService.asmx Méthode public string GetLoginToken(string username, string password) Le flux de travail qui doit être implémenté à la fin : 1. L'application qui appelle saute les données de connexion (identifiant et mot de passe) en appelant un Web Service. 2. Le Web service retrouve l'information. 3. Il renvoie le jeton à l'application qui appelle, en identifiant la session en cours. 4. L'application qui appelle charge la solution en se référant au jeton revenu (GUID) dans la chaîne de requête dans l'URL : http://server/PowerFormsWeb/default.aspx?logintoken=1351ED23-9C74411C-C887-40234952A116 C'est là qu'il faut remplacer server par le nom du serveur et PowerFormsWeb par l'emplacement exact du Web Printing installé, et 1351ED23-9C74-411C-C88740234952A116 par le jeton reçu du service d'authentification. www.nicelabel.fr 45 5. Le Web Printing fournit le fichier de la solution qui a été assignée à l'utilisateur donné. 6. Après réussite de la connexion, le jeton est invalidé et ne peut plus resservir. 10.2 Authentification Par Formulaire Le site Web Printing utilise l'authentification native de l'utilisateur par défaut (Authentification par formulaire). Ce mode d'authentification utilise le nom des utilisateurs du Client Web tels que définis dans Control Center. Après ouverture du site Web Printing, il est demandé à l'utilisateur son identifiant et son mot de passe. Les deux sont vérifiés dans la configuration de l'utilisateur du Web Printing dans Control Center. Si l'authentification est correcte, la solution de l'utilisateur s'ouvre. Pour sauter la page de connexion, il est possible de paramétrer une chaîne de requête spécifique pour l'utilisateur dans l'URL Dans ce cas, l'utilisateur est déjà connecté par une autre application qui intègre le site Web Printing. L'application existante va fournir l'identifiant et le mot de passe à la chaîne de requête, comme dans l'exemple suivant : Le site du Web Printing s'ouvre avec une URL, par ex. : http://server/PowerFormsWeb/default.aspx?UserName=<username>&Password=<pa ssword> Dans la quelle <username> est le nom du client Web et <password> le mot de passe du même compte utilisateur défini dans Control Center. Si l'utilisateur listé existe, la solution définie pour son compte s'ouvre. Dans une installation de site Web Printing par défaut, le <password> est formaté en texte simple. Pour protéger le mot de passe, il faut activer le Standard de chiffrement avancé (Advanced Encryption Standard) et crypter le mot de passe dans la chaîne de la requête. Pour activer le cryptage du mot de passe, procéder comme suit : 1. Ouvrir web.config dans un traitement de texte. 2. Aller dans la section <appSettings></appSettings> pour insérer les deux clés suivantes : <configuration> <appSettings> <add key="PasswordKey" value="passwordkey" /> <add key="PasswordIV" value="passwordiv" /> </appSettings> 3. Saisir les valeurs des champs passwordkey (clé du mot de passe) et paswordiv (vecteur d'initialisation du mot de passe). La clé du mot de passe doit avoir entre 16 et 32 caractères et le vecteur doit en avoir 16. 4. Les champs passwordkey et paswordiv décryptent les valeurs du mot de passe crypté www.nicelabel.fr 46 fourni dans la chaîne de requête. Si le mot de passe décrypté correspond aux identifiants définis pour le Web Printing dans Control Center, la solution associée va s'ouvrir. Pour tester le cryptage et le décryptage du mot de passe, utiliser l'application PasswordGenerator.exe qui se trouve sur le DVD de NiceLabel dans le dossier \Utility\AES Password Encrypter. Par exemple, l'utilisateur test a pour mot de passe veryhardtoguess. L'URL sera : http://<server>/PowerFormsWeb/default.aspx?UserName=test&Password=uEe6X5C y9Xjhad2PmKlowg%3d%3d NOTE: les paramètres passwordkey et passwordiv définissent l'algorithme de cryptage pour le mot de passe. Différentes combinaisons de ces paramètres donneront un cryptage différent du mot de passe. 10.3 Authentification Windows Si le site de Web Printing est intégré dans une page Web différente, l'authentification de l'utilisateur est dans la plupart des cas déjà faite dans l'application Web utilisant l'authentification Windows. Dans ces cas-là, le comportement par défaut du site Web Printing peut être modifié pour qu'il hérite de l'authentification précédente. Quand un utilisateur accède au site Web Printing dans l'entreprise (dans le même domaine), l'authentification Windows est utilisable. Dans ce cas, il est automatiquement identifié par son compte Windows, aucune autre connexion n'est nécessaire. Pour modifier le mode d'authentification sur votre système, modifier les paramètres suivants : 1. Modifier system.web/authentication dans le fichier web.config. Le fichier web.config est situé dans le dossier racine du site Web. Cette action définit l'authentification pour le bon mode. l Paramètre avant modification : <authentication mode="Forms"/> l Paramètre après modification : <authentication mode="Windows"/> 2. Modifier system.web/authorization dans le fichier web.config. Le fichier web.config est situé dans le dossier racine du site Web. Tous les utilisateurs peuvent accéder à ce site. l Paramètre avant modification : <deny users="?"/> l Paramètre après modification : <allow users="*" /> 3. Ouvrir le gestionnaire des IIS et aller à Sites/Default Web Site/PowerFormsWeb. Ouvrir Éditeur de configuration et effectuer les étapes suivantes : Étape 1 : Sélectionner Débloquer la section pour : www.nicelabel.fr 47 l Section définie : system.webServer/security/authentication/windowsAuthentication. l À partir de défini : ApplicationHost.Config <location path='Default Web Site/PowerFormsWeb' />. Étape 2 : Modifier l'option Activé de Faux à Vrai pour : l Section définie : system.webServer/security/authentication/windowsAuthentication. l À partir de défini : Default Web Site/PowerFormsWeb Web.Config. Après avoir activé l'authentification Windows dans Web Printing, l'authentification de l'utilisateur n'est plus effectuée dans le Web Printing mais sous la responsabilité du serveur Web (IIS). De plus, les options de connexion sont configurables en utilisant les propriétés Internet de la Zone Locale Intranet : l l Options de connexion automatique : L'explorateur fait suivre l'accréditation de l'utilisateur connecté au serveur Web. L'utilisateur est connecté automatiquement. Invite pour le nom d'utilisateur et le mot de passe : L'explorateur ne fait pas suivre les identifiants de l'utilisateur actuellement connecté. L'utilisateur doit ressaisir ses identifiants de connexion. www.nicelabel.fr 48 www.nicelabel.fr 49 11 Problèmes Problème Solution Lors du téléchargement de C'est un problème connu sur les systèmes serveur. Les l'application Web Printing sur Win2012 installations MSI par utilisateur sont désactivées par la R2, le message d'erreur suivant peut stratégie de groupe par défaut. apparaître. Consulter les deux pages ci-dessous pour résoudre le problème. https://msdn.microsoft.com/enus/library/windows/desktop/aa368304(v=vs.85).aspx et http://answers.microsoft.com/enus/windows/forum/windows_xp-security/thisinstallation-is-forbidden-by-system-policy/ac1986bea063-4b7b-834f-8fa56a8c0d04 www.nicelabel.fr 50 12 Support 12.1 Support En Ligne Les dernières versions, mises à jour, solutions de contournement des problèmes et les Questions Fréquemment Posées (FAQ) se trouvent sur le site d'assistance NiceLabel. Pour plus d'informations, se référer à : l Base de connaissances : https://www.nicelabel.com/support/knowledge-base l Assistance NiceLabel : https://www.nicelabel.com/support/technical-support l Tutoriels NiceLabel : https://www.nicelabel.com/learning-center/tutorials l Forums NiceLabel : https://forums.nicelabel.com/ NOTE: Les titulaires d'un contrat de maintenance (SMA) doivent contacter le service d'assistance premium comme spécifié sur le contrat. 12.2 Demander Une Assistance Technique Il peut arriver d'avoir besoin d'une aide technique pour résoudre certains problèmes. Notre équipe technique est joignable sur : https://www.nicelabel.com/support/technical-support NOTE: Les titulaires d'un contrat de maintenance (SMA) doivent contacter le service d'assistance premium comme spécifié sur le contrat. Avant de contacter le support technique, il peut être utile de collecter des informations sur le problème, l'ordinateur et le système d'exploitation sur lequel tourne NiceLabel. Vous pouvez utiliser la liste de contrôle suivante : Liste de contrôle : o Que s'est-il passé ? Écrire le message d'erreur reçu ou en faire une capture d'écran. o Quelle erreur a été découverte pour la première fois ? o Qu'attendiez-vous ? o Avez-vous découvert ce problème avant ? o Est-il possible de reproduire l'erreur ? o Est-ce que l'erreur se produit souvent ? o Avez-vous essayé d'utiliser NiceLabel de cette manière avant ? o Si le problème est intermittent, merci de décrire les circonstances et les conditions pour que l'erreur apparaisse. www.nicelabel.fr 51 o Quelle est la version de NiceLabel utilisée ? o Avec quelle version de NiceLabel l'étiquette a t-elle été créée ? o Merci de fournir les fichiers utilisés quand l'erreur est survenue (données, configuration, étiquette, etc...) o Quelle est l'imprimante utilisée ? o Quelle est la version du pilote d'imprimante utilisé ? o Quel est le système d'exploitation utilisé ? Dans quelle langue ? o Y a t-il un pare-feu ? Est-ce que tous les ports requis sont ouverts ? o Quelle est la version de Microsoft .NET Framework installée ? www.nicelabel.fr 52 Amériques +1 262 784 2456 [email protected] EMEA +386 4280 5000 [email protected] Allemagne +49 6104 68 99 80 [email protected] Chine +86 21 6249 0371 [email protected] www.nicelabel.fr ">
Link pubblico aggiornato
Il link pubblico alla tua chat è stato aggiornato.