

Documentación del módulo de Revisiones Internas

Introducción

El módulo de revisiones internas nos permite llevar un control de ítems a revisar para todos los modelos que queramos que estén dentro del ERP. Es un sistema parecido a los reconocimientos de la normativa 328/2001, pero en este caso las revisiones no son solo para líneas de alta tensión y centros transformadores, sino que podemos hacer revisiones a cualquier modelo

Se tienen que definir qué modelos queremos revisar y configurar las normativas para que en cada modelo nos aplique los ítems que queremos revisar

Conceptos

Para entender el funcionamiento del módulo de revisiones, se deben tener claros algunos conceptos.

Normativas

Las normativas nos permitiran configurar qué ítems queremos revisar. Las normativas permiten definir a que modelo y dentro de este añadir una restricción para que se cumplan unas características específicas. Estas restricciones se definen con un lenguaje propio del ERP llamado dominios del qual hablaremos más adelante.

Valoraciones

Nos permiten definir el nivel de gravedad en el que se encuentra el ítem que se está revisando en caso de que no esté correcto. Las valoraciones están estructuradas por un texto descriptivo de la valoración y una configuración del tiempo límite de reparación de los ítems que tengan asignada esta valoración

Modelos

Los modelos son los objetos del ERP que queremos revisar, por ejemplo las Líneas de Alta, Pólizas, CUPS, Transformadores, Centros Transformadores, Contadores, Números de serie, Productos, etc.

Revisiones

Las revisiones son los modelos concretos que se han de revisar.

Configuración

Configuración de un modelo

Primero se debe configurar qué modelo queremos revisar, introduciendo un modelo después seremos capaces de configurar una normativa para este modelo y hacerle una revisión.

Esto lo podremos hacer mediante el Menú principal > Revisiones internas > Configuración > Modelos

Para crear un nuevo modelo simplemente haremos click en Nuevo como hacemos en el resto de formularios del ERP.

En el formulario tenemos los siguientes campos:

Modelo: Utilizando este campo seleccionaremos qué modelo es el que queremos configurar.
Activo: Nos servirá para marcar si un modelo está o no activo para realizar una revisión. Es útil por si alguna vez hemos configurado un modelo y desde un determinado momento no queremos seguir utilizándolo, lo podemos desactivar y ya no aparecerá más en el listado. Siempre se debe desactivar y nunca eliminar
Nombre del objeto: Es el nombre descriptivo para este modelo dentro del ERP.
Objeto: Es el nombre interno de este objeto.
Dominio: Es una expresión que nos permitirá aplicar un filtro a los registros que forman parte de este modelo.
SQL: Es un campo que nos mostrará el dominio transformado en SQL por si queremos probar si los resultados son los esperados.
Nombre para menú: Se utilizará este valor para escribir el nombre al menú, en el caso que esté en blanco, se utilizará el nombre del objeto.
Menú: El menú que se creará para acceder a las revisiones de este modelo.
Acción: La acción que ejecutará el menú para visualizar las revisiones de este modelo.

También hay el botón:

Crear Menú: Nos servirá para crear el menú para poder acceder exclusivamente a las revisiones de este modelo y para crear revisiones de este modelo. Por defecto crea el menú a "Menu > Revisiones Internas > Revisiones > Revisiones de XXXXXX" donde XXXXXX es el texto del campo Nombre del menú y en el caso que este este en blanco utilizará el valor de Nombre del objeto. Si cuando pulsamos el menú ya existe, lo elimina y lo vuelve a crear, esto significa que si hemos movido el menú nos lo volverá a dejar en el menú por defecto.

Para definir el modelo, primero debemos escoger que modelo de ERP queremos, esto lo podremos hacer con el campo Modelo utilizando la lupa de la derecha. Una vez se hace la búsqueda podemos filtrar por distintos campos, como por ejemplo, con el nombre del modelo como se ve en la captura siguiente:

O también por el nombre interno si lo sabemos a través del campo Objeto como se ve en la siguiente captura:

Una vez lo hayamos escogido ya podemos guardar el registro y automáticamente se nos rellenarán el resto de campos a excepción de el Menú y de la Acción. Seguidamente podemos pulsar el botón de Crear Menú y ya nos habrá creado el menú para este modelo.

Refrescando el menú principal, podemos ver cómo nos ha creado el submenú para las revisiones del model que hemos configurado.

Configuración de una Normativa

Una vez tengamos el modelo configurado, pasamos a configurar normativas para este modelo.

Podemos configurar y ver las normativas a través de "Menú > Revisiones Internas > Configuración > Normativas"

Para crear una normativa nueva, debemos pulsar el botón de Nuevo igual que el resto de formulario del ERP.

En el formulario tenemos distintos campos que se explican a continuación:

Pestaña General

Normativa: Nombre y descripción de la normativa.
Modelo: Indica a qué modelo de los que hemos configurado hace referencia. Siempre se debe tener configurado el modelo antes de configurar una normativa.
Activa: Informa de si la normativa está activa o no. Siempre se debe desactivas y nunca eliminar, ya que podemos perder histórico de datos.
Fecha inicio: Fecha en la que se puede aplicar esta normativa.
Fecha final: Fecha en la que se termina la vigencia de esta normativa.
Dominio del model: Es la expresión base que hemos definido en el model. La normativa siempre utilizará la suma del dominio del modelo más su dominio propio.
Dominio: Es una expresión que nos permitirá aplicar esta normativa a un conjunto específico de registros del modelo que cumplan las características que defniremos en el dominio.
SQL: Es un campo que nos mostrará el dominio transformado en SQL por si nos interesa probar si los resultados son los esperados.

Nota

Las fechas se utilizan a la hora de asignar los ítems a revisar y se hace según la fecha de la revisión.

Las normativas están pensadas para que sean reaprofitables y se pueden> crear normativas concretas y normativas más generales.

En el siguiente ejemplo solo aplicaremos la normativa a los transformadores que la marca sea JARA, para ello debemos establecer el dominio.

    [       
        ('id_marca.name', '=', 'JARA')
    ]

Después cuando guardemos podremos ver el SQL que nos genera, que puede ser distinto para cada base de datos.

   SELECT giscedata_transformador_trafo.*
   FROM giscedata_transformador_trafo
   WHERE (giscedata_transformador_trafo.id_marca in (5))

Nota

Antes de crear ítems a revisar se debe haber guardado la normativa.

Pestaña Ítems a revisar

En esta pestaña encontraremos el listado de los ítems que se deben revisar para esta normativa.

Para añadir un ítem a revisar, debemos apretar el botón de nuevo que se encuentran en el listado de ítems.

En el formulario para la creación de ítems tenemos los siguientes compos:

Código: Un código que identificará este ítem dentro de una revisión.
Tipo de campo: En el caso que este ítem no sea válido dentro de una revisión, qué entrada de datos deberá hacer la persona que la esté haciendo.
- Boleano: Sólo identificará si es incorrecto
- Numérico: Cuando el ítem sea incorrecto deberá introducir un valor numérico.
- Texto: Cuando el ítem sea incorrecto deberá introducir un texto.
Normativa: La normativa a la que pertenece este ítem.
Activo: Si el ítem esta o no activo. Si lo desmarcamos de activo a las siguientes revisiones no se asignará este ítem a la revisión.
Orden: Orden de este ítem dentro de la revisión, sirve para organizar los ítems dentro de una revisión si los queremos revisar en un cierto orden.
Descripción: Texto informativo del ítem.

Y en la siguiente imagen podemos ver el listado de todos los ítems a revisar

Configuración de las valoraciones

Las valoraciones las podemos encontrar a través de "Menú > Revisiones Internas > Configuración > Valoraciones"

Para crear una valoración nueva, debemos pulsar el botón de Nuevo igual que el resto de formulario del ERP.

En el formulario tenemos distintos campos que se explican a continuación:

Valoración: Texto informativo de la valoración
Activo: Esta valoración está activa o no.
Tiempo: Quantidad de tiempo que puede pasar, dependerá del valor que definimos en el campo Unidad.
Unidad: Tipo de intervalo de tiempo que habrá para reparar el ítem de la revisión que esté marcado como a incorrecto y tenga esta valoración.
- Día
- Mes
- Año

También disponemos del listado de todas las valoraciones que tenemos configuradas.

Creación de una revisión para un model ya configurado

Para crear una revisión para un modelo configurado lo podemos hacer utilizando Menú > Revisiones Internas > Revisiones de XXXXXX donde XXXXXX es el nombre del modelo que queremos revisar.

Nota

El menú "Menú > Revisiones Internas > Revisiones" muestra todas las revisiones definidas sin filtrar el modelo.

Para crear una revisión nueva, debemos pulsar el botón de Nuevo igual que el resto de formulario del ERP.

En el formulario de una revisión se pueden diferenciar diferentes partes.

Una parte general para identificar la revisión donde están los campos:

A revisar: Nos permite seleccionar para qué registro queremos crear la revisión. Si venimos del menú específico sólo nos dejará escoger este tipo de modelo, pero si venimos del menú general de Revisiones en esta lista podremos seleccionar todos los modelos que tenemos configurados. Primero de todo se debe seleccionar el modelo (parte izquierda) y después seleccionar el registro a través de la lupa (parte derecha)

Pestaña General

Técnico: Persona propia de la empresa que hará la revisión.
Empresa: Empresa que llevará a cabo la revisión, puede ser la propia o una externa (p.ex. subcontractación)
Fecha programada: Fecha y hora en que esta previsto realizar esta revisión. Esta se utiliza más adelante para planificar futuras revisiones.
Fecha real: Fecha y hora real en la que se realiza la revisión. Sólo se puede escribir en este campo cuando la revisión está en estado Abierta
Estatdo: Estado de la revisión. Sirve para diferenciar unas revisiones de las otras y saber en que estado se encuentran.
- Borrador: Se está preparando la revisión, pero aun no hay ningún valor que sea permanente y se pueden producir cambios.
- Asignada: Cuando se pasa en este estado se comprueban las normativas que afectan a este registro y se le asignan los items a revisar. En estos momentos la revisión se dará por preparada y queda pendiente que el técnico y/o empresa encargados de la revisión empiecen.
- Abierta: La persona que hace la revisión ha empezado a revisar y está trabajando. En estos momentos los ítems a revisar se pueden modificar para decir si un ítem es incorrecto o no y que valoración tiene.
- Cerrada: La revisión se da por finalizada.
Núm. defectos reparados: Un indicador del tipo X/Y dónde se muestra de todos los ítems que hay marcados como incorrectos (Y), cuántos hay de reparados (X).

Pestaña Observaciones

Observaciones: Campo de texto para escribir las observaciones de la revisión.

Pestaña Planificación

Periodicidad quantidad: Número en tiempo que depende del campo Periodicidad tipo.
Periodicidad tipo: TTipo de tiempo a aplicar para planificar la siguiente revisión.

Nota

El campo Núm. defectos reparados sólo muestra información válida cuando el estado de la revisión es Cerrada.

Las revisiones se deben dejar en estado Asignado.

Diagrama de flujo de una revisión

Estado

Persona

Tarea

Borrador

Administrador

Se está preparando la revisión, configurando el modelo, la fecha de planificación, el técnico y la empresa que realizará la revisión.

Asignada

Administrador

Ya se ha preparado la revisión. En el momento de pasarla a asignada se asignaran todos los items de las normativas vinculadas al modelo y que el registro cumpla con el dominio de las normativas. En este momento, la revisión ya esta a punto para que la persona que la lleva lo haga.

Abierta

Cerrada

Técnico/Empresa

La persona responsable de hacer la revisión empieza.

La persona que ha hecho la revisión ha finalizado la tarea.

Comprobación de ítems

Pasar el estado de la revisión a Abierta.
Asignar la Fecha real en que se lleva a cabo la revisión.
Comprobar todos los ítems que tenemos para revisar, haciendo doble click de uno en uno en los ítems y modificando los valores del formulario.
Pasar el estado de la revisión a Cerrada.

Modificación de los ítems a revisar

En el formulario de un ítem a revisar encontramos los siguientes campos:

Código: Es el mismo código que se ha configurado para la normativa.
Normativa: Normativa a la que pertenece este ítem a revisar.
Descripción: Descripción del ítem a revisar que se ha configurado en la normativa.
Estado: En que estado se encuentra este ítem.

No comprovado: Aún no se ha comprovado este ítem de la revisión.
Correcto: El ítem está correcto. Se deberá introducir la fecha de comprovación y según el tipo de entrada que se haya configurado para este ítem en la normativa, deberemos introducir un valor en forma de texto o numérico.
Incorrecto: El ítem está incorrecto. Se deberá introducir la fecha de comprovación, una valoración y según el tipo de entrada que se haya configurado para este ítem en la normativa, deberemos introducir un valor en forma de texto o numérico.
No aplicable: Este defecto no aplica. Sólo se deberá entrar la fecha de comprobación

Observaciones: Texto opcional con información extra.
Fecha de comprovación: Fecha en que se realiza la comprovación.
Valoración: En caso que el ítem esté marcado como Incorrecto se deberá asignar una valoración de las que se han configurado. Esta valoración tendrá efecto a la fecha límite de reparación de este ítem.
Valor: En caso que el ítem este configurado como que se debe entrar un valor numérico nos aparecerá este campo.
Datos: En el caso que el ítem esté configurado como a que se debe entrar un texto nos aparecerá este campo.
Fecha límite reparación: Campo calculado segun la valoración que se haya introducido y la fecha de comprobación del ítem. En el momento de guardar la revisión se actualiza este campo.
Reparado: Un campo para indicar si este ítem ha sido reparado.
Fecha de reparación: En el caso de que haya estado reparado, en qué fecha se reparado.
Observaciones reparación: Texto con datos extra de la reparación.

Planificación de revisiones futuras

Para crear revisiones futuras para el mismo registro se puede hacer de forma masiva (modo lista) o de un registro en concreto (modo formulario)

Masiva

Nos ponemos en el listado de revisiones que queremos actuar, puede ser en el de revisiones general o el específico por un modelo y aplicamos los filtros que se crean oportunos para listar que revisiones queremos planificar en el futuro.

Nota

Si tenemos más de 80 registros, se debe ampliar el límite para poder actuar con todo el listado a través del icono y después cambiar el límite al valor necesario .

Hacemos click en el botón Acción de la barra superior.

Se mostrará el asistente para planificar las nuevas revisiones, mostrando la siguiente pantalla.

Al pulsar el botón Continuar lo que hará el asistente és, para todas las revisiones que teníamos en el listado, si tienen configurada la planificación sumará a la fecha planificada la cantidad configurada a la pestaña de Planificación y creará una revisión nueva planificada para esta fecha.

Al finalizar, abrirá una pestaña con todas las nuevas planificaciones creadas.

Hace falta tener en cuenta que, por defecto, no hay periodicidad, de forma que no se generará ninguna revisión planificada.

En caso de existir una revisión planificada, tampoco se creará una de nueva.

Concreta

A la vista del formulario de una revisión, al margen derecho podemos ejecutar el asistente de planificaciones futuras.

Nota

Si no nos crea la planificación es porque ya hay una revisión planificada con fecha posterior a la que queremos planificar

Configuración de dominios

Los dominios que se creen a partir de una lsita de tuplas de tres elementos, Donde el prmier elemento es el campo del modelo, el segundo elemento es el operador y el tercer elemento es el valor con el que queremos comparar.

Por ejemplo queremos buscar transformadores que no tienen número de série:

    [('numero_fabricacio', '=', False)]

Los operadores que tenemos son los siguientes:

=: igual al tercer elemento.
!=: diferente al tercer elemento.
in: dentro de la lista del tercer elemento.
not in: no está dentro de la lista del tercer elemento.
like: TIene alguna coincidencia con el tercer elemento (teniendo en cuenta las mayúsculas) el carácter comodín es el %. Ej %jo% coincidiría con josé, ajo, jornada, ...
ilike: El mismo que el anterior pero sin tener en cuenta las mayúsculas.
not like: Ninguna incidencia.
>: Más grande que el tercer elemento.
>=: Más grande o igual.
<: Más pequeño.
<=: Más pequeño o igual.

Se puede usar más de una condición a la vez

   [('numero_fabricacio', '=', False), ('pes_total', '>', 200)]

Este dominio devuelve los que numero_fabricacio és NULL y el pes_total más grande que 200. Por defecto cuando se pone más de una tupla se deben cumplir todas las condiciones, si no es así hay otros operadores:

& (AND): Operador por defecto, hace que se cumplan las condiciones entre dos ANDs.
| (OR): Una condición o otra.
! (NOT): Niega toda una condición.

Se usa notación polonesa https://es.wikipedia.org/wiki/Notaci%C3%B3n_polaca

Un ejemplo con OR si quisiéramos los que pesan 100 o 200 seria:

   ['|', ('pes_total', '=', 100), ('pes_total', '=', 200)]