メインコンテンツまでスキップ

Documents

SDA の Documents は、プラットフォーム全体のアセットに関連付けたいあらゆる種類のファイルや参照資料を保存するための、柔軟でバージョン管理されたリポジトリを提供します。技術的、運用的、管理的な内容を問わず、コンテンツを保存・整理・追跡するための一元的な場所として機能します。Documents はゲートウェイ、デバイス、プロジェクト、パイプラインおよびその他のリソースにリンクできるため、自動化環境の完全なコンテキストを維持するのに役立ちます。

概要​

Documents は、SDA プラットフォーム全体でアップロード、保存、バージョン管理、参照が可能な汎用ファイルを表します。Word ドキュメント、PowerPoint プレゼンテーション、PDF といった従来の文書形式に加え、構成ファイル、変更履歴、メンテナンス記録など、デバイスやプロジェクトに長期にわたって付随させる必要がある実用的な OT 固有のファイルにも対応します。

Documents により、チームは参照資料、仕様書、手順書、補助ファイルについて統一された信頼できる情報源を維持しながら、SDA のバージョン管理、監査性、権限モデルを活用できます。

一般的なユースケース​

Documents は、以下を含む幅広い産業・運用ワークフローをサポートします。

  • 設備情報
    マニュアル、配線図、ドライブ仕様書、データシートをデバイスに直接保存します。
  • システム要件と仕様
    プロジェクトに関連するエンジニアリング仕様、要件シート、制御仕様書を管理します。
  • メンテナンスおよびサービス記録
    点検報告書、メンテナンスログ、サービス文書をデバイスの運用履歴の一部としてアップロードします。
  • 運用手順
    標準作業手順書、シフト引継ぎメモ、トラブルシューティングガイドにアクセス可能な状態でバージョン管理を行います。
  • 構成ファイルおよび補助ファイル
    デバイス、ゲートウェイ、プロジェクトに付随させる必要がある構成ファイル、スクリプト、パラメータセット、ドキュメントを添付します。

主な機能​

1. バージョン管理​

SDA 内のすべてのドキュメントは、デフォルトでバージョン管理されます。アップロードまたは変更ごとに新しいバージョンが作成され、ユーザーは以下を行えます。

  • 経時的な変更の追跡
  • 以前のバージョンの復元
  • アセットの変化に伴うドキュメント履歴の把握
  • コンプライアンスのための監査性とトレーサビリティの維持

2. プラットフォーム全体でのリンク​

ドキュメントは、以下を含む多くの種類のオブジェクトに関連付けられます。

  • ゲートウェイ
  • デバイス
  • プロジェクト
  • パイプライン
  • リソースグループ
  • その他、プラットフォーム機能の拡張に応じて追加

このオブジェクトレベルの関連付けにより、ドキュメントは常に文脈上の関連性を保ち、容易に見つけられるようになります。

3. ビューアと比較ツール​

SDA は現在、構成ファイル、スクリプト、プレーンテキストドキュメントなどのテキストベースのドキュメントについて、ブラウザ内での表示および比較機能を提供しています。

サポートされる機能は次のとおりです。

  • インライン表示
  • 並列差分表示
  • バージョン間比較
  • 変更箇所のハイライト

PDF、Office ドキュメント、バイナリ形式などのよりリッチな形式を含む、その他のドキュメント種別は今後のリリースでサポートされる予定です。

4. 柔軟なファイルサポート​

Documents には、エンジニアリング、運用、コンプライアンスに関連するほぼすべてのファイル形式を含めることができます。以下はその例です。

  • Word、Excel、PowerPoint
  • PDF
  • テキストおよび markdown ファイル
  • デバイス構成ファイル
  • XML / JSON 構成アーティファクト
  • 画像や図面
  • その他の補助ファイル

ドキュメントの整理と管理​

SDA に保存される各ドキュメントには、以下が含まれます。

  • 名称と説明 – 人が読んで識別できる情報
  • ファイル種別とメタデータ – 拡張子、サイズ、バージョン番号
  • 関連オブジェクト – プラットフォーム内でドキュメントがリンクされている場所
  • バージョン履歴 – すべての変更の時系列記録
  • 権限 – SDA のロールベースアクセス制御モデルによって適用

チームは、デバイス、ゲートウェイ、プロジェクトの SDA インターフェースから直接、新しいドキュメントのアップロード、既存ファイルの置き換え、バージョン履歴の確認、関連付けの管理を行えます。

今後の拡張​

Documents 機能領域は、今後のリリースで以下を含む形に拡張される予定です。

  • Office 形式向けのリッチビューア
  • PDF の比較機能
  • バイナリ形式のプレビュー強化
  • メタデータの拡張とドキュメントのタグ付け
  • ワークフロー統合（承認、ライフサイクル状態など）