概述

BarTender Print Portal 是一款基于网页的应用程序，用户可以通过访问托管 Print Portal 的网站，实现随时随地打印。该应用程序运行在 Internet Information Services (IIS) 上，并基于 .NET core。本篇文章将帮助您了解部分组件，并解决常见问题。虽然不是详尽无遗的列表，但足以帮助您入门。本指南主要用于排查 BarTender 端的问题，IIS 的排查不在本文范围内。

适用范围

BarTender 2021 及更高版本

信息

本文适用于 BarTender 2021 及更高版本。由于不同版本的 BarTender Print Portal 存在差异，请在上方下拉菜单中选择您的版本。

为排查任何版本的 BarTender Print Portal 问题，请确保您正在运行该版本的最新发布版，以免排查已被修复的问题。请参阅如何更新到 BarTender 当前版本获取相关帮助。

您还需要在系统上安装 IIS Web 管理控制台。该控制台可在 Windows 功能或服务器功能中找到。如果您找不到功能列表，请联系 IT 专业人员协助。

BarTender Print Portal 的组成部分

BarTender Print Portal 依赖多个组件运行，包括一些关键服务来保证应用的正常运作。以下是部分主要服务：

BarTender 系统服务 - 负责与 BarTender 系统数据库的通信。
BarTender 打印调度服务 - 负责管理下文提到的打印引擎。
.Net/Tcp 端口共享服务 - Windows 服务，帮助 BarTender Print Portal 与 BarTender 打印调度服务之间进行打印任务通信。

除了用于运行的服务外，以下是两个主要组件的详细介绍：

打印引擎

打印引擎本质上是以服务形式运行的 BarTender Designer，根据 BarTender Print Portal 的需求动态启动和停止。打印引擎由 BarTender 打印调度服务维护，无需用户干预即可运行。

当用户点击打印按钮创建打印任务时，如果没有正在运行的打印引擎，则会自动启动一个打印引擎。它会打开文档，处理从 BarTender Print Portal 发送的数据，然后将打印任务发送到 Windows 打印后台处理程序，再传送到您的打印机。在 BarTender 2021 及更高版本中，打印引擎还负责生成标签预览。

系统数据库

BarTender 系统数据库是一个 SQL 数据库，支撑整个 BarTender 套件的运行。它可以是通过管理控制台或安装向导安装的本地数据库，也可以是托管在专用服务器上的集中式数据库。

在所有版本的 BarTender 中，系统数据库都是运行 BarTender Print Portal 的必要条件。没有它，应用无法正常工作。

正常运行所需权限

BarTender Print Portal 需要一定的权限才能正常运行。这里说的不是针对单个用户的访问控制权限，而是组件执行其任务所需的权限。这些权限允许 BarTender Print Portal 执行以下操作：

访问标签文件、打开并打印它们。
访问本地或网络上的打印机。
访问 Active Directory 用户和组列表（适用于 BarTender 2021 及更高版本）。
访问 Librarian。

这并不是全部权限要求，但涵盖了 BarTender Print Portal 正常运行所需的主要功能。默认情况下，BarTender Print Portal 以本地管理员账户运行，该账户可以访问本地安装的打印机和系统上的 Print Portal 目录，但有时这还不够，权限检查可能会失败。

权限问题主要有三个方面：BarTender 打印调度服务、IIS 应用程序池身份和系统数据库登录。

对于打印调度服务和应用程序池身份，您需要一个具备以下属性的 Windows 账户：

是本地管理员，因为需要访问 Print Portal 文件目录
如果需要使用域资源（如打印机或网络驱动器），则需具备域级访问权限。无需成为域管理员。
有权限读取 Active Directory 中的用户和组列表（适用于 BarTender 2021 及更高版本）
密码不应更改。避免因密码策略导致权限错误。
具备本地登录组策略权限。没有此权限无法运行服务或应用池。
有权限访问系统数据库。如果使用 Windows 身份验证，则必须具备此权限。

建议打印调度服务和应用程序池身份使用同一个账户。您可以先将账户添加到服务中测试权限，因为应用程序池身份缺少权限时通常不会报错。

对于系统数据库，建议使用 SQL 身份验证，以避免 Windows 身份验证带来的权限问题。更多信息请参阅配置系统数据库权限（视频 - 5:45）。

设置 BarTender 打印调度服务权限

要更改打印调度服务的账户，请按以下步骤操作：

在开始菜单搜索或控制面板中找到并打开 Windows 服务应用。
向下滚动找到 BarTender 打印调度服务。
右键点击该服务，选择属性。
点击登录选项卡。
选择 此账户，输入用户名和密码。请记得添加域名，否则服务会尝试以本地账户启动。

输入凭据后，点击确定，并根据提示完成账户更改。
右键点击 BarTender 打印调度服务，选择 重新启动，以新账户重启服务。

如果启动时出现错误，请再次检查账户是否具备前述所有权限，并重复上述步骤。

设置 IIS 应用程序池身份权限

要更改 IIS 应用程序池身份的账户，请按以下步骤操作：

启动 Internet Information Services (IIS) 管理器。
点击服务器名称旁的箭头展开树形结构。
点击 应用程序池。
右键点击 BPP_AppPool，选择 高级设置。
向下滚动，找到身份设置。该身份通常为加粗显示，表示已设置为 BarTender 创建的自定义本地身份。
点击身份，然后点击右侧带有省略号 [...] 的按钮，打开设置对话框。
点击设置按钮。
在输入框中填写完整的用户名和密码。请记得添加域名，以便应用程序池使用域用户而非本地用户。
点击确定，关闭所有对话框，返回 IIS 管理器。
保持 BPP_AppPool 选中状态，点击右侧菜单中的停止，然后点击启动。这样应用程序池会以新账户重启。

如果出现错误提示，请再次确认输入的凭据无误，并确保账户满足前述所有要求。

兼容性

请注意，Print Portal 设计可兼容所有主流网页浏览器。但 BarTender 2021 及更高版本不推荐也不支持使用 Internet Explorer。

为确保 BarTender Print Portal 顺利运行，必须在兼容的操作系统上运行。兼容操作系统及版本列表请见：BarTender 支持的 Windows 版本。如果在不兼容的操作系统上运行 BarTender Print Portal，例如在 Windows Server 2008 上运行 BarTender 2021，服务和打印引擎可能无法正常运行，打印时可能出现崩溃或异常行为。为避免此类问题，请在安装前查阅兼容性列表。

同时建议 BarTender 的位数与操作系统一致。如果您运行的是 64 位 Windows，请安装 64 位 BarTender。这样可确保与 IIS 及 BarTender 服务的兼容性，并提升打印引擎的运行效率。

BarTender 2021 及更高版本故障排查

点击症状或错误信息可展开相应的排查步骤。

无法连接到打印调度服务

BarTender Print Portal 依赖 BarTender 打印调度服务来生成缩略图、打印预览和执行打印任务。如果 Print Portal 无法联系该服务，您可能会看到如下错误：

导致此错误的原因有很多，包括服务被命令行或服务管理器停止、运行服务的账户更改了密码，或通信被其他因素干扰。

要恢复服务，请按以下步骤操作：

在开始菜单中搜索并启动服务管理器。
向下滚动找到 BarTender 打印调度服务。
如果服务已停止，右键点击并选择启动。如果服务正在运行，右键点击并选择 重新启动。

如果收到用户名或密码错误的提示，请参阅设置 BarTender 打印调度服务权限

如果尝试上述所有步骤后仍有问题，请检查操作系统与 BarTender 版本的兼容性。如果使用了不兼容的组合，应用和服务之间可能无法正常通信。详情请参阅兼容性部分。

打印任务中止：文件无法打开、读取或访问

此错误信息属于文件错误的通用提示，通常涉及权限或缺失的关联文件。以下是一个示例及如何分析该错误信息：

打印任务中止后面是导致错误的条件。本例中是记录集，也就是关联数据库。标签文件在打开数据库时遇到问题。
第二行说明无法打开的内容，这里是一个 csv 数据库。
第三行简要说明了问题所在，这里是找不到该文件或指定的文件夹。

因此，该错误提示表明标签文件指定的位置不存在该文件，或打印调度服务没有权限访问该目录，导致文件“看起来”丢失。

遇到此类错误时，第一步应打开标签文件：

是否弹出任何错误提示？
在数据设置对话框中能否浏览数据库，还是提示无法连接数据库？
是否有带红色 X 的缺失图片？
能否在 BarTender Designer 中打印标签，是否有错误提示？

如果出现上述问题，需要先修正后才能打印该标签。

如果标签在 Designer 中可以正常打印，则可能是权限问题。如果打印调度服务无法获取打印任务所需的关联资源（如图片、数据库），也会出现此错误。解决方法请参阅权限部分。

设置权限时用户或组列表为空

当您尝试在 BarTender Print Portal 中为文件夹设置权限时，选择“域”作为位置后，列表显示为空，如下图所示：

这说明 BarTender Print Portal 无法获取 Active Directory 的用户和组信息，缺少相应权限。要解决此问题，需要在 IIS 应用程序池中添加有读取 Active Directory 列表权限的账户，通常只需域账户即可。如有疑问，请咨询 IT 部门确认您的账户是否有读取权限。

更改 IIS 应用程序池账户，请参考此处操作说明。

域用户或组列表未全部显示

即使已将域账户添加到 IIS 应用程序池，您可能会发现用户和组有时会随机缺失。

曾经有一个问题，当 Active Directory 记录数达到数万甚至更多时，BarTender Print Portal 无法获取完整的用户列表。请升级到 BarTender 2021 R5 或更高版本以解决此问题。

未配置根文件夹

在为单独文件夹配置安全性后，浏览 Print Portal 时，您或您的用户可能会看到如下错误提示：

如果用户没有权限查看任何文件夹，这个错误提示是正常的。

但如果某个用户确实有权限查看某个文件夹，却仍然看到此错误提示，可能有以下几种原因：

应用程序池权限

在检查用户是否有权限查看文件夹时，BarTender Print Portal 会向 Active Directory 查询该用户所属的组。如果此检查失败，用户默认会被拒绝访问。此检查依赖于应用程序池的身份，如果身份密码被更改、被移除或发生类似情况，检查就会失败。

如果是权限问题导致的，请尝试重新输入身份的密码，或更换为有权限访问 Active Directory 的账户。更多详情请参见权限部分。

组类型错误

Active Directory 中有多种不同类型的组，功能各异。用于身份验证时，只能选择“安全性”类型的组。如果选择了如用于邮件列表的“通讯”类型组，与 Active Directory 的检查会失败。

如果应用程序池身份正确，但组仍无法显示有效用户的文件夹，请升级 BarTender，确保列表中只显示“安全性”类型的组。升级后，请重新配置 BarTender Print Portal 的文件夹权限。

浏览文件夹时 Print Portal 卡住

在 Print Portal 浏览文件夹时，应用程序似乎卡住了。这通常是因为无法连接到系统数据库。导致系统数据库无法连接的原因可能有：

数据库主机已离线
数据库已不存在
系统数据库未设置
当前用户没有连接权限

连接问题

由于 BarTender 套件的大部分功能都依赖于系统数据库，建议首先在管理控制台检查连接设置。操作步骤如下：

从开始菜单打开管理控制台。
在左侧菜单中选择系统数据库。
查看右侧上方的详细信息。

正常的数据库连接会显示“已连接”状态。如果看到其他状态、数据缺失，或有提示未设置系统数据库，请使用系统数据库向导链接配置数据库连接并完成设置。这里有一份操作指南可以帮助您完成整个过程。强烈建议使用 SQL 身份验证，以避免下一个常见问题——权限问题。本视频会指导您在新数据库中完成相关设置。如果您的数据库由他人管理，请联系数据库管理员。

权限问题

如果管理控制台显示“已连接”，但在 BarTender Print Portal 仍然收到系统数据库错误，通常是权限问题。无论使用 Windows 还是 SQL 身份验证，账户都需要有六项基本权限才能正常运行。如果缺少其中任何一项，系统可能无法正常工作，甚至提示无法访问系统数据库。

首先请按以下步骤检查用于连接系统数据库的账户：

打开管理控制台。
选择左侧菜单中的系统数据库。
点击系统数据库向导。
选择自定义连接设置。在下一个界面会显示身份验证方式。
1. 如果是 SQL 身份验证，请记下对话框中显示的账户名
2. 如果是 Windows 身份验证，请记下运行 IIS 应用程序池的账户名

获得账户名后，可参考本指南检查账户是否拥有所有必要权限。如果不清楚如何操作，或数据库由他人管理，请联系数据库管理员，说明需要这六项基本权限。

遇到未知错误

尝试打印时，您可能会遇到如下未知错误：

这是一个通用错误，用于捕捉没有其他错误信息可显示的问题。通常与标签本身或与标签相关的内容有关。遇到这种通用错误，建议先检查标签本身，找出问题所在。

关联资源

最常见的原因是资源缺失。请打开标签进行检查：

是否弹出任何错误提示？
在数据设置对话框中能否浏览数据库，还是提示无法连接数据库？
是否有带红色 X 的缺失图片？
能否在 BarTender Designer 中打印标签，还是会出现错误提示？

如果出现上述任何情况，请先修复这些问题，才能打印该标签。

如果标签本身可以正常打印，则可能是权限问题。如果 Print Scheduler 服务无法获取打印所需的图片、数据库等关联资源，也会出现此错误。解决方法请参见权限部分。

关联数据库

标签中关联的数据库问题会更复杂一些，因为涉及多个因素。在 Print Portal 连接数据库时，使用的是 IIS 应用程序池账户（Windows 身份验证）或标签中保存的凭据（数据库身份验证）。文本数据库出错时通常会提示文件错误，本节主要针对关系型数据库。

以下是可能导致数据库错误的一些原因：

数据库已被移动或重命名
数据库处于离线状态
ODBC 连接使用了用户 DSN 而不是系统 DSN
连接数据库所需的凭据未保存在标签中
数据库使用 Windows 身份验证，而当前运行 BarTender Print Portal 的用户无权访问数据库

由于数据库类型和连接方式众多，以上并非全部可能原因，也不是每种情况都适用。建议打开标签，查看连接类型并针对性排查。

首先通过文件 > 数据库连接设置打开数据库对话框。
如果打开对话框或浏览记录时出现连接错误，说明数据库可能已被移动、重命名、离线或不可用。请确认数据库是否可用并在线。如果数据库由他人管理，请联系数据库管理员。
在数据库设置对话框中，点击数据库设置向导，检查连接详情。
- 连接方式是 Windows 身份验证还是数据库身份验证？
- 凭据是否已保存在文档中（针对数据库身份验证）？
- 凭据是否正确？
如果使用 ODBC 连接，请检查DSN 配置。

修正所有错误、确认身份验证方式正确、凭据已保存（Windows 身份验证除外）后，请保存文档并放回 Print Portal 文件夹。

概述

BarTender Print Portal 是一款基于网页的应用程序，用户可以通过访问托管 Print Portal 的网站，实现随时随地打印。该应用程序运行在 Internet 信息服务（IIS）中，并基于 .NET core。本篇文章将帮助您了解部分组件，并解决常见问题。虽然不是详尽无遗的列表，但足以帮助您入门。本指南主要用于排查 BarTender 端的问题，IIS 的排查不在本文范围内。

适用范围

BarTender 2016 和 2019

信息

本文适用于 BarTender 2016 和 2019。由于不同版本的 BarTender Print Portal 存在差异，请在上方下拉菜单中选择您的版本。

在排查任何版本的 BarTender Print Portal 问题前，请确保您正在运行该版本的最新发布版，以免排查已被修复的问题。请参阅如何更新到 BarTender 当前版本获取相关帮助。

您还需要在系统中安装 IIS Web 管理控制台。该控制台可在 Windows 功能或服务器功能中找到。如果您找不到功能列表，请联系 IT 专业人员协助。

BarTender Print Portal 的组成部分

BarTender Print Portal 依赖多个组件运行，包括一些关键服务来保证应用的正常运作。以下是部分主要服务：

BarTender 系统服务 - 负责与 BarTender 系统数据库的通信
BarTender 打印调度服务 - 负责管理下文提到的打印引擎
.Net/Tcp 端口共享服务 - Windows 服务，帮助 BarTender Print Portal 与 BarTender 打印调度服务之间进行打印任务通信

除了上述运行所需的服务，以下是两个主要组件的详细介绍：

打印引擎

打印引擎本质上是以服务形式运行的 BarTender Designer，会根据 BarTender Print Portal 的需求动态启动和停止。打印引擎由 BarTender 打印调度服务维护，无需用户干预即可运行。

当用户点击打印按钮创建打印任务时，如果没有正在运行的打印引擎，则会自动启动一个打印引擎。它会打开文档，处理从 BarTender Print Portal 发送的数据，然后将打印任务发送到 Windows 打印后台处理程序，最终发送到您的打印机。在 BarTender 2021 及更高版本中，打印引擎还负责生成标签预览。