Pular para o conteúdo principal

Documentos

Os documentos no SDA fornecem um repositório flexível e versionado para qualquer tipo de ficheiro ou material de referência que pretenda associar a ativos em toda a plataforma. Servem como um local centralizado para armazenar, organizar e acompanhar conteúdos — quer esse conteúdo seja de natureza técnica, operacional ou administrativa. Uma vez que os documentos podem ser ligados a gateways, dispositivos, projetos, pipelines e outros recursos, ajudam a manter o contexto completo do seu ambiente de automação.

Visão geral​

Os documentos representam ficheiros de uso geral que podem ser carregados, armazenados, versionados e referenciados em toda a Plataforma SDA. Suportam tanto formatos de documento tradicionais — como documentos Word, apresentações PowerPoint e PDFs — como ficheiros específicos de OT de caráter prático, tais como ficheiros de configuração, registos de alterações, notas de manutenção ou outros artefactos que devem permanecer associados a um dispositivo ou projeto ao longo do tempo.

Os documentos permitem que as equipas mantenham uma fonte de verdade unificada para materiais de referência, especificações, procedimentos e ficheiros de apoio, tirando ao mesmo tempo partido do versionamento, da auditabilidade e do modelo de permissões do SDA.

Casos de utilização comuns​

Os documentos podem apoiar uma vasta gama de fluxos de trabalho industriais e operacionais, incluindo:

  • Informação sobre equipamentos
    Armazene manuais, esquemas de cablagem, especificações de acionamentos ou fichas técnicas diretamente junto de um dispositivo.
  • Requisitos e especificações de sistema
    Mantenha especificações de engenharia, folhas de requisitos ou descrições de controlo associadas a um projeto.
  • Registos de manutenção e assistência
    Carregue relatórios de inspeção, registos de manutenção e documentos de assistência como parte do histórico operacional de um dispositivo.
  • Procedimentos operacionais
    Mantenha procedimentos operacionais padrão, notas de passagem de turno ou guias de resolução de problemas acessíveis e sob controlo de versões.
  • Ficheiros de configuração e de apoio
    Anexe ficheiros de configuração, scripts, conjuntos de parâmetros ou documentação que devam acompanhar um dispositivo, gateway ou projeto.

Principais capacidades​

1. Versionamento​

Todos os documentos no SDA são versionados por predefinição. Cada carregamento ou modificação cria uma nova versão, permitindo aos utilizadores:

  • Acompanhar alterações ao longo do tempo
  • Restaurar versões anteriores
  • Compreender o histórico do documento à medida que os ativos evoluem
  • Manter a auditabilidade e a rastreabilidade para efeitos de conformidade

2. Ligação em toda a plataforma​

Os documentos podem ser associados a muitos tipos de objetos, incluindo:

  • Gateways
  • Dispositivos
  • Projetos
  • Pipelines
  • Grupos de recursos
  • E mais, à medida que as capacidades da plataforma se expandem

Esta associação ao nível do objeto assegura que os documentos permanecem contextualmente relevantes e fáceis de localizar.

3. Visualizadores e ferramentas de comparação​

O SDA disponibiliza atualmente capacidades de visualização e comparação no browser para documentos baseados em texto, incluindo ficheiros de configuração, scripts e documentação em texto simples.

As capacidades suportadas incluem:

  • Apresentação inline
  • Vista de diferenças lado a lado
  • Comparação entre versões
  • Realce de alterações

Tipos de documento adicionais — incluindo formatos mais ricos, como PDFs, documentos Office e formatos binários — serão suportados em versões futuras.

4. Suporte flexível de ficheiros​

Os documentos podem incluir praticamente qualquer tipo de ficheiro relevante para engenharia, operações ou conformidade, incluindo, entre outros:

  • Word, Excel, PowerPoint
  • PDFs
  • Ficheiros de texto e markdown
  • Ficheiros de configuração de dispositivos
  • Artefactos de configuração XML / JSON
  • Imagens ou diagramas
  • Diversos ficheiros de apoio

Organização e gestão de documentos​

Cada documento armazenado no SDA inclui:

  • Nome e descrição – para identificação legível por humanos
  • Tipo de ficheiro e metadados – extensão, tamanho, número de versão
  • Objetos associados – onde o documento está ligado dentro da plataforma
  • Histórico de versões – registo cronológico de todas as alterações
  • Permissões – aplicadas através do modelo de controlo de acesso baseado em funções do SDA

As equipas podem carregar novos documentos, substituir ficheiros existentes, consultar o histórico de versões e gerir associações diretamente a partir da interface do SDA para dispositivos, gateways ou projetos.

Melhorias futuras​

A área funcional de Documentos será expandida em versões futuras para incluir:

  • Visualizadores avançados para formatos Office
  • Capacidades de comparação de PDFs
  • Pré-visualização melhorada para formatos binários
  • Metadados alargados e etiquetagem de documentos
  • Integrações de fluxos de trabalho (por exemplo, aprovações, estados do ciclo de vida)