Un'estensione è un archivio zip costituito da file di estensione e un file di metadati. Per installare il contenuto di un'estensione in ThingWorx, è necessario importare il file zip. È possibile importare più estensioni contemporaneamente raggruppando tutti i file zip di estensione in un'unica cartella zip.

L'importazione di estensioni è disattivata per default per tutti gli utenti. Per attivarla, configurare il file platform-settings.json.

Adottare un approccio iterativo per configurare i parametri in ExtensionPackageImportPolicy e attivare il numero minimo di parametri per controllare l'importazione delle estensioni. Tutti i parametri sono false per default.

Per importare un'estensione, attenersi alla procedura descritta di seguito.

Mediante l'utilizzo dell'attributo dependsOn dell'elemento ExtensionPackage, è possibile specificare coppie nome-versione separate da virgola per le estensioni. Il formato è nome:numero di release principale.numero di release secondaria.numero di patch (ad esempio EstensioneA:1.0.0) ed è utilizzato nel controllo della dipendenza.

Quando si prova ad aggiornare un'estensione con supporto Java importando una nuova versione, viene visualizzato un messaggio informativo che indica che è necessario riavviare la piattaforma. In questo caso, il file zip dell'estensione viene inserito in una coda: /ThingworxStorage/extensions/upgradequeue. Dopo aver riavviato il server Apache Tomcat, ThingWorx proverà a importare i file zip dell'estensione nella coda. Se l'importazione dell'estensione in coda non riesce, è necessario riavviare nuovamente il server per ripristinare la versione precedente dell'estensione. Dopo che ThingWorx prova a importare le estensioni in coda, la coda viene cancellata anche se un'importazione non riesce.

Non è necessario riavviare dopo ogni importazione di un'estensione supportata da Java. Nel caso di estensioni multiple, è possibile metterle in coda in modo che vengano importate nell'ordine appropriato in base alle rispettive dipendenze dopo un solo riavvio. Per ulteriori informazioni sulla configurazione delle dipendenze, vedere la Extension Development Guide.

Di seguito sono presentati alcuni messaggi informativi e avvisi che vengono di solito visualizzati durante l'importazione di estensioni.

Questo messaggio viene visualizzato ogni volta che si importa un'estensione con un JAR e informa che è necessario riavviare il server per completare l'importazione.

Dopo il riavvio, controllare i log applicazioni per assicurarsi che l'importazione delle estensioni in coda riesca. Per ogni estensione in coda importata nel log applicazioni dovrebbe essere indicato:

Se le importazioni accodate riescono, viene visualizzato il messaggio:

In caso di problemi viene visualizzato l'errore:

Se l'importazione di estensioni ha esito negativo, nel log applicazioni vengono visualizzati messaggi che indicano genericamente che l'importazione di estensioni non è riuscita e fanno riferimento al log degli errori per ulteriori dettagli. Nel file ErrorLog.log, alla fine del messaggio di errore generato per l'errore di importazione viene indicato il motivo per cui l'importazione del package estensione non è riuscita. L'errore può essere causato ad esempio dal fatto che l'importazione è disattivata, che l'importazione di file jar non è consentita e così via. Utilizzare questo errore per regolare le impostazioni di configurazione appropriate per installare correttamente l'estensione.