Saltar al contenido principal
Version: Next (5.0)

Módulo DevTools

Este módulo incluye algunas herramientas de gestión muy útiles para administrar los recursos del servidor:

Para usar este módulo, sigue estos pasos:

  • Añade las dependencias awe tools al descriptor pom.xml.
<dependencies>
...
  <dependency>
    <groupId>com.almis.awe</groupId>
    <artifactId>awe-tools-spring-boot-starter</artifactId>
  </dependency>
...
</dependencies>
  • Configura el valor de la propiedad para añadir awe-tools a la lista de módulos.
awe.application.module-list = APP, ..., awe-tools, ..., awe

Extractor SQL​

El Extractor SQL es una herramienta para ejecutar consultas SQL directamente sobre la base de datos de la aplicación

SQL Extractor
  • Añade las pantallas del módulo tools en tu archivo private.xml:
<option name="sql-extractor" label="MENU_SQL_EXTRACTOR" screen="sqlExtractor" icon="database"/>

Ejecutar consultas SQL con la base de datos en uso.​

"El Extractor SQL solo puede ejecutar consultas. Si quieres insertar, actualizar o eliminar, contacta con el equipo de AWE"

Guardar cadenas de consulta en archivos.​

Elige el nombre del archivo sin extensión. El Extractor SQL lo guardará en .txt por ti. Solo podemos guardar una consulta por archivo. Este archivo se creará automáticamente en tu directorio personal. "c:/users/{user}/aweFiles/"

save_query

Cargar cadenas de consulta desde un archivo para relanzarlas.​

Carga archivos desde tu directorio personal "c:/users/{user}/aweFiles/"

load_query

MODO LECTURA Y MODO ESCRITURA​

Por defecto, la pantalla sqlExtractor está en modo "Read", por lo que solo puedes ejecutar sentencias "select". Hay un parámetro oculto en la pantalla llamado "sqlType" que tiene por defecto "R", de "Read Mode" (modo lectura).

<criteria id="sqlType" component="hidden" value="R" />

Para permitir que algunos usuarios o perfiles ejecuten sentencias que modifiquen la base de datos (insert, delete, drop, update) debes cambiar el valor del parámetro oculto "sqlType" a "W" (modo escritura) para la pantalla sqlExtractor en la opción de configuración de pantallas.

tip

Si quieres cambiar la funcionalidad debes sobrescribir el servicio de la siguiente manera:

  <service id="selectExtract">
    <java classname="com.almis.{project}.services.controller.SqlExtractorController" method="extractData" >
      <service-parameter name="select"   type="STRING"/>
    </java>
  </service>

Y añadir tus propios SqlExtractorController.java y SqlExtractorManager.java que sobrescriban los métodos de AWE.

Ejemplo:​

Deben empezar con select(1)

select(1) INSERT INTO x (columns,...) VALUES (y,...)

Gestor de archivos​

Con el gestor de archivos puedes mover, copiar, renombrar, eliminar, comprimir, descomprimir, descargar y subir archivos...

filemanager

Para usar esta herramienta, sigue estos pasos (tras añadir la dependencia):

  • Añade las pantallas del módulo tools en tu archivo private.xml:
<option name="file-manager" label="MENU_TEST_FILEMANAGER" screen="filemanager-test" icon="folder"/>
  • Crea una nueva pantalla con el widget awe-file-manager como filemanager.xml
<screen template="full" label="MENU_TEST_FILEMANAGER"
        xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
        xsi:noNamespaceSchemaLocation='../../sch/awe/screen.xsd'>
  <tag source="center">
      <widget type="awe-file-manager" id="file-manager" style="expand"/>
  </tag>
</screen>
  • Añade esta pantalla como nueva opción de menú con tu propio locale y la opción file-manager
    <option name="filemanager-test" label="MENU_TEST_FILEMANAGER" screen="filemanager-test" icon="folder" />
    <option name="file-manager" screen="file-manager" invisible="true"/>