Partilhar via


Habilitar recursos condicionais com filtros de recursos

Os sinalizadores de recursos fornecem uma maneira de ativar ou desativar a funcionalidade em seu aplicativo. Um sinalizador de recurso básico está ativado ou desativado. O aplicativo se comporta de acordo com o valor da bandeira em todas as circunstâncias. Por exemplo, você pode implantar um novo recurso por trás de um sinalizador de recurso. Quando o sinalizador de recurso está ativado, todos os usuários experimentam o novo recurso. Desativar o sinalizador de recurso oculta o novo recurso.

Por outro lado, ao usar um sinalizador de recurso condicional, você pode ativar ou desativar dinamicamente o sinalizador de recurso. O comportamento do aplicativo depende dos critérios do sinalizador de recurso. Esse recurso é útil quando você deseja mostrar seu novo recurso a um pequeno subconjunto de usuários em um primeiro momento. Você pode usar um sinalizador de recurso condicional para ativar o sinalizador de recurso para alguns usuários enquanto o desativa para outros.

Este artigo mostra como definir critérios para alterar dinamicamente o estado de um sinalizador de recurso condicional.

Pré-requisitos

  • Uma assinatura do Azure. Se não tiver uma, crie uma conta gratuita.
  • Uma loja de Configuração de Aplicativos do Azure.

O que é um filtro de recursos?

Os filtros de feição são condições para determinar o estado de um sinalizador de recurso. Ao adicionar filtros de feição a um sinalizador de recurso, você pode invocar código personalizado sempre que o sinalizador de recurso for avaliado.

As bibliotecas de gerenciamento de recursos da Microsoft incluem os seguintes filtros de recursos internos, que você pode configurar no portal do Azure:

  • O tipo de filtro Janela de tempo ativa um sinalizador de recurso durante uma janela de tempo especificada.
  • O tipo de filtro Segmentação ativa um sinalizador de recurso para usuários e grupos especificados.

Você pode criar filtros de recursos personalizados que ativam recursos com base em critérios específicos em seu código. Este artigo orienta você pela adição de um filtro de recurso personalizado a um sinalizador de recurso. Na última etapa, você pode seguir links para instruções para implementar o filtro de recursos em seu aplicativo.

Adicionar um filtro de recurso personalizado

  1. Crie um sinalizador de recurso chamado Beta em sua loja de configuração de aplicativos e abra-o para edição. Para obter mais informações sobre como adicionar e editar um sinalizador de recurso, consulte Criar um sinalizador de recurso e Editar sinalizadores de recurso.

  2. Na caixa de diálogo Editar sinalizador de recurso , selecione Ativar sinalizador de recurso se ainda não estiver selecionado. Selecione Usar filtro de recursos e, em seguida, selecione Criar.

    Captura de ecrã da caixa de diálogo do sinalizador de funcionalidade Editar portal do Azure. O botão Criar e o sinalizador Ativar recurso e as opções Usar filtro de recurso são realçados.

  3. Na caixa de diálogo Criar um novo filtro , insira as seguintes informações:

    • Em Tipo de filtro, selecione Filtro personalizado.
    • Em Nome do filtro personalizado, insira Aleatório.

    Captura de ecrã da caixa de diálogo Criar um novo filtro. O tipo de filtro personalizado está selecionado e a caixa Nome do filtro personalizado contém Aleatório.

  4. Adicione um parâmetro seguindo as seguintes etapas:

    • Em Nome do parâmetro, insira Porcentagem.
    • Em Valor, insira 50.

    Os filtros de recursos podem, opcionalmente, usar parâmetros para condições configuráveis. Neste exemplo, você configura o filtro para ativar o sinalizador de recurso com 50% de chance. Ao implementar o filtro em seu código, você usa a porcentagem especificada e um número aleatório para avaliar o estado do sinalizador de recurso.

    Captura de ecrã da caixa de diálogo Criar um novo filtro. Um parâmetro chamado Percentage é visível. Tem um valor de 50.

  5. Para salvar o novo filtro de recursos, selecione Adicionar. Na caixa de diálogo Editar sinalizador de recurso , o filtro Aleatório agora está listado na seção Filtros de recursos .

  6. Para salvar o sinalizador de recurso, selecione Aplicar.

    Captura de tela da caixa de diálogo Editar sinalizador de recurso. O filtro aleatório está listado na seção Filtros de recursos e um botão Aplicar está disponível.

    A caixa de diálogo Editar sinalizador de recurso é fechada e seu filtro personalizado é adicionado ao sinalizador de recurso.

  7. Para implementar o filtro de recursos em seu aplicativo, consulte as instruções apropriadas para seu idioma ou plataforma:

Próximos passos