| Vocero |
Transcripción |
| Juan Moore |
Hola, gracias por acompañarme. Mi nombre es John Moore y hoy hablaremos de Lupine, un framework que he desarrollado para crear, publicar, gestionar y monitorizar complementos de JMP. |
| |
Para empezar, les cuento un poco sobre mí. Me llamo John Moore y soy ingeniero y administrador, pero en el fondo me apasionan los datos. He trabajado como analista en Elanco Animal Health durante los últimos 19 años. |
| |
Tengo un hijo, un marido, un perro y, en este momento, aproximadamente 80.000 abejas. |
| |
Entonces, ¿cómo llegamos hasta aquí? Bueno, en Elanco tenemos TC, que son consultores técnicos, generalmente veterinarios o nutricionistas, repartidos por todo el mundo, y les hicimos usar JMP y la programación de scripts de JMP. |
| |
Y muchos de estos centros comunitarios solo tienen acceso intermitente a internet debido a su lejanía. |
| |
Así que nos encontramos en una situación donde los scripts improvisados pasaban de persona a persona. No había control de versiones. No teníamos ni idea de quién estaba usando qué script. |
| |
Y obtener los scripts era difícil, actualizarlos era difícil. Así que creé Lupine para intentar llegar a un estado en el que tuviéramos scripts estandarizados, control de versiones y pudiéramos saber fácilmente quién hacía qué y quién usaba qué scripts. |
| |
Podríamos distribuir fácilmente las actualizaciones y, como ventaja adicional, añadimos un par de fórmulas al Editor de fórmulas. |
| |
Veamos Lupine. Una vez instalado, verás que es bastante sencillo. En JMP solo hay un menú de Lupine con la opción de buscar actualizaciones. |
| |
Cuando consultes la opción para buscar actualizaciones, verás que se enumeran todos los complementos controlados por Lupine. |
| |
Y si no está actualizado, indicará que sí lo está. Si lo está, simplemente dirá: «De acuerdo». Es muy sencillo: solo muestra los complementos disponibles. ¿Tiene la versión más reciente? |
| |
También en el Editor de fórmulas, dado que nos dimos cuenta de que usábamos mucho estas fórmulas en particular, ya sabes, como mes/año, que devuelve el primer día del año. |
| |
del mes del día en que ha transcurrido la fecha. Tenemos año, trimestre, estación. También tenemos semana, donde se pueden realizar acciones como inicio y fin de semana, etc. |
| |
En Lupine también contamos con registro de uso. Cada vez que un usuario utiliza un script gestionado por Lupine, se crea un archivo de registro. Así sabemos quién usó qué script y qué complemento, y en qué momento. Esto nos ayuda a determinar qué scripts son útiles y cuáles no. |
| |
Digamos que quieres configurar Lupine en tu organización. |
| |
Bien, el primer paso es descargar algunos archivos zip. Tenemos un archivo zip de Lupine, un administrador de Lupine y una plantilla de Lupine. |
| |
También tenemos el ejemplo de Lupine. Por lo tanto, le sugiero que busque una carpeta y descargue los tres archivos que contiene. |
| |
Lo siguiente que debes decidir como administrador al configurar esto es: ¿dónde voy a colocar mis carpetas de red? Hay dos carpetas de red que son realmente importantes para Lupine. |
| |
Primero, debes agregar carpetas de depósito. Esta es una carpeta que contendrá todos tus complementos y el archivo PublishedAddins.jmp que contiene metadatos sobre esos complementos. |
| |
Otro aspecto que debemos considerar es nuestra carpeta central de registros. Esta carpeta contendrá todos los archivos de registro que se suben y que los usuarios crean cada vez que ejecutan un script gestionado por Lupine. |
| |
Como pueden ver, aquí tenemos un ejemplo de todos los complementos que tenemos en nuestro archivo de complementos publicados. Y aquí tienen solo un ejemplo de... |
| |
Archivos de registro. Cada archivo de registro tiene un ID único. Hablaremos de esto más adelante, pero cuando accedamos a ellos y los descarguemos, solo descargaremos el más reciente para que no tengas que descargar todo cada vez. |
| |
Una vez que hayas decidido dónde quieres colocarlos, debemos indicarle a Lupine dónde se encuentran. Para ello, accede a la carpeta de Lupine después de descomprimirla. |
| |
Y en la subcarpeta de administración de complementos, verá un archivo llamado "setup"; esta es la parte que debe buscar en la configuración. |
| |
Aquí es donde se define la ruta del repositorio de complementos y la ruta de los registros centrales. En producción, necesitará estas ubicaciones de red, pero para este sencillo ejemplo, las he creado en mi máquina. Aquí es donde usted definiría su ruta de red. |
| |
Una vez hecho esto, es hora de compilar Lupine para tu organización. En la carpeta de Lupine, copia todo excepto el archivo `gitattributes`, si lo hay. Yo uso GitHub Desktop para gestionar mi repositorio. |
| |
scripts. Lo recomiendo encarecidamente. Me ha facilitado mucho la vida. Pero no querrás incluirlos en tu script, así que copia todo menos el archivo gitattributes. Haz clic derecho en ellos, selecciona "Enviar a" y... |
| |
Envía esos archivos a una carpeta comprimida en formato ZIP. Esto creará un archivo ZIP con todos ellos. Los archivos de complementos de JMP son básicamente archivos ZIP. Así que lo que haremos será cambiarle el nombre a Lupine.jmpaddin. |
| |
Una vez que le asignes un nombre, solo tienes que hacer doble clic y se instalará. Así tendrás Lupine en tu ordenador. De momento no vamos a usarlo, pero ahí está. Si miras la barra de menús, verás Lupine. |
| |
A continuación, hablemos de Lupine Manager. Se trata de un complemento independiente diseñado para la persona que administra el sistema. |
| |
y el seguimiento y la actualización de todos los complementos dentro de una organización. Por lo tanto, probablemente esto no estará en el equipo de un usuario típico, simplemente porque |
| |
No es útil. Lo que sí tiene es un conjunto de herramientas que te ayudarán... a ti, como administrador, a gestionar los complementos. |
| |
Lo primero que debes hacer al abrir Lupine Manager es ir a Configuración y luego diremos |
| |
Nuestro archivo de usuarios únicos, que contiene todos los usuarios únicos de su organización, y datos de registro. |
| |
Bien, la tabla de usuarios únicos vincula los ID de usuario. Así que estamos obteniendo los ID de usuario de su ordenador. |
| |
identidad, pero normalmente no dicen nada demasiado significativo. Por ejemplo, la mía es 00126545. |
| |
Nos gustaría vincular algo que diga John Moore. Eso es lo que hace la función de usuarios únicos. El archivo de registro tiene una fila por cada registro. Este es un resumen de todos los archivos de registro que creamos anteriormente. Así que podemos analizarlos a nuestro antojo. |
| |
Bien, supongamos que quieres empezar a usar Lupine Manager. |
| |
Lo primero que debes hacer es indicarle qué complementos quieres administrar. Para ello, vamos a crear complementos y luego a administrar los complementos disponibles. |
| |
Y luego esto quedará en blanco. Cuando llegues a él, haz clic en Agregar complemento y podrás seleccionar las carpetas que contienen los archivos de los complementos que deseas controlar. |
| |
Una vez que lo hagas, verás que aparecen en la lista de complementos disponibles. Haz clic en "Crear complementos". Bien, aquí tienes dos opciones. "Crear complemento" simplemente creará |
| |
Es un archivo adicional en la carpeta donde están los scripts, así que esto es genial para, por ejemplo, hacer pruebas. Quiero hacer una compilación rápida para poder probar si funciona. |
| |
La opción "Compilar y publicar" hará lo mismo, pero además copiará el complemento a la carpeta de tu repositorio de complementos y actualizará el archivo de complementos publicados. Así, cuando estés listo para distribuirlo a la empresa, una vez realizadas las pruebas, estará listo para su uso. |
| |
Ahora bien, si desea importar todos esos datos de registro, lo único que tiene que hacer es ir a importar y procesar datos de registro, y esto importará todos los archivos de registro nuevos y los agregará a su archivo de datos de registro. |
| |
Aquí tenemos un resumen de usuarios, que es simplemente una tabla rápida que indica quién usa qué complemento. Esto le ofrece una visión general muy rápida de |
| |
¿Quiénes son mis mayores usuarios de cada complemento? Como pueden ver, en este ejemplo, Lupine y LupineManager se usan mucho; LupineExample1 también; y LupinExample, no tanto. |
| |
Bien, supongamos que ya tienes instalado Lupine y Lupine Manager. Ahora tienes algunos complementos que te gustaría administrar con Lupine. Veamos los pasos para hacerlo. |
| |
Lo primero que debes hacer es ir a la plantilla de complemento (el archivo de plantilla de Lupine) que tenemos y copiarla en alguna ubicación. Esta plantilla contiene todos los scripts necesarios y todo lo que permite que Lupine funcione con tu complemento. Así que, adelante, cópiala. |
| |
A continuación, vamos a seguir algunos pasos. El primero es editar el archivo addin.def. |
| |
Vamos a crear todos los scripts que necesitarás en tu complemento o a actualizarlos si ya los tienes. |
| |
Al crear el complemento, personalizaremos los menús para que tengan el aspecto deseado. Al hacer clic en él, se verá como usted quiere. Volveremos a crear el complemento una vez que hayamos corregido el menú para probarlo y asegurarnos de que funciona correctamente. Tras finalizar las pruebas, podremos publicarlo. |
| |
Hablemos entonces del archivo addin.def; addin.def es un pequeño archivo de texto, pero es necesario para cada complemento. Contiene la información esencial sobre el complemento. |
| |
¿Cuál es su ID y cuál es su nombre? Tendrás que editarlo para cambiarlo por el nombre que tendrá tu complemento. |
| |
Y esto solo se hace una vez. Una vez hecho esto, no debería ser necesario volver a modificarlo para el complemento. Así que esto solo se hace una vez... se configura al momento de la instalación. |
| |
A continuación, debes decidir qué script voy a incluir en este complemento. Ahora he creado un, |
| |
Archivo de registro de creación de Lupine. |
| |
Esto es lo que creará el archivo de registro para cualquier complemento que utilice Lupine. Esto es lo que realmente crea los registros y permite realizar el seguimiento de versiones. |
| |
Por lo tanto, recomiendo colocar este encabezado al final... al principio de todos tus archivos. El script que vas a usar, porque eso es lo que te permitirá monitorear las cosas. |
| |
Ahora que ya tienes todos tus scripts, lo siguiente que debes hacer es personalizar el archivo del menú. Por ahora, solo dirá "plantillas". |
| |
Primero vamos a compilar esto. Igual que hicimos con Lupine antes, seleccionando todo excepto los archivos gitattributes, haciendo clic derecho, comprimiendo y cambiando el nombre. |
| |
Vamos a hacer lo mismo. Y entonces tendremos el menú incorrecto, porque ahora mismo todavía tiene el menú de plantilla. Así que tenemos que entrar y actualizar ese menú de plantilla para que haga lo que queremos. |
| |
Bien, una vez instalado, verás tu nuevo script aquí arriba, tu nuevo complemento aquí arriba, la plantilla. Vamos a hacer clic derecho. |
| |
En el menú superior verás una larga lista. Al final, encontrarás la opción "Personalizar" y lo que queremos hacer es ir a "Menús y barras de herramientas". Una vez allí, verás algo parecido a esto. |
| |
Lo primero que debemos hacer es indicarle a JMP qué queremos editar. Queremos editar el menú que corresponde a nuestro complemento, que actualmente se llama plantilla. |
| |
Así que iremos a este botón de cambio. Haremos clic en él y tendremos una gran cantidad de opciones. Pero lo que queremos hacer es hacer clic en el botón de opción "Complementos JMP" y luego bajar a |
| |
El complemento que nos interesa. Bien. Aquí lo dejé como plantilla, pero si... dado que ya lo modificaste en el archivo addin.def, será lo que sea. |
| |
Una vez que hagas eso, lo que verás serán los fragmentos. |
| |
Los elementos que pertenecen a tu complemento aparecerán en azul aquí a la izquierda. |
| |
Esto es lo que vamos a editar y cambiar para adaptarlo a nuestras necesidades para nuestro nuevo complemento. |
| |
Veamos esto. Incluí la sección "Acerca de" en "Novedades" como un script estándar, pero cuando lo recibas, verás que apunta a |
| |
Este complemento de plantilla no es el que necesitas. Tú tienes el nombre que quieres para tu propio complemento. Así que lo que vamos a hacer es hacer clic en "Ejecutar complemento" en este archivo. |
| |
Haz clic en esta carpeta de complementos y selecciona el complemento que quieras. Esto indicará a JMP dónde están los nuevos scripts que acabas de crear. Finalmente, haz clic en Examinar. |
| |
Y entonces podemos buscar, navegar e ir al script específico que queremos y decir: "No, no, no quiero usarlo en la plantilla. Quiero que lo uses en mi nuevo complemento". |
| |
Asimismo, podemos hacer lo mismo con la sección "Novedades" del menú. |
| |
Y una vez que hayas hecho esos, realmente solo queda agregar el resto que queremos. |
| |
Si haces clic derecho sobre el área azul, verás estas opciones para insertar antes, insertar después, donde puedes agregar o eliminar elementos de tu menú. |
| |
Así que puedes añadir elementos, la mayoría serán comandos. También puedes crear un submenú para tener más opciones, o puedes añadir un separador que cree una línea discreta. |
| |
Así que vas a crear tu menú, incluyendo todos los elementos que... para los scripts que acabas de crear. |
| |
Y luego lo vamos a guardar, pero lo vamos a guardar dos veces. |
| |
Al guardarlo aquí, lo que sucederá es que simplemente se modificará la versión del complemento que está instalada en su máquina. |
| |
Eso está bien, pero también tendríamos que guardarlo en la carpeta donde estás desarrollando el complemento. Así, la próxima vez que desarrollemos el complemento, tendrá el archivo de menú correcto. |
| |
Después de hacer clic en guardar, haremos clic en guardar como e iremos a la carpeta que contiene nuestros archivos complementarios. |
| |
Bien, ya tenemos nuestros scripts. Tenemos nuestro addin.def definido, y tenemos nuestro menú listo. |
| |
Lo siguiente que debemos hacer es construir esto y probarlo. Normalmente, se lo enviaré a los usuarios para que me digan qué funciona y qué no. |
| |
Después de eso, puedo entrar y publicarlo. Cuando entres y publiques, te pedirá que actualices la información. |
| |
Lo más importante, y esto se aplica a Lupine Manager, es cambiar la fecha de lanzamiento. Así se informa a los usuarios de que hay una versión más reciente. |
| |
Hay una versión disponible, ¿verdad? Entonces... lo que va a pasar es que esta se compara con la fecha de publicación, y esa es la que Lupine va a usar para decir: "Oye, hay una versión más reciente para que la subas". |
| |
También puedes añadir notas, como notas de revisión. Estos son los cambios que hice esta vez. Estas son las grandes actualizaciones y mejoras que le hice a mi complemento. Y una vez que lo hagas, si haces clic en Publicar, |
| |
Luego, Lupine Manager hará una copia de ese complemento y la colocará en la carpeta que crea el complemento, donde se encuentra el código fuente. |
| |
También lo publicará en el repositorio de complementos y actualizará el archivo de complementos publicados para que contenga la versión más reciente. |
| |
Lo más importante es que incluya la fecha de lanzamiento. Así, si un usuario hiciera clic en "Buscar actualizaciones", se le indicaría que hay una nueva versión disponible para este complemento y le preguntaría si desea descargarla. Al hacer clic, se instalaría en su equipo. |
| |
Bueno, esa fue una introducción muy breve. |
| |
Espero que aquí encuentres suficiente material para hacerlo tú mismo. Si no es así, contáctame en john_moore@elanco.com. Con gusto te ayudaré a configurarlo. |
| |
Muchas gracias, y gracias de nuevo. Adiós. |
