Creación de un paquete basado en instrucciones
Los paquetes basados en instrucciones permiten crear paquetes que definen un conjunto de instrucciones que el dispositivo Edge debe realizar. El conector de eMessage cuenta con soporte integrado para paquetes basados en instrucciones.
 |
En esta sección, se supone que se han completado los requisitos previos de para crear un paquete basado en instrucciones.
|
Complete los siguientes pasos para crear un paquete basado en instrucciones:
1. En el panel izquierdo de ThingWorx Software Content Management, en la sección Paquetes, navegue hasta > .
Aparece la página Crear paquete.
2. En el campo Nombre paquete, introduzca el nombre del paquete.
3. En el campo Descripción paquete, introduzca una descripción breve del paquete.
4. En el campo Versión, introduzca un número de versión del paquete.
Las siguientes reglas se aplican a la versión de un paquete:
◦ Se debe introducir el número de versión principal del paquete.
◦ Solo es posible introducir números enteros no negativos.
◦ En cada cuadro del campo de versión, es posible introducir una cadena numérica con una longitud máxima de 4 para una versión del paquete, tal como se muestra en la siguiente imagen:
| | Por defecto, el número de versión principal se rellena con un 1 y se considera que los campos restantes tienen un valor de 0. Los siguientes son ejemplos de valores no válidos: • Si hay un valor definido para el último campo en el campo Versión, un valor vacío para los campos anteriores no es válido y se realza en rojo, tal como se muestra a continuación:  En lugar de dejar los campos en blanco, introduzca los siguientes valores (o cualquier otro valor) en los campos vacíos:  • Si se introduce un valor negativo en cualquiera de los campos, el campo en particular se realza en rojo, tal como se muestra a continuación:  Corrija el error introduciendo solo enteros no negativos en los campos. • Si se introduce una cadena alfabética o alfanumérica en cualquiera de los campos, el campo en particular se realza en rojo, tal como se muestra a continuación:  Corrija el error introduciendo solo enteros no negativos en los campos. |
5. Para indicar si el paquete tiene fecha de vencimiento, seleccione una de las siguientes opciones del campo Caducidad:
◦ Nunca: el paquete no caducará. Por defecto, esta opción define la fecha de vencimiento en 100 años a partir de la fecha de creación del paquete.
◦ Fecha: permite utilizar el widget del selector de fecha y hora para especificar cuándo desea que el paquete caduque.
| | No es posible crear dos paquetes con el mismo nombre y número de versión. Si se muestra un mensaje donde se indica que el nombre y la versión del paquete ya existen, proporcione una combinación única de nombre y versión. |
6. Para asociar un tipo de activo (plantilla de cosa) a un paquete, seleccione el tipo de activo en el selector de entidades Tipo de activo. Por defecto, este selector de entidades enumeraría todas las plantillas de cosa según la configuración mencionada en Configuración de ThingWorx Software Content Management.
Si el usuario selecciona una plantilla de cosa para los activos que deben recibir paquetes basados en instrucciones, solo se muestra la ficha Paquete basado en instrucciones y la ficha Paquete basado en ficheros está oculta.
Los tipos de activo que se muestran en el selector de entidades también dependen de la configuración de Tipos de paquete Tipos de paquete. Si solo se selecciona el tipo Paquete basado en instrucciones como visible, solo las plantillas que soportan paquetes basados en instrucciones se mostrarán en el selector de entidades.
7. Seleccione la ficha Paquete basado en instrucciones.
8. Pulse en Añadir instrucción para seleccionar el tipo de instrucción que desee entregar al activo.
9. En la lista Tipo de instrucción, en función de la instrucción que desee añadir, seleccione una de las siguientes instrucciones y realice la tarea correspondiente:
Instrucción | Tarea | ||||||
Descargar | Seleccione un fichero del almacén ThingWorx que desea descargar en el agente. Complete los siguientes pasos para añadir un fichero del almacén ThingWorx: a. En el campo Almacén de destino se muestra el valor de Almacén de destino de descargas configurado en la página Configuración de implementación. Pulse en  para modificar el almacén de descargas configurado.Para obtener más información, consulte Configuración de implementación. b. En la sección Estructura de directorio se muestra el contenido del repositorio seleccionado. En la sección Estructura de directorio se pueden realizar las siguientes acciones: ◦ Si el fichero que desea entregar al activo no está disponible en el almacén seleccionado, pulse en  para cargar un fichero al repositorio de ThingWorx.◦ Pulse en  para descargar el fichero en la ubicación de descarga por defecto del ordenador.◦ Pulse en  para borrar el fichero del almacén.c. En la sección Estructura de directorio, navegue hasta el fichero que desee descargar en el activo y, en la sección Contenido del directorio, seleccione el fichero para mostrar su nombre en el campo Nombre de fichero zip de contenido seleccionado. En la sección Contenido del directorio está disponible la siguiente información para cada fichero: ◦ Nombre: si el fichero está disponible en el almacén de ThingWorx, se especifica el nombre del fichero con la extensión. Si el fichero se carga en el almacén, la fecha y hora (en tiempo de época) se incorporan al nombre del fichero. Esta fecha y hora permiten distinguir entre dos ficheros con el mismo nombre. ◦ Fecha de carga: permite especificar la fecha y hora en que el fichero se ha añadido al almacén de ThingWorx. ◦ Tamaño: permite especificar el tamaño del fichero en bytes. ◦ Ruta: permite especificar la ruta absoluta del fichero en el almacén de ThingWorx. d. En el campo Directorio de destino, especifique la ubicación del activo donde desee que se descargue el fichero. e. Si se ha proporcionado una ruta absoluta en el campo Directorio de destino, seleccione la casilla El directorio de destino es absoluto. Este campo es opcional. Por defecto, no está seleccionado. f. Si desea que el dispositivo de Edge descomprima el fichero después de que se descargue, seleccione la casilla El agente debe descomprimir este archivo después de descargarlo. Este campo es opcional. Por defecto, no está seleccionado.
g. Seleccione la casilla Sobrescribir los ficheros existentes cuando el fichero se descargue en el directorio dado si desea que los ficheros existentes se sobrescriban cuando el fichero se descargue en el directorio especificado. Este campo es opcional. Por defecto, no está seleccionado. h. Pulse en Añadir para añadir la instrucción a la lista de instrucciones. | ||||||
Ejecutar | Permite ejecutar un comando en la cosa remota. a. En el campo Ejecutable, introduzca el comando que desee ejecutar. b. En el campo Argumentos, especifique los argumentos del comando que se ha definido en el campo Ejecutable. Este campo es opcional.
c. Si la ruta del ejecutable es absoluta, seleccione la casilla La ruta ejecutable es absoluta. Por defecto, esta opción no está seleccionada. d. Si desea que los comandos sean asíncronos, lo que significa que son independientes entre sí durante la ejecución, seleccione la casilla Ejecutar este comando de manera asincrónica (por ejemplo, no esperar a que el comando regrese antes de continuar con el procesamiento). Por defecto, la casilla no está seleccionada y las ejecuciones son sincrónicas. e. Pulse en Añadir para añadir la instrucción a la lista de instrucciones. | ||||||
Registrar script | Permite añadir instrucciones como script que se pueden implementar para un activo o varios activos para una instancia de Axeda Agent. Para obtener los pasos para registrar scripts, consulte: Ejecución de scripts para la implementación. | ||||||
Reiniciar | Permite reiniciar el agente. a. Seleccione la casilla Reinicio forzado. Desactivar para un reinicio normal para anular el proceso actual del agente e iniciar un nuevo proceso de agente. Por defecto, Reinicio forzado. Desactivar para un reinicio normal está seleccionado. Si no desea anular el proceso actual del agente, sino que solo desea reinicializar todos los componentes y recargar datos del disco, asegúrese de despejar la casilla Reinicio forzado. Desactivar para un reinicio normal. Se trata de un reinicio normal. b. Pulse en Añadir para añadir la instrucción a la lista de instrucciones.
| ||||||
Ejecutar script | Permite ejecutar el script registrado que se puede implementar para un activo o varios activos para una instancia de Axeda Agent. Para obtener los pasos para ejecutar scripts, consulte: Ejecución de scripts para la implementación. | ||||||
Definir propiedad | Permite definir el valor de propiedad especificado en el dispositivo Edge remoto. a. En los campos Nombre de propiedad y Valor de propiedad, especifique el nombre y el valor de la propiedad.
b. Pulse en Añadir para añadir la instrucción a la lista de instrucciones. | ||||||
Anular registro de script | Permite anular el registro de un script registrado de un activo o múltiples activos para una instancia de Axeda Agent. Para obtener los pasos para anular el registro del script, consulte: Ejecución de scripts para la implementación. | ||||||
Cargar | Permite a los agentes de Axeda eMessage cargar uno o más archivos a la plataforma ThingWorx. a. En el campo Almacén de destino, pulse en  para seleccionar el almacén en el que desee cargar los ficheros.Se puede crear un almacén de ficheros para las cargas y seleccionar el almacén de ficheros, por ejemplo, UploadRepository. b. En el campo Ruta de destino, especifique la ubicación en el almacén donde desea guardar los ficheros cargados. Por ejemplo: /UploadFiles permite guardar los ficheros en el directorio /UploadRepository/UploadFiles. Un valor de / permite guardar los ficheros cargados en el directorio UploadRepository.
c. En el campo situado junto a  , escriba el nombre del fichero que desee cargar y pulse en . Se pueden incluir entradas de comodín, como * o ?, en los nombres de fichero. Se utiliza * para representar varios caracteres y ? para representar un único carácter. Asegúrese de que este fichero exista en la ruta relativa del dispositivo.Para los agentes de Linux se permiten caracteres comodín (*,?). Para los agentes que se ejecutan en Windows, el carácter ? tiene el mismo efecto que el carácter *.
En la rejilla Ficheros para cargar se muestra la lista de ficheros que se deben cargar en la plataforma ThingWorx junto con su estado señalizador de borrado. Si desea borrar cualquier fichero de la lista, seleccione la entrada de la lista y pulse en .d. Después de añadir un fichero para cargarlo, el usuario tiene la opción de borrarlo del almacén después de que el paquete se haya implementado correctamente. Para borrar un fichero después de la carga, selecciónelo y cambie el botón Acciones de fila. Esto cambia el estado Borrar fichero después de la carga a true y el fichero se borra después de que el paquete se haya implementado correctamente. Se pueden seleccionar ficheros individuales seleccionando cada fichero de la rejilla, o bien seleccionar todos los ficheros añadidos para cargar seleccionando la casilla Nombre de fichero. Por defecto, el estado Borrar fichero después de la carga es false. El botón de alternar puede cambiar el estado de true a false o de false a true e. Pulse en Añadir para añadir la instrucción a la lista de instrucciones. |
| | Es posible añadir varias instrucciones a un solo paquete basado en instrucciones. |
10. Revise las instrucciones de la lista de instrucciones, donde se proporcionan los siguientes detalles:
◦ Orden: permite especificar el orden en el que las instrucciones se ejecutan en el agente.
◦ Tipo: permite especificar el tipo de instrucción como uno de los que se indican a continuación.
▪ Descargar
▪ Ejecutar
▪ Registrar script
▪ Reiniciar
▪ Ejecutar script
▪ Definir propiedad
▪ Anular registro de script
▪ Cargar
◦ Detalles: permite especificar los detalles de la instrucción que se han especificado al crear la instrucción.
Seleccione una instrucción de la lista y utilice una de las siguientes opciones para modificar la instrucción:
◦ Pulse en 
para editar una instrucción.
para editar una instrucción.◦ Pulse en 
o 
para reordenar una instrucción.
o para reordenar una instrucción.| | Asegúrese de que solo haya una instrucción de reinicio en la lista de instrucciones y de que la instrucción de reinicio sea la última instrucción de la lista de instrucciones. |
◦ Pulse en 
para borrar una instrucción.
para borrar una instrucción.11. Pulse en Guardar para guardar el paquete.
Aparece la página Añadir o modificar dependencias. Añadir o modificar dependencias es un paso opcional. Para obtener más información, consulte Adición o modificación de las dependencias de paquete.
12. Si se han añadido dependencias del paquete, pulse en Guardar.
Aparecerá la página Crear despliegue de prueba. La creación de un despliegue de prueba es un paso opcional. Para obtener más información, consulte Despliegue de paquetes de prueba.
13. También es posible especificar el nivel de acceso que se debe proporcionar para usuarios o grupos de usuarios específicos. Para obtener más información, consulte Especificación del control de acceso del usuario.
14. Continúe con la publicación del paquete.