Guide de dépannage : BarTender Print Portal
Aperçu
BarTender Print Portal est une application web qui permet aux utilisateurs d’imprimer depuis n’importe où en accédant au site web où Print Portal est hébergé. L’application fonctionne dans Internet Information Services (IIS) et repose sur .NET core. Cet article va vous aider à vous familiariser avec certains composants et à résoudre les problèmes courants. Il ne s’agit pas d’une liste exhaustive, mais cela devrait vous permettre de bien démarrer. Ce guide vise à aider au dépannage côté BarTender, car le dépannage d’IIS dépasse un peu le cadre de cet article.
S’applique à
BarTender 2021 et versions ultérieures
Informations
Pour dépanner n’importe quelle version de BarTender Print Portal, assurez-vous d’utiliser la dernière version disponible afin de ne pas essayer de résoudre un problème qui aurait déjà été corrigé. Consultez Comment mettre à jour vers la révision actuelle de BarTender pour obtenir de l’aide à ce sujet.
Vous devrez également installer la console de gestion Web IIS sur votre système. Vous pouvez trouver cette console dans les fonctionnalités de Windows ou les fonctionnalités du serveur. Si vous avez du mal à trouver la liste des fonctionnalités, contactez un professionnel de l’informatique pour obtenir de l’aide.
Composants de BarTender Print Portal
BarTender Print Portal s’appuie sur plusieurs composants pour fonctionner, dont plusieurs services qui assurent la stabilité de l’application. Voici quelques-uns des services clés :
- Service système BarTender – responsable de la communication avec la base de données système BarTender.
- Service BarTender Print Scheduler – gère les moteurs d’impression mentionnés dans la section suivante.
- Service de partage de port .Net/Tcp – un service Windows qui facilite la communication entre BarTender Print Portal et BarTender Print Scheduler pour les travaux d’impression.
En plus des services nécessaires au fonctionnement, voici deux composants majeurs détaillés :
Moteurs d’impression
Les moteurs d’impression sont en fait BarTender Designer fonctionnant comme un service, démarrant et s’arrêtant dynamiquement selon les besoins pour répondre aux demandes de BarTender Print Portal. Ces moteurs sont gérés par le service BarTender Print Scheduler et ne nécessitent aucune intervention de l’utilisateur pour fonctionner.
Lorsqu’un utilisateur crée un travail d’impression en cliquant sur le bouton d’impression, un moteur d’impression démarre automatiquement s’il n’est pas déjà en cours d’exécution. Il ouvre le document, traite les données envoyées depuis BarTender Print Portal, puis envoie le travail d’impression au spouleur d’impression Windows pour l’envoyer à votre imprimante. À partir de BarTender 2021, les moteurs d’impression sont également responsables de l’affichage des aperçus d’étiquettes.
Base de données système
La base de données système BarTender est une base SQL qui fonctionne en arrière-plan de toute la suite BarTender. Il peut s’agir d’une base locale installée via la console d’administration ou l’assistant d’installation, ou d’une base centralisée hébergée sur un serveur dédié.
Dans toutes les versions de BarTender, la base de données système est requise pour exécuter BarTender Print Portal. L’application ne fonctionnera pas sans elle.
Autorisations pour un fonctionnement normal
BarTender Print Portal nécessite certaines autorisations pour fonctionner normalement. Il ne s’agit pas ici d’autorisations pour contrôler l’accès des utilisateurs individuels, mais des autorisations nécessaires aux composants pour bien fonctionner. Ces autorisations permettent à BarTender Print Portal de :
- Accéder aux étiquettes, les ouvrir et les imprimer.
- Accéder aux imprimantes, localement ou sur le réseau.
- Accéder à la liste des utilisateurs et groupes Active Directory (pour BarTender 2021 et versions ultérieures).
- Accéder à Librarian.
Cette liste n’est pas exhaustive mais couvre certaines des fonctionnalités clés dont BarTender Print Portal a besoin pour fonctionner. Par défaut, BarTender Print Portal fonctionne avec un compte administrateur local qui a accès aux imprimantes installées localement et au répertoire Print Portal sur votre système, mais parfois cela ne suffit pas et les vérifications d’autorisations échouent.
Il existe trois points principaux où des problèmes d’autorisations peuvent survenir : le service BarTender Print Scheduler, l’identité du pool d’applications IIS et la connexion à la base de données système.
Pour le service Print Scheduler et l’identité du pool d’applications, vous aurez besoin d’un compte Windows avec les propriétés suivantes :
- Être administrateur local, car il devra accéder au répertoire de fichiers Print Portal
- Avoir un accès au niveau du domaine, si vous prévoyez d’utiliser des ressources du domaine comme des imprimantes ou des lecteurs réseau. Il n’a pas besoin d’être administrateur du domaine.
- Avoir les droits pour lire la liste des utilisateurs et groupes dans Active Directory (pour BarTender 2021 et versions ultérieures)
- Ne pas changer son mot de passe. Vous ne voulez pas d’erreurs d’autorisations si votre politique de mot de passe s’applique dans quelques mois.
- Avoir la permission de connexion locale via la stratégie de groupe. Il ne peut pas exécuter un service ou un pool d’applications sans cela.
- Avoir les droits d’accès à la base de données système. Ceci n’est requis que si vous utilisez l’authentification Windows.
Il est recommandé d’utiliser le même compte pour le Print Scheduler et l’identité du pool d’applications. Vous pouvez d’abord ajouter le compte au service pour tester les autorisations, car l’identité du pool d’applications ne donne généralement pas de messages d’erreur en cas de manque d’autorisation.
Pour la base de données système, il est conseillé d’utiliser l’authentification SQL afin d’éviter tout problème d’autorisations avec l’authentification Windows. Pour plus d’informations, consultez Configurer les autorisations pour une base de données système (Vidéo – 5:45).
Définir les autorisations du service BarTender Print Scheduler
Pour changer le compte du service Print Scheduler, procédez comme suit :
- Ouvrez l’application Services de Windows en la recherchant dans le menu Démarrer ou en la trouvant dans le Panneau de configuration.
- Faites défiler jusqu’au service BarTender Print Scheduler.
- Faites un clic droit sur le service et allez dans Propriétés.
- Cliquez sur l’onglet Connexion.
- Sélectionnez Ce compte et saisissez le nom d’utilisateur et le mot de passe. N’oubliez pas d’ajouter le nom de domaine sinon le service tentera de démarrer avec un compte local.
- Une fois les identifiants saisis, cliquez sur OK et passez les notifications concernant le changement de compte.
- Faites un clic droit sur le service BarTender Print Scheduler et sélectionnez Redémarrer pour relancer le service avec le nouveau compte.
Si vous recevez des erreurs au démarrage, vérifiez que le compte dispose bien de toutes les autorisations listées dans la section précédente et recommencez ces étapes.
Définir les autorisations de l’identité du pool d’applications IIS
Pour changer le compte de l’identité du pool d’applications IIS, procédez comme suit :
- Lancez le Gestionnaire des services Internet (IIS).
- Cliquez sur la flèche à côté du nom de votre serveur pour ouvrir l’arborescence.
- Cliquez sur Pools d’applications.
- Faites un clic droit sur BPP_AppPool et sélectionnez Paramètres avancés.
- Faites défiler et trouvez le paramètre Identité. La valeur sera probablement en gras car elle est définie sur une identité locale personnalisée créée par BarTender.
- Cliquez sur Identité puis sur le bouton à droite avec les points de suspension [...]. Cela ouvrira la boîte de dialogue des paramètres.
- Cliquez sur le bouton Définir.
- Saisissez le nom d’utilisateur complet et le mot de passe. N’oubliez pas d’ajouter le nom de domaine pour que le pool d’applications utilise un utilisateur du domaine et non un utilisateur local.
- Cliquez sur OK et fermez toutes les boîtes de dialogue pour revenir au gestionnaire IIS.
- Avec BPP_AppPool toujours sélectionné, cliquez sur Arrêter dans le menu de droite puis sur Démarrer. Cela redémarrera le pool d’applications avec le nouveau compte.
Si des messages d’erreur apparaissent, vérifiez que les identifiants sont corrects et que le compte répond à toutes les exigences listées dans la section précédente.
Compatibilité
Pour garantir le bon fonctionnement de BarTender Print Portal, il doit être exécuté sur un système d’exploitation compatible. Vous pouvez consulter la liste des systèmes d’exploitation et versions compatibles ici : Versions Windows prises en charge par BarTender. Si vous exécutez BarTender Print Portal sur un système d’exploitation non compatible, par exemple BarTender 2021 sur Windows Server 2008, les services et moteurs d’impression risquent de ne pas fonctionner correctement et vous pourriez rencontrer des plantages ou des comportements irréguliers lors de l’impression. Pour éviter cela, vérifiez la liste avant d’installer BarTender Print Portal.
Il est également recommandé d’adapter la version de BarTender (32 ou 64 bits) à celle de votre système d’exploitation. Si vous utilisez Windows 64 bits, installez BarTender 64 bits. Cela garantit la compatibilité avec IIS et les services BarTender, et assure que les moteurs d’impression fonctionnent efficacement.
Dépannage de BarTender 2021 et versions ultérieures
Cliquez sur le symptôme ou le message d’erreur pour développer la section et afficher les étapes de dépannage.
Le planificateur d’impression est inaccessible
BarTender Print Portal dépend du service BarTender Print Scheduler pour créer les miniatures, générer les aperçus d’impression et lancer l’impression. Si Print Portal ne parvient pas à contacter ce service, vous pouvez voir une erreur comme celle-ci :
Plusieurs raisons peuvent expliquer cette erreur, notamment si le service a été arrêté via la ligne de commande ou dans la console des services, si le compte exécutant le service a changé de mot de passe, ou si quelque chose perturbe la communication.
Pour relancer le service, procédez comme suit :
- Lancez la console Services en la recherchant dans le menu Démarrer.
- Faites défiler jusqu’au service BarTender Print Scheduler.
- Si le service est arrêté, faites un clic droit dessus et sélectionnez Démarrer. S’il est déjà en cours d’exécution, faites un clic droit et sélectionnez Redémarrer.
Si vous recevez un message d’erreur concernant un nom d’utilisateur ou un mot de passe incorrect, consultez Définir les autorisations du service BarTender Print Scheduler
Si le problème persiste après avoir suivi toutes ces étapes, vérifiez la compatibilité entre votre système d’exploitation et la version de BarTender. Si vous utilisez une combinaison incompatible, l’application et les services peuvent avoir du mal à communiquer. Consultez la section compatibilité pour plus d’informations.
Travail d’impression annulé : le fichier n’a pas pu être ouvert, lu ou accédé
Ce message d’erreur est une sorte de message générique pour les erreurs de fichiers et fait généralement référence à deux choses : les autorisations ou des fichiers liés manquants. Voici un exemple et comment analyser ce message d’erreur :
- À côté de Travail d’impression annulé se trouve la condition qui a provoqué l’erreur. Dans cet exemple, il s’agit d’un ensemble d’enregistrements, c’est-à-dire une base de données liée. Le fichier d’étiquette a donc des problèmes pour ouvrir la base de données.
- La deuxième ligne indique ce qui n’a pas pu être ouvert. Ici, il s’agit d’une base de données csv.
- La troisième ligne donne quelques détails sur le problème. Ici, le fichier ou le dossier défini n’a pas pu être trouvé.
Ce message d’erreur indique donc que le fichier n’existe pas à l’emplacement spécifié dans le fichier d’étiquette ou que le service Print Scheduler n’a pas les autorisations nécessaires pour accéder au dossier, ce qui le fait apparaître comme manquant.
Lorsque vous rencontrez ce type d’erreur, la première étape consiste à ouvrir le fichier d’étiquette.
- Des messages d’erreur apparaissent-ils ?
- Pouvez-vous parcourir la base de données dans la boîte de dialogue de configuration des données ou un message indique-t-il qu’il est impossible de se connecter à la base ?
- Avez-vous des images manquantes avec des croix rouges ?
- Pouvez-vous imprimer l’étiquette depuis BarTender Designer ou des messages d’erreur s’affichent-ils ?
Si l’un de ces problèmes apparaît, vous devrez les corriger avant de pouvoir imprimer cette étiquette.
Si vous constatez que l’étiquette s’imprime correctement, il s’agit probablement d’un problème d’autorisations. Si le service Print Scheduler ne peut pas accéder à des ressources liées comme des images ou des bases de données pour imprimer correctement le travail, vous verrez également cette erreur. Pour corriger cela, consultez la section sur les autorisations pour savoir comment résoudre le problème.
La liste des utilisateurs ou groupes est vide lors de la définition des autorisations
Lorsque vous essayez de définir des autorisations pour des dossiers dans BarTender Print Portal, la boîte de dialogue peut apparaître vide lorsque vous sélectionnez Domaine comme emplacement, comme dans la capture ci-dessous :
Cela signifie que BarTender Print Portal n’a pas pu récupérer la liste des utilisateurs et groupes Active Directory. Il n’a pas l’autorisation de le faire. Pour corriger cela, vous devrez ajouter un compte sur le pool d’applications IIS qui a les droits de lecture de la liste Active Directory. Il s’agit généralement d’un compte du domaine. Parlez-en à votre service informatique si vous avez des questions sur les droits de votre compte.
Pour changer le compte du pool d’applications IIS, suivez les instructions ici.
Tous les utilisateurs ou groupes n’apparaissent pas dans la liste du domaine
Bien que vous ayez ajouté un compte de domaine au pool d'applications IIS, il se peut que certains utilisateurs et groupes soient absents de la liste de façon aléatoire.
Un problème empêchait BarTender Print Portal de récupérer la liste complète depuis un Active Directory très volumineux, contenant des dizaines de milliers d'enregistrements ou plus. Veuillez mettre à jour vers BarTender 2021 R5 ou une version ultérieure pour corriger ce problème.
Aucun dossier racine n’a été configuré
Après avoir configuré la sécurité pour des dossiers individuels, lors de la navigation dans Print Portal, vous ou vos utilisateurs pouvez voir un message d’erreur comme celui-ci :
Ce message d’erreur peut être justifié s’il n’y a aucun dossier que l’utilisateur est autorisé à voir.
Cependant, si un utilisateur a bien les droits d’accès à un dossier et que ce message apparaît, il peut y avoir plusieurs causes possibles :
Permissions du pool d’applications
Pour vérifier si l’utilisateur a accès à un dossier, BarTender Print Portal interroge l’Active Directory pour connaître les groupes auxquels appartient l’utilisateur. Si cette vérification échoue, l’accès est refusé par défaut. Cette vérification dépend de l’identité du pool d’applications et peut échouer si le mot de passe a changé, si le compte a été supprimé ou pour une raison similaire.
Si le problème est lié aux permissions, essayez de ressaisir le mot de passe de l’identité ou de la remplacer par un compte ayant les droits nécessaires pour communiquer avec l’Active Directory. Consultez la section sur les permissions pour plus de détails.
Mauvais type de groupe
L’Active Directory peut contenir plusieurs types de groupes selon leur usage. Pour l’authentification, il faut sélectionner uniquement un groupe de type Sécurité dans la liste. Si un autre type de groupe, comme un groupe de Distribution utilisé pour les listes de diffusion email, est choisi, la vérification échouera.
Si l’identité du pool d’applications est correcte mais que les groupes ne permettent toujours pas aux utilisateurs d’accéder à leurs dossiers, mettez à jour BarTender pour que seuls les groupes de type Sécurité apparaissent dans la liste. Après la mise à jour, reconfigurez les permissions des dossiers dans BarTender Print Portal.
Print Portal semble se bloquer lors de la navigation dans les dossiers
Lorsque vous naviguez dans les dossiers de Print Portal, l’application semble se bloquer. Cela se produit lorsqu’il y a un problème de connexion à la base de données système. Plusieurs raisons peuvent expliquer qu’une base de données système ne soit pas connectée :
- l’hôte de la base de données est hors ligne
- la base de données n’existe plus
- la base de données système n’a pas été configurée
- l’utilisateur actuel n’a pas les droits de connexion
Problèmes de connexion
Comme une grande partie de la suite BarTender dépend de la base de données système, il est conseillé de commencer par la Console d’administration où la connexion est configurée. Pour cela, suivez ces étapes :
- Ouvrez la Console d’administration depuis le menu Démarrer.
- Allez dans Base de données système dans le menu de gauche.
- Vérifiez les informations dans la partie supérieure du panneau de droite.
Une connexion saine à la base de données affichera le statut « connecté ». Si vous voyez un autre statut, des données manquantes ou une bannière indiquant qu’aucune base de données système n’est configurée, utilisez le lien de l’Assistant Base de données système pour configurer la connexion et en créer une. Voici un guide pour vous aider dans cette démarche. Il est fortement recommandé d’utiliser l’authentification SQL pour éviter le prochain problème majeur : les permissions. Cette vidéo vous explique comment configurer cela sur une nouvelle base de données. Si votre base de données est gérée, contactez votre administrateur de base de données.
Problèmes de permissions
Si la Console d’administration indique que la connexion est établie mais que vous recevez toujours une erreur de base de données système dans BarTender Print Portal, il s’agit probablement d’un problème de permissions. Quel que soit le mode d’authentification (Windows ou SQL), un compte doit disposer de six permissions de base pour fonctionner correctement. Si l’une de ces six permissions manque, le fonctionnement normal est perturbé et il se peut que vous receviez un message indiquant que la base de données système est inaccessible.
Commencez par vérifier quel compte est utilisé pour se connecter à la base de données système en procédant comme suit :
- Ouvrez la Console d’administration.
- Sélectionnez Base de données système dans le menu de gauche.
- Cliquez sur Assistant Base de données système.
- Choisissez de personnaliser les paramètres de connexion. L’écran suivant vous indiquera la méthode d’authentification.
- Si la méthode est l’authentification SQL, notez le nom du compte affiché dans la boîte de dialogue
- Si la méthode est l’authentification Windows, notez le nom du compte qui exécute le pool d’applications IIS
Une fois le nom du compte obtenu, vous pouvez utiliser ce guide pour vérifier que votre compte dispose de toutes les permissions nécessaires. Si vous ne savez pas comment faire ou si votre base de données est gérée, contactez votre administrateur de base de données et indiquez-lui que vous avez besoin de ces six permissions de base.
Une erreur inconnue est survenue
Lorsque vous essayez d’imprimer, il se peut que vous rencontriez une erreur inconnue comme celle-ci :
Il s’agit d’une erreur générique utilisée pour signaler des problèmes qui n’ont pas de message d’erreur spécifique. Souvent, cela est lié à un problème avec l’étiquette ou un élément associé à celle-ci. Avec une erreur générique de ce type, il est conseillé d’inspecter l’étiquette pour identifier le problème.
Ressources liées
La cause la plus fréquente est l’absence de ressources. Ouvrez l’étiquette et examinez-la.
- Des messages d’erreur apparaissent-ils ?
- Pouvez-vous parcourir la base de données dans la boîte de dialogue de configuration des données ou un message indique-t-il que la connexion à la base de données est impossible ?
- Des images manquantes avec une croix rouge s’affichent-elles ?
- Pouvez-vous imprimer l’étiquette depuis BarTender Designer ou des messages d’erreur apparaissent-ils ?
Si l’un de ces problèmes apparaît, il faudra les corriger avant de pouvoir imprimer cette étiquette.
Si l’étiquette s’imprime correctement, il se peut que le problème soit lié aux permissions. Si le service Print Scheduler ne parvient pas à accéder à certaines ressources liées (images, bases de données, etc.) pour imprimer correctement, cette erreur peut également apparaître. Pour corriger cela, consultez la section sur les permissions pour savoir comment résoudre le problème.
Bases de données liées
Les bases de données liées à une étiquette peuvent être plus complexes à gérer car plusieurs éléments entrent en jeu. Lors de la connexion à une base de données dans Print Portal, la connexion utilise le compte du pool d’applications IIS (pour l’authentification Windows) ou les identifiants enregistrés dans l’étiquette (pour l’authentification base de données). Les bases de données texte affichent généralement des erreurs de fichier en cas de problème de connexion, donc cette section concerne surtout les bases de données relationnelles.
Voici quelques causes possibles d’erreur de base de données :
- La base de données a été déplacée ou renommée
- La base de données est hors ligne
- La connexion ODBC est configurée avec un DSN utilisateur au lieu d’un DSN système
- Les identifiants nécessaires pour se connecter à la base de données ne sont pas enregistrés dans l’étiquette.
- La base de données utilise l’authentification Windows et l’utilisateur exécutant BarTender Print Portal n’est pas autorisé à y accéder.
Comme il existe de nombreux types de bases de données et de connexions, cette liste n’est pas exhaustive et toutes les options ne s’appliquent pas à chaque connexion. Il est préférable d’ouvrir l’étiquette, de vérifier le type de connexion et de procéder au dépannage à partir de là.
- Commencez par ouvrir la boîte de dialogue de connexion à la base de données via Fichier > Configuration de la connexion à la base de données.
- Si une erreur de connexion apparaît à l’ouverture de la boîte de dialogue ou lors de la navigation dans les enregistrements, la base de données a probablement été déplacée, renommée, est hors ligne ou indisponible. Vous devrez localiser la base de données et vérifier qu’elle est accessible et en ligne. Si votre base de données est gérée, contactez votre administrateur de base de données.
- Dans la boîte de dialogue de configuration de la base de données, cliquez sur Assistant de configuration de la base de données et vérifiez les détails de la connexion.
- La connexion utilise-t-elle l’authentification Windows ou l’authentification base de données ?
- Les identifiants sont-ils enregistrés dans le document (pour l’authentification base de données) ?
- Les identifiants sont-ils corrects ?
- Si vous utilisez une connexion ODBC, vérifiez la configuration du DSN.
Une fois les erreurs corrigées, l’authentification vérifiée et les identifiants enregistrés dans le document (sauf pour l’authentification Windows), n’oubliez pas d’enregistrer le document et de le replacer dans le dossier Print Portal.
Aperçu
BarTender Print Portal est une application web qui permet aux utilisateurs d’imprimer depuis n’importe où en accédant au site web où Print Portal est hébergé. L’application fonctionne dans Internet Information Services (IIS) et repose sur un noyau .NET. Cet article va vous aider à vous familiariser avec certains composants et à résoudre les problèmes courants. Il ne s’agit pas d’une liste exhaustive, mais cela devrait vous permettre de bien démarrer. Ce guide vise à aider au dépannage côté BarTender, car le dépannage d’IIS sort un peu du cadre de cet article.
S’applique à
BarTender 2016 et 2019
Informations
Pour dépanner n’importe quelle version de BarTender Print Portal, assurez-vous d’utiliser la dernière version disponible afin de ne pas essayer de résoudre un problème qui a déjà été corrigé. Consultez Comment mettre à jour vers la révision actuelle de BarTender pour obtenir de l’aide à ce sujet.
Vous devrez également avoir la console de gestion Web IIS installée sur votre système. Vous pouvez trouver cette console dans les fonctionnalités de Windows ou les fonctionnalités du serveur. Si vous avez du mal à trouver la liste des fonctionnalités, veuillez contacter un professionnel de l’informatique pour obtenir de l’aide.
Composants de BarTender Print Portal
BarTender Print Portal s’appuie sur plusieurs composants pour fonctionner, dont plusieurs services qui assurent la stabilité de l’application. Voici quelques-uns des services clés :
- Service système BarTender – responsable de la communication avec la base de données système BarTender
- Service BarTender Print Scheduler – gère les moteurs d’impression mentionnés dans la section suivante
- Service de partage de port .Net/Tcp – un service Windows qui facilite la communication entre BarTender Print Portal et BarTender Print Scheduler pour les travaux d’impression
En plus des services nécessaires au fonctionnement, voici deux composants majeurs détaillés :
Moteurs d’impression
Les moteurs d’impression sont en fait BarTender Designer qui s’exécute comme un service, démarrant et s’arrêtant dynamiquement selon les besoins pour répondre aux demandes de BarTender Print Portal. Ces moteurs d’impression sont gérés par le service BarTender Print Scheduler et ne nécessitent aucune intervention de l’utilisateur pour fonctionner.
Lorsqu’un utilisateur crée un travail d’impression en cliquant sur le bouton d’impression, un moteur d’impression démarre automatiquement s’il n’est pas déjà en cours d’exécution. Il ouvre le document, traite les données envoyées depuis BarTender Print Portal, puis envoie un travail d’impression au spouleur d’impression Windows pour l’envoyer à votre imprimante. À partir de BarTender 2021, les moteurs d’impression sont également responsables de l’aperçu des étiquettes.
Base de données système
La base de données système BarTender est une base SQL qui fonctionne en arrière-plan de toute la suite BarTender. Il peut s’agir d’une base locale installée via la console d’administration ou l’assistant d’installation, ou d’une base centralisée hébergée sur un serveur dédié.
Dans toutes les versions de BarTender, la base de données système est requise pour exécuter BarTender Print Portal. L’application ne fonctionnera pas sans elle.
Autorisations pour un fonctionnement normal
BarTender Print Portal nécessite certaines autorisations pour fonctionner normalement. Il ne s’agit pas ici des autorisations pour contrôler l’accès des utilisateurs individuels, mais des autorisations nécessaires aux composants pour qu’ils puissent fonctionner correctement. Ces autorisations permettent à BarTender Print Portal de :
- Accéder aux étiquettes, les ouvrir et les imprimer
- Accéder aux imprimantes, localement ou sur le réseau
- Accéder à la liste des utilisateurs et groupes Active Directory (pour BarTender 2021 et versions ultérieures)
- Accéder à Librarian
Cette liste n’est pas exhaustive mais couvre certaines des fonctionnalités clés dont BarTender Print Portal a besoin pour fonctionner. Par défaut, BarTender Print Portal fonctionne avec un compte administrateur local qui a accès aux imprimantes installées localement et au répertoire Print Portal sur votre système, mais parfois cela ne suffit pas et les vérifications d’autorisations échouent.
Il y a trois points principaux où des problèmes d’autorisations peuvent survenir : le service BarTender Print Scheduler, l’identité du pool d’applications IIS et la connexion à la base de données système.
Pour le service Print Scheduler et l’identité du pool d’applications, vous aurez besoin d’un compte Windows avec les propriétés suivantes :
- Être administrateur local, car il aura besoin d’accéder au répertoire de fichiers Print Portal
- Avoir un accès au niveau du domaine, si vous prévoyez d’utiliser des ressources du domaine comme des imprimantes ou des lecteurs réseau. Il n’est pas nécessaire d’être administrateur du domaine.
- Ne pas changer de mot de passe. Vous ne voulez pas d’erreurs d’autorisations si votre politique de mot de passe s’applique dans quelques mois.
- Avoir l’autorisation de stratégie de groupe de connexion locale. Il ne peut pas exécuter un service ou un pool d’applications sans cela.
- Avoir les autorisations pour accéder à la base de données système. Ceci n’est requis que si vous utilisez l’authentification Windows.
Il est recommandé d’utiliser le même compte pour le Print Scheduler et l’identité du pool d’applications. Vous pouvez d’abord ajouter le compte au service pour tester les autorisations, car l’identité du pool d’applications ne donne généralement pas de messages d’erreur en cas de manque d’autorisation.
Pour la base de données système, il est conseillé d’utiliser l’authentification SQL afin d’éviter tout problème d’autorisations avec l’authentification Windows. Pour plus d’informations, consultez Configurer les autorisations pour une base de données système (Vidéo - 5:45).
Définir les autorisations du service BarTender Print Scheduler
Pour changer le compte du service Print Scheduler, veuillez suivre les étapes suivantes :
- Ouvrez l’application Services de Windows en la recherchant dans le menu Démarrer ou en la trouvant dans le Panneau de configuration.
- Faites défiler jusqu’au service BarTender Print Scheduler.
- Faites un clic droit sur le service et allez dans Propriétés.
- Cliquez sur l’onglet Connexion.
- Sélectionnez Ce compte et saisissez le nom d’utilisateur et le mot de passe. N’oubliez pas d’ajouter le nom de domaine, sinon le service tentera de démarrer avec un compte local.
- Une fois les identifiants saisis, cliquez sur OK et passez les notifications concernant le changement de compte.
- Faites un clic droit sur le service BarTender Print Scheduler et sélectionnez Redémarrer pour relancer le service avec le nouveau compte.
Si vous recevez des erreurs au démarrage, vérifiez que le compte dispose bien de toutes les autorisations listées dans la section précédente et recommencez ces étapes.
Définir les autorisations de l’identité du pool d’applications IIS
Pour changer le compte de l’identité du pool d’applications IIS, veuillez suivre les étapes suivantes :
- Lancez le Gestionnaire des services Internet (IIS).
- Cliquez sur la flèche à côté du nom de votre serveur pour ouvrir l’arborescence.
- Cliquez sur Pools d’applications.
- Faites un clic droit sur BPP_AppPool et sélectionnez Paramètres avancés.
- Faites défiler et trouvez le paramètre Identité. La valeur sera probablement en gras car elle est définie sur une identité locale personnalisée créée par BarTender.
- Cliquez sur Identité puis sur le bouton à droite avec les points de suspension [...]. Cela ouvrira la boîte de dialogue des paramètres.
- Cliquez sur le bouton Définir.
- Saisissez le nom d’utilisateur complet et le mot de passe. N’oubliez pas d’ajouter le nom de domaine pour que le pool d’applications utilise un utilisateur du domaine et non un utilisateur local.
- Cliquez sur OK et fermez toutes les boîtes de dialogue pour revenir au gestionnaire IIS.
- Avec BPP_AppPool toujours sélectionné, cliquez sur Arrêter dans le menu de droite puis sur Démarrer. Cela redémarrera le pool d’applications avec le nouveau compte.
Si des messages d’erreur apparaissent, vérifiez que les identifiants saisis sont corrects et que le compte répond à toutes les exigences listées précédemment.
Compatibilité
Pour garantir le bon fonctionnement de BarTender Print Portal, il doit être exécuté sur un système d’exploitation compatible. Vous pouvez consulter la liste des systèmes d’exploitation et versions compatibles ici : Versions Windows prises en charge par BarTender. Si vous exécutez BarTender Print Portal sur un système d’exploitation non compatible, les services et moteurs d’impression risquent de ne pas fonctionner correctement et vous pourriez rencontrer des plantages ou des comportements irréguliers lors de l’impression. Pour éviter cela, vérifiez la liste avant d’installer BarTender Print Portal.
Il est également recommandé d’installer la version de BarTender correspondant à l’architecture de votre système d’exploitation. Si vous utilisez Windows 64 bits, installez BarTender 64 bits. Cela garantit la compatibilité avec IIS et les services BarTender, et assure que les moteurs d’impression fonctionnent efficacement.
Dépannage BarTender 2016 & 2019
Cliquez sur un message d’erreur pour développer la section et afficher les étapes de dépannage
Impossible d’accéder à la base de données système BarTender
BarTender Print Portal dépend de la base de données système pour de nombreuses opérations. En cas de problème de connexion, vous verrez un message comme celui-ci :
Voici quelques raisons pour lesquelles une base de données système peut ne pas être connectée :
- l’hôte de la base de données est hors ligne.
- la base de données n’existe plus.
- la base de données système n’a pas été configurée.
- l’utilisateur actuel n’a pas les autorisations pour se connecter.
Problèmes de connexion
Comme une grande partie de la suite BarTender dépend de la base de données système, le meilleur endroit pour commencer est la console d’administration où la connexion est définie. Pour cela, veuillez suivre les étapes suivantes :
- Ouvrez la Console d’administration depuis le menu Démarrer.
- Allez dans Base de données système dans le menu de gauche.
- Vérifiez les détails dans la partie supérieure du volet de droite.
Une connexion à la base de données en bon état affichera le statut connecté. Si vous voyez un autre statut, des données manquantes ou une bannière indiquant qu’aucune base de données système n’est configurée, utilisez le lien de l’Assistant Base de données système pour configurer votre connexion et en créer une. Voici un guide pour vous aider dans le processus. Il est fortement recommandé d’utiliser l’authentification SQL pour éviter le prochain problème majeur : les autorisations. Cette vidéo vous guidera pour configurer cela sur une nouvelle base de données. Si votre base de données est gérée, veuillez contacter votre administrateur de base de données.
Problèmes d’autorisations
Si la console d’administration indique que la connexion est établie mais que vous recevez toujours une erreur de base de données système dans BarTender Print Portal, il s’agit probablement d’un problème d’autorisations. Quel que soit le mode d’authentification (Windows ou SQL), un compte doit disposer de six autorisations de base pour fonctionner correctement. Si ce compte ne possède pas ces six autorisations, le fonctionnement normal est compromis et il se peut même que l’application indique qu’elle ne peut pas accéder à la base de données système.
Commencez par vérifier quel compte est utilisé pour se connecter à la base de données système en procédant comme suit :
- Ouvrez la Console d’administration.
- Sélectionnez Base de données système dans le menu de gauche.
- Cliquez sur Assistant Base de données système.
- Choisissez de personnaliser les paramètres de connexion. L’écran suivant vous indiquera la méthode d’authentification.
- Si la méthode est l’authentification SQL, notez le nom du compte affiché dans la boîte de dialogue.
- Si la méthode est l’authentification Windows, notez le nom du compte qui exécute le pool d’applications IIS.
Une fois que vous avez le nom du compte, vous pouvez utiliser ce guide pour vérifier que votre compte dispose de toutes les autorisations nécessaires. Si vous ne savez pas comment faire ou si votre base de données est gérée, veuillez contacter votre administrateur de base de données et lui indiquer que vous avez besoin de ces six autorisations de base.
Échec de la connexion au service BarTender Print Scheduler
BarTender Print Portal dépend du service BarTender Print Scheduler pour générer les aperçus avant impression et lancer une impression. Si Print Portal n’arrive pas à contacter ce service, vous pouvez voir une erreur comme celle-ci :
Plusieurs raisons peuvent expliquer cette erreur : le service a été arrêté via la ligne de commande ou dans la console des services, le compte qui exécute le service a changé de mot de passe, ou encore un problème de communication est survenu.
Pour relancer le service, veuillez suivre ces étapes :
- Ouvrez la console des services en la recherchant dans le menu Démarrer ou en la trouvant dans le panneau de configuration.
- Descendez jusqu’au service BarTender Print Scheduler.
- Si le service est arrêté, faites un clic droit dessus et sélectionnez Démarrer. Si le service est déjà en cours d’exécution, faites un clic droit et sélectionnez Redémarrer.
Si vous recevez un message d’erreur concernant un nom d’utilisateur ou un mot de passe incorrect, consultez Définir les autorisations du service BarTender Print Scheduler
Si le problème persiste après avoir essayé toutes ces étapes, vérifiez la compatibilité entre votre système d’exploitation et la version de BarTender. Si vous utilisez une combinaison incompatible, l’application et les services peuvent avoir du mal à communiquer. Veuillez consulter la section compatibilité pour plus d’informations.
Cette opération envoyée à PrintScheduler/Service n’a pas reçu de réponse dans le délai imparti
BarTender Print Portal dépend du service BarTender Print Scheduler pour générer les aperçus avant impression et lancer une impression. Dans certains cas, la communication entre les deux s’interrompt soudainement et vous recevez ce long message d’erreur :
Il existe plusieurs solutions possibles à ce message d’erreur, mais la plus simple et la plus courante consiste à redémarrer le service BarTender Print Scheduler :
- Ouvrez la console des services en la recherchant dans le menu Démarrer ou en la trouvant dans le panneau de configuration.
- Descendez jusqu’au service BarTender Print Scheduler.
- Si le service est arrêté, faites un clic droit dessus et sélectionnez Démarrer. Si le service est déjà en cours d’exécution, faites un clic droit et sélectionnez Redémarrer.
Si vous recevez un message d’erreur concernant un nom d’utilisateur ou un mot de passe incorrect, consultez Définir les autorisations du service BarTender Print Scheduler. Cela peut être dû au fait que le compte utilisé par le service a changé de mot de passe. Il est recommandé d’utiliser un compte dont le mot de passe ne change pas.
Travail d’impression annulé : le fichier n’a pas pu être ouvert, lu ou accédé
Ce message d’erreur est une sorte de message générique pour les erreurs de fichiers et fait généralement référence à deux choses : les autorisations ou des fichiers liés manquants. Voici un exemple et comment analyser ce message d’erreur :
- À côté de Travail d’impression annulé, vous voyez la condition qui a provoqué l’erreur. Dans cet exemple, il s’agit d’un ensemble d’enregistrements, c’est-à-dire une base de données liée. Le fichier d’étiquette a donc des problèmes pour ouvrir la base de données.
- Ensuite, il est indiqué ce qui n’a pas pu être ouvert. Ici, il s’agit d’une base de données csv.
- Puis, quelques détails sur le problème. Dans ce cas, le fichier n’a pas pu être trouvé ou le dossier défini n’a pas pu être localisé.
Ce message d’erreur indique donc que le fichier n’existe pas à l’emplacement spécifié dans le fichier d’étiquette ou que le service Print Scheduler n’a pas les droits nécessaires pour accéder au dossier, ce qui donne l’impression qu’il manque.
Lorsque vous rencontrez ce type d’erreur, la première étape consiste à ouvrir le fichier d’étiquette.
- Des messages d’erreur s’affichent-ils ?
- Pouvez-vous parcourir la base de données dans la boîte de dialogue de configuration des données ou un message indique-t-il qu’il est impossible de se connecter à la base de données ?
- Avez-vous des images manquantes avec des croix rouges ?
- Pouvez-vous imprimer l’étiquette depuis BarTender Designer ou des messages d’erreur apparaissent-ils ?
Si l’un de ces problèmes apparaît, il faudra les corriger avant de pouvoir imprimer cette étiquette.
Si vous constatez que l’étiquette s’imprime sans problème, il se peut que ce soit un souci d’autorisations. Si le service Print Scheduler n’arrive pas à accéder à certaines ressources liées comme des images ou des bases de données pour imprimer correctement, vous verrez aussi cette erreur. Pour corriger cela, consultez la section sur les autorisations pour savoir comment résoudre le problème.
Impossible de créer l’ensemble d’enregistrements
Lors de l’impression ou de l’aperçu d’une étiquette, un message d’erreur similaire à celui-ci apparaît en bas de l’écran :
Ce message est une erreur de base de données, indiquant qu’il y a un problème avec la connexion à la base de données enregistrée dans l’étiquette. Lors de la connexion à une base de données dans Print Portal, la connexion utilise le compte du pool d’applications IIS (pour l’authentification Windows) ou les identifiants enregistrés dans l’étiquette (pour l’authentification base de données). Les bases de données texte génèrent généralement des erreurs de fichiers en cas de problème de connexion, donc cette section concerne surtout les bases de données relationnelles.
Quelques causes possibles pour ce message d’erreur :
- La base de données a été déplacée ou renommée.
- La base de données est hors ligne.
- La connexion ODBC est configurée avec un DSN utilisateur au lieu d’un DSN système.
- Les identifiants nécessaires pour se connecter à la base de données ne sont pas enregistrés dans l’étiquette.
- La base de données utilise l’authentification Windows et l’utilisateur actuel qui exécute BarTender Print Portal n’est pas autorisé à accéder à la base de données.
Comme il existe de nombreux types de bases de données et de connexions, cette liste n’est pas exhaustive et toutes les options ne conviendront pas à chaque connexion. Il est préférable d’ouvrir l’étiquette, de vérifier le type de connexion et de procéder au dépannage à partir de là. Commencez par ouvrir la boîte de dialogue de connexion à la base de données via Fichier > Configuration de la connexion à la base de données
- Si vous recevez une erreur de connexion à l’ouverture de la boîte de dialogue ou lors de la navigation dans les enregistrements, la base de données a probablement été déplacée, renommée, est hors ligne ou indisponible. Vous devrez localiser la base de données et vérifier qu’elle est disponible et en ligne. Si votre base de données est gérée, contactez votre administrateur de base de données.
- Dans la boîte de dialogue de configuration de la base de données, cliquez sur l’assistant de configuration et vérifiez les détails de la connexion
- La connexion utilise-t-elle l’authentification Windows ou l’authentification base de données ?
- Les identifiants sont-ils enregistrés dans le document (pour l’authentification base de données) ?
- Les identifiants sont-ils corrects ?
- Si vous utilisez une connexion ODBC, vérifiez la configuration du DSN.
Une fois les erreurs corrigées, l’authentification vérifiée et les identifiants enregistrés dans le document (sauf pour l’authentification Windows), n’oubliez pas d’enregistrer le document et de le replacer dans le dossier Print Portal.
Vous avez encore besoin d'aide ? Contactez-nous !