Ver el código de «Controls: Crear y editar un control»

{{DISPLAYTITLE:Crear y editar un control}}

= Crear y editar un control =
Esta página explica cómo crear, editar o duplicar un '''control''' dentro de una [[Facilities|instalación]] de Cloud kiconex.

Un control representa un equipo, máquina o sistema supervisado. Su configuración define cómo se identifica, cómo se comunica y qué opciones estarán disponibles para el usuario.

__TOC__

== Antes de comenzar ==
Antes de crear o editar un control, compruebe que dispone de:

* Acceso a la instalación correspondiente.
* Permisos para crear o editar controles.
* Información técnica del equipo que se va a configurar.
* Datos de comunicación necesarios para el protocolo utilizado.
* Librería o configuración necesaria para el tipo de control.

Si el control pertenece a una organización gestionada por keyusers, consulte también la guía avanzada [[keyuser:Control|Crear y editar un control para gestores de organización]].

== Crear un control ==
Para crear un control nuevo:

# Acceda a la [[Facilities|instalación]] correspondiente.
# Entre en la sección '''Controles'''.
# Haga clic en el icono '''+'''.
# Complete la configuración del control.
# Guarde los cambios.

[[Archivo:Crear instalación.png|alt=Crear un control desde el listado|centro|miniaturadeimagen|800x800px|Creación de un nuevo control desde el listado de controles.]]

<!-- Pendiente de revisión visual: comprobar si esta captura debe sustituirse por una captura específica de creación de control. -->

== Editar un control existente ==
Puede editar un control desde varios puntos de la interfaz:

* Desde los tres puntos situados a la derecha del control en el listado.
* Desde el menú contextual al hacer clic derecho sobre el control.
* Desde la vista del control, mediante el icono de edición cuando esté disponible.

Para editar un control:

# Localice el control.
# Abra el menú de acciones.
# Seleccione '''Editar'''.
# Modifique los apartados necesarios.
# Guarde los cambios.

Las opciones disponibles dependen de los permisos del usuario.

== Duplicar un control ==
La opción '''Duplicar''' permite crear un control nuevo a partir de otro ya configurado.

Esta opción es útil cuando hay dos equipos iguales o muy similares y se desea reutilizar una configuración existente.

Después de duplicar un control, revise:

* Nombre y descripción.
* Protocolo y datos de comunicación.
* Estado habilitado o deshabilitado.
* Variables visibles.
* Variable principal.
* Vista simple.
* Permisos.

No deje operativo un control duplicado sin revisar su configuración específica.

== Pestaña General ==
La pestaña '''General''' permite configurar la información básica del control.

Puede incluir:

* Nombre del control.
* Descripción del control.
* Traducciones disponibles según los idiomas configurados.
* Imagen identificativa.
* Estado habilitado o deshabilitado.

[[Archivo:Nueva instalación.png|alt=Pantalla general de creación o edición de un control|centro|miniaturadeimagen|800x800px|Pestaña general de creación o edición de un control.]]

<!-- Pendiente de revisión visual: comprobar si la captura "Nueva instalación.png" debe renombrarse o sustituirse por una captura específica de control. -->

Use nombres descriptivos. Un nombre claro facilita la búsqueda del control y reduce errores al ejecutar comandos o modificar parámetros.

== Pestaña Protocolo ==
La pestaña '''Protocolo''' permite configurar cómo se comunica el control con el Box kiconex de la instalación.

Al crear un control nuevo, la plataforma puede solicitar la selección del protocolo disponible para el Box kiconex adquirido o configurado en la instalación.

La configuración puede incluir datos como:

* Protocolo de comunicación.
* Puerto.
* Dirección del equipo.
* Otros parámetros específicos del protocolo.

[[Archivo:Protocolo nueva.png|alt=Configuración de protocolo de un control|centro|miniaturadeimagen|800x800px|Pestaña de protocolo de un control.]]

Revise cuidadosamente esta configuración. Un error en el protocolo, puerto o dirección puede impedir que el control comunique correctamente.

== Pestaña Acciones ==
La pestaña '''Acciones''' agrupa operaciones técnicas sobre el control.

Puede incluir:

* '''Recargar''': fuerza una resincronización entre Cloud kiconex y el Box kiconex.
* '''Reinicializar desde librería''': vuelve a cargar la información de la librería sobre el control.
* '''Test Modbus''': abre una herramienta para realizar pruebas de comunicación Modbus sobre el control.

[[Archivo:Acciones.png|alt=Acciones técnicas disponibles en un control|centro|miniaturadeimagen|800x800px|Pestaña de acciones técnicas de un control.]]

'''Advertencia:''' la opción '''Reinicializar desde librería''' puede borrar configuraciones aplicadas sobre el control, como visibilidad de variables, intervalos de muestreo o ajustes de vista. Utilice esta opción solo cuando sea necesario y después de revisar el impacto.

Para más detalle, consulte [[Controls: Acciones técnicas del control|Acciones técnicas del control]].

== Pestaña Acceso API ==
La configuración de acceso API se documenta en una página específica.

Consulte [[API KEY CONFIGURATION|Configurar la clave API de Cloud kiconex en Core]].

No duplique claves API en capturas de pantalla, documentación, correos ni tickets de soporte. Una clave API debe tratarse como una credencial privada.

== Pestaña Permisos ==
La pestaña '''Permisos''' permite definir qué usuarios o grupos pueden ver, editar o actuar sobre el control.

Los permisos del control pueden afectar a:

* Visualización del control.
* Edición.
* Eliminación.
* Ejecución de comandos.
* Modificación de consignas.
* Modificación de parámetros o configuración.

Para más detalle, consulte [[Controls: Permisos de controles|Permisos de controles]] y [[Permissions|Permisos]].

== Después de guardar ==
Después de guardar un control, revise:

* Que aparece en el [[Controls: Listado de controles|listado de controles]].
* Que el estado de conexión es el esperado.
* Que la configuración de protocolo es correcta.
* Que la [[Controls: Vista de un control|vista del control]] muestra las variables esperadas.
* Que los permisos permiten el acceso solo a los usuarios adecuados.

== Enlaces relacionados ==
* [[Controls|Controles]]
* [[Controls: Listado de controles|Listado de controles]]
* [[Controls: Vista de un control|Vista de un control]]
* [[Controls: Permisos de controles|Permisos de controles]]
* [[Controls: Acciones técnicas del control|Acciones técnicas del control]]
* [[Controls: Configuración de la vista|Configuración de la vista de un control]]
* [[API KEY CONFIGURATION|Configurar la clave API de Cloud kiconex en Core]]
* [[keyuser:Control|Crear y editar un control para gestores de organización]]