Operations: How to Configure Revisions

The ConfigureRevisionsOperation modifies the revisions settings for a particular database. Within that database, each collection can have its own separate revisions settings.

To configure the revisions settings for a database and/or the collections in that database, follow these steps:

1. Create a RevisionsCollectionConfiguration object for each desired collection.
2. Put those RevisionsCollectionConfiguration objects in a RevisionsConfiguration object.
3. Send that RevisionsConfiguration to the server.

RevisionsCollectionConfiguration

This object contains the four revisions settings for a particular collection:

public class RevisionsCollectionConfiguration
{
    public TimeSpan? MinimumRevisionAgeToKeep;
    public long? MinimumRevisionsToKeep;
    public bool Disabled;
    public bool PurgeOnDelete;
}

A revision is only deleted if both the MinimumRevisionsToKeep for that document is exceeded, and the revision is older than the MinimumRevisionAgeToKeep limit. The oldest revisions are deleted first.

• By default both these options are set to null, meaning that an unlimited number of revisions will be saved indefinitely.

• If only MinimumRevisionsToKeep is null, revisions will be deleted only when they are older than MinimumRevisionAgeToKeep.

• If only MinimumRevisionAgeToKeep is null, revisions will be deleted each time there are more revisions than MinimumRevisionsToKeep.

These deletions will only take place when a new revision is added to a document. Until a new revision is added, that document's revisions can exceed these limits.

RevisionsConfiguration

This object contains a Dictionary of the revision settings for each collection in the database, plus an optional default configuration.

public class RevisionsConfiguration
{
        public Dictionary<string, RevisionsCollectionConfiguration> Collections;
        public RevisionsCollectionConfiguration Default;
}

Note that when this object is sent to the server, it overrides the configurations for all collections, including all existing configurations currently on the server. If a collection is not listed in Collections and Default has not been set, the default values listed in the table above are applied.

ConfigureRevisionsOperation

Lastly, the operation itself sends the RevisionsConfiguration to the server, overriding all existing collection configurations. You'll want to store these configurations on the client side so they don't have to be created from scratch each time you want to modify them.

public ConfigureRevisionsOperation(RevisionsConfiguration configuration);

The following code sample updates the settings of the Document Store's default database - which in this case is a database named "Northwind". To update the configuration of different database, use the ForDatabase() method.

// Create a configuration for the Employees collection
var employeesRevConfig = new RevisionsCollectionConfiguration() 
{
    MinimumRevisionAgeToKeep = new TimeSpan(hours: 1, minutes: 23, seconds: 45),
    MinimumRevisionsToKeep = 42,
    PurgeOnDelete = true
};

// Create a configuration for the Products collection
var productsRevConfig = new RevisionsCollectionConfiguration()
{
    Disabled = true
};

// Create a default collection configuration
var defaultRevConfig = new RevisionsCollectionConfiguration()
{
    MinimumRevisionAgeToKeep = new TimeSpan(days: 7, 0, 0, 0),
    MinimumRevisionsToKeep = 100,
    PurgeOnDelete = false
};

// Combine to create a configuration for the database
var northwindRevConfig = new RevisionsConfiguration()
{
    Collections = new Dictionary<string, RevisionsCollectionConfiguration>()
    {
        { "Employees", employeesRevConfig },
        { "Products", productsRevConfig }
    },

    Default = defaultRevConfig
};

// Execute the operation to update the database
documentStore.Maintenance.Send(new ConfigureRevisionsOperation(northwindRevConfig));

// Create a configuration for the Employees collection
var employeesRevConfig = new RevisionsCollectionConfiguration()
{
    MinimumRevisionAgeToKeep = new TimeSpan(hours: 1, minutes: 23, seconds: 45),
    MinimumRevisionsToKeep = 42,
    PurgeOnDelete = true
};

// Create a configuration for the Products collection
var productsRevConfig = new RevisionsCollectionConfiguration()
{
    Disabled = true
};

// Create a default collection configuration
var defaultRevConfig = new RevisionsCollectionConfiguration()
{
    MinimumRevisionAgeToKeep = new TimeSpan(days: 7, 0, 0, 0),
    MinimumRevisionsToKeep = 100,
    PurgeOnDelete = false
};

// Combine to create a configuration for the database
var northwindRevConfig = new RevisionsConfiguration()
{
    Collections = new Dictionary<string, RevisionsCollectionConfiguration>()
    {
        { "Employees", employeesRevConfig },
        { "Products", productsRevConfig }
    },

    Default = defaultRevConfig
};

// Execute the operation to update the database
await documentStore.Maintenance.SendAsync(new ConfigureRevisionsOperation(northwindRevConfig));