使用批次工具來儲存資料

您可以使用批次輸入工具,將現有的 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 報告中包含的術語:
類型 說明 項目零組件
已處理 已處理檔案的清單。
  • FilePath:檔案的完整路徑 (目錄名稱和檔案名稱)
  • 類型:物件的 3DEXPERIENCE 類型。
  • Name: 物件的 3DEXPERIENCE 名稱。
  • 修訂版: 物件的 3DEXPERIENCE 修訂版。
  • PhysicalId:物件的 3DEXPERIENCE 實體 ID。
  • 模型組態:模型組態清單。模型組態的說明方式:
    • SWconfigId:模型組態的 SOLIDWORKS ID。
    • SWconfigName:SOLIDWORKS 模型組態的名稱。
    • 類型:物件的 3DEXPERIENCE 類型。
    • Name: 物件的 3DEXPERIENCE 名稱。
    • 修訂版: 物件的 3DEXPERIENCE 修訂版。
    • PhysicalId:物件的 3DEXPERIENCE 實體 ID。
  • VirtualComponents:虛擬零組件清單。虛擬零組件的描述方式:
    • SWvirtualIdent:串連模型組態的 SOLIDWORKS ID、「-」,以及虛擬零組件檔案名稱的字串。
    • 類型:物件的 3DEXPERIENCE 類型。
    • Name: 物件的 3DEXPERIENCE 名稱。
    • 修訂版: 物件的 3DEXPERIENCE 修訂版。
    • PhysicalId:物件的 3DEXPERIENCE 實體 ID。
to_be_processed 待處理的檔案清單。 檔案路徑: 檔案或目錄的完整路徑。
already_processed 已處理檔案的清單。
  • FilePath:檔案的完整路徑 (目錄名稱和檔案名稱)
  • 類型:物件的 3DEXPERIENCE 類型。
  • Name: 物件的 3DEXPERIENCE 名稱。
  • 修訂版: 物件的 3DEXPERIENCE 修訂版。
  • PhysicalId:物件的 3DEXPERIENCE 實體 ID。
  • 模型組態:模型組態清單。模型組態的說明方式:
    • SWconfigId:模型組態的 SOLIDWORKS ID。
    • SWconfigName:SOLIDWORKS 模型組態的名稱。
    • 類型:物件的 3DEXPERIENCE 類型。
    • Name: 物件的 3DEXPERIENCE 名稱。
    • 修訂版: 物件的 3DEXPERIENCE 修訂版。
    • PhysicalId:物件的 3DEXPERIENCE 實體 ID。
  • VirtualComponents:虛擬零組件。虛擬零組件清單說明:
    • SWvirtualIdent:串連模型組態的 SOLIDWORKS ID、「-」,以及虛擬零組件檔案名稱的字串。
    • 類型:物件的 3DEXPERIENCE 類型。
    • Name: 物件的 3DEXPERIENCE 名稱。
    • 修訂版: 物件的 3DEXPERIENCE 修訂版。
    • PhysicalId:物件的 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"
            }
        ]
    }
  ]
}