Saltar al contenido principal

Documentos

Los documentos en SDA proporcionan un repositorio flexible y versionado para cualquier tipo de archivo o material de referencia que desee asociar con los activos de la plataforma. Sirven como una ubicación centralizada para almacenar, organizar y controlar contenido, ya sea de naturaleza técnica, operativa o administrativa. Dado que los documentos pueden vincularse a gateways, dispositivos, proyectos, pipelines y otros recursos, ayudan a mantener el contexto completo de su entorno de automatización.

Descripción general​

Los documentos representan archivos de uso general que pueden cargarse, almacenarse, versionarse y referenciarse en toda la plataforma SDA. Admiten tanto formatos de documento tradicionales —como documentos de Word, presentaciones de PowerPoint y PDF— como archivos prácticos específicos de OT, tales como archivos de configuración, registros de cambios, notas de mantenimiento u otros artefactos que deban permanecer asociados a un dispositivo o proyecto a lo largo del tiempo.

Los documentos permiten a los equipos mantener una única fuente de verdad para materiales de referencia, especificaciones, procedimientos y archivos de apoyo, aprovechando al mismo tiempo el modelo de versionado, auditabilidad y permisos de SDA.

Casos de uso habituales​

Los documentos pueden dar soporte a una amplia variedad de flujos de trabajo industriales y operativos, entre ellos:

  • Información de equipos
    Almacene manuales, esquemas de cableado, especificaciones de accionamientos u hojas de datos directamente con un dispositivo.
  • Requisitos y especificaciones del sistema
    Mantenga especificaciones de ingeniería, hojas de requisitos o descripciones de control asociadas a un proyecto.
  • Registros de mantenimiento y servicio
    Cargue informes de inspección, registros de mantenimiento y documentos de servicio como parte del historial operativo de un dispositivo.
  • Procedimientos operativos
    Mantenga accesibles y bajo control de versiones los procedimientos operativos estándar, las notas de relevo de turno o las guías de resolución de problemas.
  • Archivos de configuración y de apoyo
    Adjunte archivos de configuración, scripts, conjuntos de parámetros o documentación que deban acompañar a un dispositivo, gateway o proyecto.

Capacidades clave​

1. Versionado​

Todos los documentos en SDA se versionan de forma predeterminada. Cada carga o modificación crea una nueva versión, lo que permite a los usuarios:

  • Seguir los cambios a lo largo del tiempo
  • Restaurar versiones anteriores
  • Comprender el historial del documento a medida que evolucionan los activos
  • Mantener la auditabilidad y la trazabilidad para el cumplimiento normativo

2. Vinculación en toda la plataforma​

Los documentos pueden asociarse a muchos tipos de objetos, entre ellos:

  • Gateways
  • Dispositivos
  • Proyectos
  • Pipelines
  • Grupos de recursos
  • Y otros más, a medida que se amplían las capacidades de la plataforma

Esta asociación a nivel de objeto garantiza que los documentos se mantengan contextualmente relevantes y sean fáciles de localizar.

3. Visores y herramientas de comparación​

Actualmente, SDA ofrece capacidades de visualización y comparación en el navegador para documentos basados en texto, incluidos archivos de configuración, scripts y documentación en texto plano.

Entre las capacidades admitidas se incluyen:

  • Visualización en línea
  • Vista de diferencias en paralelo
  • Comparación entre versiones
  • Resaltado de cambios

En próximas versiones se admitirán tipos de documento adicionales, incluidos formatos más completos como PDF, documentos de Office y formatos binarios.

4. Compatibilidad flexible con archivos​

Los documentos pueden incluir prácticamente cualquier tipo de archivo relevante para ingeniería, operaciones o cumplimiento normativo, incluidos, entre otros:

  • Word, Excel, PowerPoint
  • PDF
  • Archivos de texto y markdown
  • Archivos de configuración de dispositivos
  • Artefactos de configuración XML / JSON
  • Imágenes o diagramas
  • Otros archivos de apoyo diversos

Organización y gestión de documentos​

Cada documento almacenado en SDA incluye:

  • Nombre y descripción: para una identificación legible por personas
  • Tipo de archivo y metadatos: extensión, tamaño, número de versión
  • Objetos asociados: donde el documento está vinculado dentro de la plataforma
  • Historial de versiones: registro cronológico de todos los cambios
  • Permisos: aplicados mediante el modelo de control de acceso basado en roles de SDA

Los equipos pueden cargar nuevos documentos, reemplazar archivos existentes, revisar el historial de versiones y gestionar las asociaciones directamente desde la interfaz de SDA para dispositivos, gateways o proyectos.

Mejoras futuras​

El área funcional de Documentos se ampliará en próximas versiones para incluir:

  • Visores avanzados para formatos de Office
  • Capacidades de comparación de PDF
  • Previsualización mejorada para formatos binarios
  • Metadatos ampliados y etiquetado de documentos
  • Integraciones de flujos de trabajo (por ejemplo, aprobaciones, estados del ciclo de vida)