Acumatica SO301000经典UI自定义转现代UI时文件不显示求助

问题描述 #

已在经典UI中完成销售订单界面（SO301000）的自定义，尝试转换为现代UI时，按以下步骤操作后无效：

• 进入销售订单界面，点击「自定义>转换为现代UI」
• 将导出的.html和.ts文件解压后移动至..\FrontendSources\screen\src\screens\SO\SO301000路径
• 返回并打开自定义项目
• 点击「Modern UI Files」
• 点击「+」添加文件

问题：无文件显示，且无法浏览文件所在路径（按规则应自动识别）。尝试将文件放入..\FrontendSources\screen\src\screens\SO\SO301000\extensions文件夹，仍无文件显示。

遗漏步骤排查 #

• 检查文件命名匹配度：导出的文件必须与屏幕ID完全一致，比如主文件需命名为SO301000.ts和SO301000.html。若导出文件带额外后缀（如SO301000_1.ts），需重命名去掉后缀，确保文件名与屏幕ID严格对应。
• 绑定FrontendSources项目：打开自定义项目后，右键项目 → 选择「添加>现有项目」，找到..\FrontendSources\screen\screen.csproj并添加。仅复制文件到路径不足以让Acumatica识别，必须将前端项目绑定到自定义解决方案中。
• 执行前端构建命令：进入..\FrontendSources\screen目录，运行以下命令：

  npm install  # 首次操作执行，安装依赖
  npm run build  # 编译前端资源
  

  未编译的源文件无法被Modern UI文件管理器识别，必须完成构建步骤。
• 修正文件夹结构：转换后的自定义文件直接放在..\FrontendSources\screen\src\screens\SO\SO301000根目录即可，不需要放入extensions子文件夹（该目录用于第三方扩展集成，不适用于自身UI转换的文件）。
• 刷新应用缓存：复制文件并完成构建后，重启Acumatica对应的IIS应用程序池，清除应用缓存后再打开自定义项目查看文件。

内容的提问来源于stack exchange，提问作者pmfith