为 Dynamics 365 Business Central 安装和设置 BarTender 打印连接器
概述
BarTender Print Connector for Dynamics 365 Business Central 是一款专为 Business Central 设计的插件,
可为用户提供一个专属、可自定义的解决方案,将 BarTender 世界级的打印引擎直接集成到 Business Central 中。
本指南将教您如何安装 BarTender Print Connector for Dynamics 365 Business Central,连接到 BarTender Cloud,并配置所有必要的设置,让您可以顺利开始打印。
适用范围
BarTender Cloud
Microsoft Dynamics 365 Business Central
信息
要使用 BarTender Print Connector for Dynamics 365 Business Central,您需要运行以下应用程序:
- BarTender Cloud(需订阅 Automation 计划)
- Dynamics 365 Business Central 云端版
安装插件
要安装 BarTender Print Connector for Dynamics 365 Business Central,请使用以下任一方法:
- 在 Microsoft AppSource 商店中搜索 BarTender,然后点击下载并
安装该插件。 - 在 Business Central 中,在搜索框输入 BarTender,点击
BarTender Connector(来自 Microsoft AppSource),然后点击下载并安装该插件。
准备 BarTender Cloud
在连接 BarTender Print Connector 之前,您需要在 BarTender Cloud 内完成以下步骤:
- 为 BarTender Print Connector 创建一个专用的 BarTender Cloud 账户。此账户不应为现有用户账户,而应专门为此目的新建。
- 为您创建的账户配置基于密码的访问权限,并在 BarTender Cloud 中注册 BarTender Print Connector。这样,Business Central 就可以访问您的 BarTender Cloud 租户空间。有关操作说明,请参阅 BarTender Cloud REST API 使用基于密码的 OAuth 认证。
连接到 BarTender Cloud
要将 Business Central 连接到 BarTender Cloud 并同步数据库,请按照以下步骤操作:
- 在 Business Central 中,点击右上角的搜索图标,在搜索框中输入 BarTender。
- 在“转到页面和任务”下,点击 BarTender 设置。
- 在 BarTender 设置页面,配置以下设置:
-
根 URL:如果尚未指定,请输入您的 BarTender Cloud 租户的基础 URL。您可以登录 BarTender Cloud 后,从浏览器地址栏复制该 URL。基础 URL 格式如下:
https://YourOrganizationDomainID.Datacenter.bartendercloud.com
如需帮助查找您的组织域 ID 或数据中心,请参阅 如何在 BarTender Cloud 管理您的组织 的入门部分。 - 应用程序 ID 和 客户端密钥:在相应字段中输入您的 BarTender Cloud 应用程序 ID 和客户端密钥。您可以在 管理云账户 > BarTender Cloud API 中,点击已注册的 BarTender Print Connector 右侧的竖省略号图标,然后选择 查看 ID 和密钥 获取。
- 用户名:输入您的 BarTender Cloud 用户名。
- 密码:输入您的 BarTender Cloud 密码。
- 打印超时:可选,设置 BarTender 打印作业超时前的秒数。例如,如果发现某些打印作业比预期耗时更长,可以适当延长超时时间。
-
根 URL:如果尚未指定,请输入您的 BarTender Cloud 租户的基础 URL。您可以登录 BarTender Cloud 后,从浏览器地址栏复制该 URL。基础 URL 格式如下:
- 点击 测试连接,以验证连接信息是否正确。如果连接 BarTender Cloud 时遇到问题,请参阅 这篇文章。
- 点击 同步库,将您的 BarTender Cloud 打印机、标签模板和模板数据字段与 Business Central 同步。您想要使用的标签必须已在 BarTender Cloud 中创建并配置好,Business Central 才能导入。详情请参阅 使用 BarTender Cloud 模板助手创建 BarTender 文档。
- 点击 返回 按钮,退出 BarTender 设置页面。
BarTender 设置故障排除
如果在 BarTender 设置过程中出现错误,或找不到客户端密钥字段,您可能需要更新 BarTender Print Connector for Dynamics 365 Business Central 应用。
- 首先,点击 Dynamics 365 右上角的 设置 图标,选择管理中心。
- 点击您想要更新的环境。
- 点击页面顶部的 应用。
- 在 BarTender Print Connector 条目右侧选择“安装更新”。
更新完成后,您可能需要重启 Dynamics 365。
配置模板映射
在您可以从 Business Central 打印到 BarTender Cloud 之前,必须先配置模板映射,将 Business Central 中的源表和数据库字段与 BarTender 标签模板中的目标字段进行关联。
操作步骤如下:
- 在 Business Central 中,点击右上角的搜索图标,在搜索框中输入 BarTender。
- 在“转到页面和任务”下,点击 BarTender 模板映射。
- 点击 新建。
- 在常规区域,配置以下设置:
- 源表 ID:通过下拉菜单选择您需要的 Business Central 表 ID,选择后会自动填充到源表名称字段。
- 模板名称:选择您需要的 BarTender 文档模板名称。
-
打印机:选择您要发送打印作业的打印机。如果选择 PDF,
还需配置以下附加设置:
- PDF 打印文件名:为保存的 PDF 文件输入名称。
- 描述:为该映射输入描述。请注意,该描述会在打印时显示给用户。
在打印机设置部分,您还可以启用以下两个选项,均为自解释:
- 打印后关闭文档
- 打印后保存
字段映射
- 在 BarTender 模板映射页面的字段映射区域,将所选源表中的字段与 BarTender 模板字段进行映射,具体设置如下:
- 源字段编号:输入要映射的源字段 ID。点击省略号可显示字段查找页面,然后选择您需要的字段。
- 目标字段名称:选择要映射到的目标字段名称。
如需添加更多映射,请点击下一行,重复此步骤配置其他源字段和目标字段。
- 点击 返回 按钮,关闭 BarTender 模板映射页面。您的模板现在会出现在可打印标签列表中。
其他资源
使用 BarTender Print Connector for Dynamics 365 Business Central 打印