Con el Complemento Administrador de complementos , puede realizar personalizaciones adicionales, que anteriormente habrían requerido editar XML sin formato manualmente. Este complemento también le brinda acceso automatizado a atributos de metadatos personalizados para todos sus complementos.
Elementos de menú personalizados
Puede cambiar el menú principal (complementos de forma predeterminada) haciendo clic derecho en el elemento de nivel superior del árbol. También puede cambiar el elemento del menú para insertarlo en este mismo menú. Esto sería útil si está utilizando un elemento del menú principal existente, como Analizar, y desea colocar el elemento del menú en una posición específica, como después de Ajustar Y por X.
Cambiar el menú principal a un menú integrado
- Haga clic derecho en el elemento superior del árbol de elementos del menú y seleccione "Cambiar menú principal".
- Desde la ventana "Cambiar menú principal", seleccione el menú del cuadro combinado en el que desea que se coloquen los elementos del menú.
- Si ya hay un valor establecido en la propiedad "Insertar después" (y el menú anterior era personalizado), se le pedirá que cambie la propiedad a un nuevo valor. El elemento que seleccione aquí determinará dónde se colocará su menú personalizado dentro de la barra del Menú principal.
Si no se le solicitó un valor Insertar después, puede hacer clic derecho en el elemento superior en el árbol de elementos del menú y seleccionar "Cambiar Insertar después" para actualizar este valor.
- Reconstruya su complemento e instálelo. El elemento del menú complementario aparecerá ahora en el menú principal seleccionado, después del elemento del menú especificado, como se muestra a continuación.
Cambiar el menú principal a un menú personalizado
- Haga clic derecho en el elemento superior del árbol de elementos del menú y seleccione "Cambiar menú principal".
- Desde la ventana "Cambiar menú principal", seleccione "Personalizado" en el cuadro combinado y escriba el nombre del menú que desee en el cuadro de edición de texto, como se muestra a continuación.
- Si ya hay un valor establecido en la propiedad "Insertar después" (y el menú anterior estaba integrado), se le pedirá que cambie la propiedad a un nuevo valor. El elemento que seleccione aquí determinará dónde se colocará su menú personalizado dentro de la barra del Menú principal.
Si no se le solicitó un valor Insertar después, puede hacer clic derecho en el elemento superior en el árbol de elementos del menú y seleccionar "Cambiar Insertar después" para actualizar este valor.
- Reconstruya su complemento e instálelo. El elemento del menú complementario aparecerá ahora en su menú principal personalizado, después del menú principal especificado, como se muestra a continuación.
Uso de varios menús principales en un único complemento
Con Add-In Manager, ahora puede crear un único complemento que cree varios elementos de menú dentro de varios menús principales diferentes. Esto puede resultar útil si está creando un complemento que realiza varias tareas que se ajustan a diferentes áreas. Por ejemplo, un complemento de utilidades de tablas de datos podría solicitar un elemento de menú con los menús Tablas, Filas y/o Columnas.
- Para agregar un menú principal adicional a su complemento, haga clic en el menú del triángulo rojo junto al "árbol de elementos de menú" en la pestaña elementos de menú y seleccione Agregar menú principal de nivel superior.
A continuación, seleccione el menú principal que desea que represente el nuevo menú, como se muestra en las secciones anteriores. A continuación, agregué dos menús principales adicionales.
- Una vez que haya agregado todos los menús principales deseados y los elementos de menú que los contienen, cree el complemento y vea los tres elementos de menú en varios menús principales.
Iconos JMP integrados para elementos del menú
Al igual que puede hacer en Add-In Builder, en Add-In Manager, puede especificar un archivo de icono personalizado para un elemento del menú. Sin embargo, en el Administrador de complementos, también puede elegir un ícono integrado para que aparezca junto al elemento del menú.
- En la pestaña Elementos del menú, seleccione un comando y haga clic en el botón Seleccionar dentro de la sección Icono.
- Seleccione el icono que desea utilizar y haga clic en Aceptar.
- Verá una vista previa del icono en el árbol de elementos del menú.
- Después de crear e instalar el complemento, verá el ícono integrado junto al elemento del menú.
Si desea utilizar cualquiera de estos íconos dentro de su complemento, consulte mi Iconos JMP integrados complemento.
Metadatos personalizados
Se pueden incluir metadatos personalizados en su complemento en forma de matriz asociativa. La matriz asociativa se escribirá en un archivo "customMetadata.jsl" en la carpeta de nivel superior de su complemento. Consulte el Índice de secuencias de comandos (Ayuda > Índice de secuencias de comandos) para ver ejemplos de uso.
Metadatos incluidos
A continuación se muestra una lista de todos los pares clave/valor que el Administrador de complementos administra automáticamente. No utilice ninguna de estas claves en sus propios metadatos personalizados.
Llave
|
Valor
|
Tipo de datos
|
versión adicional
|
%versión
|
Numérico
|
la fecha de construcción
|
%La fecha de construcción
|
Numérico
|
identificación
|
%Identificación
|
Personaje
|
desplegadoAddinsNombre de archivo
|
nombre-archivo-tabla-depósito.jmp
|
Personaje
|
implementadoAddinsLoc
|
/ruta/al/complemento/depósito/tabla
|
Personaje
|
nombre
|
%Nombre
|
Personaje
|
estado
|
"DEV" o "TEST" o "PROD"
|
Personaje
|
Agregar nuevos metadatos personalizados
Se pueden agregar metadatos personalizados haciendo clic en el ícono más verde al lado de la tabla en la pestaña Metadatos personalizados (dentro de la pestaña Información general).
Uso de metadatos personalizados en su complemento
A continuación se muestra un script de ejemplo "customMetadata.jsl", con una clave de metadatos personalizada denominada "autor".
Associative Array(
List(
List( "addinVersion", 2 ),
List( "author", "Justin Chilton" ),
List( "buildDate", 3594195289 ),
List( "deployedAddinsFilename", "publishedAddins.jsl" ),
List( "deployedAddinsLoc", "\\server\share\Add-In Depot\Meta\" ),
List( "id", "com.jmp.juchil.myjmpaddin" ),
List( "name", "My JMP Add-In" ),
List( "state", "DEV" )
)
)
La matriz asociativa se puede importar en su complemento usando la siguiente instrucción de inclusión (después de reemplazar 'com.jmp.myaddin' con el ID de su complemento).
aa = Include( "$ADDIN_HOME(com.jmp.myaddin)\customMetadata.jsl" );
Una vez que haya importado la matriz asociativa, puede utilizar la siguiente sintaxis para hacer referencia a un valor:
aa["author"]
Esta publicación de blog es la tercera parte de una serie de tres que cubre cómo definir y crear un complemento , implementar un complemento para los usuarios y haga que las personalizaciones avanzadas estén disponibles en el Administrador de complementos.Espero que encuentres mi Administrador de complementos complemento útil!
