Salvataggio dei dati tramite lo strumento Batch

È possibile utilizzare lo strumento di importazione batch per salvare i dati SOLIDWORKS esistenti sulla 3DEXPERIENCE Platform. Lo strumento Batch è uno strumento a riga di comando che salva il contenuto di una directory, di un singolo file o di una singola struttura di assieme sulla 3DEXPERIENCE Platform.

La posizione del file dello strumento Batch è:
C:\Program Files\Dassault
    Systemes\B<release_number>xcadconnectors\win_b64\USWC\
Eseguire lo strumento dalla riga di comando o dal file batch poiché lo strumento accetta solo argomenti della riga di comando.
Di seguito sono riportati alcuni argomenti della riga di comando.
  • -h o --help: descrive l'utilizzo di base del comando
  • -f o --file: elabora un singolo file o una singola struttura di assieme
  • -d o --directory: elabora il contenuto di una cartella
  • -o o --output: genera un output JSON nel percorso specificato
  • --simul: consente di utilizzare lo strumento in modalità di simulazione senza salvare alcun file
  • --swversion: genera il CGR della versione specificata. Se si utilizza l'opzione --file o --directory, l'opzione --swversion è obbligatoria.
  • --drawing: elabora i disegni associati contenuti nel file

Se si utilizza l'opzione -f, il processo di salvataggio può essere completato più rapidamente di quando si utilizza l'opzione -d ma il processo utilizzerà più memoria.

Se le dimensioni della transazione sono grandi, l'elaborazione in batch può richiedere molto tempo o il processo potrebbe interrompersi. Se durante l'esecuzione del processo in batch viene visualizzata la finestra di dialogo di accesso, immettere nuovamente le credenziali di accesso per continuare l'operazione.

Mentre lo strumento è in esecuzione:
  • Non riavviare lo strumento.
  • Non eseguire altre operazioni 3DEXPERIENCE in SOLIDWORKS.
Se viene visualizzato il messaggio di errore Impossibile avviare SOLIDWORKS anche se l'esecuzione dello strumento è in corso, fare clic su OK. Il messaggio di errore scompare e l'esecuzione continua.

Esecuzione dei comandi

La seguente tabella descrive le operazioni che è possibile eseguire:

  Salvataggio di un singolo file SOLIDWORKS sulla 3DEXPERIENCE Platform Salvataggio del contenuto di una cartella sulla 3DEXPERIENCE Platform
Descrizione Questo comando salva un singolo file SOLIDWORKS sulla 3DEXPERIENCE Platform.
Lo strumento elabora e salva i disegni correlati per una parte o un assieme solo se nel comando viene utilizzato l'argomento --drawing.
 Questo comando salva il contenuto della cartella sulla 3DEXPERIENCE Platform. Lo strumento esegue la scansione del contenuto della cartella specificata e cerca i file SOLIDWORKS (file con estensione .SLDASM, .SLDPRT o .SLDDRW). Altri tipi di file non vengono elaborati. Ogni file SOLIDWORKS trovato viene salvato sulla 3DEXPERIENCE Platform insieme ai relativi file di riferimento.
Lo strumento non elabora le sottocartelle presenti nella cartella specificata. Solo se i file nella cartella specificata fanno riferimento a file nelle sottocartelle i file di riferimento vengono elaborati.
Sintassi Salvataggio di un file:

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

Salvataggio di un file con disegni associati:

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

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

Questo esempio presuppone che la posizione dello strumento sia dichiarata in %PATH%. Specificare il percorso completo per l'esecuzione dello strumento.

L'opzione Verificare l'unicità del titolo del file non è compatibile con questa utility. L'unicità del titolo non viene verificata e i file con titoli duplicati vengono salvati.

Output dei comandi

Al termine dell'esecuzione, l'output generato è in formato JSON. L'output contiene le seguenti informazioni:
  • Il percorso completo dei file salvati.
  • Il tipo, il nome, la revisione e l'ID fisico degli oggetti corrispondenti nella 3DEXPERIENCE Platform. Se i file contengono configurazioni e componenti o parti virtuali, i relativi dettagli vengono inclusi nel rapporto.
La seguente tabella spiega i termini utilizzati nel rapporto JSON:
Tipo Descrizione Componenti dell'elemento
processed L'elenco dei file elaborati.
  • FilePath: percorso completo del file (nome della directory e nome del file)
  • Tipo : tipo 3DEXPERIENCE dell'oggetto.
  • Cognome: nome 3DEXPERIENCE dell'oggetto.
  • Revisione: revisione 3DEXPERIENCE dell'oggetto.
  • PhysicalId: ID fisico 3DEXPERIENCE dell'oggetto.
  • Configurazioni: elenco delle configurazioni. Una configurazione è descritta da:
    • SWconfigId: ID SOLIDWORKS della configurazione.
    • SWconfigName: nome della configurazione SOLIDWORKS.
    • Tipo : tipo 3DEXPERIENCE dell'oggetto.
    • Cognome: nome 3DEXPERIENCE dell'oggetto.
    • Revisione: revisione 3DEXPERIENCE dell'oggetto.
    • PhysicalId: ID fisico 3DEXPERIENCE dell'oggetto.
  • VirtualComponents: elenco dei componenti virtuali. Un componente virtuale è descritto da:
    • SWVirtualIdent: stringa che concatena il SOLIDWORKS ID della configurazione, “-“ e il nome del file del componente virtuale.
    • Tipo : tipo 3DEXPERIENCE dell'oggetto.
    • Cognome: nome 3DEXPERIENCE dell'oggetto.
    • Revisione: revisione 3DEXPERIENCE dell'oggetto.
    • PhysicalId: ID fisico 3DEXPERIENCE dell'oggetto.
to_be_processed L'elenco dei file da elaborare. Filepath: percorso completo del file o della directory.
already_processed L'elenco dei file già elaborati.
  • FilePath: percorso completo del file (nome della directory e nome del file)
  • Tipo : tipo 3DEXPERIENCE dell'oggetto.
  • Cognome: nome 3DEXPERIENCE dell'oggetto.
  • Revisione: revisione 3DEXPERIENCE dell'oggetto.
  • PhysicalId: ID fisico 3DEXPERIENCE dell'oggetto.
  • Configurazioni: elenco delle configurazioni. Una configurazione è descritta da:
    • SWconfigId: ID SOLIDWORKS della configurazione.
    • SWconfigName: nome della configurazione SOLIDWORKS.
    • Tipo : tipo 3DEXPERIENCE dell'oggetto.
    • Cognome: nome 3DEXPERIENCE dell'oggetto.
    • Revisione: revisione 3DEXPERIENCE dell'oggetto.
    • PhysicalId: ID fisico 3DEXPERIENCE dell'oggetto.
  • VirtualComponents: elenco dei componenti virtuali. Un componente virtuale è descritto da:
    • SWVirtualIdent: stringa che concatena il SOLIDWORKS ID della configurazione, “-“ e il nome del file del componente virtuale.
    • Tipo : tipo 3DEXPERIENCE dell'oggetto.
    • Cognome: nome 3DEXPERIENCE dell'oggetto.
    • Revisione: revisione 3DEXPERIENCE dell'oggetto.
    • PhysicalId: ID fisico 3DEXPERIENCE dell'oggetto.
not_processed L'elenco dei file non elaborati.
  • Filepath: percorso completo del file o della directory.
  • Ragione: Spiegazione dell'errore dell'operazione di salvataggio.
Utilizzare i seguenti comandi per salvare l'output JSON generato in un file di testo.
  • Per il file:

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

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

  • Per la directory:

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

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

L'esempio seguente è l'output JSON visualizzato al termine di un'esecuzione senza errori dello strumento. I valori indicati nell'esempio seguente sono solo a scopo illustrativo.
{
  "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"
            }
        ]
    }
  ]
}