Criar e editar regras de negócios
As informações destacadas nesta página referem-se a funcionalidades que ainda não estão disponíveis. Ela está disponível somente no ambiente de Pré-visualização para todos os clientes. Depois das versões mensais para produção, os mesmos recursos também ficam disponíveis no ambiente de produção para clientes que ativaram versões rápidas.
Para obter informações sobre versões rápidas, consulte Habilitar ou desabilitar versões rápidas para sua organização.
Uma regra de negócios permite aplicar validação a objetos do Workfront e impede que os usuários criem, editem ou excluam um objeto quando determinadas condições forem atendidas. As regras de negócios ajudam a melhorar a qualidade dos dados e a eficiência operacional, evitando ações que podem comprometer a integridade dos dados.
Uma única regra de negócios pode ser atribuída a apenas um objeto. Por exemplo, se você criar uma regra de negócios para não editar projetos sob determinadas condições, não poderá aplicar a mesma regra a tarefas. Seria necessário criar uma regra de negócios separada com as mesmas condições para tarefas.
Os níveis de acesso e o compartilhamento de objetos têm uma prioridade mais alta do que as regras de negócios quando um usuário interage com um objeto. Por exemplo, se um usuário tiver um nível de acesso ou permissão que não permita a edição de um projeto, eles terão precedência sobre uma regra de negócios que permita a edição de um projeto sob determinadas condições.
Quando mais de uma regra de negócios se aplica a um objeto, as regras são todas seguidas, mas não são aplicadas em uma determinada ordem. Por exemplo, você tem duas regras de negócios. Restringe-se a criação de despesas no mês de fevereiro. O segundo impede a edição de um projeto quando o status do projeto é Concluído. Se um usuário tentar adicionar uma despesa a um projeto concluído em junho, a despesa não poderá ser adicionada porque acionou a segunda regra.
As regras de negócios se aplicam à criação, edição e exclusão de objetos por meio da API e da interface do Workfront.
Requisitos de acesso
Você deve ter o seguinte para executar as etapas deste artigo:
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| plano do Adobe Workfront | Ultimate |
| Licença do Adobe Workfront | Padrão |
| Configurações de nível de acesso | Administrador do sistema |
Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação do Workfront.
Cenários de regras de negócios
O formato de uma regra de negócios é "Se a condição definida for atendida, o usuário será impedido de realizar a ação no objeto e a mensagem será exibida".
A sintaxe das propriedades e outras funções em uma regra de negócios é igual à sintaxe de um campo calculado em um formulário personalizado. Para obter mais informações sobre a sintaxe, consulte Adicionar campos calculados com o designer de formulário.
Para obter informações sobre instruções IF, consulte a visão geral das instruções "IF" e os Operadores de condição em campos personalizados calculados.
Para obter informações sobre curingas baseados no usuário, consulte Usar curingas baseados no usuário para generalizar relatórios.
Para obter informações sobre curingas baseados em data, consulte Usar curingas baseados em data para generalizar relatórios.
Um curinga de API também está disponível nas regras de negócios. Você pode usar $$ISAPI para acionar a regra somente na interface ou somente na API.
Os curingas $$BEFORE_STATE e $$AFTER_STATE são usados em expressões para acessar os valores de campo do objeto antes e depois de qualquer edição.
- Esses curingas estão disponíveis para o acionador de edição. O estado padrão do acionador de edição (se nenhum estado for incluído na expressão) é
$$AFTER_STATE. - O acionador de criação de objeto permite apenas
$$AFTER_STATE, pois o estado anterior não existe. - O gatilho de exclusão de objeto permite apenas
$$BEFORE_STATE, pois o estado posterior não existe.
Alguns cenários simples de regras de negócios são:
- Os usuários não podem adicionar novas despesas durante a última semana de fevereiro. Esta fórmula pode ser declarada como:
IF(MONTH($$TODAY) = 2 && DAYOFMONTH($$TODAY) >= 22, "You cannot add new expenses during the last week of February.") - Os usuários não podem editar o nome de um projeto com o status Concluído. Esta fórmula pode ser declarada como:
IF({status} = "CPL" && {name} != $$BEFORE_STATE.{name}, "You cannot edit the project name.")
Um cenário com instruções IF aninhadas é:
Os usuários não podem editar projetos concluídos e não podem editar projetos com uma Data de conclusão planejada para março. Esta fórmula pode ser declarada como:
IF(
$$AFTER_STATE.{status}="CPL",
"You cannot edit a completed project",
IF(
MONTH({plannedCompletionDate})=3,
"You cannot edit a project with a planned completion date in March")
)
Adicionar uma nova regra de negócios
-
Clique no ícone Menu Principal
-
Clique em Regras de Negócios no painel esquerdo.
-
Clique em Nova regra de negócio.
-
Selecione o tipo de objeto ao qual atribuir a regra de negócios e clique em Continuar.
-
Digite o Nome da regra de negócios.
-
No campo Está ativo, selecione se a regra deve estar ativa ao salvá-lo.
Se você selecionar Não, a regra será salva como inativa e você poderá ativá-la mais tarde.
-
Selecione um Acionador para a regra de negócios. As opções são:
- Na criação do objeto: a regra é aplicada quando um usuário tenta criar um objeto.
- Na edição do objeto: a regra é aplicada quando um usuário tenta editar um objeto.
- Na exclusão de objeto: a regra é aplicada quando um usuário tenta excluir um objeto.
-
(Opcional) Insira uma Descrição da regra de negócios e o que acontece quando ela é aplicada.
-
Crie a fórmula no editor de fórmulas, no centro da caixa de diálogo de regra de negócios.
O formato de uma regra de negócios é "Se a condição definida for atendida, o usuário será impedido de realizar a ação no objeto e a mensagem será exibida".
Na área da fórmula, as partes da regra de negócios criadas são a condição e a mensagem exibida no Workfront quando a condição é atendida.
-
O "objeto" é o tipo de objeto selecionado ao criar a regra de negócios. Ele é exibido no cabeçalho da caixa de diálogo.
-
A "ação" é o acionador selecionado para a regra: criar, editar ou excluir o objeto.
-
Como o objeto e a ação já estão definidos, você não os inclui na fórmula.
-
A mensagem de erro personalizada é exibida ao usuário quando ele aciona a regra de negócios. Ele deve fornecer instruções claras sobre o que deu errado e como corrigir o problema.
Você pode incluir uma URL estática na mensagem de erro, para vincular à documentação ou outras páginas úteis para orientar o usuário sobre como modificar sua ação dentro da restrição da regra.
Neste exemplo, "Saiba mais" será vinculado à URL.
"You are not allowed to add a new project in November.[Learn more](http://url)"A URL deve estar entre parênteses, mas o texto do link entre parênteses não é necessário. Você pode exibir a URL completa e ela será um link clicável.
Este exemplo é uma regra de negócios para projetos. Se o mês atual for novembro, os usuários não poderão criar novos projetos e a mensagem explica isso.
Para obter mais exemplos de regras de negócios, consulte Cenários para regras de negócios neste artigo.
-
-
(Opcional) Use a fórmula Expressões e Campos no painel direito para auxiliar na criação da regra.
Procure por uma expressão ou campo para restringir a lista de itens disponíveis.
A lista de campos disponíveis é limitada aos campos relacionados ao tipo de objeto da regra de negócios.
-
Clique em Salvar quando terminar de criar a regra de negócios.
Ativar uma regra de negócios
Quando uma regra de negócios está inativa, o campo Está Ativo na lista de regras de negócios exibe Falso. Não é possível atualizar o status da regra na exibição em lista.
Para ativar uma regra de negócios:
- Selecione a regra de negócios na lista de regras e clique no ícone Editar.
- Selecione Sim para Está ativo na caixa de diálogo de regra de negócios.
- Clique em Salvar.