Aller au contenu principal

Documents

Les documents dans SDA constituent un référentiel flexible et versionné pour tout type de fichier ou de support de référence que vous souhaitez associer à des actifs sur l'ensemble de la plateforme. Ils offrent un emplacement centralisé pour stocker, organiser et suivre les contenus, qu'ils soient de nature technique, opérationnelle ou administrative. Comme les documents peuvent être liés à des passerelles, des appareils, des projets, des pipelines et d'autres ressources, ils permettent de conserver le contexte complet de votre environnement d'automatisation.

Vue d'ensemble​

Les documents représentent des fichiers à usage général qui peuvent être téléversés, stockés, versionnés et référencés dans l'ensemble de la plateforme SDA. Ils prennent en charge aussi bien les formats documentaires traditionnels — tels que les documents Word, les présentations PowerPoint et les PDF — que les fichiers pratiques spécifiques à l'OT, comme les fichiers de configuration, les journaux de modifications, les notes de maintenance ou d'autres artefacts devant rester associés à un appareil ou à un projet dans la durée.

Les documents permettent aux équipes de maintenir une source de vérité unifiée pour les supports de référence, les spécifications, les procédures et les fichiers annexes, tout en tirant parti du modèle de versionnement, d'auditabilité et de permissions de SDA.

Cas d'usage courants​

Les documents peuvent prendre en charge un large éventail de flux de travail industriels et opérationnels, notamment :

  • Informations sur les équipements
    Stockez les manuels, schémas de câblage, spécifications de motoréducteurs ou fiches techniques directement avec un appareil.
  • Exigences et spécifications système
    Conservez les spécifications d'ingénierie, les fiches d'exigences ou les descriptifs de commande associés à un projet.
  • Registres de maintenance et d'intervention
    Téléversez les rapports d'inspection, les journaux de maintenance et les documents d'intervention dans le cadre de l'historique opérationnel d'un appareil.
  • Procédures opérationnelles
    Gardez les procédures d'exploitation standard, les notes de passation de poste ou les guides de dépannage accessibles et soumis au contrôle de version.
  • Fichiers de configuration et fichiers annexes
    Joignez les fichiers de configuration, scripts, jeux de paramètres ou documentations qui doivent suivre un appareil, une passerelle ou un projet.

Fonctionnalités clés​

1. Versionnement​

Tous les documents dans SDA sont versionnés par défaut. Chaque téléversement ou modification crée une nouvelle version, ce qui permet aux utilisateurs de :

  • Suivre les modifications dans le temps
  • Restaurer les versions précédentes
  • Comprendre l'historique d'un document à mesure que les actifs évoluent
  • Maintenir l'auditabilité et la traçabilité à des fins de conformité

2. Association dans toute la plateforme​

Les documents peuvent être associés à de nombreux types d'objets, notamment :

  • Passerelles
  • Appareils
  • Projets
  • Pipelines
  • Groupes de ressources
  • Et d'autres encore, à mesure que les capacités de la plateforme s'étendent

Cette association au niveau des objets garantit que les documents restent pertinents dans leur contexte et faciles à localiser.

3. Visionneuses et outils de comparaison​

SDA propose actuellement des capacités de consultation et de comparaison dans le navigateur pour les documents au format texte, y compris les fichiers de configuration, les scripts et la documentation en texte brut.

Les capacités prises en charge incluent :

  • Affichage en ligne
  • Vue de différences côte à côte
  • Comparaison de version à version
  • Mise en évidence des modifications

D'autres types de documents — y compris des formats plus riches tels que les PDF, les documents Office et les formats binaires — seront pris en charge dans les prochaines versions.

4. Prise en charge flexible des fichiers​

Les documents peuvent inclure pratiquement tout type de fichier pertinent pour l'ingénierie, l'exploitation ou la conformité, notamment mais sans s'y limiter :

  • Word, Excel, PowerPoint
  • PDF
  • Fichiers texte et markdown
  • Fichiers de configuration d'appareils
  • Artefacts de configuration XML / JSON
  • Images ou schémas
  • Divers fichiers annexes

Organisation et gestion des documents​

Chaque document stocké dans SDA comprend :

  • Nom et description – pour une identification lisible par l'humain
  • Type de fichier et métadonnées – extension, taille, numéro de version
  • Objets associés – emplacements où le document est lié au sein de la plateforme
  • Historique des versions – enregistrement chronologique de toutes les modifications
  • Permissions – appliquées via le modèle de contrôle d'accès basé sur les rôles de SDA

Les équipes peuvent téléverser de nouveaux documents, remplacer des fichiers existants, consulter l'historique des versions et gérer les associations directement depuis l'interface SDA pour les appareils, les passerelles ou les projets.

Évolutions à venir​

Le domaine fonctionnel Documents s'enrichira dans les prochaines versions pour inclure :

  • Des visionneuses riches pour les formats Office
  • Des capacités de comparaison de PDF
  • Un aperçu amélioré pour les formats binaires
  • Des métadonnées étendues et le marquage des documents
  • Des intégrations de flux de travail (p. ex. approbations, états du cycle de vie)