Azure-docs: Filters?

[13daysaweek]

The documentation on this page mentions filters and it appears filters can be set in the Azure portal, however I haven't yet seen any documentation on how to use filters. Can this page be expanded to include documentation on filters, or a link to any existing documentation?

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: e89c8e11-d8bf-7c62-1bd2-bfaf145d20ae
• Version Independent ID: cac9d257-3328-0ed7-fa73-22be44bf84c5
• Content: Azure App Configuration feature management
• Content Source: articles/azure-app-configuration/concept-feature-management.md
• Service: azure-app-configuration
• GitHub Login: @yegu-ms
• Microsoft Alias: yegu

[kobulloc-MSFT]

@13daysaweek Thank you for the feedback! We are investigating this and will get back to you shortly.

[yegu-ms]

@13daysaweek, thanks for asking! Filter usage are documented in the following:

• https://docs.microsoft.com/en-us/azure/azure-app-configuration/use-feature-flags-dotnet-core#mvc-filters

• https://docs.microsoft.com/en-us/dotnet/api/microsoft.featuremanagement?view=azure-dotnet-preview

please-close

[hansmbakker]

@yegu-ms @kobulloc-MSFT can you please reopen this issue and look at how the documentation can be improved?

The following points are not clear and are not discussed in the documentation:

• how can filters be combined? Is there an OR, or an AND logic to them? (if two IFeatureFilter return a different value for the same Feature, what value will be used by Asp.Net Core?)
• Can we use them to make Features available from different sources (Cookie, Azure App Configuration manager)?
• IFeatureFilters and MVC filters are different things I believe.
  
  
  
  • How are they related?
  
  
  • How should they be implemented?
  
  
  • What filters are available out of the box?
  
  
• I see that they are added in different ways and places:

services.AddMvc(options => {
        options.Filters.AddForFeature<SomeMvcFilter>(nameof(MyFeatureFlags.FeatureA));
    });

public void ConfigureServices(IServiceCollection services)
    {
        services.AddFeatureManagement()
                .AddFeatureFilter<PercentageFilter>();
    }

Could you please reopen this and clarify?

[hansmbakker]

https://andrewlock.net/introducing-the-microsoft-featuremanagement-library-adding-feature-flags-to-an-asp-net-core-app-part-1/ seems to be a good blog about this

[hansmbakker]

There is updated documentation in

• https://github.com/Azure/AppConfiguration
• https://github.com/microsoft/FeatureManagement-Dotnet

Also, some issues in those repos document some behavior, limitations and explanations.

It would be good if at least there was a link to those repos, and it would be better if the content of that would be available as updated tutorials/ articles on Microsoft Docs :)

[LarsKemmann]

Agreed. In particular, some explanation on Microsoft Docs for how to do user group segmentation with feature flags would be helpful, because as of right now the only info provided for filters is focused on the built-in percentage and timeframe filters.

[jpconnock]

We have added stories to our backlog to capture this work -- thanks very much for your feedback!

please-close