Gerir as regras

A Proteção contra Fraude do Microsoft Dynamics 365 oferece a flexibilidade de criar regras que usam a pontuação gerada pelo modelo de inteligência artificial (IA) de última geração da Proteção contra fraudes, juntamente com parâmetros adicionais da carga útil da solicitação. Com base nessas entradas, as regras podem converter uma avaliação em uma decisão, como Aprovar, Rejeitar, Revisar ou Contestar.

Se sua instância de Proteção contra fraude tiver vários ambientes, você poderá gerenciar regras em um ambiente específico usando o seletor de ambiente. Se o ambiente tiver ambientes pai, as regras no ambiente pai de nível superior serão avaliadas primeiro. Se as configurações de regra para o ambiente pai de nível superior estiverem definidas como Executar todas as regras correspondentes até que uma decisão seja tomada, as regras no ambiente pai de segundo nível serão avaliadas em seguida. Esse processo continua, a menos que as configurações de regra para um ambiente sejam definidas como Executar somente a primeira regra de correspondência ou até que todas as regras para o ambiente pai e o ambiente atual sejam avaliadas.

Definição de uma regra: Guia de início rápido

As regras consistem em cláusulas e são definidas pelas palavras-chave RETURN e WHEN . Eles têm a seguinte estrutura básica.

RETURN <decision>
WHEN <condition>

A instrução RETURN só é executada se a instrução WHEN for avaliada como True. A instrução RETURN encerra a execução da regra e deve especificar uma função de decisão válida: Aprovar, Rejeitar, Contestar ou Revisão. Cada função de decisão também aceita um parâmetro opcional, permitindo que você expresse o motivo da decisão. Para saber mais, consulte Funções de decisão.

Além de uma decisão, a instrução RETURN também pode ser usada para gravar dados na resposta da API ou no rastreamento de eventos. Para saber mais, consulte Funções de observação.

A instrução WHEN especifica uma condição booleana que determina se a instrução RETURN é executada.

A instrução WHEN pode usar qualquer um dos seguintes itens:

• Todos os atributos enviados na solicitação de API para a avaliação, incluindo dados personalizados. Você pode acessar esses atributos com o operador @. Por exemplo, @"user.userId".
• As pontuações que são geradas a partir dos modelos de inteligência artificial da Fraud Protection. Por exemplo, @"riskscore".
• Listas que carregou para a Proteção contra fraudes. Para obter mais informações sobre como carregar listas, consulte Gerenciar listas. Para obter mais informações sobre como fazer referência a essas listas em suas regras, consulte Usando listas em regras.
• Velocidades definidas em Proteção contra fraude. Para obter mais informações, consulte Executar verificações de velocidade.
• Chamadas externas que você criou na Proteção contra fraudes. Para obter mais informações, consulte Chamadas externas.
• Funções que criou na Proteção contra Fraudes. Para obter mais informações, consulte Funções.

As expressões podem ser comparadas usando operadores de comparação (como ==, !=, >, <), e podem ser combinadas usando operadores lógicos como e (&&) e ou (||).

Para obter mais informações sobre a sintaxe da regra, consulte o Guia de referência de idioma.

Vista visual

Use o modo visual para escrever regras de forma rápida e fácil usando os atributos da carga útil da solicitação.

1. Para criar regras visuais, selecione + Nova cláusula.
2. Selecione Visual View ao lado do nome da cláusula.
3. Você pode adicionar vários filtros à cláusula e escolher os atributos no menu suspenso.
4. Volte para a Visualização de código para exibir e editar as regras na linguagem de consulta de fraude. Depois que a regra for editada na Visualização de código, você não poderá voltar para a Visualização visual.

O gráfico a seguir mostra a Visualização Visual das regras e o botão Visualização de Código que você pode selecionar para alterar a exibição.

O gráfico a seguir mostra a Visualização de código das regras e o botão Visualização visual que você pode selecionar para alterar a exibição.

Exemplos de regras

RETURN Reject("high score")
WHEN @"riskScore" > 900

RETURN Review("medium score")
WHEN @"riskScore" <= 900 and @"riskScore" > 400

RETURN Approve(), Other(ip=@"device.ipAddress")
WHEN @"user.countryRegion" == "US"

RETURN Reject("user on block list")
WHEN ContainsKey("Email Block List", "Emails", @"user.email")

RETURN Review()
WHEN @"user.email".EndsWith(“@contoso.com”)

Guia Regras

Você pode criar regras personalizadas e gerenciar regras existentes na guia Regras .

• Para criar e gerir regras relacionadas com compras, selecione Comprar e, em seguida, selecione o separador Regras.
• Para criar e gerir regras relacionadas com contas, selecione Criação de conta ou Início de sessão de conta e, em seguida, selecione o separador Regras .
• Para criar e gerenciar regras relacionadas a uma avaliação personalizada, selecione Avaliações personalizadas, selecione uma avaliação personalizada e selecione a guia Regras .

A guia Regras mostra uma lista das regras configuradas para um tipo de avaliação. Estas regras estão divididas em duas secções: Regras publicadas e Rascunhos. Para obter informações sobre rascunhos, consulte a seção Rascunhos mais adiante neste artigo.

Você pode exibir as seguintes informações para cada regra ou rascunho:

• O nome
• A condição que você criou
• O status: Ativo ou Inativo

Você também pode selecionar o bloco de cada regra para expandi-la e mostrar informações adicionais. Seguem-se alguns exemplos:

• A descrição
• O número de cláusulas da regra
• Quem atualizou a regra pela última vez
• Quando a regra foi atualizada pela última vez

Nota

Na guia Regras, as regras publicadas são listadas na ordem em que são executadas.

Configurações de regra

Você pode acessar as configurações de regra na guia Regras para uma avaliação específica. Lá, você pode alterar o comportamento de avaliação da regra e a carga útil da amostra. Estas alterações aplicam-se a regras apenas para a avaliação que está a editar.

Comportamento de avaliação de regras

Você pode atualizar como suas regras são avaliadas. Se você selecionar Executar a primeira regra de correspondência, apenas uma regra será avaliada por transação. Se essa regra não retornar uma decisão, nenhuma outra regra será avaliada e uma decisão padrão de Aprovar será retornada. Se você selecionar Executar todas as regras correspondentes até que uma decisão seja tomada, várias regras poderão ser avaliadas para uma única transação. Se a primeira regra avaliada não retornar uma decisão, cada regra de correspondência subsequente será avaliada até que uma decisão seja retornada.

Amostra de carga útil

No painel Configurações de carga útil, você pode definir a carga útil de exemplo para o tipo de avaliação. A carga útil de exemplo destina-se a conter um exemplo dos campos que são enviados na API de solicitação para a avaliação e podem ser usados em sua regra.

Na solicitação de API, você pode optar por não enviar campos opcionais do esquema de avaliação. Como alternativa, você pode optar por enviar campos personalizados adicionais. Em ambos os casos, certifique-se de atualizar o exemplo de carga útil mostrado no painel Configurações de carga útil, para que reflita os campos específicos que você está enviando.

Este exemplo de carga útil é mostrado sempre que uma nova regra é criada para a avaliação (consulte a seção Exemplo de carga útil mais adiante neste artigo). Quaisquer alterações feitas aplicam-se apenas às regras criadas a partir desse momento.

Para desfazer todas as alterações que você ou outras pessoas fizeram na amostra de carga útil e devolvê-la à amostra de carga padrão do sistema, selecione Reverter.

Componentes de uma regra

Uma regra consiste nos seguintes componentes:

• Um nome e uma descrição que descrevem a finalidade da regra
• O status atual da regra: Ativo ou Inativo
• Um exemplo de campos, para ajudá-lo a escrever e avaliar a regra
• Componentes que ajudam a criar a lógica que aprova, rejeita, desafia ou analisa eventos automaticamente:
  • Uma condição
  • Um ou mais dos seguintes tipos de cláusulas:
    • Antes de todas as cláusulas de pontuação
    • Cláusulas de pontuação pós-bot
    • Cláusulas de pontuação pós-risco

Uma regra publicada também pode ter uma versão preliminar.

Nome e descrição

Ao criar uma regra, você pode adicionar um nome e uma descrição para ajudar você e sua equipe a identificar facilmente a regra. Os nomes das regras devem ser exclusivos e não diferenciam maiúsculas de minúsculas.

Status

Quando você cria uma regra pela primeira vez, o status é definido como Rascunho somente antes de ser publicado.

Ao publicar uma regra, você pode definir o status como Ativo ou Inativo.

• Se uma regra estiver ativa, ela afetará o tráfego de produção em tempo real e todos os eventos serão avaliados em relação à regra.
• Se uma regra estiver inativa, ela não afetará o tráfego de produção.

Quando você edita uma regra publicada anteriormente, a regra é salva com um status de Ativo (com Rascunho) ou Inativo (com Rascunho), dependendo do status da regra publicada.

Exemplos

Quando você cria ou edita uma regra, o painel Exemplo aparece no lado direito da página. Este painel tem duas seções: uma para a amostra de carga útil e outra para a amostra de pontuação.

Para exibir as variáveis de exemplo usadas na regra, selecione Mostrar variáveis usadas.

Amostra de carga útil

O exemplo de carga útil contém um exemplo dos campos que podem ser enviados na API de solicitação para a avaliação, conforme definido no painel Configurações de carga útil. Esses campos podem ser usados como variáveis em sua regra.

Amostra de pontuação

A amostra de pontuação contém pontuações que são geradas a partir dos modelos de IA da Proteção contra Fraudes. Você pode fazer referência a variáveis de pontuação em regras depois de executar o modelo de IA associado e gerar a pontuação. Por exemplo, você pode usar @"botScore" depois que a avaliação do bot é executada e pode usar @"riskScore" depois que a avaliação de risco é executada. Para obter mais informações, consulte a seção Cláusulas mais adiante neste artigo.

Editando o exemplo

Para verificar se a regra funciona para vários eventos, você pode editar o exemplo conforme necessário e, em seguida , avaliar os dados de exemplo em relação à regra. Todos os valores na amostra de carga útil e na amostra de pontuação podem ser editados. Quando você edita uma amostra, as alterações não afetam quais dados você envia (ou não envia) para a Proteção contra fraude.

Quando você publica uma regra, todas as alterações feitas no exemplo são salvas e persistem como parte da regra.

Para desfazer todas as alterações feitas por você ou outras pessoas no exemplo, selecione Reverter. A amostra de pontuação é revertida para a amostra de pontuação padrão do sistema e a amostra de carga útil é revertida para a amostra de carga definida pelo usuário no painel Configurações de carga útil.

Condições

As condições começam com a palavra-chave WHEN e são seguidas por uma expressão booleana que avalia uma instrução como True ou False. Uma condição pode ser criada para determinar qual regra é avaliada e para agrupar a lógica de negócios relacionada. Por exemplo, a condição a seguir está relacionada a transações de produtos digitais.

WHEN @"productList.type" == "Digital"

Em seguida, você pode criar cláusulas que configuram uma estratégia de fraude relacionada a transações de produtos digitais.

A adição de uma condição a uma regra é opcional. Se quiser que uma regra se aplique a todos os eventos, não adicione uma condição. Para obter informações sobre como usar condições para ordenar regras, consulte a seção Ordenação de regras mais adiante neste artigo.

Cláusulas

As cláusulas contêm a lógica de fraude e as políticas de negócios relevantes para o segmento de tráfego definido na condição. As cláusulas usam valores na carga útil do evento juntamente com as pontuações de IA da Proteção contra Fraude para aceitar, rejeitar, revisar ou contestar eventos. Cada regra deve conter pelo menos uma cláusula, e a cada cláusula é atribuído um nome exclusivo. Você pode selecionar o nome para personalizá-lo.

As cláusulas têm a seguinte estrutura básica.

RETURN <decision> 
WHEN <condition is true>

Você pode usar essa estrutura para criar uma cláusula que retorna uma decisão de Aprovar, Rejeitar, Contestar ou Revisão. Em seguida, você pode adicionar parâmetros opcionais que enviam mais informações sobre a decisão.

Tudo após a palavra-chave WHEN deve ser capaz de ser avaliado como True ou False. Essa expressão booleana pode consistir em valores da carga útil do evento, listas definidas pelo usuário e pontuações de risco e bot baseadas em IA.

Para obter informações sobre a sintaxe das cláusulas, consulte o Guia de referência de linguagem.

Quando uma cláusula é acionada (ou seja, quando a instrução WHEN retorna True), a decisão especificada na instrução RETURN é retornada e nenhuma cláusula subsequente é executada.

Se uma condição corresponder à decisão, mas não acionar uma cláusula, a regra será executada.

RETURN Approve("NO_CLAUSE_HIT")

As cláusulas são executadas sequencialmente na ordem em que aparecem na guia Regras . Você pode usar os botões de seta no lado direito de uma cláusula para alterar sua posição na lista.

As cláusulas estão organizadas em secções. Os modelos de IA são executados com base nessas seções e geram uma pontuação como parte da avaliação. As seções diferem por avaliação e indicam quando a cláusula é executada em relação ao modelo de IA.

• Para proteção de compra, é executado um modelo de risco de IA que gera uma pontuação de risco para a transação. Portanto, essas regras contêm cláusulas de pontuação prévia a todas e cláusulas de pontuação pós-risco.
• Para proteção de conta, um modelo de bot é executado além de um modelo de risco. Esses modelos geram uma pontuação de bot e uma pontuação de risco, respectivamente. Portanto, essas regras contêm cláusulas de pontuação prévia a todos, cláusulas de pontuação pós-bot e cláusulas de pontuação pós-risco.
• Para avaliações personalizadas, nenhum modelo de IA é executado, e essas regras contêm apenas cláusulas de pontuação prévia a todas.
• As avaliações criadas usando o assistente de Avaliação não têm um conceito de cláusulas de pontuação prévia e pós-pontuação. Em vez disso, todas as cláusulas são executadas sequencialmente (de cima para baixo) com base na ordem em que estão listadas na regra.

Cláusulas de pontuação prévia a todas

As cláusulas de pontuação prévia a todas são executadas antes que os modelos de IA da Proteção contra Fraude sejam executados. Portanto, eles são executados antes de qualquer bot ou pontuação de avaliação de risco ter sido gerada. Essas cláusulas podem usar qualquer combinação de campos enviados como parte da carga útil do evento e contidos em listas. Eles podem ser configurados para implementar embargo, delimitação geográfica ou outras políticas de negócios.

O exemplo a seguir ajuda você a revisar compras quando os usuários compram um produto em um mercado fora de sua localização geográfica.

RETURN Review("location inconsistency") 
WHEN Geo.MarketCode(@"device.ipAddress") != "@productList.market"

Nesta seção, você também pode escrever uma cláusula para listas de referência cruzada. Por exemplo, se você tiver uma lista personalizada chamada E-mails de risco, a cláusula a seguir rejeitará eventos se o endereço de e-mail do usuário aparecer na lista.

RETURN Reject ("risky email") 
WHEN ContainsKey ("Risky Emails", "Emails", @"user.email")

Para obter informações sobre a sintaxe usada para fazer referência a listas em regras, consulte o Guia de referência de idioma.

Cláusulas de pontuação pós-bot

As cláusulas de pontuação pós-bot são executadas depois que os modelos de IA da Proteção contra Fraude geram uma pontuação de bot para um evento. Essa pontuação representa a probabilidade de um bot ter iniciado o evento. É um número entre 0 e 999. Uma pontuação mais alta indica uma maior probabilidade de bot.

Nas cláusulas de pontuação pós-bot, você pode usar essa pontuação junto com campos da carga útil e listas para tomar decisões. Você faz referência a essa pontuação usando a variável @botScore . Por exemplo, a cláusula a seguir rejeita eventos de um domínio de e-mail específico que tenha uma pontuação de bot superior a 700.

RETURN Reject()
WHEN @"user.email".EndsWith("@contoso.com") && @"botScore" > 700

Cláusulas de pontuação pós-risco

As cláusulas de pontuação pós-risco são executadas depois que os modelos de IA da Proteção contra Fraude geram uma pontuação de avaliação de risco para um evento. Esta pontuação é um número entre 0 e 999. Uma pontuação mais alta indica um risco percebido mais alto.

Em cláusulas de pontuação pós-risco, você pode usar essa pontuação junto com campos da carga útil e listas para tomar decisões. Você faz referência a essa pontuação usando a variável @riskScore . Por exemplo, a cláusula a seguir rejeita transações caras que tenham uma pontuação de risco superior a 700.

RETURN Reject("high price and risk score")
WHEN @purchasePrice >= 199.99 && @riskScore > 700

Rascunhos

Uma regra pode ter uma versão publicada e uma versão de rascunho . Ambas as versões podem ser visualizadas como separadores lado a lado no separador Regras .

A versão publicada é somente leitura e pode ser visualizada por qualquer pessoa. A versão preliminar é visível apenas para o seu autor. Os rascunhos podem ser editados e todas as alterações são salvas automaticamente.

• Para descartar o rascunho, selecione Descartar.
• Para publicar o rascunho, selecione Publicar.

Quando você publica um rascunho, a Proteção contra fraude substitui a versão publicada da regra pela versão de rascunho.

Ordenação de regras

A guia Regras mostra uma lista das regras publicadas configuradas para a avaliação. A ordem em que as regras são listadas afeta a ordem em que são avaliadas. Para reordenar as regras, basta arrastar uma regra para a posição desejada e, em seguida, selecionar Guardar.

Um evento é avaliado em relação a cada condição de regra, em ordem, até que uma condição retorne True. Cada cláusula da regra selecionada é então avaliada. Se uma destas cláusulas devolve uma decisão, não são avaliadas outras regras. Se nenhuma dessas cláusulas retornar uma decisão, a transação será aprovada por padrão ou a próxima regra publicada que tiver uma condição correspondente será avaliada. O comportamento depende do comportamento de avaliação da regra selecionado nas configurações da regra.

Criar uma nova regra

Você pode criar regras que tomam decisões relacionadas à compra, criação de conta e eventos de login de conta.

Importante

Por padrão, quando uma nova regra é publicada, ela aparece na parte inferior da lista na seção Regras publicadas da guia Regras . Para obter informações sobre como reposicionar a regra, consulte a seção Alterar a ordem de uma regra mais adiante neste artigo.

1. Na guia Regras, selecione Nova Regra.

   É criado um novo projeto de regra. Todas as alterações feitas nos rascunhos são salvas automaticamente.

2. Selecione Renomear e insira um nome e uma descrição.

3. Adicione uma condição à sua regra.

4. Adicione cláusulas para expressar suas políticas de negócios e estratégias de fraude.

   • Para criar uma nova cláusula do zero, selecione Nova cláusula na seção de cláusula apropriada.
   • Você também pode começar a partir de um modelo de cláusula existente selecionando a seta à direita de Nova cláusula. Para exibir uma lista completa de modelos e seu conteúdo, selecione Ver tudo.

5. Para avaliar sua regra e verificar se ela funciona como esperado, selecione Expandir no canto inferior direito da guia Regras para abrir o painel de avaliação da regra.

6. Para publicar a regra, selecione Publicar. Na caixa de diálogo de confirmação, altere o nome, a descrição e o status e selecione Publicar.

7. Defina o status como Ativo ou Inativo.

8. Para reposicionar a regra na lista da guia Regras , selecione-a, arraste-a para a nova posição e selecione Salvar ordem.

Regras definidas pelo sistema (padrão)

A Proteção contra Fraudes pode criar regras por ambiente. Por exemplo, a seguinte regra padrão pode ser criada.

• Regra de suporte padrão

Algumas funcionalidades de Proteção contra Fraude dependem de regras padrão. Depois de adicionar um e-mail, endereço IP ou outro conteúdo de lista conhecido a uma lista de suporte (seguro, vigiado ou rejeitado), esta regra padrão garante que as listas sejam verificadas durante a avaliação da avaliação.

Você pode editar, excluir e desativar regras definidas pelo sistema. Como prática recomendada, considere criar ou editar uma regra diferente, a menos que você queira alterar o comportamento padrão.

Regras de avaliação (padrão)

Cada modelo de avaliação mencionado na etapa Selecionar modelo do assistente de Avaliação vem predefinido com uma ou ambas as seguintes regras padrão:

• Regra de modelo de exemplo – Esta regra contém uma série de cláusulas de exemplo que servem como blocos de construção para definir sua própria lógica para tomar decisões com base em valores como pontuação de risco, pontuação de bot e atributos de dispositivo, quando aplicável. Nenhuma dessas cláusulas toma decisões por padrão, no entanto, elas podem ser rapidamente alteradas para fazê-lo usando as amostras fornecidas.
• Regra da lista de suporte – Esta regra consiste em uma série de cláusulas que usam as listas de suporte da Proteção contra Fraude (seguro, bloqueio, observação) para ajudá-lo a tomar decisões informadas (aceitar, rejeitar, revisar) com base nas entidades nessas listas.

Quando aplicável, essas regras padrão aparecem como ativas em Regras publicadas imediatamente após a criação de uma avaliação. A tabela a seguir é um resumo das regras padrão suportadas pelo modelo de avaliação:

Template	Regra de modelo	Regra da lista de suporte
Pagamento com cartão	Suportado	Suportado
Impressão digital do dispositivo	Suportado	N/A
Programa de fidelização	Suportado	Suportado
Transferência de dinheiro	Suportado	Suportado
Pirataria de software	Suportado	Suportado
Personalizado	N/A	Suportado

Regras e cláusulas adicionais podem ser adicionadas manualmente a uma avaliação em seus ambientes raiz e filho.

Para invocar o risco e as pontuações de bot da Proteção contra fraude de dentro de uma regra para uma avaliação criada usando um dos modelos, as seguintes funções de modelo devem ser usadas:

• Pontuação de risco: Model.Risk(). Pontuação
• Pontuação do Bot: Model.Bot(@"deviceFingerprinting.id"). Pontuação

Ramos

As filiais permitem que você modifique regras com segurança sem afetar o que está acontecendo na produção. Você pode criar ramificações na guia Regras , onde cada ramificação representa uma coleção de regras. A ramificação padrão é a ramificação Produção , que é a ramificação de regras que é executada sempre que o tráfego é enviado para uma avaliação.

Criar um ramo

Para criar uma nova ramificação, vá para Ação > de ramificação Criar uma nova ramificação. Você pode nomear a ramificação, fornecer um nome de API e selecionar quais regras deseja copiar da ramificação de origem. A ramificação de origem é qualquer ramificação em que você estava quando selecionou Criar uma nova ramificação, produção ou de outra forma. Nenhum rascunho é preservado durante a criação do ramo.

Modificar regras dentro de filiais

Quaisquer alterações de regra em ramificações que não sejam de produção não afetam a pilha de regras de produção. Você pode editar regras normalmente e publicá-las na filial, onde podem ser vistas por todos que têm acesso à página de regras.

Testes e experiências

Há duas maneiras de testar o comportamento da regra de ramificação: enviando tráfego diretamente para uma ramificação e sombreando o tráfego de produção.

Enviar tráfego diretamente para uma filial

Você pode enviar tráfego de teste diretamente para uma ramificação específica em uma avaliação usando o ponto de extremidade da API de ramificação encontrado em Informações de ramificação de ações > de ramificação. Esse ponto de extremidade da API usa a mesma estrutura de carga útil da avaliação e executa a pilha de regras da ramificação.

Nota

Enviar tráfego diretamente para uma filial não tem impacto na produção, portanto, as velocidades não são atualizadas e as transações de filial não são visíveis na pesquisa.

Tráfego de produção de sombra

Você também pode testar o comportamento da regra de ramificação sombreando o tráfego de produção. Para sombrear o tráfego de produção, configure e inicie um experimento para uma ramificação selecionando Executar experimento. Quando um experimento estiver em andamento, você poderá visualizar seu desempenho na guia Monitoramento alternando para a ramificação em que o experimento está sendo executado. Quando um experimento está em andamento, seus parâmetros não podem ser editados, mas você sempre pode parar um experimento para fazer alterações e iniciá-lo novamente. Na vista de navegação do prestador de serviços de pagamento (PSP), o menu pendente Ações da sucursal só é visível na página de regras e não na página de monitorização.

Nota

O tráfego sombreado que é executado na pilha de regras de ramificação não tem qualquer impacto na produção, portanto, as velocidades não serão atualizadas duas vezes como resultado da sombra, mas apenas uma vez como resultado da execução da produção.

Promover os ramos de produção

Se você quiser fazer de um ramo o ramo de produção, você pode fazê-lo promovendo um ramo para a produção. A ação de promoção pode ser encontrada em Ações > do ramo Promover a produção. Esta ação torna o ramo atual que você está promovendo o novo ramo de produção. Você pode clonar as regras de produção existentes em uma nova ramificação para salvá-las para referência. Os rascunhos são preservados se a opção para clonar estiver selecionada. Uma vez concluída a promoção, o ramo de produção é atualizado para conter as regras do ramo promovido.

Nota

Na primeira vez que você promove uma ramificação para produção para uma determinada avaliação, não é possível clonar as regras de produção existentes em uma nova ramificação. Se você quiser salvar as regras de produção existentes na primeira vez que promover, crie um novo ramo da produção com essas regras para preservar as regras de produção existentes.

Gerir regras existentes

Na guia Regras, você pode executar as seguintes operações em uma regra existente:

• Mudar o nome
• Ativar ou desativar
• Eliminar
• Editar

Atualizar o nome e a descrição de uma regra

Para atualizar o nome e a descrição de uma regra, selecione-a, selecione Renomear e insira um nome e uma descrição exclusivos.

Alterar o status de uma regra

Para alterar o estado de uma regra, selecione-a e, em seguida, selecione Ativar ou Desativar.

Eliminar uma regra

Para eliminar uma regra, selecione-a e, em seguida, selecione Eliminar. Esta operação não pode ser desfeita.

Editar uma regra existente

Quando você edita uma regra publicada, a Proteção contra fraude salva as alterações como rascunho até que você as publique. Tanto a versão publicada da regra selecionada quanto a versão de rascunho podem ser visualizadas como guias lado a lado. Até que um rascunho seja publicado, ele é visível apenas para a pessoa que o cria. Para obter mais informações, consulte a seção Rascunhos anteriormente neste artigo.

1. Selecione a regra e, em seguida, selecione Editar.

   A guia Rascunho e a guia Publicado são exibidas.

2. Selecione a guia Rascunho e faça as alterações na regra.

   A proteção contra fraudes salva automaticamente todas as alterações feitas na regra.

   Para descartar as alterações, selecione Descartar. A Proteção contra Fraudes exclui o rascunho, mas mantém a regra original publicada.

3. Para publicar as alterações, selecione Publicar.

   Quando você publica um rascunho, a Proteção contra Fraude substitui a versão original publicada da regra pelas alterações feitas na versão de rascunho.

   Se um colega de equipa atualizar e publicar uma regra enquanto ainda a está a editar, as alterações poderão estar desatualizadas. Nesse caso, você recebe uma mensagem de aviso perguntando se você ainda deseja publicar suas alterações.

   • Se você selecionar Publicar, as alterações substituirão todas as alterações feitas anteriormente.
   • Se você selecionar Cancelar, poderá revisar as alterações feitas por outras pessoas antes de publicar sua versão.

Procurar uma regra

Quando você pesquisa uma regra, todos os nomes e descrições de regras são pesquisados e os resultados são filtrados de acordo.

Para pesquisar uma regra, insira uma palavra-chave no campo Pesquisar .

Para remover um filtro, exclua a palavra-chave do campo Pesquisar ou selecione o X no lado direito do campo.

Alterar a ordem de uma regra

Como as regras publicadas aparecem na guia Regras na ordem em que são executadas, a posição de uma regra publicada afeta significativamente a forma como os eventos são avaliados.

Reordenar uma regra publicada

1. Selecione a regra publicada que pretende mover e arraste-a para uma nova posição.
2. Repita o passo 1 para cada regra que pretende mover e, em seguida, selecione Guardar.
3. Para cancelar as alterações, selecione Cancelar.

Nota

As regras na seção Rascunhos não podem ser reordenadas .

Avaliar uma regra

Antes de publicar a nova regra, você pode usar o painel de avaliação da regra para garantir que ela retorne os resultados esperados.

• Para abrir o painel de avaliação de regras, selecione Expandir no canto inferior direito da guia Regras.
• Para fechar o painel, selecione Recolher.

Quando o painel de avaliação estiver aberto, você poderá observar a regra sendo avaliada em relação à amostra de carga útil atual e à amostra de pontuação. À medida que você faz alterações no exemplo ou na própria regra, o conteúdo no painel de avaliação é atualizado.

O painel de avaliação mostra a decisão que a Proteção contra fraude retorna para o evento de amostra. Ele também mostra quaisquer valores associados à resposta, como um motivo ou uma mensagem de suporte. A cláusula que aciona a decisão é delineada em verde fora do painel.

Se a amostra de carga útil não corresponder à condição, a regra não será avaliada. Se a condição for correspondida, mas nenhuma das cláusulas acionar um retorno, a decisão padrão será Aprovar e o motivo será NO_CLAUSE_HIT.

Exemplo de avaliação

Crie uma regra que tenha as três cláusulas a seguir.

`// Approves when email from contoso domain has been validated`
`RETURN Approve()`
`WHEN @"email.isEmailValidated" == true && @"email.emailValue".EndsWith("@contoso.com")`

`// Rejects when email has not been validated and high risk score`
`RETURN Reject()`
`WHEN @"email.isEmailValidated" == false && @"riskscore" > 700`

`// Reviews when email has not been validated and medium risk score`
`RETURN Review()`
`WHEN @"email.isEmailValidated" == false && @"riskscore" > 400`

O exemplo de carga útil contém o seguinte objeto.

"email": {
    "email": "Primary",
    "emailValue": "kayla@contoso.com",
    "isEmailValidated": true,
    "emailValidatedDate": "2020-02-25T15:12:26.9733817-08:00",
    "isEmailUsername": true
},

A amostra de pontuação contém o seguinte valor.

"riskScore": 500,

Quando o painel de avaliação é expandido, a cláusula 1 é acionada e uma decisão de Aprovar é retornada.

Na carga útil de exemplo, você altera o valor do campo isEmailValidated na carga de true para false.

"isEmailValidated": false,

Neste caso, a cláusula 2 é acionada e uma decisão de revisão é devolvida.

Na pontuação da amostra, se você alterar o valor de "riskScore" de 500 para 700, a cláusula 3 será acionada e a decisão será atualizada para Rejeitar.