Librerías


Índice:

   Librería: Informar en archivo html (scr_web.sh)

      Etiquetas de las sección de cabecera

      Líneas de información

      Mensajes tipo

      Cómo usar la librería



Librería: Informar en archivo html (scr_web.sh)  ⮴  

Esta librería proporciona la herramientas para informar en un archivo html de:


Para ello en la sección de cabecera del archivo html se definen tres etiquetas


Y en la sección cuerpo se incorporan las líneas en las que se mostrará la in-

formación. Estas líneas tiene una estructura similar a:


    <span id="id_prbs_info_1" class="color_verde"> 🗸 2026-02-10 14:44:03</span>


Etiquetas de las sección de cabecera  ⮴  

En la sección cabecera hay tres etiquetas que son usadas por la librería:


  1. <meta num_tasks="..."> : Número de tareas/script que están funcionando y

    presentando la información en el archivo html.


  2. <meta date_tasks="...">: Contiene la fecha/hora en la que modificó por

    última vez la etiqueta num_tasks


  3. <meta http-equiv="refresh" content="...">: Contiene el número de segun-

    dos que será el intervalo de actualización de la página web. Se emplea

    un valor de 10 cuando num_task es mayor de 0 (hay tareas en curso) y un

    valor de 360000 cuando num_task es 0 (no hay tareas en curso).


Líneas de información  ⮴  

      <span id="..." class="...">...</span>


La información se de los script,s se presenta enmarcadas por una etiqueta

span que tiene dos atributos. Los atributos de la etiqueta span son:



Por último está el texto, que podrá se el que se desee.


Mensajes tipo  ⮴  

La librería implementa los siguientes mensajes tipo:


  1. _web_ini_task: Muestra un mensaje que informa que la tarea se está

    ejecutando, e incrementa el número de tareas (num_task) en curso en 1.


  2. _web_fin_task_ok: Muestra un mensaje que informa que la tarea ha fina-

    lizado con la fecha/hora. Decrementa el número de tareas (num_task) en

    la unidad.


  3. _web_fin_task_error: Muestra un mensaje que informa que la tarea ha

    finalizado con error y la fecha/hora. Decrementa el número de tareas

    (num_task) en la unidad.


  4. _web_fin_task_aviso: Muestra un mensaje que informa que la tarea ha

    finalizado con mensaje(s) de aviso y la fecha/hora. Decrementa el

    número de tareas (num_task) en la unidad.


Cómo usar la librería  ⮴  

  1. Cargar la librería e inicializarla con _web_init


              _inc_source "$K_CFG_SCRIPTS_PATH_SOURCE/src_web.sh"

              _web_init "$HOME/Documentos/personalpage/main.html" "id_bckp_imp"


    En _web_init los parámetros son:

    1. Nombre completo del archivo html donde se mostrará la información.

    2. Id que identifica la línea que contiene la información que se tratará.


  2. Al iniciar la tarea incluir la línea para que se informe que se ha ini-

    ciado la tarea. Se compruebca con [[ $__WEB_LIB_LOADED = 1 ]] si la

    librería está cargada y pueden ser usadas sus funciones.

              [[ $__WEB_LIB_LOADED = 1 ]] && _web_ini_task


  3. En la salida (_trap_exit()) incluir:


              # Si se está informando en la página web, informar de la finalización

              if [[ $__WEB_LIB_LOADED = 1 ]]; then

                if [[ $_LOG_COUNT_ERROR -gt 0 ]]; then

                  _web_fin_task_error

                elif [[ $_LOG_COUNT_AVISO -gt 0 ]]; then

                  _web_fin_task_aviso

                else

                  _web_fin_task_ok

                fi

               fi


    Los contadores de error y aviso se gestionan en la librería de log.