Automatizzare le esportazioni approvate di Prism
Configurare esportazioni Ultra da riga di comando coperte da licenza, con snapshot approvati, file di richiesta versionati e autorizzazione per computer.
- Si applica a
- Release corrente di Prism · Navisworks Manage 2025–2027
- Disponibilità
- Ultra; licenza per singola pipeline
- Per
- Specialisti dell'automazione BIM e amministratori di piattaforma
- Ultima revisione
Che cos'è l'esportazione headless
Il comando headless di Ultra invia un ModelSnapshot Paramora esistente agli stessi runner di destinazione soggetti a licenza e agli stessi controlli delle funzionalità usati dal connettore interattivo. Non è un lettore NWD generico, non automatizza l'interfaccia utente di Navisworks e non aggira la disponibilità delle destinazioni né la validazione.
Prerequisiti
- Un accordo Ultra che copra esplicitamente la pipeline di automazione e le funzionalità di destinazione.
- Un computer supportato con il motore Prism firmato completo e i componenti di destinazione richiesti.
- Un file .pmsnap della versione corrispondente, generato tramite un connettore o un flusso di acquisizione approvato.
- Un file JSON di richiesta di esportazione validato, che usi la versione del protocollo documentata e ID stabili.
- Un diritto d'uso online associato al computer oppure una licenza offline rilasciata separatamente, adeguati alla distribuzione.
Sintassi del comando
Paramora.Engine.exe --export <request.json> --snapshot <model.pmsnap>
Paramora.Engine.exe --export <request.json> --snapshot <model.pmsnap> --license <license.json>L'avanzamento e il risultato finale del job vengono emessi come righe JSON su standard output; la diagnostica, ripulita dai dati sensibili, usa standard error. Considerare determinanti lo stato finale del job e il report, non solo il codice di uscita del processo o la presenza di un file di destinazione.
Progettare una pipeline di produzione
Fissare input compatibili
Gestire insieme le versioni di generatore dello snapshot, protocollo, schema della richiesta, preset/profilo e canale dei componenti firmati.
Validare prima di pubblicare
Scrivere in una destinazione di staging, richiedere la politica di validazione finale e promuovere solo un set di artefatti completo e verificato.
Raccogliere le evidenze
Conservare il digest della richiesta, l'identità dell'input, gli hash dei file generati, il profilo effettivo, il report, la versione di componenti e prodotto e i timestamp.
Limitare le risorse e gestire l'annullamento
Definire i limiti attesi di tempo, memoria e spazio di archiviazione per ogni job e gestire l'annullamento cooperativo prima di ricorrere alla pulizia forzata.
Proteggere l'autorizzazione
Usare credenziali associate al computer o licenze offline prelevandole dall'archivio dei segreti previsto; non eseguirne mai il commit accanto ai file di richiesta.
Informazioni per l'assistenza sull'automazione
- Versione del prodotto e dei componenti, canale di aggiornamento e formato di destinazione.
- Il JSON della richiesta ripulito dai dati sensibili, oppure una riproduzione minima, senza percorsi privati né credenziali.
- Risultato JSON finale, report e diagnostica pertinente emessa su standard error.
- Schema/versione dello snapshot di input e un suo hash; non allegare un modello del cliente a meno che l'assistenza non richieda esplicitamente un trasferimento sicuro.
- Risultato atteso ed effettivo, data e ora del primo errore con fuso orario e se la stessa richiesta riesce in modalità interattiva.