File Versioning

Track changes and manage file history

Datar Drive provides comprehensive versioning capabilities that let you track changes to files over time, compare different versions, and restore previous states when needed. This guide explains how to effectively use file versioning features.

Version History Structure

Datar maintains a complete version history for files, with detailed metadata for each version.

version-history-example.json

Version Properties

  • Version ID: Unique identifier for each version
  • Creation Details: Timestamp and user information
  • Size: File size for each version
  • Comments: Optional notes about changes made
  • Checksum: For integrity verification
  • Status: Current or archived state

How Versioning Works

Datar Drive's versioning system automatically creates and manages file versions.

Automatic Version Creation

New versions are created when:

  • A file is uploaded or updated
  • File content is modified in connected apps
  • A new version is explicitly saved by a user
  • File metadata is significantly changed
  • A file is restored from a previous version

Version Storage

How versions are stored:

  • Each version is stored as a complete file
  • Versions are immutable once created
  • Older versions are available but marked as archived
  • Space-efficient storage optimizes capacity usage
  • Retention policies control version lifecycle
[Version Creation Process Diagram]

Version Management

Datar provides a suite of tools for working with file versions.

Accessing Version History

You can view a file's complete version history through several methods:

  • File Context Menu: Right-click a file and select "Version History"
  • File Details Panel: Open file details and select the "Versions" tab
  • File Preview: Click the version history icon in the preview toolbar
  • File Actions: Use the "More Actions" menu and select "View Versions"

The version history view shows a chronological list of all versions with details such as:

  • Version number and timestamp
  • User who created the version
  • Size and change indicators
  • Version comments
  • Actions available for each version
[Version History Interface]

Versioning Policies

Datar allows you to configure versioning policies to control how versions are created, stored, and retained.

Versioning Policy Options

Policy Setting
Description
Available Options
Version Creation
Controls when new versions are created
Always, Major edits only, Manual only, Custom rules
Version Limit
Maximum number of versions to keep per file
Unlimited, 5, 10, 25, 50, 100, Custom number
Retention Period
How long versions are kept before automatic cleanup
Forever, 30 days, 90 days, 1 year, Custom period
Storage Tier
Where older versions are stored
Standard storage, Archive storage, Custom lifecycle rules
Deletion Protection
Prevents deletion of versions
None, Basic (confirmation), Enhanced (approval workflow)
Versioning policies can be configured at the organization, drive, folder, or individual file level. More specific settings override broader ones.

Version Integration

Datar's versioning system integrates with other modules and external applications.

Internal Integration

Version history integrates with:

  • Audit logs for compliance tracking
  • Activity feed for visibility and notifications
  • User profiles to track contributions
  • Project timelines for document milestones
  • Workflow systems for document approvals
  • Content search for version-specific queries

External Integration

Version support for external tools:

  • Microsoft Office version tracking
  • Google Workspace revision history
  • Adobe Creative Cloud version support
  • CAD software version management
  • External version control systems (Git, SVN)
  • Third-party document comparison tools
[Version Integration Architecture]

Versioning Best Practices

  1. Use Descriptive Version Comments

    Always include clear, informative comments when creating new versions. Describe what changed and why to help team members understand the evolution of the document without having to compare versions manually.

  2. Create Milestone Versions

    For important documents, create explicit milestone versions at significant points in the document lifecycle (e.g., draft complete, review complete, final approved). This makes it easier to navigate the version history.

  3. Configure Appropriate Retention Policies

    Balance storage costs with compliance needs by setting appropriate version retention policies. Consider keeping more versions for critical documents and fewer for less important files.

  4. Use Version Comparison Tools

    Take advantage of Datar's version comparison features to understand changes between versions. This is particularly important during review cycles to ensure all changes are captured and understood.

  5. Train Users on Version Management

    Ensure all users understand how versioning works and the importance of creating meaningful versions. Proper training reduces confusion and improves the quality of your version history.

  6. Regularly Review Version History

    Periodically review version history for critical documents to ensure appropriate changes are being made and documented. This helps maintain document integrity and can identify unauthorized changes.

Related Drive Components

  1. File Management

    Learn the basics of managing files and folders in the Drive module.

  2. Access Control

    Understand how to manage permissions and share files securely.

  3. Metadata Management

    Discover how to use metadata to organize and classify your content.

Was this documentation helpful?