Con el Complemento Administrador de complementos , puede realizar personalizaciones adicionales, que anteriormente habrían requerido editar XML sin procesar 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 con el botón derecho en el elemento de nivel superior en el árbol. También puede cambiar el elemento del menú para insertar en este mismo menú. Esto sería útil si está utilizando un elemento de menú principal existente, como Analizar, y desea colocar el elemento de menú en una posición específica, como después de Ajustar Y por X.
Cambio del menú principal a un menú integrado
- Haga clic con el botón derecho en el elemento superior del árbol de elementos del menú y seleccione "Cambiar menú principal".
- En la ventana "Cambiar menú principal", seleccione el menú del ComboBox en el que desea que se coloquen sus elementos de menú.
- Si ya hay un valor establecido en la propiedad "Insertar después" (y el menú anterior era uno 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 con el botón 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 de menú de su complemento ahora aparecerá en el menú principal seleccionado, después del elemento de menú especificado, como se muestra a continuación.
Cambio del menú principal a un menú personalizado
- Haga clic con el botón derecho en el elemento superior del árbol de elementos del menú y seleccione "Cambiar menú principal".
- En la ventana "Cambiar menú principal", seleccione "Personalizar" en el cuadro combinado y escriba el nombre del menú deseado 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 con el botón 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 de menú de su complemento ahora aparecerá 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 solo complemento
Con el Administrador de complementos, ahora puede crear un solo complemento que crea varios elementos de menú dentro de varios menús principales diferentes. Esto puede ser útil si está creando un complemento que realiza múltiples tareas que se ajustan a diferentes áreas. Por ejemplo, un complemento de utilidades de tabla de datos puede requerir 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ú Triángulo rojo junto al "Árbol de elementos del menú" en la pestaña Elementos del 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, he agregado 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 de menú
Al igual que puede hacer en Add-In Builder, en Add-In Manager, puede especificar un archivo de icono personalizado para un elemento de menú. Sin embargo, en el Administrador de complementos, también puede elegir un icono incorporado para que aparezca junto a su elemento de 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 le gustaría usar y haga clic en Aceptar.
- Verá una vista previa del icono en el árbol de elementos del menú.
- Después de compilar e instalar el complemento, verá el icono integrado junto a su elemento de menú.
Si desea utilizar alguno de estos iconos dentro de su complemento, consulte mi Iconos JMP incorporados complemento
Metadatos personalizados
Los metadatos personalizados se pueden incluir 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
|
AddinVersion
|
% ver
|
Numérico
|
la fecha de construcción
|
%La fecha de construcción
|
Numérico
|
identificación
|
%Identificación
|
Personaje
|
deploymentAddinsFilename
|
nombre-archivo-tabla-depot.jmp
|
Personaje
|
desplegadoAddinsLoc
|
/ruta/hacia/complemento/depósito/tabla
|
Personaje
|
nombre
|
%Nombre
|
Personaje
|
estado
|
"DEV" o "PRUEBA" o "PROD"
|
Personaje
|
Adición de nuevos metadatos personalizados
Se pueden agregar metadatos personalizados haciendo clic en el icono verde más junto a 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 mediante la siguiente declaración de inclusión (después de reemplazar 'com.jmp.myaddin' con la ID de su complemento).
aa = Include( "$ADDIN_HOME(com.jmp.myaddin)\customMetadata.jsl" );
Una vez que haya importado la matriz asociativa, puede usar 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 partes, 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!
