Autodesk Forge 数据管理参考 API 未列出 Revit 参考

Question

我的目标是使用设计自动化 API 计算 Revit 模型。 Revit 模型托管在 BIM360 文档 上。 Revit 模型包含其他模型的链接/参考。这些引用是在 Revit 中创建的，并且都引用了同样托管在 BIM360 文档上的模型。

为了将工作项提交给设计自动化 API，我需要知道所有引用的文件。这被描述为here。

但是，当我查询数据管理 API {{FORGE_HOST}}/data/v1/projects/:project/versions/:version/relationships/refs 的引用端点时，我得到一个空数据对象。

我本来希望得到引用项目的版本。

建议的工作流程似乎是使用 BIM360 文档前端中的“上传链接文件”功能将文件上传到 BIM360，请参阅this blog post。这样做，我确实使用上述引用端点获得了引用。但是，这不适用于我们的组织和工作流程，因为在规划阶段添加了越来越多的参考资料。而且，有些文件相互引用，使用“上传链接文件”功能也无法实现。博客中还提到了链接文件的 forge API，但我们不想使用 forge API 手动链接模型，而是想使用 Revit 提供的功能。

如何为已使用 Revit 中的引用链接的 Revit 文件提取/查询 Revit 引用？

Answer 1

更新

现在情况变了。要使用 Forge 数据管理 API 获取 Revit 参考，模型需要与以下内容匹配：

• Revit Could Workshared models(C4R)
• Cloud Models for Revit
• 通过BIM360 Docs'Upload Linked Files上传主机和链接
  • 在我的博客BIM360 Docs: Setting up external references between files (Upload Linked Files) 之后使用 Forge DM 设置参考

参考：https://knowledge.autodesk.com/support/revit-products/troubleshooting/caas/sfdcarticles/sfdcarticles/Collaboration-for-Revit-Local-links-not-visible-on-the-cloud.html

如果您的 Revit 模型是上述任一模型，则 Revit API 方式是另一种选择。在运行您提到的设计自动化工作项之前，您可以编写一个在 Revit Desktop 上运行的 Revit 插件来读取 Revit 链接数据。

===========

Autodesk Desktop Connector 将是设置引用的最佳选择，而无需使用我在博客中分享的 upload linked files 或 Forge DM API。

如果您只想转储链接信息，我们可以利用 Revit API 来执行此操作。这是给你的代码sn-p。 （在 Forge Design Automation API for Revit 上运行之前，TaskDialog.Show 需要删除）

https://thebuildingcoder.typepad.com/blog/2019/06/accessing-bim360-cloud-links-thumbnail-and-dynamo.html

  // Obtain all external resource references 
  // (saying BIM360 Cloud references and local 
  // file references this time)

  ISet<ElementId> xrefs = ExternalResourceUtils
    .GetAllExternalResourceReferences( doc );

  string caption = "BIM360 Links";

  try
  {
    int n = 0;
    var msg = string.Empty;

    foreach( ElementId eid in xrefs )
    {
      var elem = doc.GetElement( eid );
      if( elem == null ) continue;

      // Get RVT document links only this time

      var link = elem as RevitLinkType;
      if( link == null ) continue;

      var map = link.GetExternalResourceReferences();
      var keys = map.Keys;

      foreach( var key in keys )
      {
        var reference = map[key];

        // Contains Forge BIM360 ProjectId 
        // (i.e., LinkedModelModelId) and 
        // ModelId (i.e., LinkedModelModelId) 
        // if it's from BIM360 Docs. 
        // They can be used in calls to
        // ModelPathUtils.ConvertCloudGUIDsToCloudPath.

        var dictinfo = reference.GetReferenceInformation();

        // Link Name shown on the Manage Links dialog

        var displayName = reference.GetResourceShortDisplayName();
        var path = reference.InSessionPath;
      }

      try
      {
        // Load model temporarily to get the model 
        // path of the cloud link

        var result = link.Load();

        // Link ModelPath for Revit internal use

        var mdPath = result.GetModelName();

        link.Unload( null );

        // Convert model path to user visible path, 
        // i.e., saved Path shown on the Manage Links 
        // dialog

        var path = ModelPathUtils
          .ConvertModelPathToUserVisiblePath( mdPath );

        // Reference Type shown on the Manage Links dialog

        var refType = link.AttachmentType;

        msg += string.Format( "{0} {1}\r\n", 
          link.AttachmentType, path );

        ++n;
      }
      catch( Exception ex ) // never catch all exceptions!
      {
        TaskDialog.Show( caption, ex.Message );
      }
    }

    caption = string.Format( "{0} BIM360 Link{1}", 
      n, Util.PluralSuffix( n ) );

    TaskDialog.Show( caption, msg );
  }
  catch( Exception ex )
  {
    TaskDialog.Show( caption, ex.Message );
  }