求助：Design Automation无法导出Revit .sat文件的问题

问题描述 #

桌面端Revit运行代码可正常导出SAT文件，但在Design Automation环境下，项目文件和族文件调用document.Export导出SAT均返回false，无异常抛出；FBX、IFC、DWFX等格式导出无问题。使用代码如下：

View3D view3D = new FilteredElementCollector(document)
    .OfClass(typeof(View3D))
    .Cast<View3D>()
    .FirstOrDefault(v => v.Name == "3D_View");

ICollection<ElementId> view3Ds = new List<ElementId>() { view3D.Id };

try
{
    SATExportOptions SATOptions = new SATExportOptions();
    bool isExported = document.Export(desktopPath, $"Files.sat", view3Ds , SATOptions);
    TaskDialog.Show("Export Sin transaction" , isExported ? "(*) SAT Modelo exportado correctamente" : "(X) SAT Error al exportar modelo");
    //transaction.Commit();
}
catch (Exception ex)
{
    TaskDialog.Show("Title",$"(X) Error al Exportar .sat {ex.Message}");
}

排查与解决方向 #

• 环境与权限检查
  Design Automation对SAT导出可能有特殊组件依赖，确认AppBundle包含Revit SAT导出所需模块；同时保证云端Revit版本与桌面端完全一致，版本差异可能导致导出逻辑不兼容。

• 显式配置SATExportOptions参数
  桌面端默认参数在云端可能不生效，建议显式设置关键参数：

  SATExportOptions satOptions = new SATExportOptions
  {
      IncludeGeometry = true,
      ExportScope = SATExportScope.View,
      ExportLinkedFiles = false
  };
  

• 修正导出路径
  Design Automation不能使用桌面本地路径，必须使用云端允许的工作目录：

  string workDir = Environment.GetEnvironmentVariable("APPDATA");
  bool isExported = document.Export(workDir, "Files.sat", view3Ds, satOptions);
  

  注意document.Export第一个参数是目录路径，第二个是文件名，不要混淆。

• 事务与文档状态处理
  将导出操作包裹在事务中，确保文档状态正确：

  using (Transaction transaction = new Transaction(document, "Export SAT"))
  {
      transaction.Start();
      bool isExported = document.Export(workDir, "Files.sat", view3Ds, satOptions);
      transaction.Commit();
      // 用文件日志替代TaskDialog
      File.WriteAllText(Path.Combine(workDir, "export_log.txt"), isExported ? "SAT导出成功" : "SAT导出失败");
  }
  

  若操作族文件，需先调用document.EditFamily()激活编辑模式。

• 日志排查
  云端环境TaskDialog无法显示，需将日志写入文件或输出到Design Automation日志系统，通过日志信息定位具体失败原因。

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