🖥️ Sincronizar variables
Objetivo Principal: Revisar todas las señales que la instalación está publicando, elegir cuáles interesan y darlas de alta en la plataforma, sin tener que crearlas una a una.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
Se llega desde el listado de Variables, con el botón "Sincronizar" de la cabecera: abre la ventana "Sincronizar Variables" sobre el listado. El botón solo se muestra a los perfiles con permisos de edición.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Título "Sincronizar Variables" | Cabecera de ventana | — | Encabeza la ventana. A su derecha, el aspa cierra la ventana y descarta la selección hecha. |
| Resumen "Total", "Assets", "Importadas" y "Actuadores" | Indicadores informativos | — | Primera fila de la ventana, en cuatro etiquetas. "Total" es el número de señales que la instalación ofrece con los filtros aplicados; "Assets" cuántos equipos distintos las publican; "Importadas" cuántas de ellas ya están dadas de alta en la plataforma; y "Actuadores" cuántas admiten escritura. |
| Aviso de resultado de la importación | Mensaje de estado | — | Banda que aparece tras importar. En verde, con el título "Importacion completada"; en rojo, "Importacion completada con errores". Debajo, el desglose "X creadas, Y actualizadas, Z omitidas" y, si los hubo, el número de errores. Las omitidas son las que ya estaban dadas de alta y no se han tocado. |
| Aviso de error | Mensaje de estado | — | Texto en rojo con el motivo que devuelve la plataforma cuando no consigue leer el catálogo de señales o cuando falla la importación. |
| Buscador "Buscar por nombre, variable, asset o ID..." | Campo de búsqueda | Filtrar el listado | Filtra por el nombre visible de la señal, por su nombre técnico, por el equipo que la publica o por su identificador. Espera un momento a que dejes de escribir antes de recargar el listado. |
| Filtro "Todas las categorias" | Filtro desplegable | Filtrar por categoría | Ofrece solo las categorías presentes en el catálogo de la instalación, no la lista completa de la plataforma. |
| Filtro "Todos los tipos" | Filtro desplegable | Filtrar por tipo de dato | Limita el listado a un tipo de dato concreto de los que la instalación esté publicando. |
| Filtro "Todos los assets" | Filtro desplegable | Filtrar por equipo | Deja a la vista solo las señales de un equipo. Es la vía rápida cuando se incorpora un equipo nuevo y no interesa el resto. |
| Casilla "Solo actuadores" | Casilla de verificación | Filtrar por capacidad de escritura | Muestra únicamente las señales que admiten recibir órdenes. |
| Casilla "Ocultar importadas" | Casilla de verificación | Filtrar lo ya incorporado | Deja fuera las señales que ya están dadas de alta, para ver de un vistazo qué queda por incorporar. |
| Botones "Expandir todo" y "Contraer todo" | Botones de acción | Desplegar o plegar los grupos | Abren o cierran de golpe todos los grupos de equipo del listado. "Expandir todo" se deshabilita si no hay nada que mostrar y "Contraer todo" si no hay ningún grupo abierto. |
| Casilla de la cabecera de la tabla | Casilla de verificación | Seleccionar la página | Marca o desmarca todas las señales de la página actual, estén sus grupos desplegados o no. |
| Cabeceras de la tabla | Cabecera de tabla | — | Las columnas son "Nombre", "Tipo dato", "Unidad", "Categoria", "Tipo punto" y "Estado". Se quedan fijas al desplazar el listado. |
| Fila de grupo por equipo | Fila desplegable | Desplegar el equipo | Cada equipo abre un grupo con su identificador, una etiqueta con el tipo de equipo y el recuento "N variables, M importadas". Al pulsar sobre la fila se despliegan o se pliegan sus señales; la casilla del grupo selecciona todas las señales de ese equipo en la página, y se muestra a medias cuando solo hay algunas marcadas. |
| Fila de señal | Fila de datos | Seleccionar la señal | Una por señal disponible, con su casilla a la izquierda. Las que ya están dadas de alta se muestran atenuadas, pero siguen pudiendo marcarse. |
| Distintivo "ACT" | Indicador informativo | — | Aparece en la columna "Tipo punto" de las señales que admiten escritura, es decir, las que después podrán recibir consignas. |
| Distintivo de la columna "Estado" | Indicador de estado | — | "Nueva" cuando la señal todavía no está en la plataforma. Si ya lo está, en su lugar se muestra en verde el estado que tiene ahí la variable. |
| Mensajes de listado vacío | Mensaje de estado | — | Mientras carga se lee "Cargando variables disponibles...". Si los filtros no dejan nada, "No se encontraron variables con los filtros actuales". Si la instalación no ofrece ninguna señal, "No se encontraron variables en el catalogo del adaptador". |
| Paginación "Anterior" / "Siguiente" | Controles de paginación | Cambiar de página | Aparecen solo cuando hay más de una página. Entre ambos botones se indica "Pagina N de M". El listado se sirve de cien en cien. |
| Aviso "La seleccion persiste entre paginas." | Mensaje de estado | Limpiar la selección | Aparece cuando hay señales marcadas y más de una página, para recordar que lo marcado en otras páginas sigue contando. Incluye el enlace "Limpiar seleccion", que desmarca todo. |
| Contador de selección | Indicador informativo | — | Pie de la ventana, a la izquierda. Indica "Ninguna seleccionada" o cuántas hay marcadas y, entre paréntesis, cuántas de ellas ya estaban dadas de alta y por tanto se van a re-sincronizar. |
| Botón "Cancelar" | Botón secundario | Cerrar la ventana | Cierra sin importar nada. Queda deshabilitado mientras una importación está en curso. |
| Botón "Importar" | CTA Principal | Incorporar las señales marcadas | Lleva entre paréntesis el número de señales seleccionadas y permanece deshabilitado mientras no haya ninguna. Si entre las marcadas hay alguna ya dada de alta, el botón pasa a llamarse "Importar/Actualizar" y la operación también refresca los datos de esas. Al terminar, la selección se vacía, el listado se recarga y el resultado se muestra en el aviso de la parte superior. |
💡 Guía de Uso
Esta ventana es el camino normal para dar de alta variables que ya existen en la planta: la plataforma pregunta a la instalación qué señales está publicando y las presenta agrupadas por equipo, marcando cuáles ya están incorporadas y cuáles no. Las variables internas de la plataforma no se crean aquí, sino con el botón "Nueva" descrito en Crear variable global.
Quién puede usarla. El botón "Sincronizar" solo aparece para los perfiles con permisos de edición, y la incorporación de señales está reservada a los perfiles Administrador y Admin Global. Con el perfil Mantenimiento la ventana llega a abrirse, pero el listado no carga y en su lugar se muestra un aviso de error.
Cómo trabajar con el listado. Conviene empezar reduciendo el ruido: marca "Ocultar importadas" para ver solo lo que falta, y usa el filtro de equipo o el buscador para centrarte en la parte de la instalación que estás dando de alta. Los grupos vienen plegados; despliega el equipo que te interese o pulsa "Expandir todo". Puedes marcar señales sueltas, un equipo entero con la casilla de su fila de grupo, o la página completa con la casilla de la cabecera. Si hay varias páginas, lo marcado en cada una se conserva: el contador del pie siempre dice cuántas llevas.
Qué mirar antes de importar. La columna "Estado" distingue lo nuevo de lo ya incorporado, y el distintivo "ACT" señala las señales que admiten escritura, que son las que después podrán recibir consignas desde SCADA o automatizaciones. Si entre lo marcado hay señales ya dadas de alta, el botón cambia a "Importar/Actualizar": sus datos se refrescan con lo que dice ahora la instalación. Las variables que alguien haya editado y guardado desde su ficha quedan protegidas —la plataforma no las sobrescribe y las cuenta como omitidas—, así que una re-sincronización no deshace el trabajo de nombrado y clasificación ya hecho. Cuando solo quieras añadir lo nuevo, desmárcalas o filtra con "Ocultar importadas".
Después de importar. El aviso de la parte superior resume cuántas variables se han creado, cuántas se han actualizado y cuántas se han omitido, y avisa si alguna dio error. Las variables recién incorporadas aparecen en el listado de Variables con estado "Descubierta": todavía hay que activarlas —con la barra de acciones en bloque— y completar su nombre visible, su unidad y sus límites desde la ficha de la variable para que se entiendan bien en dashboards e informes.