Referencias del Sistema (Parámetros Clave-Valor)

Descripción, Propósito y Objetivo

NOTE

La vista de Referencias del Sistema es la consola administrativa encargada de consultar, registrar, editar y eliminar referencias globales del sistema (URLs o referencias a base de datos) empleadas en la configuración general.

Una Referencia del Sistema consta de los siguientes atributos clave:

• Clave*: Identificador único sin espacios (ej. API_TIMEOUT, STORAGE_LIMIT).
• Tipo de referencia: Modalidad de parametrización:
  • URL: Habilita el campo Valor o URL* para ingresar la dirección web.
  • Referencia BD: Habilita el campo Ruta del Documento* (debe ingresarse con el formato colección/ID).

El objetivo de esta vista es permitir la actualización dinámica de URLs de servicios externos y punteros de base de datos sin necesidad de realizar despliegues de código.

---

Contexto de Uso

Este módulo es administrado por el equipo de arquitectura e infraestructura para:

• Ajustar configuraciones dinámicas: Modificar endpoints de servicios externos e integraciones.
• Vincular referencias de base de datos: Almacenar rutas de documentos con la sintaxis colección/ID.

---

Acciones Posibles

1. Consultar y Filtrar Referencias

1. Utiliza la barra de búsqueda (Buscar) para localizar claves o valores específicos en tiempo real.
2. Haz clic sobre los encabezados de columna (Clave (Key) o Valor) para cambiar la ordenación de la lista de forma ascendente o descendente.

2. Crear una Nueva Referencia

1. haga clic en el botón Agregar Referencia ubicado en la esquina superior derecha.

2. En el panel lateral que se despliega, completa los campos requeridos:
   • Clave* (ingrese el identificador único sin espacios).
   • Tipo de referencia: seleccione la opción correspondiente:
     • URL: Habilita el campo Valor o URL* para ingresar el enlace.
     • Referencia BD: Habilita el campo Ruta del Documento* (debe ingresar con el formato colección/ID).

3. haga clic en el botón Guardar para registrar la referencia. El formulario cambiará dinámicamente el campo de entrada según el tipo seleccionado.

3. Editar una Referencia Existente

1. En la fila de la referencia deseada dentro de la tabla principal, ubica la columna Acciones y haga clic en **lápiz (Editar).

2. Se desplegará el panel Editar Referencia; modifica la clave, cambia la modalidad (URL / BD) o actualiza la ruta y guarda los cambios mediante el botón "Actualizar".

4. Eliminar una Referencia

1. En la columna Acciones de la fila correspondiente, haga clic en **caneca de basura (Borrar).

2. El sistema desplegará un cuadro de confirmación directa.

---

Roles y Permisos Requeridos

El acceso a estos parámetros globales del sistema está restringido al rol de Administrador General o Soporte de Plataforma. Requiere los siguientes permisos:

• Parámetros Geográficos y UI: country_read, state_read, languages_read y menus_read.
• Entidades y Licenciamiento: memberships_read, system_products_read y config_refs_read.
• Trazabilidad: tags_read y incident_tracking_read (para seguimiento de incidencias).
• Acciones de Escritura: Permisos con sufijo _create y _update correspondientes para modificar las tablas del sistema.