使用批处理工具保存数据

您可以使用批量导入工具将现有 SOLIDWORKS 数据保存到 3DEXPERIENCE Platform。这是一个命令行工具,可将目录、单个文件或单个装配体结构的内容保存到 3DEXPERIENCE Platform。

批处理工具的文件位置为:
C:\Program Files\Dassault
    Systemes\B<release_number>xcadconnectors\win_b64\USWC\
从命令行或批处理文件中运行该工具,因为它仅接受命令行参数。
以下是几个命令行参数。
  • -h--help:显示命令的基本用法
  • -f--file:处理单个文件或单个装配体结构
  • -d--directory:处理文件夹的内容
  • -o--output:在给定路径生成 JSON 输出
  • --simul:工具在仿真模式下操作文件,不保存任何内容
  • --swversion:生成指定版本的 CGR。如果使用 --file--directory 选项,则 --swversion 选项为必需选项。
  • --drawing:处理文件中存在的关联工程图

如果使用 -f 选项,同时使用 -d 选项,则保存流程可能会更快完成,但该流程将消耗更多内存。

如果事务较大,批处理可能需要很长时间,或者该流程可能会停止。如果在执行批处理期间出现登录对话框,请再次输入登录凭据以继续该流程。

工具运行时:
  • 请勿再次启动工具。
  • 请勿在 SOLIDWORKS 中执行任何 3DEXPERIENCE 操作。
如果出现未能启动 SOLIDWORKS 的错误消息,即使工具正在执行,也请单击确定。错误消息消失,执行继续。

命令执行

下表介绍了可以执行的操作:

  将单个文件保存到 3DEXPERIENCE Platform 将文件夹的内容保存到 3DEXPERIENCE Platform
说明 此命令可将单个 SOLIDWORKS 文件保存到 3DEXPERIENCE Platform。
只有在命令中使用 --drawing 参数时,该工具才会处理并保存零件或装配体的相关工程图。
此命令可将文件夹的内容保存到 3DEXPERIENCE Platform。该工具可扫描给定文件夹的内容并搜索 SOLIDWORKS 文件(扩展名为 .SLDASM.SLDPRT 或者 .SLDDRW 的文件)。不处理其他文件类型。每个 SOLIDWORKS 文件及其参考的文件都会保存到 3DEXPERIENCE Platform。
该工具不会处理给定文件夹中的子文件夹。只有在给定文件夹中的文件涉及到了子文件夹中的文件时,才会处理参考的文件。
句法 保存文件:

C:\>SaveInto3DEXPERIENCE.exe –-file filepath --swversion sw20xx_spxx

保存包含关联工程图的文件:

C:\>SaveInto3DEXPERIENCE.exe –-file filepath --drawing
    --swversion
C:\>SaveInto3DEXPERIENCE.exe –-directory folderpath –-swversion
    sw20xx_spxx
示例

C:\>SaveInto3DEXPERIENCE.exe --file
              "C:\3DEXPERIENCE\Local Work Folder\Skateboard.SLDASM" –-swversion
              sw2019_sp05
C:\>SaveInto3DEXPERIENCE.exe --directory "C:\3DEXPERIENCE\Local Work Folder\Test"
      -–swversion sw2019_sp05

示例假定工具位置在 %PATH% 中声明。提供工具执行的完整路径。

检查文件标题的唯一性选项与此实用程序不兼容。标题唯一性未经验证,具有重复标题的文件会被保存。

命令输出

执行结束后,输出采用 JSON 格式。它会提供以下详细信息:
  • 已保存文件的完整路径。
  • 3DEXPERIENCE Platform 中相应对象的类型、名称、修订版和物理 ID。如果文件包含配置和虚拟零部件或零件,其详细信息也会包含在报告中。
下表说明了 JSON 报告中包含的术语:
类型 说明 项目零部件
processed 已处理的文件列表。
  • 文件路径:文件的完整路径(目录名和文件名)
  • 类型:对象的 3DEXPERIENCE 类型。
  • 名称: 对象的 3DEXPERIENCE 名称。
  • 版本: 对象的 3DEXPERIENCE 版次。
  • 物理 ID:对象的 3DEXPERIENCE 物理 ID。
  • 配置:配置列表。配置的描述如下:
    • SWconfigId:配置的 SOLIDWORKS ID。
    • SWconfigName:SOLIDWORKS 配置的名称。
    • 类型:对象的 3DEXPERIENCE 类型。
    • 名称: 对象的 3DEXPERIENCE 名称。
    • 版本: 对象的 3DEXPERIENCE 版次。
    • 物理 ID:对象的 3DEXPERIENCE 物理 ID。
  • 虚拟零部件:虚拟零部件的列表。虚拟零部件的描述如下:
    • SWvirtualIdent:连接配置的 SOLIDWORKS ID、“-”和虚拟零部件文件名的字符串。
    • 类型:对象的 3DEXPERIENCE 类型。
    • 名称: 对象的 3DEXPERIENCE 名称。
    • 版本: 对象的 3DEXPERIENCE 版次。
    • 物理 ID:对象的 3DEXPERIENCE 物理 ID。
to_be_processed 要处理文件的列表。 文件路径: 文件或目录的完整路径。
already_processed 已处理文件的列表。
  • 文件路径:文件的完整路径(目录名和文件名)
  • 类型:对象的 3DEXPERIENCE 类型。
  • 名称: 对象的 3DEXPERIENCE 名称。
  • 版本: 对象的 3DEXPERIENCE 版次。
  • 物理 ID:对象的 3DEXPERIENCE 物理 ID。
  • 配置:配置列表。配置的描述如下:
    • SWconfigId:配置的 SOLIDWORKS ID。
    • SWconfigName:SOLIDWORKS 配置的名称。
    • 类型:对象的 3DEXPERIENCE 类型。
    • 名称: 对象的 3DEXPERIENCE 名称。
    • 版本: 对象的 3DEXPERIENCE 版次。
    • 物理 ID:对象的 3DEXPERIENCE 物理 ID。
  • 虚拟零部件:虚拟零部件的列表。虚拟零部件的描述如下:
    • SWvirtualIdent:连接配置的 SOLIDWORKS ID、“-”和虚拟零部件文件名的字符串。
    • 类型:对象的 3DEXPERIENCE 类型。
    • 名称: 对象的 3DEXPERIENCE 名称。
    • 版本: 对象的 3DEXPERIENCE 版次。
    • 物理 ID:对象的 3DEXPERIENCE 物理 ID。
not_processed 未处理文件的列表。
  • 文件路径: 文件或目录的完整路径。
  • 原因: 保存操作失败的说明。
使用以下命令将生成的 JSON 输出保存在文本文件中。
  • 对于文件:

    语法: C:\>SaveInto3DEXPERIENCE.exe --file save_location_of_file –-swversion sw20xx_spxx -o location_and_format_of_output

    示例: C:\>SaveInto3DEXPERIENCE.exe --file "C:\3DEXPERIENCE\Local work folder\Skateboard.SLDASM" –-swversion sw2019_sp05 –o C:\temp\Report1.json

  • 对于目录:

    语法: C:\>SaveInto3DEXPERIENCE.exe --directory save_location_of_directory –-swversion sw20xx_spxx -o location_and_format_of_output

    示例: C:\>SaveInto3DEXPERIENCE.exe --directory "C:\3DEXPERIENCE\Local work folder\Folder1" –-swversion sw2019_sp05 –o C:\temp\Report1.json

以下示例是成功执行该工具后显示的 JSON 输出。以下示例中提到的值仅供参考。
{
  "processed": [{
    "Configurations": [{
            "Name": "prd-00000400",
            "PhysicalId": "B03728D97A4000006311D9DE000203A1",
            "Revision": "A",
            "SWconfigId": 0,
            "SWconfigName": "Default",
            "Type": "VPMReference"
        }, {
            "Name": "prd-00000401",
            "PhysicalId": "B03728D97A4000006311D9DE0005B251",
            "Revision": "A",
            "SWconfigId": 1,
            "SWconfigName": "C2",
            "Type": "VPMReference"
        }, {
            "Name": "prd-00000402",
            "PhysicalId": "B03728D97A4000006311D9DE00074B23",
            "Revision": "A",
            "SWconfigId": 2,
            "SWconfigName": "C3",
            "Type": "VPMReference"
        }
    ],
    "FilePath": "C:\\3DEXPERIENCE\\My Work\\BatchSave\\EMPTY_C1_C2_C3.SLDPRT",
    "Name": "xcadmodel-DSQAL012-00000013",
    "PhysicalId": "B03728D97A4000006311D9DE001B9FFF",
    "Revision": "A",
    "Type": "XCADModelRepReference"
  }, {
    "Configurations": [{
            "Name": "prd-00000539",
            "PhysicalId": "B03728D97A4000006311EB21000C15FB",
            "Revision": "A",
            "SWconfigId": 0,
            "SWconfigName": "Default",
            "Type": "VPMReference"
        }
    ],
    "FilePath": "C:\\3DEXPERIENCE\\My Work\\BatchSave\\EMPTY_Tree_VCAssem3_VCAssem4_VCPart1.SLDASM",
    "Name": "xcadmodel-00000023",
    "PhysicalId": "B03728D97A4000006311EB2100161FD9",
    "Revision": "A",
    "Type": "XCADModelRepReference",
    "VirtualComponents": [{
            "Name": "prd-00000540",
            "PhysicalId": "B03728D97A4000006311EB2100197AAB",
            "Revision": "A",
            "SWvirtualIdent": "0-Assem3^EMPTY_Tree_VCAssem3_VCAssem4_VCPart1.SLDASM",
            "Type": "VPMReference"
        }, {
            "Name": "prd-00000541",
            "PhysicalId": "B03728D97A4000006311EB21001B6283",
            "Revision": "A",
            "SWvirtualIdent": "0-Assem4^Assem3_EMPTY_Tree_VCAssem3_VCAssem4_VCPart1.SLDASM",
            "Type": "VPMReference"
        }, {
            "Name": "prd-00000538",
            "PhysicalId": "B03728D97A4000006311EB2100001983",
            "Revision": "A",
            "SWvirtualIdent": "0-Part1^Assem4_Assem3_EMPTY_Tree_VCAssem3_VCAssem4_VCPart1.SLDPRT",
            "Type": "VPMReference"
            }
        ]
    }
  ]
}