A partir de la versión 2.0 de Administrador de complementos , ahora puede implementar la actualización automática JMP complementos a sus usuarios con un solo clic. Add-In Manager le permite implementar en ubicaciones de prueba y producción. La implementación, para fines del Administrador de complementos, es el proceso de mover (o enviar) un complemento a sus usuarios.
Puede definir ubicaciones de implementación predeterminadas para TEST y PROD con las preferencias del Administrador de complementos. También puede configurar las ubicaciones de PRUEBA y PROD de manera diferente para cada complemento en la sección Ubicaciones de carpetas en la pestaña Información general.Hay un archivo de secuencia de comandos "customMetadata.jsl" creado dentro de su complemento con una matriz asociativa que contiene varios fragmentos de información. Una clave en la matriz asociativa se llama "estado", que contiene la ubicación de la compilación actual, ya sea DEV, TEST o PROD. Puede encontrar más información sobre cómo agregar sus propios metadatos personalizados en mi próxima publicación de blog, Administrador de complementos, Parte 3: Personalización avanzada .
Complemento de compilación en la ubicación de DEV
Una ubicación de implementación es una ruta de carpeta que apunta a un área de ensayo particular. En Add-In Manager, hay tres áreas de preparación (denominadas Ubicaciones de implementación): DEV, TEST y PROD. La ubicación DEV es la ubicación donde se crean inicialmente los complementos. Esta ubicación es un excelente lugar para que usted, el desarrollador, pruebe su complemento y lo pruebe. Para obtener información sobre cómo crear un complemento en esta ubicación DEV, consulte mi blog anterior, Administrador de complementos, parte 1: definición y creación de un complemento JMP .
Implementar complemento en la ubicación de PRUEBA
Si necesita que uno o más de sus usuarios prueben una compilación particular de su complemento, pero no está listo para enviarla a todos, puede implementar su complemento en la ubicación de implementación de PRUEBA y proporcionar la ruta para instalar este complemento a los usuarios.
Antes de implementar un complemento en una ubicación de PRUEBA, asegúrese de tener una ubicación de implementación de PRUEBA definida en la pestaña PRUEBA de la sección Ubicaciones de carpetas.
Haga clic en el botón desplegable Implementar y seleccione "Implementar TEST" para copiar el complemento en la carpeta de implementación de TEST. El complemento TEST se sobrescribirá cada vez que se implemente en la carpeta de implementación TEST.
Implementar complemento en la ubicación de PROD
Una vez que se completan todas las pruebas para que una nueva versión de un complemento esté lista para su lanzamiento, puede implementar su complemento
Antes de implementar un complemento en una ubicación de PROD, asegúrese de tener una ubicación de implementación de PROD definida en la pestaña PROD de la sección Ubicaciones de carpetas. Si usa el script de verificación de actualizaciones, asegúrese de que la carpeta de metadatos PROD use una ruta de servidor, ya que los usuarios deberán poder acceder a esta ruta cuando busquen actualizaciones.
Haga clic en el botón desplegable Implementar y seleccione "Implementar PROD" para copiar el complemento en la carpeta de implementación de PROD con un estado establecido en "PROD". El complemento PROD anterior se archivará en la carpeta Archivo PROD y el nuevo complemento PROD ocupará su lugar.
Al implementar en PROD, el script de matriz asociativa "publishedAddins.jsl" en la carpeta de metadatos de PROD se actualizará con la fecha de compilación del complemento implementado. Esta información se puede consultar mediante el script updateCheck, que se puede activar en las Preferencias de implementación.
A continuación se muestra un archivo de secuencia de comandos "publishedAddins.jsl" de ejemplo con dos complementos publicados. Nunca debería necesitar mirar o editar este archivo, pero podría ser bueno saber cómo funciona detrás de escena.
Associative Array(
List(
List( "com.jmp.juchil.myjmpaddin1",
Associative Array(
List(
List( "filename", "My First JMP Add-In.jmpaddin" ),
List( "folder", "\\server\share\Add-In Depot\Production\" ),
List( "pubDate", 3594027166 )
)
)
),
List( "com.jmp.juchil.myjmpaddin2",
Associative Array(
List(
List( "filename", "My Second JMP Add-In.jmpaddin" ),
List( "folder", "\\server\share\Add-In Depot\Production\" ),
List( "pubDate", 3594026242 )
)
)
)
)
)
Actualizar secuencia de comandos de verificación
Para que los complementos se actualicen automáticamente, debe activar la preferencia "Incluir secuencia de comandos de verificación de actualización". Con esta preferencia activada, se incluirá un script llamado "updateCheck.jsl" en la carpeta de nivel superior de su complemento. Puede cambiar el script predeterminado editando el archivo "updateCheck.jsl" en el directorio "Template Scripts" dentro del directorio de inicio del Administrador de complementos. Asegúrese de hacer una copia de este archivo antes de editarlo.
El archivo "updateCheck.jsl" existente verifica la matriz asociativa de metadatos PROD que se analizó en la sección anterior. Utiliza la clave "buildDate" del archivo de metadatos personalizado para verificar si la versión instalada es más antigua que una versión publicada disponible. Dado que la secuencia de comandos de actualización se basa en el archivo de metadatos personalizado, es importante mantener activada la opción "Crear archivo de metadatos" si utiliza las funciones de implementación.
Puede usar este script usando la instrucción Incluir a continuación. Deberá cambiar la ID para que coincida con la ID de su complemento. Puede usar esta verificación de actualizaciones al comienzo de la secuencia de comandos de su comando o en una secuencia de comandos de ButtonBox para buscar una nueva versión. Sin embargo, a partir de JMP 13, el uso de este script dentro de un script addinLoad.jsl no funcionará.
Include( "$ADDIN_HOME(com.jmp.myaddin)\updateCheck.jsl" );
com.jmp.juchil.addinmanager:checkForUpdate();
Puede editar la secuencia de comandos "updateCheck.jsl" dentro de su carpeta de origen una vez que se haya copiado, o puede editar la copia original utilizada desde la carpeta Plantilla de secuencias de comandos dentro de la carpeta de inicio del Administrador de complementos.
El concepto que usa una matriz asociativa para buscar actualizaciones se adaptó de @brady_brady El método de usar una tabla con fechas de publicación. Este método se describe en @Jeff_Perkinson publicación de Cómo escribir complementos JMP de actualización automática .
Esta publicación de blog es la segunda parte de una serie de tres partes, que cubre cómo definir y crear un complemento , implementar un complemento para los usuarios y hacer personalizaciones avanzadas disponible en el Administrador de complementos.Espero que encuentres mi Administrador de complementos complemento útil!
