通过

配置从 SharePoint 的数据导入

  • 项目

若要使用电子申报 (ER) 框架从传入文件导入数据，必须配置用于为导入提供支持的 ER 格式，然后运行将该格式用作数据源且类型为截止目标的模型映射。 若要导入数据，您必须导航到要导入的文件。 用户可以手动选择传入文件。 在新的 ER 功能中，为了为从 Microsoft SharePoint 导入数据提供支持，可将此过程配置为无人值守。 您可以使用 ER 配置从 Microsoft SharePoint 文件夹中存储的文件导入数据。 本文介绍如何完成从 SharePoint 的导入。 示例将供应商交易记录用作业务数据。

先决条件

要完成本文中的示例，您必须具有以下访问权限：

  • 访问以下其中一个角色：

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

  • 已针对与此应用程序配合使用配置了 Microsoft SharePoint Server 实例的访问权限。

  • 1099 付款的 ER 格式和模型配置。

创建所需的 ER 配置

播放 ER 从 Microsoft Excel 文件导入数据任务指南，该任务指南属于 7.5.4.3 获取/开发 IT 服务/解决方案产品 (10677) 业务流程。 这些任务指南将引导您完成设计和使用 ER 配置以便以交互方式从 Microsoft Excel 文件导入供应商交易记录这一过程。 有关详细信息，请参阅分析 Excel 格式的传入文档。 在您完成任务指南后，将具有以下设置。

ER 配置

  • ER 模型配置 1099 付款模型
  • ER 格式配置用于从 Excel 导入供应商的交易记录的格式

用于从 SharePoint 导入数据的 ER 配置。

用于数据导入的传入文件示例

  • Excel 文件 1099import-data.xlsx，其中包含应导入的供应商交易记录。

用于从 SharePoint 导入的 Excel 示例文件。

注释

将选择用于导入供应商交易记录的格式作为默认模型映射。 因此，如果运行 1099 付款模型的模型映射，并且该模型映射类型为截止目标，则该模型映射运行此格式以从外部文件导入数据。 然后使用这些数据更新申请表。

配置对用于文件存储的 SharePoint 的访问

要在 SharePoint 位置存储电子报表文件，您必须配置对当前公司将使用的 SharePoint Server 实例的访问。 在此示例中，该公司为 USMF。 有关说明，请参阅配置 SharePoint 存储。

  1. 完成配置 SharePoint 存储中的步骤。

  2. 打开配置的 SharePoint 站点。

  3. 创建以下可以存储传入的电子报告文件的文件夹：

    • 文件导入源（主）（以下屏幕截图中显示的示例）
    • 文件导入源（备用）

    文件导入源（主）。

  4. （可选）创建以下可以在文件导入后存储文件的文件夹。

    • 文件存档文件夹 - 此文件夹将是成功导入的文件。
    • 文件警告文件夹 - 此文件夹将是包含警告的导入文件。
    • 文件错误文件夹 - 此文件夹将是导入失败的文件。

  5. 转至组织管理 > 单据管理 > 单据类型。

  6. 创建将用于访问您创建的 SharePoint 文件夹的以下文档类型。 有关说明，请参阅配置文档类型。

单据类型 组合 库位 SharePoint 文件夹
SP 主 文件 SharePoint 文件导入源（主）
SP 备用 文件 SharePoint 文件导入源（备用）
SP 存档 文件 SharePoint 文件存档文件夹
SP 警告 文件 SharePoint 文件警告文件夹
SP 错误 文件 SharePoint 文件错误文件夹

SharePoint 设置 – 新文档类型。

为 ER 格式配置 ER 源

  1. 单击组织管理>电子申报>电子申报来源。

  2. 在电子申报来源页面中，使用配置的 ER 格式为数据导入配置源文件。

  3. 定义一个文件名掩码，以便导入 .xlsx 扩展名的文件。 该文件名掩码可选，仅当定义了才使用。 只能为每个 ER 定义一种掩码。

  4. 如果存在若干要导入的文件，并且导入顺序不重要，将导入文件前先进行排序更改为不排序

  5. 选择前面创建的所有 SharePoint 文件夹。

    ER 文件来源设置。

注释

  • 将为每家申请公司分别定义 ER 来源。 相反，ER 配置则由多家公司共用。
  • 如果删除 ER 格式的 ER 来源设置，也将通过确认删除所有连接的文件的状态（见下文）。

检查 ER 格式的文件状态

  1. 在电子申报来源页中，选择来源的文件状态检查为当前 ER 格式配置的文件来源的内容。

  2. 在文件 部分，检查文件的列表。 此列表提供以下信息：

    • 根据文件名掩码（如果定义了文件名掩码）适用且已准备就绪可导入的源文件。 对于这些文件，导入格式的源日志部分为空。
    • 以前导入的文件。 对于每个这样的文件，可在导入格式的源日志部分中检查该文件的导入历史记录。

也可以打开源的文件状态页，方法是选择组织管理>电子申报>源的文件状态。 这样，该页就提供了有关在您当前登录的公司中已经为其配置了文件来源的所有 ER 格式的文件来源的信息。

从 SharePoint 文件夹中的 Excel 文件导入数据

  1. 在 SharePoint 中，将包含供应商交易记录的 Microsoft Excel 文件 1099import-data.xlsx 上传到您前面创建的文件导入源（主）SharePoint 文件夹。

    SharePoint 内容 – 要导入的 Microsoft Excel 文件。

  2. 在源的文件状态页中，选择刷新以刷新页面。 此页面中将显示已上传到 SharePoint 的 Excel 文件，其状态为就绪。 现在支持以下状态：

    • 就绪 – 为 SharePoint 文件夹中的每个新文件自动分配的状态。 此状态表示该文件已准备就绪，可以导入。
    • 正在导入 – 导入过程（如果正在同时运行多个过程）将锁定文件以防其他过程使用时 ER 报表自动分配的状态。
    • 已导入 – 文件导入成功完成时 ER 报表自动分配的状态。 此状态表示已从配置的文件来源（SharePoint 文件夹）删除了导入的文件。
    • 失败 – 文件导入完成，但出现错误或异常时，ER 报表自动分配的状态。
    • 保留 – 用户在此页面中手动分配的状态。 此状态表示暂时不导入该文件。 此状态可用于推迟导入某些文件。

    所选来源的已刷新 ER 文件状态页面。

从 SharePoint 文件导入数据

  1. 打开 ER 配置树，选择 1099 付款模型，然后展开 ER 模型组件列表。

  2. 选择模型映射名称以打开所选 ER 模型配置的模型映射列表。

    配置页面。

  3. 选择运行以运行所选模型映射。 因为您为 ER 格式配置了文件源，所以，如果需要，可以更改文件源选项的设置。 如果保留此选项的设置，将从配置的源（本示例中为 SharePoint 文件夹）导入 .xslx 文件。

    在本示例中，仅导入一个文件。 但是，如果有多个文件，将按这些文件添加到 SharePoint 文件夹的顺序选择导入。 每次运行 ER 格式都将导入选择的一个文件。

    从 SharePoint 导入和运行 ER 模型映射。

  4. 该模型映射可以以批处理模式的无人值守方式运行。 在这种情况下，只要批处理运行该 ER 格式，都将从配置的文件源导入一个文件。

    将文件从 SharePoint 文件夹成功导入时，它将从该文件夹中删除并移到存储成功导入文件的文件夹或存储包含警告的导入文件的文件夹。 否则，它将移到失败文件的文件夹或如果未设置失败文件的文件夹将留在此文件夹中。

  5. 输入凭证 ID（如 V-00001），然后选择确定。

    运行 ER 模型映射。

  6. 在源的文件状态页中，选择刷新以刷新页面。

    来源的 ER 文件状态页面。

  7. 在文件 部分，检查文件的列表。 导入格式的源日志部分提供 Excel 文件导入历史记录。 由于该文件已成功导入，所以在 SharePoint 文件夹中标记为已删除。

  8. 检查文件导入源（主）SharePoint 文件夹。 已从该文件夹删除了成功导入的 Excel 文件。

  9. 转至应付帐款>定期任务>1099 税>1099 的供应商结算。

  10. 在开始日期和结束日期字段中，输入相应值。 然后选择手动 1099 交易记录。

    此页面中将显示在 SharePoint 上为凭证 V-00001 通过 Excel 文件导入的供应商交易记录。

    1099 供应商交易页面。

准备要导入的 Excel 文件

  1. 打开以前使用过的 Excel 文件。 在第 3 行第 1 列，添加一个申请中没有的供应商代码。 为该行添加更多虚假的供应商信息。

    要从 SharePoint 导入的 Microsoft Excel 示例文件。

  2. 将已更新且包含供应商交易记录的 Excel 文件上传到文件导入源（主）SharePoint 文件夹。

  3. 打开 ER 配置树，选择 1099 付款模型，然后展开 ER 模型组件列表。

  4. 选择模型映射的名称以更新该模型映射，从而在数据导入过程中将不正确的供应商代码视为错误。

  5. 选择设计器。

  6. 在验证选项卡上，必须更改为了评估应用程序中是否存在导入的供应商科目而配置的验证规则的验证后操作。 将验证后操作字段的值更改为停止执行，保存更改，然后关闭页面。

    ER 模型映射设计器页面。

  7. 保存更改，然后关闭 ER 模型映射设计器。

  8. 选择运行以运行修改后的 ER 模型映射。

  9. 输入凭证 ID（如 V-00002），然后选择确定。

    信息日志中包含用于说明 SharePoint 文件夹中存在包含不正确的供应商科目的文件，因此不能导入的通知。

    已完成的“运行 ER 模型映射”。

  10. 在源的文件状态页，选择刷新，然后在文件部分中查看文件列表。

    所选来源的 ER 文件状态页面。

导入格式的源日志部分指示导入过程失败，文件在“文件错误”SharePoint 文件夹中（已删除复选框未选中）。 如果您通过添加适当的供应商代码在 SharePoint 上修复了此文件，并将其移到“文件导入源（主）”SharePoint 文件夹，您可以再次导入该文件。

  1. 选择应付帐款>定期任务>1099 税>1099 的供应商结算，在开始日期和结束日期字段中输入相应值，然后选择手动 1099 交易记录。

    只有凭证 V-00001 的交易记录。 即使在 Excel 文件中发现了上次导入的交易记录的错误，也没有凭证 V-00002 的交易记录。

限制

在版本 10.0.25 之前的 Dynamics 365 Finance 版本中，ER 框架的用户界面 (UI) 不提供启动新批处理作业的功能，该作业将以无人参与模式运行模型映射以进行数据导入。 您必须开发新的逻辑，以便可以从应用程序 UI 调用配置的 ER 模型映射，以从传入文件中导入数据。 要开发此逻辑，需要完成一些工程工作。

有关 ER API 的详细信息，请参阅针对应用程序更新 7.3 的 ER 框架 API 更改中的用于运行格式映射以导入数据的代码一节。 查看 Application Suite 模型的 BankImport_RU 类中的代码，以了解如何实现自定义逻辑。 BankImport_RU 类扩展了 RunBaseBatch 类。 特别是，查看 runER() 方法，在此方法中，创建的 ERIModelMappingDestinationRun 对象充当 ER 模型映射的运行器。

在 Finance 版本 10.0.25 及更高版本中，ER 框架 UI 会提供启动新批处理作业的功能，该作业将以无人参与模式运行模型映射以进行数据导入。 有关此流程的详细信息，请参阅在批处理模式下从手动选择的文件导入数据。

其他资源

电子申报概览

针对 Application update 7.3 的 ER API 更改

针对 Application update 10.0.23 的 ER API 更改

针对 Application update 10.0.25 的 ER API 更改