使用条码数据源生成条码图像

您可以使用电子报告 (ER) 框架来设计可以运行来生成所需的电子版和可打印传出文档的 ER 格式组件。 若要生成 Microsoft Office 格式的传出文档,必须使用 Microsoft Excel 文档或 Microsoft Word 文档作为报告模板来指定报告的布局。 ER 操作设计器使您可以将 Excel 或 Word 文档附加为 ER 格式的模板。 附加模板中的以下命名元素与配置的格式组件的元素相关联:

  • Word 中的内容控件
  • Excel 中的命名工作表、范围、单元格、形状和图像

这些命名元素用作运行 ER 格式时在生成的文档中输入的数据的占位符。 ER 格式元素将绑定到数据源。 这些数据源指定在运行时将在生成的文档中输入的数据。 有关详细信息,请参阅使用 ER 在您生成的文档中嵌入图像和形状

ER 现在支持条码数据源类型。 因此,您现在可以生成一个代表指定文本的条码的图像。 配置 ER 格式时,可以指定条码类型的数据源来生成条码图像。 然后,您可以将这些图像添加到生成的业务文档中,如订单、发票、装箱单和收据。 您还可以将它们添加到各种标签中,如产品和货位标签以及包装和发货标签。

报告模板中可以使用以下占位符来输入条码图像:

通过使用条码类型的数据源,您可以生成以下格式的条码:

  • 一维条码:

    • Codabar
    • Code 39
    • Code 93
    • Code 128
    • EAN-8
    • EAN-13
    • ITF-14
    • 智能邮件
    • MSI
    • Plessey
    • PDF417
    • UPC-A
    • UPC-E
  • 二维条码:

    • Aztec
    • 数据矩阵
    • QR 码

当您配置条码数据源时,您可以定义用于生成图像的特定绘制参数:

  • 宽度 – 以像素为单位指定条码的宽度。 值 0(零)指示使用默认宽度。 对于不同的格式,含义可能有所不同。
  • 高度 – 以像素为单位指定条码的高度。 值 0(零)指示使用默认高度。 对于不同的格式,含义可能有所不同。
  • 边距 – 以像素为单位指定条码边距的大小。 边距是条码两侧必须留出的区域(静区)。 值 0(零)指示使用默认边距。 对于不同的格式,含义可能有所不同。
  • 输出内容 – 将值设置为将生成包含编码信息作为文本的条码图像。 默认值为
  • 编码 – 指定在生成的条码图像中编码的字符的类型。 默认情况下,使用 UTF-8 编码。

重要

当您添加新的条码数据源时,必须将其作为嵌套元素放在另一个项目(容器)下。

当您将条码数据源以某种格式绑定到单元格元素,并且该单元格元素表示 Word 内容控件或 Excel 图片时,数据源在该绑定中显示为具有单个字符串类型参数的函数。 您必须使用此参数来指定应转换为条码图像并在扫描生成的条码时读取的文本。

有关此功能的详细信息,请完成本文中的示例。

示例:生成包含对应付金额进行编码的条码的付款支票

本示例说明具有系统管理员电子报告功能顾问角色的用户如何配置 ER 格式,该格式包含用于生成包含条码的 Excel 格式传出文档的模板。 这里是所涉及步骤的概览。

  1. 完成先决条件

  2. 激活配置提供程序

  3. 导入提供的 ER 解决方案

  4. 生成付款支票

  5. 查看生成的付款支票

  6. 修改提供的 ER 解决方案的格式

    1. 应用新支票模板

    2. 添加新条码数据源

    3. 绑定新格式元素

    4. 使修改后的版本可用于测试运行

      1. 完成修改后的格式版本
      2. 使草稿版本可供使用
  7. 生成付款支票

  8. 将生成的支票转换为 PDF

在此示例中,您将使用已配置为生成付款支票的提供的 ER 解决方案。 此解决方案生成应付金额同时以数字和文本形式书写的付款支票。 您将修改此 ER 解决方案,使支票还包括对应付金额进行编码的生成的条码,该条码可以使用条码扫描仪进行读取。

这些步骤可以在 Microsoft Dynamics 365 Finance 中在 USMF 公司中完成。

完成先决条件

若要完成本示例,您必须能够用以下角色之一访问 USMF 公司的 Finance:

  • 电子申报功能顾问
  • 系统管理员

如果您尚未完成使用 ER 在您生成的文档中嵌入图像和形状一文中的示例,请下载示例 ER 解决方案的以下配置。

内容描述 文件名
ER 数据模型配置 Model for cheques.xml
ER 格式配置 Cheques printing format.xml

此外,下载以下 Excel 文件,其中包含所提供的 ER 解决方案的修改后的模板。

内容描述 文件名
报告模板 Check template Excel.xlsx

激活配置提供程序

  1. 转到组织管理>工作区>电子申报
  2. 本地化配置页上的配置提供程序部分中,确保列出了示例公司 Litware, Inc.配置提供程序,并将其标记为活动状态。 如果未列出,或者未将其标记为活动状态,请按照创建一个配置提供程序,并标记其为活动状态一文中的步骤操作。

在“本地化配置”页面上将示例公司设置为活动状态。

导入提供的 ER 解决方案

  1. 转到组织管理>工作区>电子申报

  2. 本地化配置页面的配置部分中,选择报告配置磁贴。

  3. 配置页面上,如果支票的模型配置在配置树中不可用,请按照以下步骤导入 ER 数据模型配置:

    1. 在操作窗格上,选择交换>从 XML 文件加载
    2. 在对话框中,选择浏览,找到并选择 Model for cheques.xml 文件,然后选择确定
  4. 如果支票打印格式配置在配置树中不可用,请按照以下步骤导入 ER 格式配置:

    1. 在操作窗格上,选择交换>从 XML 文件加载
    2. 在对话框中,选择浏览,找到并选择 Cheques printing format.xml 文件,然后选择确定
  5. 在配置树中,展开支票的模型

  6. 在配置树中查看导入的 ER 配置的列表。

生成付款支票

  1. 转至现金和银行管理>银行帐户>银行帐户

  2. 银行帐户页面上,选择 USMF OPER 帐户。

  3. 在银行帐户详细信息页的操作窗格中,在设置选项卡的布局组中,选择支票

  4. 支票版式页面上,选择编辑

  5. 常规快速选项卡上,将一般电子导出格式选项设置为

  6. 导出格式配置字段中,选择您先前导入的支票打印格式 ER 格式。

  7. 在操作窗格上,选择打印测试

  8. 在对话框中,将可转让支票格式选项设置为,然后选择确定

    支票版式 - 打印测试对话框。

查看生成的付款支票

  • 在 Excel 中打开生成的支票。
  1. 检查生成的支票。

    在 Excel 中生成的付款支票。

修改提供的 ER 解决方案的格式

应用新支票模板

您可以使用 Excel 桌面应用程序打开您先前导入的 Cheque template Excel.xlsx 文件。 请注意,此模板与您在提供的 ER 解决方案中用于生成付款支票的模板不同。 此外,它还包括条码图像的 AmountBarcode 元素。

Excel 模板中的 AmountBarcode 元素。

您现在必须修改 ER 解决方案,然后重新应用修改后的模板。

  1. 转到组织管理>工作区>电子申报

  2. 本地化配置页面的配置部分中,选择报告配置

  3. 配置页面,在配置树中,展开支票的模型,然后选择支票打印格式

  4. 在操作窗格上,选择设计器

  5. 在 ER 操作设计器中,选择页面右侧的映射选项卡,然后在左侧的格式树窗格中,选择展开/折叠

  6. 请注意,所有单元格格式元素都绑定到适当的数据源。

    在 ER 操作设计器中将单元格格式元素绑定到数据源。

  7. 选择页面右侧的格式选项卡。

  8. 在操作窗格上,选择省略号 (...),然后选择导入

  9. 导入组中,选择从 Excel 更新,然后选择更新模板

  10. 在对话框中,浏览到保存在计算机上的 Cheque template Excel.xlsx 文件,选择它,然后选择确定确认应该应用所选模板。

  11. 选择页面右侧的映射选项卡,然后在左侧的格式树窗格中,选择展开/折叠

  12. 请注意,AmountBarcode 单元格元素已添加到格式。 此元素与 AmountBarcode 元素相关联,后者已作为条码图像的占位符添加到修改后的 Excel 模板中。

    在 ER 操作设计器中添加到格式中的 AmountBarcode 单元格元素。

添加新条码数据源

接下来,您必须添加条码类型的新数据源。

  1. 在 ER 操作设计器中,在页面右侧的映射选项卡上,选择打印数据源。

  2. 选择添加,然后在函数组中,选择条码数据源类型。

    选择条码数据源类型。

  3. 在对话框的名称字段中,输入条码

  4. 条码格式中,选择 Code 128

  5. 宽度字段中,输入 500

  6. 选择确定

    数据源属性对话框。

绑定新格式元素

接下来,必须将新的格式元素绑定到刚才添加的数据源。

  1. 在 ER 操作设计器中,在页面右侧的映射选项卡上,选择打印\条码数据源。

  2. 在左侧的格式树窗格中,选择 AmountBarcode 单元格元素,然后选择绑定

  3. 在操作窗格上,选择显示详细信息

  4. 请注意,由于条码数据源在绑定中表示为包含单个参数的函数,绑定格式元素的名称已自动提取为该参数的参数。

    ER 操作设计器中条码数据源的详细信息。

  5. 选择编辑公式调整绑定。

    您不希望返回单元格元素的名称。 因此,您必须配置一个返回包含当前支票的应付金额的文本的表达式。 由于父 ChequeLines 范围绑定到 model.cheques 数据源,因此当前支票的应付金额可在实数数据类型的 model.cheques.attributes.amount 字段中找到。

  6. 公式字段中,输入 print.barcode(NUMBERFORMAT(@.attributes.amount, "F2"))

  7. 选择保存,然后关闭 ER 公式设计器

  8. 请注意,绑定已调整。

    在 ER 操作设计器中调整的绑定。

  9. 选择保存,然后关闭 ER 操作设计器。

使修改后的版本可用于测试运行

默认情况下,只有状态为已完成已共享的版本将在运行 ER 格式时使用。

如果您已经完成更改,可以使用当前的草稿版本完成工作,然后使更改可供使用。 有关说明,请参阅接下来的完成修改后的格式版本一节。

如果要继续使用当前的草稿版本,但是必须使用它来生成支票,您必须明确指定要使用格式的草稿版本来执行。 有关说明,请参阅使草稿版本可供使用一节。

完成修改后的格式版本
  1. 转到组织管理>工作区>电子申报
  2. 本地化配置页面的配置部分中,选择报告配置
  3. 配置页面,在配置树中,展开支票的模型,然后选择支票打印格式
  4. 版本快速选项卡上,选择状态为草稿的记录。
  5. 选择更改状态,然后选择完成
  6. 在对话框中,选择确定

当前版本的状态将从草稿更改为已完成,并将创建状态为草稿的新版本。 您可以使用此新的草稿版本来应用其他更改。

使草稿版本可供使用
  1. 转到组织管理>工作区>电子申报
  2. 本地化配置页面的配置部分中,选择报告配置
  3. 配置页操作窗格中配置选项卡的高级设置组中,选择用户参数
  4. 在对话框中,将运行设置选项设置为,然后选择确定
  5. 在配置树中,展开支票的模型,选择支票打印格式
  6. 运行草稿选项设置为
  7. 选择保存

运行所选格式时,所选格式的草稿版本将被标记为可以使用。

生成付款支票

  1. 转至现金和银行管理>银行帐户>银行帐户

  2. 银行帐户页面上,选择 USMF OPER 帐户。

  3. 在银行帐户详细信息页的操作窗格中,在设置选项卡的布局组中,选择支票

  4. 支票版式页面上的操作窗格上,选择打印测试

  5. 在对话框中,将可转让支票格式选项设置为

  6. 选择确定

  7. 检查生成的支票。 请注意,已生成条码以对支票的应付金额进行编码。

    在 Excel 中使用条码生成的付款支票。

重要

如果条码数据源的参数不符合特定于条码格式的适当要求,将引发异常。 例如,当调用条码数据源以为提供的文本生成 EAN-8 条码时,如果文本长度超过七个字符将引发异常。

将生成的支票转换为 PDF

生成可打印的 FTI 表单一文中所述,您可以使用特殊字体在生成的文档中生成条码。 在这种情况下,生成文档的其他转换可能取决于转换环境中该字体的可用性。 例如,如果您尝试将文档转换为 PDF 格式或在缺少字体的环境中预览文档,条码将无法正确呈现。

但是,当您使用条码数据源来生成条码时,这些条码的呈现将不依赖于任何字体。 因此,您可以轻松地将包含条码的文档转换为 PDF 格式。 下图显示了生成的付款支票的预览,该支票已基于配置的 ER 目标的设置转换为 PDF。

付款支票的 PDF 的预览。

限制

注释

生成的某些类型的条码具有固定的纵横比。 如果您已打开支持在电子申报框架中使用 EPPlus 库功能以在 ER 中使用 Excel 文档,此行为将很重要。 在这种情况下,图像将输入到具有锁定纵横比的占位符中。 因此,当模板中占位符的尺寸对应于所输入图像的比例时,可以调整生成文档中的实际图片的大小,以保持所需的纵横比。 为阻止图片调整大小,请使用具有预期纵横比的占位符。

其他资源