Ver el código de «Facilities»

<translate>
= Instalaciones = <!--T:9-->
Ésta es la sección donde se agrupan los controles a monitorizar para cada uno de los ''kiBox'' desplegados. Un ''kiBox'' corresponde a una instalación, y cada instalación está compuesta por uno o varios controles, los cuales son los que disponen de la sensórica y actuadores.
__TOC__
== Menú de instalaciones ==
Se puede acceder de dos formas: desde el menú lateral o desde el menú principal donde indica el número de instalaciones a las que se tiene acceso:
[[Archivo:GeneralView1.png|centro|miniaturadeimagen|643x643px]]
[[Archivo:GeneralView2.png|centro|miniaturadeimagen|643x643px]]

Independientemente de por donde se accede, se listará todas las instalaciones a las que se tiene acceso. Existen tres pestañas asociadas a las instalaciones:

<!--T:11-->
* '''Instalaciones'''
* '''Ubicación'''
* '''Grupos'''

=== Pestaña Instalaciones === <!--T:12-->
En esta pestaña se lista todas las instalaciones a las que el usuario tiene permisos de "''ver''".
[[Archivo:FacilitiesList.png|centro|miniaturadeimagen|800x800px]]

Un circulo rojo tachado sobre la instalación significa que dicha instalación está deshabilitada.

<!--T:13-->
En la columna de estado se muestra el estado actual de cada instalación:

<!--T:14-->
* '''Conectado''': Aparece el símbolo de "conectado" en verde; significa que dicha instalación está conectada al servidor y podemos interactuar con ella.
* '''Desconectado''': Aparece el símbolo de "desconectado" en rojo ; significa que dicha instalación no está conectada al servidor. Por alguna razón, el kiBox perteneciente a esa instalación no tiene acceso a internet y, por tanto, no puede conectarse al servidor. En ese caso, podremos obtener valores históricos almacenados por el servidor pero no datos en tiempo real.
* '''Activas #''': Con este símbolo en rojo se indica, mediante el número adjunto al texto, la cantidad de alarmas actualmente activas en esa instalación. Las alarmas pueden ser de conectividad o propias del dispositivo supervisado.


<!--T:15-->
En la esquina superior derecha de la pestaña se encuentran una serie de botones para poder interactuar con la lista de instalaciones y poder filtrar según sus estados:

<!--T:16-->
* '''Habilitadas/Deshabilitadas''': Mediante el botón del circulo tachado se puede alternar entre el filtrado de instalaciones habilitadas (color verde), instalaciones deshabilitadas (color rojo) y listar todas las instalaciones (color gris).
* '''Con alarmas/Sin alarmas''': Con el botón de la campana se puede modificar el filtrado de instalaciones con alarmas y sin alarmas, además podrás diferenciar entre alarmas graves (color rojo) y alarmas leves (color amarillo) en caso de no querer filtrar por alarmas el color será gris.
* '''Conectadas/Desconectadas''': Usando este botón con forma de enchufe se pueden aplicar los filtros: mostrar las instalaciones conectadas (color verde), mostrar las instalaciones desconectadas (color rojo) y mostrar todas las instalaciones (color gris). Este filtro se puede combinar junto con el de instalaciones habilitadas/deshabilitadas (por ejemplo: listar las instalaciones habilitadas y conectadas a la vez).
* '''Vista cuadrícula''': Éste botón permite el cambio de vista de lista a formato cuadrícula. Es posible alternar entre estos formatos pulsando de nuevo sobre el botón.
* '''Buscador''': Con el botón con forma de lupa se puede realizar un filtrado por instalaciones que contengan dicho nombre tanto en su campo "nombre", "descripción" como la búsqueda por "UUID".


Abriendo el menú de opciones sobre una instalación podemos observar las siguientes:
[[Archivo:FacilityOptions19.png|centro|miniaturadeimagen|800x800px]]


* '''Ver''': Ésta opción nos permite navegar al menú de la instalación, la cual se describe más abajo, en la '''sección [[Facilities#Instalación|instalación]]'''
* '''Editar''': Con esta opción navegamos hacia la ventana de edición y configuración de la instalación sección que se explica más adelante en '''[[Facilities#Editar y configurar la instalación|editar y configurar la instalación]]'''
*'''Duplicar''': Para no crear una instalación desde 0, tenemos la opción 'Duplicar', con la que podemos copiar una instalación completa con su configuración y elementos en otra nueva, para saber más puedes visitar la '''sección [[Facilities#Duplicar instalación|duplicar instalación]]'''.
* '''Añadir a favoritos''': Aquellas instalaciones que se hayan seleccionado como favoritas aparecerán al principio de la lista, facilitando su búsqueda.
*'''Quitar de favoritos''': Cuando pulsemos este botón sobre aquellas instalaciones que estén marcadas como favoritas, estas dejarán de serlo, provocando así que no aparezcan al principio de la lista de instalaciones.

Pulsando sobre alguna de las instalaciones pasamos directamente al menú de la instalación, la cual se describe más abajo, en la '''sección [[Facilities#Instalación|instalación]]'''.

=== Pestaña Ubicación === <!--T:18-->
En esta pestaña se presenta la ubicación de cada una de las instalaciones en un mapa. Se puede navegar en el mapa utilizando el ratón o mediante el deslizamiento de un dedo en los móviles. También es posible ampliar o alejar la imagen a través del scroll del ratón o utilizando los botones "'''+'''" y "'''-'''" que aparecen arriba a la izquierda en el mapa.
[[Archivo:FacilitiesListLocation.png|centro|miniaturadeimagen|800x800px]]

En este mapa se presentan las instalaciones que están conectadas en color verde y aquellas que no tienen conexión en color rojo. Si en alguna instalación existe una alarma activa, esto se indicará en este mapa mediante un circulo rojo que parpadea justo debajo de la instalación con alarma.

<!--T:19-->
En este mapa también es posible filtrar las instalaciones según las pulsaciones que se realicen sobre el botón "enchufe" a la izquierda del mapa:
*Enchufe '''gris''': se muestran todas las instalaciones. Es decir, no se aplica ningún filtrado sobre las instalaciones.
*Enchufe '''rojo''': se muestran sólo las instalaciones que están desconectadas.
*Enchufe '''verde''': se muestran sólo las instalaciones que están conectadas.
Haciendo clic sobre el enchufe repetidamente se van alternando los diferentes filtros.

=== Pestaña Grupos === <!--T:20-->
En la pestaña GRUPOS se pueden crear grupos de instalaciones para su mejor gestión, clasificación y acceso rápido. Cada grupo dispone de un '''indicador de alarma''' el cual se activará si alguna de las instalaciones incluidas en este grupo tiene una o varias alarmas activas.
[[Archivo:FacilitiesListGroup2.png|centro|miniaturadeimagen|800x800px]]

<!--T:21-->
Para crear un grupo de instalaciones se debe pulsar sobre el botón "'''+'''" que aparece arriba a la derecha. Acto seguido, se abrirá una ventana donde se puede configurar el grupo a crear.
[[Archivo:NewGroup.png|centro|miniaturadeimagen|800x800px]]

Para crear un grupo es necesario asignarle un nombre. También se puede incluir, opcionalmente, una descripción del grupo la cual será visible justo bajo el nombre. 

<!--T:22-->
El siguiente paso es seleccionar las instalaciones que van a formar parte de dicho grupo.

<!--T:23-->
Por último, se puede asignar una imagen para identificar, más rápida y claramente, al grupo. Una vez terminado el proceso de configuración se debe pulsar el botón "guardar".

== Instalación == <!--T:24-->

<!--T:25-->
Una vez que se ha pulsado para acceder a una instalación concreta, aparece la pantalla con las principales herramientas de la instalación.
[[Archivo:7.png|centro|miniaturadeimagen|800x800px]]



<!--T:26-->
Arriba a la izquierda aparece el nombre de la instalación, su descripción y la zona horaria donde se ha ubicado la instalación (por ejemplo, la instalación de la imagen está ubicada en GMT+1).

<!--T:27-->
Arriba a la izquierda puede aparecer el número de alarmas activas en la instalación así como el número de alarmas silenciadas.

<!--T:28-->
También arriba a la derecha aparecerá un icono de un lápiz para poder editar y configurar dicha instalación. Este icono sólo le aparecerá a los usuarios que tengan permisos de ver y [[Facilities#Editar y configurar instalación|editar]] sobre dicha instalación.

<!--T:29-->
Entre la parte superior y la parte inferior con las diferentes secciones existe una línea que podrá aparecer en verde o en rojo según si la instalación está conectada o no.

<!--T:30-->
Finalmente, la parte inferior incluye iconos para acceder a las siguientes secciones de cada instalación:

<!--T:31-->
* [[Facilities#Listado controles|'''Controles''']]: Acceso directo al listado de los controles pertenecientes a dicha instalación.
* [[Facilities#Alarmas|'''Alarmas''']]: En esta sección se puede comprobar todas las alarmas activas en la instalación así como el histórico de éstas.
* [[Facilities#Actividad|'''Actividad''']]: Sección para comprobar todas las acciones realizadas sobre dicha instalación por parte de los usuarios con acceso a la instalación.
* [[Facilities#Gráficas|'''Gráficas''']]: Acceso directo a las gráficas rápidas creadas para dicha instalación.
* [[Facilities#Diagramas|'''Diagramas''']]: Acceso a los diagramas (SCADA) creados para dicha instalación.
* [[Facilities#Informes|'''Informes''']]: Sección para la exportación y creación de informes sobre funcionamiento de los diferentes controles de la instalación.
* [[Facilities#Reglas|'''Reglas''']]: Sección para poder crear y configurar reglas lógicas para tomar acciones en caso de que se cumplan ciertos eventos y/o condiciones.
* [[Facilities#Documentación|'''Documentación''']]: Acceso rápido a un repositorio para almacenar y consultar todo tipo de documentos asociados a dicha instalación.
* [[Facilities#Notificaciones|'''Notificaciones''']]: Sección para configurar las notificaciones de alarmas mediante emails o envío de SMS a los usuarios configurados. 
* [[Facilities#Información|'''Información''']]: Información sobre el funcionamiento y estado actual de la instalación. Principalmente información sobre el dispositivo kiBox que se encuentra tras dicha instalación.
* [[Facilities#Localización|'''Localización''']]: Información acerca de la ubicación en tiempo real del kibox y la ruta que sigue a lo largo del tiempo. Solo estará disponible en aquellos kibox con el hardware específico necesário. 


<!--T:32-->
Este menú de las diferentes herramientas, también aparece siempre arriba una vez se ha accedido a alguna de ellas.
[[Archivo:8.png|centro|miniaturadeimagen|800x800px]]



<!--T:33-->
Si usted no puede ver una de estas pestañas, se debe a que su [https://{{SERVERNAME}}/index.php/Special:MyLanguage/plans suscripción] no incluye el acceso a dicha herramienta.

=== Predicción meteorológico y actual === <!--T:34-->
Para aquellas instalaciones que previamente han sido ubicadas en el mapa, el sistema identificará su situación y podrá vincular la instalación con la predicción meteorológica para esa zona. De esta manera, arriba en el centro de la pantalla aparecerá un icono con la temperatura actual de esa zona así como el estado climático actual. Si se pincha sobre el icono del tiempo aparecerá una ventana emergente con el pronostico de la semana.
[[Archivo:9.png|centro|miniaturadeimagen|800x800px]]

En esta pantalla se puede seleccionar las unidades para mostrar la temperatura, pudiendo cambiar entre grados centrigrados y fahrenheits.

== Editar y configurar la instalación == <!--T:35-->
Se puede acceder a la edición de la instalación desde 2 sitios:
[[Archivo:FacilityEdit.png|centro|miniaturadeimagen|800x800px]]
[[Archivo:11.png|centro|miniaturadeimagen|800x800px]]


La ventana de configuración de la instalación tiene las siguientes pestañas:
=== Pestaña GENERAL === <!--T:37-->
Desde aquí se configura el '''nombre''' y '''descripción''' de la instalación. También se puede '''habilitar''' o '''deshabilitar''', cambiar los segundos que tarda en reintentar una '''reconexión automática''' y establecer una '''imagen''' para hacerla más visual en la lista de instalaciones. 
[[Archivo:12.png|centro|miniaturadeimagen|800x800px]] 

Una instalación que se deshabilita no recibe comunicaciones desde la plataforma, por lo que no muestra información actualizada de los controles que tenga conectados.

=== Pestaña UBICACIÓN === <!--T:38-->
La ubicación permite geolocalizar la instalación manualmente mediante datos de latitud y longitud  o a través de GPS. Esta configuración es de gran importancia, ya que la plataforma usa esta información para ubicar a la instalación en una zona horaria. Dicha zona horaria es usada para la visualización de históricos de datos en una gráfica o para las notificaciones de alarma, por lo que si no se configura, toda la información se muestra con la hora del Meridiano de Greenwich (GMT+0).

<!--T:39-->
En caso de que se trate de una ubicación establecida manualmente, no estará sincronizada y actualizada de forma automática a través del kiBox. El formato en el que se introducen los datos de latitud y longitud debe ser con coma decimal, como los extraídos desde Google Maps. En la siguiente imagen se muestra un ejemplo:
[[Archivo:FacilityLocation13.png|centro|miniaturadeimagen|800x800px]]


Para que la ubicación pueda ser establecida a través del sistema GPS, el kibox debe de tener el hardware específico necesario para ello. Si se intenta configurar y el equipo no tiene el hardware específico aparecerá un aviso concreto para la situación. En caso de querer tener está funcionalidad contactar con ventas.

=== Pestaña ACCIONES === <!--T:40-->
Desde esta ventana, es posible realizar una de estas acciones sobre el kibox:

<!--T:64-->
* '''Enviar''': reenvía al kibox la configuración actual de la instalación: configuración de puertos, protocolos, lista de controles y librerías que usan, etc.
* '''Reiniciar''': reiniciar el software que usa el kibox para enviar datos a myKiconex.
* '''Restaurar''': detiene el software del kibox, borra la información de configuración de la instalación y vuelve a poner en marcha el software.
[[Archivo:FacilityActions14.png|centro|miniaturadeimagen|800x800px]]

=== Pestaña HARDWARE === <!--T:41-->
Esta pestaña es de las más importantes en la configuración de la instalación, ya que es donde se especifica qué puertos RS485 del kiBox se usan y bajo que configuración Modbus: velocidad, bits de parada, paridad, etc.

<!--T:42-->
Las configuraciones posibles para cada puerto son:

<!--T:43-->
* '''Función''':
** '''Deshabilitado''': puerto sin uso
** '''Modbus RTU - Maestro''': puerto con un uso estándar para monitorizar controles bajo protocolo Modbus RTU
** '''Modbus RTU - Puente''': puerto usado para servir información a otro sistema de supervisión externo a kiconex. Un puerto configurado de esta forma hace que el kiBox actúe como un esclavo Modbus RTU, sirviendo la información de todos los controles que tenga conectados en aquellos puertos configurados en modo MAESTRO.
* '''Velocidad (bps)''': Velocidad de la comunicación Modbus en bps. Se admite 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600 y 115200.
* '''Bits de datos''': bits de datos de la transmisión. Debe conincidir con la configuración que tengan los controles conectados. Puede tener el valor 7 o el 8
* '''Paridad''': los bits de paridad permiten al control receptor de la trama determinar si el mensaje recibido está corrupto. Este dato también debe establecerse coincidiendo con el valor que tenga configurado el control. Las posibilidades son: ''ninguna'', ''impar'' y ''par''.
* '''Bits de parada''': el valor puede ser 1 ó 2. Dicho valor, al igual que los parámetros anteriores, debe establecerse acorde a la configuración de los controles que se conectarán al bus. 
[[Archivo:Instalacion-hardware.png|centro|miniaturadeimagen|800x800px|Configuración de un puerto RS485 del kiBox, para funcionar en modo maestro con una velocidad de 9600bps, 8 bits de datos, sin paridad y con 1 bit de parada.]]


 <!--T:44-->
''<u>Información</u>: para conocer como deben establecerse los parámetros de configuración del puerto, desde kiconex recomendamos revisar los manuales de funcionamiento de los controles que se conectarán al kiBox, en la sección donde se describe la comunicación Modbus''.

=== Pestaña PERMISOS === <!--T:45-->
La sección de permisos permite dar acceso a otro usuario existente en la plataforma mykiconex. Las posibilidades son:

<!--T:46-->
* '''Ver''': para ver el elemento instalación, pero no su contenido: controles conectados, gráficas, diagramas, etc.. Todos esos elementos llevan sus propios permisos.
* '''Editar''': permite acceder al menú de configuración de la instalación para modificar nombre, descripción y configuración de puertos.
* '''Crear''': da la posibilidad de crear nuevos elementos dentro de la instalación: controles, gráficas, diagramas, reglas, etc.
* '''Eliminar''': como su nombre indica, daría la posibilidad al usuario de eliminar la instalación por completo.

<!--T:47-->
El usuario se añade desde el botón con el símbolo '''+''', ubicado en la parte superior derecha, como se muestra en la siguiente imagen:
[[Archivo:Permisos-instalacion.png|centro|miniaturadeimagen|800x800px|Ejemplo de adición de un usuario con los permisos de '''ver''', '''editar''' y '''crear''' en la instalación]]

== Secciones de la instalación == <!--T:48-->

=== Listado controles === <!--T:49-->
El listado de controles es la sección donde se resumen los diferentes controles (dispositivos) que están conectados a una instalación (''kiBox''). Esta sección se detalla en profundidad en la sección de [[Controls|controles]].

=== Alarmas === <!--T:50-->
En la sección de alarmas se puede comprobar las alarmas activas de la instalación, así como el histórico de alarmas. La explicación detallada de cada una de las alarmas y la información que podemos obtener de ellas se puede encontrar el la sección de [[Alarms|alarmas]].

=== Actividad === <!--T:51-->
Cualquier acción llevada acabo sobre un elemento de una instalación, como puede ser: cambio de consigna, envío de comando, cambio configuración control...etc, queda registrada en la sección de "actividad".
[[Archivo:FacilityActivity.png|centro|miniaturadeimagen|800x800px]]

De esta forma, se puede llevar un control de qué acción se han realizado sobre los elementos de la instalación y quién es el que la ha llevado a cabo. Esto resulta muy importante ya que el acceso a una instalación puede estar habilitado para un gran número de usuarios. Todo depende de la configuración y los niveles de permisos asignados. Aunque los permisos se pueden asignar por grupo de usuarios, siempre se recomienda utilizar un usuario nominativo para una persona y nunca compartir usuarios entre varias personas. De esta forma es más fácil identificar el usuario que ha llevado a cabo una acción en concreto.

<!--T:52-->
Si se pasa el ratón por encima del texto que indica el registro del evento, nos indicará la fecha y hora exacta en la que se produjo dicho evento.

=== Gráficas === <!--T:53-->
Las gráficas es una de las herramientas más útiles para poder estudiar el comportamiento de los equipos y evaluar su correcto funcionamiento. Las gráficas se explican en detalle en la sección [[Graphics|gráficas de datos]]

=== Diagramas === <!--T:54-->
Diagramas es un módulo para poder crear sinópticos de las instalaciones. Es decir, se puede crear una imagen con símbolos y variables dinámicas para, de un sólo vistazo, poder conocer y controlar el estado de la instalación. En otras palabras se puede crear SCADAS fácilmente dentro de este módulo. El módulo se explica en detalle en la sección [[Diagrams|diagramas]]

=== Informes === <!--T:55-->
La plataforma ''myKiconex'' permite generar una serie de informes variados para poder facilitar el estudio del comportamiento de controles e instalaciones. Estos informes, y como generarlos, se explica en detalle en la sección [[Reports| informes]]

=== Reglas === <!--T:56-->
El módulo de reglas permite realizar programaciones del tipo IF..THEN...Es decir, programaciones donde cuando se cumplen unas condiciones (IF) se realizan unas acciones (THEN). Todo ello puedo estar gestionado bajo un programador horario donde se indica las fechas y horas cuando se deben de evaluar dichas programaciones. Todo este módulo esta detalladamente explicado en la sección [[Rules|reglas]]

=== Documentación === <!--T:57-->
La plataforma ''myKiconex'' permite alojar documentos en la nube. De esta forma, se puede disponer de documentación relacionada con los controles y/o instalaciones desde cualquier lugar. En la sección [[Documentation|documentos]] se explica como utilizar este módulo.

=== Notificaciones === <!--T:58-->
El módulo de notificaciones permite informar a los usuarios sobre eventos de alarmas o desconexión de elementos. Las notificaciones podrán ser vía email o SMS, según el plan contratado. En la sección [[Notifications|notificaciones]] se detalla como configurar correctamente dichas notificaciones.

=== Información === <!--T:59-->
En esta sección obtenemos información sobre el ''kiBox'' utilizado como pasarela en esta instalación.

=== Localización === <!--T:60-->
La sección de localización es un módulo que nos permite ubicar en tiempo real la instalación, está sincronizada y actualizada de forma automática a través del ''kiBox''.
[[Archivo:18.png|centro|miniaturadeimagen|800x800px]]

Esta sección tiene la opción de ver la ruta a lo largo del tiempo que realiza el ''kiBox''.

Para poder utilizar esta funcionalidad es necesario hardware especial dedicado y en el caso de que se quiera utilizar contactar con el equipo de ventas.

=== Permisos === <!--T:61-->
En cada uno de los objetos y/o elementos de la instalación existe la configuración de permisos, para que un usuario y/o grupo tenga permisos sobre una gráfica, diagrama, regla o informe debe tenerlos configurados.
[[Archivo:SP - Permisos generales.png|centro|miniaturadeimagen|800x800px|Permisos generales]]
Al crear algún elemento los permisos se heredan de la instalación, en el caso de los controles hay que seleccionar (en caso de ser necesario) ejecutar comandos, cambiar ajustes o cambiar configuración en cambio en los demás elementos tienen sólo las opciones de Ver, Editar, Eliminar y Crear.
[[Archivo:Control16.png|centro|miniaturadeimagen|800x800px]]

Con ellos se mantiene la gestión de la instalación correctamente indicando los permisos correspondientes según necesidad de la instalación o según niveles de usuarios.

<!--T:61-->
# Ver: Permite la visualización sobre el objeto.
# Editar: Permite la edición del objeto.
# Eliminar: Permite eliminar el objeto, siempre que tenga el permiso de eliminar sobre los permisos de la instalación.
# Crear: Permite crear el objeto o en él, siempre que tenga el permiso de crear sobre los permisos de la instalación.
# Ejecutar comandos: Permite ejecutar comandos sobre el control.
# Cambiar ajustes: Permite cambiar ajustes sobre el control.
# Cambiar configuración: Permite cambiar la configuración sobre el control.


<!--T:62-->
En los controles se pueden separar los permisos según si se requiere permisos en todos los controles o no, también existe la opción de propagar estos permisos seleccionando los permisos en un control y extendiéndolos a los demás para que queden así unificados según necesidad.
[[Archivo:Spread.png|centro|miniaturadeimagen|800x800px]]

== Duplicar instalación ==  <!--T:63-->
La opción '''Duplicar instalación''' permite replicar una instalación existente, incluyendo toda su configuración y sus elementos internos (como controles, gráficas y diagramas). Esta funcionalidad es útil cuando se desea crear una nueva instalación con las mismas características que otra, evitando tener que hacer la configuración desde cero.
[[Archivo:FacilityDuplicate.png|centro|miniaturadeimagen|800x800px]]


Debemos de seguir una serie de pasos muy sencillos para '''Duplicar una instalación''':

[[Archivo:FacilityDuplicateUUID.png|centro|miniaturadeimagen|464x464px]]
Nos pedirá el UUID de la nueva instalación, este debe de ser el UUID que identificará a la nueva instalación del resto. Es importante que este bien escrito y con el formato correcto de lo contrario aparecerá un error que te impedirá seguir.

Además durante el proceso de validación se comprobará si la cantidad de elementos que contiene la instalación pueden ser duplicados en la nueva, esto es debido a la diferencias de recursos en función del plan contratado. En caso de no ser posible la duplicación debido a esto aparecerá un error  concreto explicando el motivo.
[[Archivo:FacilityDuplicateEdit.png|centro|miniaturadeimagen|800x800px]]

Una vez haya comprobado el UUID, aparecerá una ventana de edición de la nueva instalación, teniendo esta la configuración de la original instalación, en ella podemos modificar tanto como necesitemos la instalación.

Por último le damos a guardar, y al terminar el proceso tendremos nuestra instalación duplicada.



<!--T:64-->
__FORZAR_TDC__
</translate>