Rulesets

Os desenvolvedores coletam regras individuais em uma instância de um ruleset, chamada de versão do ruleset Para atualizar o conteúdo do ruleset, crie uma nova versão do ruleset. A nova versão do ruleset está disponível — ou desbloqueada — para o desenvolvedor realizar atualizações de regras e adicionar novas regras. É uma melhor prática bloquear versões antigas do ruleset. A versão do ruleset ajuda os desenvolvedores a identificar e gerenciar alterações em um aplicativo.

A Pega Platform identifica rulesets por nomes e números de versão. Por exemplo, um aplicativo para processar relatórios de despesas inclui um ruleset chamado Despesa (Expense). A Pega Platform adiciona o número da versão ao nome do ruleset. Despesa:01-02-03 é a versão número 01-02-03 do ruleset Despesa.

O número da versão é dividido em três segmentos: uma versão principal, uma versão secundária e uma versão do patch. Cada segmento é um número de dois dígitos iniciando em 01 e aumentando até 99. A numeração da versão do ruleset começa em 01-01-01 e vai aumentando.

Na imagem a seguir, clique nos ícones + para saber mais sobre os segmentos de versões de rulesets.

Cada aplicativo consiste em uma sequência de rulesets chamada de estrutura de ruleset. A estrutura de ruleset determina a ordem na qual a Pega Platform busca nos rulesets para encontrar a regra que está em uso. Cada entrada na estrutura de ruleset representa todas as versões do ruleset especificado, começando com a versão listada e seguindo até a versão secundária e de patch da versão principal especificada.

Cada versão de um aplicativo contém uma estrutura de ruleset exclusiva. A estrutura de ruleset permite que um aplicativo atualizado referencie novas versões do ruleset que contêm atualizações e novos recursos.

Por exemplo, Bob é um desenvolvedor que trabalha na primeira versão de um aplicativo para gerenciar relatórios de despesas. Bob cria regras para a primeira versão do aplicativo, como processos, IUs e notificações. Ele coleta essas regras na primeira versão do ruleset Despesa (Expense), Despesa:01-01-01. Após várias interações de implementação em um ambiente de QC e correções de bugs, o ruleset Despesa é compilado em várias versões até 01-01-05, antes de ser enviado para produção.

Meses depois, Tânia recebe uma solicitação de aprimoramento para atualizar a IU no aplicativo para coletar informações adicionais dos funcionários devido a uma mudança de política. Essa atualização aprimora as regras criadas anteriormente por Bob. Tânia cria regras para modelar esse novo comportamento em uma segunda versão do ruleset, Despesa:01-02-01. Em seguida, ela usa o ruleset Despesa:01-02-01 no aplicativo de relatórios de despesas atualizado.

Na imagem a seguir, clique nos ícones + para saber mais sobre as estruturas de ruleset.

Utilize as melhores práticas a seguir ao criar rulesets.

Convenções de nomenclatura

• Para rulesets do aplicativo, use nomes exclusivos que sejam significativos em um contexto de negócios e fáceis de lembrar para transmitir claramente o propósito do ruleset. Por exemplo, em um aplicativo bancário, nomeie seu ruleset como Contas (Accounts) para armazenar regras relacionadas a contas.
• Para rulesets compartilhados, da organização e da divisão, inicie o nome do seu ruleset com uma frase que identifique claramente a sua empresa e o propósito de negócios, evitando usar acrônimos que possam ser difíceis de entender. Por exemplo, nomeie seu ruleset como ContratosTelcoUPlus em vez de CTUP. Essa convenção também evita possíveis conflitos de ruleset.
• Não utilize Pega ou Pega- como prefixo para nomes de rulesets. Esses prefixos estão restritos para uso interno na Pega Platform e podem causar comportamento inesperado.
• Evite utilizar espaços em nomes de rulesets. O tamanho máximo do nome de um ruleset é de 32 caracteres.
• Evite o uso de caracteres especiais como traços (-), sublinhados (_), sinais de soma (+) ou aspas (" "). O sistema não permite salvar regras com esses atributos.

Salvando rulesets

• Evite ter o mesmo ruleset em vários aplicativos. Em vez disso, refatore o ruleset para o próprio aplicativo ou para um aplicativo comum.
• Limite o desenvolvimento a rulesets da camada mais superior do aplicativo e mantenha aplicativos embutidos bloqueados.

Versões de rulesets

• Considere criar uma versão principal do seu aplicativo se você fizer atualização do servidor do seu aplicativo ou do servidor do banco de dados para uma nova versão principal.
• Incremente versões de rulesets com frequência para acompanhar facilmente as atualizações do seu aplicativo ao longo do tempo.
• Crie um novo ruleset com uma classe de nível superior que herde diretamente de @baseclass.

Verifique o seu conhecimento com a seguinte interação: