SPDataStore.UpdateFilter method

Article
05/27/2015

Updates a filter in a SharePoint list.

Namespace: Microsoft.PerformancePoint.Scorecards.Store
Assembly: Microsoft.PerformancePoint.Scorecards.Store (in Microsoft.PerformancePoint.Scorecards.Store.dll)

Syntax

'Declaration
Public Function UpdateFilter ( _
    filter As Filter _
) As Filter
'Usage
Dim instance As SPDataStore
Dim filter As Filter
Dim returnValue As Filter

returnValue = instance.UpdateFilter(filter)

public Filter UpdateFilter(
    Filter filter
)

Parameters

filter
Type: Microsoft.PerformancePoint.Scorecards.Filter

The filter object that contains the updated information. The Location property must specify the URL of the object to update.

Return value

Type: Microsoft.PerformancePoint.Scorecards.Filter
The updated object, which contains updated information such as the new version number.

Implements

IBIMonitoringStore.UpdateFilter(Filter)

Remarks

For filter, we recommend that you use a filter object that was previously retrieved by using the GetFilter(RepositoryLocation) method.

Examples

The following code example shows how to retrieve a filter, update the retrieved filter, and then save the updated object to the repository.

Before you can compile this code example, you must do the following:

Configure your development environment and create a C# class library project in Visual Studio. For information about configuring a development environment, see Set up a general development environment for SharePoint 2013.
Add the Microsoft.PerformancePoint.Scorecards.Client, Microsoft.PerformancePoint.Scorecards.ServerCommon, and Microsoft.PerformancePoint.Scorecards.Store DLLs as references to your project. For more information about PerformancePoint Services DLLs, see PerformancePoint Services DLLs Used in Development Scenarios.

Add the following using directives to your class.

using Microsoft.PerformancePoint.Scorecards;
using Microsoft.PerformancePoint.Scorecards.Store;
using System.Globalization;

Create a method that does the following:
- Defines a string variable named "relativePath" to store the server-relative path to the object. The following example path sets the object identifier to "5": /BI Center/Lists/PerformancePoint Content/5_.000.
- Creates an instance of a Filter object named "updatedFilter." For an example of how to create the object, see the CreateFilter method.
Paste the following code example into the new method.

// As a best practice, retrieve an object and then update it.
// The RepositoryLocation constructor takes the server-relative path to the object.
Filter requestedFilter = SPDataStore.GlobalDataStore.GetFilter(new RepositoryLocation(relativePath));

if (requestedFilter != null)
{
    // Update the description to show the time of the last update operation.
    requestedFilter.Description.Text = String.Format(
        CultureInfo.CurrentCulture,
        "Last updated at {0}",
        DateTime.Now.ToLocalTime());

    // Update the filter in the repository.
    updatedFilter = SPDataStore.GlobalDataStore.UpdateFilter(requestedFilter);
}