关于 Autodesk DWG Integrity and Migration for Docs

使用 Autodesk® DWG Integrity and Migration for Docs 可高效地将项目数据上传到 Autodesk Docs。

Autodesk DWG Integrity and Migration for Docs 应用程序在包括数据完整性检查、修复和上传在内的整个数据移植过程中提供指导。它使您能够清理数据完整性问题，以便上传过程可以成功且高效地完成。

若要使用此工具，必须满足以下先决条件：

有关如何使用此工具的更多信息，请参见 使用 Autodesk DWG Integrity and Migration for Docs 将文件移植到 Autodesk Docs 的步骤。

Autodesk DWG Integrity and Migration for Docs 将对您选择上传的数据集执行数据完整性检查，并确定内容存在的不同问题（如果存在）。有关每种问题类型的详细信息，请参见以下部分。

提示： 作为 Autodesk DWG Integrity and Migration for Docs 应用程序的补充，您可以使用参考资源管理器检查数据集内的依存关系。

解决数据完整性问题

DWG Integrity and Migration for Docs 会指导数据完整性维护过程，包括问题检查和修复。修复本地数据完整性问题工具旨在跟踪断开的链接和循环参照。此外，还会报告相关数据，以解决在将本地数据移植到 Docs 后可能断开的链接。可以解决的数据完整性问题包括：
  • 本地图形中缺少参照。移植后，云项目中缺少参照可能会导致数据不一致、功能问题、从属问题和维护困难，从而影响系统性能和整体项目效率。
  • 相关数据。如果参照文件不在要移植的同一文件夹中（或位于其子文件夹之一内），则它们不会与主体文件一起上传，并产生断开的链接。
  • 循环参照。这将导致各种协作问题。
  • 绝对路径。当在多个用户之间或跨不同系统共享文件时，绝对路径将无法在每个系统上正确解析，从而导致链接断开和错误。

有关更多信息，请参见使用 Autodesk DWG Integrity and Migration for Docs 将文件移植到 Autodesk Docs 的步骤。

数据完整性问题类型

在数据完整性检查中，可能会出现以下问题。

  • 问题类型：长文件路径。上传具有长路径的文件和文件夹不会对 Desktop Connector 造成问题。但在该问题解决前，DWG Integrity and Migration for Docs 将跳过对这些文件和文件夹的扫描。此外，仍存在不支持的操作。本地工作流以及通过 Desktop Connector 在 Autodesk Docs 中进行的工作流，会出现文件自动锁定或文件重命名等同步问题。

    有关详细信息，请参见 Desktop Connector 文档。

    如何修复此问题：考虑缩短文件夹层级结构以及文件/文件夹的名称长度。

  • 问题类型：更新过程中部分文件已被跳过。若您遇到“文件引用更新警告”且附带文件列表，则表明扫描过程中出现了问题。文件将会上传，但其引用关系可能未被完整扫描且未得到充分保留。请尝试以下步骤进行故障排除：
    如何解决此问题：
    • 检查文件访问权限：确保您拥有访问这些文件所需的读/写权限。
    • 检查图形：在 AutoCAD 或 Civil 3D 中使用 AUDIT 命令，检测并修复 DWG 文件中可能存在的问题。

    如果问题仍然存在，请收集受影响的文件以及 DWGRefMgr.exe 日志文件，并将其共享给 Civil 3D 团队，以便进一步调查。日志文件位于此处：C:\Users\{用户名}\AppData\Local\Temp\DWGRefMgr_Log\{executeTime}.感谢您的合作！

  • 问题类型：缺少参照。当 Desktop Connector 传输包含参照的文件时，它会尝试查找所有参照文件。如果在未修复缺失参照的情况下执行移植，Desktop Connector 将显示以下通知：“收集参照时失败。一个或多个参照文件可能已被删除，或者您可能没有读取权限。”

    此问题表示未能找到参照文件。

    这是一个问题，因为缺失的参照不会上传到 Autodesk Docs。这将导致存储在 Autodesk Docs 的主体图形中的链接被破坏。

    如何解决此问题：
    • 选项 1：使用 Autodesk DWG Integrity and Migration for Docs 解决缺失参照的问题。为此，请展开缺失参照列表并指定缺失文件所在的路径。系统将重新指定参照的路径并将其与主体文件一起上传到 Autodesk Docs。请注意，如果参照的文件不在主体文件的文件夹结构中（在与主体文件相同的文件夹或其下方的一个子文件夹内），则修复缺失的参照问题类型将生成相关数据问题类型。
    • 选项 2：在编写应用程序中打开原始文件，并解决任何缺失参照，然后再上传文件。修复断开的参照并保存对主体文件所做的更改后，您需要选择“重新扫描”按钮以使用更改。
  • 问题类型：相关数据。当 Desktop Connector 传输包含参照的主体文件时，它会计算这些参照相对于主体的相对位置。

    如果参照文件不在要移植的同一文件夹中（或位于其子文件夹之一内），则它们被视为“相关数据”，不会与主体文件一起上传。

    这是一个问题，因为相关数据被视为位于移植集之外，因此受影响的文件将从移植中排除，并且参照文件的路径将不会在主体文件中解析。这表示数据完整性问题，并会导致移植的数据集中的参照被损坏。

    如何解决此问题：
    • 在 Autodesk DWG Integrity and Migration for Docs 中，展开相关数据问题列表，选择要解决的问题并指定要上传到 Autodesk Docs 目标位置的文件夹。

      您可以在 Autodesk Docs 中选择表示数据集未来状态的目标文件夹，或创建用于存储参照文件的新文件夹。

      • 注： 表示数据集未来状态的文件夹将以蓝色标记为待定状态。
  • 问题类型：循环参照。一系列指回自己的嵌套参照称为循环参照。例如，如果图形 A 参照图形 B，而图形 C 参照图形 A，则参照顺序 A>B>C>A 即为循环参照。

    这是一个问题，因为循环参照可能会导致通过 Desktop Connector 下载和上传文档时出现问题，并且还可能影响性能。

    如何修复此问题：由于无法在 Autodesk DWG Integrity and Migration for Docs 应用程序中解决此类问题，因此它们被视为仅具有提醒作用。如果可能，建议但不强制要求删除循环参照。删除循环参照的步骤：
    1. 使用 Autodesk DWG Integrity and Migration for Docs 检查所选数据集中是否存在任何循环参照。
    2. 在编写应用程序（如 Civil 3D 或 AutoCAD）中打开受影响的文件。
      注： 可以单击文件名以展开依存关系图并查看其参照。
    3. 删除导致循环依存关系的参照。
    4. 保存文件。
    5. 单击“重新扫描”按钮以使用更改。
  • 问题类型：文件名重复。在极少数情况下，如果数据集包含多个存储在本地不同路径中的同名源文件，则解决以前的问题类型（缺少参照、相关数据）可能会产生文件名重复问题。

    当选择将两个同名的源文件存储在同一 Autodesk Docs 目标位置时，将发生这种情况。同名文件可以表示完全相同的文件、相同文件的不同版本或恰好具有相同名称的完全不同的文件。

    这是一个问题，因为将两个同名文件上传到 Desktop Connector 将导致待定操作失败和/或意外的文件覆盖。

    如何修复此问题：使用 Autodesk DWG Integrity and Migration for Docs，通过为每个文件使用最合适的选项来解决此问题：
    • 选择文件，然后使用“解决”按钮为文件指定其他目标位置。
    • 选择文件，然后单击右侧的“...”按钮。然后，选择“不上传”选项，以便不会上传文件。
  • 问题类型：不受支持的文件。以下产品主题中介绍了支持和不支持的文件类型：

    尝试上传不受支持的文件类型是一个问题，因为这会导致 Desktop Connector 中的挂起操作失败。

    由于这种类型的错误不需要用户输入，因此被视为仅具有提醒作用。Autodesk DWG Integrity and Migration for Docs 应用程序将从上传过程中排除不受支持的文件类型。

移植 Civil 3D 数据快捷方式项目的最佳实践

使用 Autodesk DWG Integrity and Migration for Docs 移植 Civil 3D 数据快捷方式项目时，主体图形中的数据参照 (DREF) 信息将自动更新以指向 Autodesk Docs 中的新路径，但数据快捷方式 .xml 文件中的信息不会更新。只要源图形存储在要移植的文件夹中，并且工作文件夹的相对路径在移植后保持不变，这就不会影响数据快捷方式机制。在这些情况下，将在 Civil 3D 中为具有足够权限的其他用户找到并解析对快捷方式的数据参照。

以下条件可能会导致移植后快捷方式被损坏：

要解决移植后参照被损坏的问题，请使用数据快捷方式编辑器指定 Autodesk Docs 中源图形所在的路径。

注： 数据快捷方式 .xml 文件中的原始路径会针对数据快捷方式编辑器中的所有快捷方式进行显示，因此在将项目上传到 Autodesk Docs 之后，您将不会看到对该路径的更改。如果需要，可以在移植完成后修复所有路径以指向 Autodesk Docs 路径。

移植大型或复杂数据集的注意事项和最佳实践

Autodesk DWG Integrity and Migration for Docs 应用程序中有一些操作（例如检查数据完整性、修复多个缺少的参照、准备列表以进行上传，以及浏览到 Autodesk Docs 中的文件夹）可能存在处理延迟。如果数据集包含许多文件和文件夹，则这些延迟会更大。在这种情况下，请等待应用程序完成处理。

此外，Autodesk DWG Integrity and Migration for Docs 会将选定文件夹和文件复制到 Desktop Connector 工作空间，然后依靠 Desktop Connector 进行上传过程。对于大型和/或复杂的数据集，这两个过程都可能非常耗时。因此，当 Desktop Connector 未用于其他过程（不应有任何待定操作）时，建议使用 Autodesk DWG Integrity and Migration for Docs。在运行移植时应避免以下操作：打开和保存图形、将文件夹拖放到 Desktop Connector 中，以及运行应用程序的多个实例。

对于复杂项目，处理和移植文件所需的存储空间可能会相当大。生成 JSON 导出引用文件时，系统会使用默认临时文件夹存储文件，路径为：C:\Users\{用户名}\AppData\Local\Temp\DWGMigrationForDocs_Temp。如有需要，您可以在其他驱动器上指定新的存储位置。单击 DWG Integrity and Migration for Docs 应用程序右上角的“设置”。在“设置”对话框中，指定新的临时文件夹位置，然后单击“保存”。

尽管 Autodesk DWG Integrity and Migration for Docs 可以识别给定数据集的所有数据完整性问题，但如果问题数量很多，在该应用程序内修复所有问题可能会适得其反。如果您拥有大型数据集（大小很大或文件数量很多），并在其中发现了许多“长路径”问题、“缺少参照”问题和“相关数据”问题，请考虑花费时间在本地重新排列文件夹和修复参照，然后使用“重新扫描”按钮来使用更改。需要修复的问题越多，该应用程序完成所有过程（包括上传阶段，这可能会占用过多的带宽）所需的时间就越长。

使用排除列表过滤掉不需要的文件（.log、.tmp、.err等），该过程不是必要的，并且会增加处理时间。同样，如果需要，可以从本地数据集中清除对整个文件夹的选择。

请尽可能避免太多的循环参照，特别是当它们包含许多嵌套级别时，因为它们可能会增加上传时间。如果需要循环关系，请考虑暂时删除该关系以进行移植，然后在将文件存储在 Autodesk Docs 中后重新添加该关系。

Autodesk DWG Integrity and Migration for Docs 应用程序中的已知问题

父主题： Autodesk Collaboration for Civil 3D