Una extensión es un archivo comprimido compuesto de ficheros de extensión y un fichero de metadatos. Para instalar el contenido de una extensión en ThingWorx, es necesario importar el fichero comprimido. Se pueden importar varias extensiones a la vez al empaquetar todos los ficheros comprimidos de extensión en una carpeta comprimida.

La importación de extensión está desactivada por defecto para todos los usuarios, pero se puede activar mediante la configuración del fichero platform-settings.json:

Aplique un método iterativo al configurar los parámetros en ExtensionPackageImportPolicy para activar el número mínimo de parámetros y controlar las importaciones de extensión. Todos los parámetros son false por defecto.

Para importar una extensión, siga los siguientes pasos:

Con el uso del atributo dependsOn del elemento ExtensionPackage, se pueden especificar pares de nombre-versión para extensiones separados por comas. El formato es nombre:número de versión principal.número de versión secundaria.número de parche (por ejemplo, ExtensiónA:1.0.0), que se utiliza en la verificación de la dependencia.

Cuando se intenta actualizar una extensión basada en Java mediante la importación de una nueva versión, se muestra un mensaje de información en el que se indica que es necesario reiniciar la plataforma. Cuando sucede esto, el fichero comprimido de extensión se coloca en una cola: /ThingworxStorage/extensions/upgradequeue. Después de reiniciar el servidor Apache Tomcat, ThingWorx intentará importar los ficheros comprimidos de extensión en la cola. Si falla una importación de extensión en cola, es necesario volver a reiniciar el servidor para volver a la versión anterior de la extensión. Después de que ThingWorx intente importar extensiones en cola, la cola se despeja, incluso si falla la importación de extensión en cola.

No es necesario reiniciar después de cada importación de una extensión basada en Java. Es posible poner varias extensiones en cola para la importación y estas se importarán en el orden adecuado en función de sus dependencias después de un único reinicio. Consulte el manual Extension Development Guide para obtener más información sobre la configuración de las dependencias.

Los siguientes mensajes de información y avisos son comunes durante las importaciones de extensiones:

Cada vez que se importa una extensión con un fichero JAR en ella, se recibirá este mensaje en el que se indica que es necesario reiniciar el servidor para completar la importación.

Después de reiniciar, compruebe los registros de aplicación para asegurarse de que las extensiones en cola se importan correctamente. Se debería ver lo siguiente en el registro de aplicación para cada extensión en cola que se está importando:

Si las importaciones en cola se han completado correctamente, se mostrará el siguiente mensaje:

Si se han producido incidencias, se mostrarán los siguientes errores:

Si falla la importación de extensión, se recibirán mensajes en el registro de aplicación que indican genéricamente que la "importación de extensión ha fallado" y que hacen referencia al registro de errores para obtener más detalles. En el fichero ErrorLog.log, al final del mensaje de error que se genera debido al fallo de importación, se indica el motivo por el que ha fallado la importación del paquete de extensión. Algunos ejemplos de fallo son la desactivación de la importación, la importación de jar no permitida, etc. Utilice este error como ayuda para ajustar los valores de configuración adecuados y poder instalar la extensión correctamente.