您是否正在计划或已经开始将您的 Sitecore 网站升级到最新版本？如果是，那么您很可能遇到了一个棘手的问题：如何将您的旧版 Web Forms for Marketers (WFFM) 表单迁移到 Sitecore Forms？Sitecore Forms 作为 Sitecore 的新一代表单解决方案，提供了更加现代化和灵活的功能。然而，手动迁移 WFFM 表单既耗时又容易出错。幸运的是，有一款名为 WFMM 转换工具的工具可以帮助您自动化这个过程。本文将带您深入了解 WFMM 转换工具，从其基本概念、核心功能到实际应用，提供一份详尽的上⼿指南，助您轻松完成表单迁移，让您的 Sitecore 网站焕发新生。
WFMM 转换工具使用要点
了解 WFMM 转换工具的基本功能和用途
掌握该工具支持的 Sitecore 版本和数据源
熟悉使用 JSON 文件配置数据映射和转换规则
理解工具的工作流程和最佳实践
掌握分析转换报告，识别需要手动调整的部分
探索工具的可扩展性，满足自定义需求
深入了解 WFMM 转换工具
什么是 WFMM 转换工具？
wfmm 转换工具是一款由 sitecore 社区成员 alessandro faniulo 开发的开源工具，旨在帮助 sitecore 开发人员将旧版 web forms for marketers (wffm) 表单及其数据迁移到 sitecore forms。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
该工具通过自动化大部分迁移过程，极大地节省了开发人员的时间和精力，降低了手动操作可能带来的错误。通过这款WFMM转换工具将Sitecore WFFM转换为Sitecore Forms可以极大的提高效率，并减少出错可能性。
WFMM 转换工具的核心功能包括：
- 自动化表单结构迁移：自动将 WFFM 表单的结构（包括字段、布局和验证规则）转换成 Sitecore Forms 的等效结构。
- 数据迁移：将 WFFM 表单收集到的数据迁移到 Sitecore Forms 的数据存储中，确保数据的完整性和一致性。
- 可配置的数据映射：通过 JSON 文件配置字段之间的数据映射关系，灵活适应不同的表单结构。
- 可扩展性：支持自定义转换规则和逻辑，满足特定的迁移需求。
- 分析报告：生成详细的转换报告，帮助识别需要手动调整的部分。
通过使用WFMM转换工具，您可以省去大量手动操作的繁琐，轻松将旧版本的Sitecore WFFM平滑的迁移到新一代Sitecore Forms。
WFMM 转换工具适用场景
WFMM 转换工具主要适用于以下场景：
- Sitecore 版本升级：当您将 Sitecore 网站从 8.x 版本升级到 9.0 或更高版本时，需要将 WFFM 表单迁移到 Sitecore Forms。
- 表单现代化改造：如果您希望将旧版的 WFFM 表单升级到更现代化的 Sitecore Forms，以获得更好的用户体验和更强大的功能。
- 表单数据整合：如果您需要将多个 WFFM 表单的数据整合到一个统一的数据存储中，Sitecore Forms 提供了更便捷的实现方式。
总之，只要您需要将 WFFM 表单迁移到 Sitecore Forms，WFMM 转换工具都可以为您提供有力的支持。
WFMM 转换工具技术特点
WFMM 转换工具采用了以下技术特点：
- 控制台应用程序：该工具是一个控制台应用程序，可以通过命令行界面进行操作，方便自动化和集成到 CI/CD 流程中。
- 数据层直接交互：该工具直接与 Sitecore 数据库进行交互，无需依赖 Sitecore API，提高了迁移效率。
- 元数据驱动：该工具使用 JSON 文件描述表单结构和数据映射关系，实现了高度的可配置性和可扩展性。
- 插件式架构：该工具支持通过插件扩展其功能，例如支持自定义字段类型和保存操作。
WFMM 转换工具版本支持
WFMM 转换工具支持以下 Sitecore 版本：
| 组件 | 支持版本 |
|---|---|
| Sitecore WFFM | 9.1 之前的任何 Sitecore 版本，支持 SQL Server 和 MongoDB 数据提供程序 |
| Sitecore Forms | 官方测试使用 Sitecore 9.1+ 版本 |
需要注意的是，WFMM 转换工具在 Sitecore 9.1 及更高版本上经过官方测试，但在较低版本上可能也能正常工作。建议在迁移前进行充分的测试。
WFMM转换工具实战：迁移表单分步详解
准备工作
在开始迁移之前，请确保您已经做好了以下准备工作：
- 备份您的 Sitecore 数据库：以防万一迁移过程中出现意外，请务必备份您的 Sitecore 数据库。
- 安装 Sitecore Forms：如果您的 Sitecore 实例尚未安装 Sitecore Forms，请先安装。
- 下载 WFMM 转换工具：从 GitHub 仓库 或 Sitecore Marketplace 下载 WFMM 转换工具。
- 配置数据库连接字符串：在 WFMM 转换工具的配置文件中，配置连接到您的 WFFM 数据库和 Sitecore Forms 数据库的连接字符串。
配置表单映射
-
了解元数据模板：WFMM 转换工具使用元数据模板（Metadata Template）JSON 对象来控制转换过程。您需要根据您的 WFFM 表单结构创建或修改这些元数据模板。
-
创建 JSON 映射文件：为每个需要迁移的 WFFM 表单创建一个 JSON 映射文件，描述 WFFM 字段和 Sitecore Forms 字段之间的映射关系。
-
配置字段映射：在 JSON 映射文件中，指定每个 WFFM 字段应该映射到哪个 Sitecore Forms 字段。您还可以定义自定义的转换规则和逻辑。
运行转换工具
- 打开命令行界面：打开 Windows 命令提示符或 PowerShell。
-
导航到工具目录：使用
cd命令导航到 WFMM 转换工具的安装目录。 - 运行转换命令：使用以下命令运行转换工具：
WFFM.ConversionTool.exe -convert
或者，如果您只想迁移表单结构而不迁移数据，可以使用以下命令：
WFFM.ConversionTool.exe -convert -nodata
- 查看转换报告：转换完成后，WFMM 转换工具会生成一个 CSV 报告，其中列出了成功转换和未能转换的字段。检查该报告，并手动调整未能自动转换的部分。
手动调整和验证
- 检查 Sitecore Forms：登录 Sitecore Content Editor，并导航到您迁移的表单。
- 验证表单结构：检查表单的字段、布局和验证规则是否正确。
- 验证数据：检查表单收集到的数据是否已成功迁移。
- 手动调整：根据转换报告，手动调整未能自动转换的部分，例如自定义验证规则和保存操作。
WFMM 转换工具的获取方式
免费开源
WFMM 转换工具是一款免费开源的工具，您可以从以下渠道获取：
-
GitHub 仓库：https://github.com/afaniulo/WFFM-Conversion-Tool
- 在这里您可以下载最新的源代码、查看文档和提交问题报告。
-
Sitecore Marketplace：https://marketplace.sitecore.net/Modules/W/WFFM_Conversion_Tool.aspx
- 在 Sitecore Marketplace，您可以下载预编译的安装包。
WFMM 转换工具的优缺点
? Pros自动化大部分迁移过程，节省时间和精力
通过 JSON 文件灵活配置数据映射和转换规则
支持自定义转换规则和逻辑，满足特定需求
提供详细的转换报告，方便问题排查
免费开源，易于获取和使用
? Cons
需要一定的技术知识和经验
对于复杂的 WFFM 表单，可能需要手动调整
无法完全替代人工干预，仍需进行验证和测试
目前只支持控制台操作，界面不够友好
常见问题解答
WFMM 转换工具是否支持 Sitecore 10？
WFMM 转换工具在 Sitecore 9.1 及更高版本上经过官方测试。虽然在 Sitecore 10 上可能也能正常工作，但建议在迁移前进行充分的测试，以确保兼容性。
如何处理自定义的 WFFM 字段类型？
WFMM 转换工具支持通过插件扩展其功能。您可以开发自定义的转换规则和逻辑，以处理特定的 WFFM 字段类型。
如何迁移 WFFM 表单收集到的文件上传数据？
WFMM 转换工具的最新版本引入了对文件上传字段的支持。您可以使用相应的插件来迁移文件上传数据。
您可能还想了解以下问题
WFMM转换工具分析报告里面都包含哪些内容?
WFMM转换工具分析报告包含了全面的迁移信息，主要包含以下几个方面： 成功转换的字段列表：详细列出所有成功从 WFFM 迁移到 Sitecore Forms 的字段，包括字段名称、类型和映射关系。 未成功转换的字段列表：列出未能自动转换的字段，并提供可能的原因，例如：自定义字段类型、缺少映射关系等。 数据一致性校验结果：如果启用了数据迁移功能，报告会包含数据一致性校验的结果，指出哪些数据未能成功迁移或存在差异。 手动调整建议：针对未能自动转换的字段，报告会提供手动调整的建议，例如：创建自定义字段类型、修改映射关系等。
如果WFMM转换工具在迁移过程中出现错误怎么办?
WFMM转换工具能极大的提高迁移速度，但是依旧可能会存在出现错误的情况，出现问题时，可以按照以下步骤进行排查： 查看转换报告：首先，仔细阅读 WFMM 转换工具生成的 CSV 报告，查找错误信息和警告信息。 检查配置文件：检查数据库连接字符串、元数据模板和自定义转换规则是否配置正确。 查看日志文件：WFMM 转换工具会将详细的日志信息写入到文件中，您可以查看日志文件以获取更多关于错误的上下文信息。 调试代码：如果您有编程经验，可以尝试调试 WFMM 转换工具的源代码，以找出问题的根本原因。 寻求社区支持：如果以上方法都无法解决问题，您可以向 Sitecore 社区寻求帮助，例如在 Sitecore Stack Exchange 或 Sitecore Slack 上提问。别忘了提供尽可能多的信息，包括 Sitecore 版本、WFFM 表单结构、JSON 映射文件和错误信息。
