Saltar al contenido principal

Editor de interfaz del script

El editor de interfaz del script sirve para crear el formulario de parámetros que se muestra antes de ejecutar un script. Después de guardarlo, el usuario puede hacer clic en Configuración al seleccionar el script en la interfaz principal, completar los parámetros y ejecutarlo.

Abrir desde el directorio de scripts​

Los directorios de scripts planos y los directorios de paquetes .xpp compatibles con la configuración de interfaz muestran Editar configuración de UI del script. Si esta opción no aparece en el menú contextual, comprueba que el script esté en Directorio de scripts y que el control central pueda reconocer su estructura.

El flujo habitual es:

  1. En Gestor de archivos → Directorio de scripts, abre el menú contextual de un directorio de scripts plano o de un directorio de paquete .xpp.
  2. Selecciona Editar configuración de UI del script.
  3. Añade campos de entrada, interruptores, listas desplegables, grupos de selección múltiple y otros elementos desde la lista de elementos del formulario.
  4. Selecciona un elemento en el área de vista previa y ajusta su orden.
  5. Modifica el título, el valor predeterminado, la lista de opciones y otros datos en el área de propiedades.
  6. Tras comprobar la vista previa del formulario, haz clic en Guardar.

Después de guardar, vuelve a la interfaz principal y selecciona el script en la lista desplegable de scripts. Si la configuración es válida, aparecerá el botón Configuración junto a la lista. Haz clic en Configuración, completa los parámetros y ejecuta el script. Los scripts planos guardan la configuración en lua/scripts/main.json; los paquetes .xpp, en el main.json de la raíz del paquete.

Si no aparece el botón Configuración, normalmente se debe a que el script aún no está seleccionado, la configuración no se guardó correctamente o su contenido no es válido.

Abrir desde el editor de texto​

También puedes entrar en el editor de interfaz del script desde el árbol del proyecto al abrir un proyecto en el editor de texto:

  1. Busca main.json en el árbol del proyecto.
  2. Abre su menú contextual y selecciona Editar configuración de UI del script.
  3. Guarda y vuelve al editor de texto para editar el script o ejecutar las pruebas.

Este método resulta útil para editar el script y ajustar al mismo tiempo los parámetros que se deben completar antes de ejecutarlo.

Si el mismo script necesita parámetros diferentes para distintos grupos, puedes combinarlo con la función de configuración de scripts por grupo de Grupos de dispositivos.

Elegir los elementos del formulario​

  • Texto: muestra una descripción o un separador informativo y no requiere entrada del usuario.
  • Campo de entrada: permite introducir texto como cuentas, rutas, palabras clave o cantidades.
  • Interruptor: indica si una opción está activada o desactivada.
  • Lista desplegable: permite elegir una opción entre muchas.
  • Grupo de selección única: permite elegir una opción entre varias que se excluyen mutuamente.
  • Grupo de selección múltiple: permite marcar varias opciones a la vez.

Las listas desplegables y los grupos de selección única o múltiple requieren configurar sus opciones. Para definir la selección predeterminada, introduce los índices de las opciones según las indicaciones de la interfaz; si no estás seguro, deja vacío el valor predeterminado y abre el formulario desde el botón Configuración después de guardarlo para comprobar el resultado.