Adicionar regras de lógica a formulários e campos personalizados
As informações destacadas nesta página referem-se a funcionalidades que ainda não estão disponíveis. Ele está disponível somente no ambiente de Pré-visualização da Sandbox.
As regras lógicas permitem personalizar ainda mais os campos no formulário.
Por exemplo, você pode exibir ou ignorar campos ou seções em um formulário personalizado com base nas escolhas que um usuário faz ao preenchê-lo.
Requisitos de acesso
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacote do Adobe Workfront |
Para aplicar a exibição avançada, o valor padrão, a formatação condicional ou a lógica de capacidade de edição: Workflow Prime ou superior Para aplicar todos os outros tipos lógicos: qualquer pacote de Workfront ou Workflow |
| Licença do Adobe Workfront |
Padrão Plano |
| Configurações de nível de acesso | Acesso administrativo a formulários personalizados |
Para obter informações, consulte Requisitos de acesso na documentação do Workfront.
Ícones de indicador lógico
Os formulários personalizados exibem ícones para indicar quando a lógica é aplicada aos campos.
Clique em Mostrar lógica no cabeçalho do designer de formulário para mostrar ou ocultar os ícones dos diferentes tipos de lógica de campo.
Para lógica de exibição e de salto somente, selecione um campo para mostrar as regras de lógica existentes nas configurações do campo.
Considerações sobre o uso da lógica de exibição e da lógica de salto
-
Para adicionar lógica de exibição em um campo personalizado, widget ou quebra de seção, pelo menos um campo de múltipla escolha (botões de opção, lista suspensa ou caixas de seleção) deve ser posicionado antes dele no formulário.
Para obter informações sobre campos e widgets personalizados em formulários personalizados, consulte Criar um formulário personalizado. -
Não é possível adicionar lógica de salto a um widget ou quebra de seção. Você pode adicioná-lo somente a um campo de múltipla escolha (botões de opção, lista suspensa ou caixas de seleção).
-
Não é possível aplicar a exibição ou a lógica de salto para mostrar ou ocultar as opções de um campo de várias opções. Por exemplo, você não pode restringir as opções exibidas para um campo Suspenso, Grupo de caixas de seleção ou Botão de opção, com base na exibição ou na lógica de ignorar outro campo.
-
Você pode adicionar a lógica de exibição e a lógica de salto a um campo personalizado se todos os itens a seguir forem verdadeiros sobre o campo personalizado:
- É um campo de múltipla escolha (botões de opção, lista suspensa ou caixas de seleção)
- É precedido por um campo de múltipla escolha
- Ele é seguido por outro campo personalizado
-
Ao copiar formulários com lógica de exibição ou lógica de salto, a lógica é copiada para o novo formulário personalizado.
-
Ao editar objetos em massa, todos os campos personalizados são exibidos na caixa Editar objetos, incluindo os campos que são ignorados ou ocultos.
-
Lembre-se do seguinte ao criar uma regra de lógica de exibição para um formulário personalizado:
- Campos personalizados não incluídos em uma instrução lógica de exibição são exibidos em um formulário personalizado por padrão.
- Você pode criar instruções lógicas de exibição de vários campos.
- Se todos os campos em uma quebra de seção tiverem lógica de exibição aplicada a eles e todos estiverem ocultos como resultado da lógica, a seção inteira será ocultada no formulário personalizado.
Adicionar lógica de exibição a um formulário personalizado
A lógica de exibição define quais campos personalizados aparecem no formulário quando o usuário seleciona um valor específico em um campo de múltipla escolha. A lógica é adicionada ao campo de destino, que é exibido somente quando o valor é selecionado.
-
Clique no ícone Menu Principal
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário. Pelo menos um campo de múltipla escolha (botão de opção, lista suspensa ou caixa de seleção) deve ser posicionado antes do campo de destino que será exibido.
-
Selecione o campo de destino e clique em Adicionar Lógica.
-
Selecione a guia Exibição no construtor de lógica.
-
Clique em Adicionar Regra de Exibição.
-
Siga as etapas abaixo para criar a instrução lógica no construtor.
-
A primeira opção é escolher o campo de definição. Este é o campo com o valor de seleção que exibe o target. Deve ser um campo de múltipla escolha.
-
A segunda opção é escolher o valor de seleção. Somente os valores já definidos para esse campo estão disponíveis.
-
A terceira opção é Selecionado ou Não Selecionado. Escolher Selecionado significa que, quando o valor for selecionado, o campo de destino será exibido. Escolher Não selecionado significa que quando qualquer outro valor é selecionado no campo de definição, o campo de destino é exibido.
-
Para adicionar uma regra And à instrução lógica, clique em Adicionar Regra diretamente abaixo da regra que você acabou de criar. Siga os mesmos prompts para criar a regra. Todas as regras And devem ser atendidas para que o campo de público alvo seja exibido.
-
Para adicionar uma regra Or à instrução lógica, clique em Adicionar regra próximo à parte inferior do construtor de lógica. Em seguida, clique em Adicionar regra dentro da área Ou e siga os mesmos prompts para criar a regra. Quando uma regra Ou é atendida, o campo de destino é exibido.
-
-
Clique em Aplicar quando terminar de criar a instrução lógica.
Os ícones de lógica de exibição são adicionados ao campo de destino e ao campo de definição no designer do formulário.
Adicionar lógica de exibição avançada a um formulário personalizado
A lógica de exibição avançada para campos de formulário personalizados permite criar lógica complexa usando fórmulas. É possível aplicar essa lógica aos seguintes tipos de campo: texto de linha única, parágrafo, texto com formatação, lista suspensa de seleção única, lista suspensa de seleção múltipla, pesquisa externa, pesquisa externa de seleção múltipla, referência de campo nativo, digitação antecipada, calculada, data, grupo de caixas de seleção e botões de opção.
Exemplos
Você pode usar a lógica de exibição avançada para controlar a visibilidade de seções de formulário personalizadas com base em funções de usuário e a visibilidade de um campo com base no status de outro campo.
Nenhuma lógica é aplicada à seção padrão no formulário, portanto, ela é sempre visível para todos os usuários.
Usando a condição a seguir, a seção Recursos Necessários só é exibida quando um usuário com a função de trabalho de Gerenciador de Recursos visualiza o formulário.
IF($$USER.{roleID}="123abc", true)
Observe que 123abc representa a ID de função do Gerenciador de Recursos.
A mesma condição com uma ID de função diferente é aplicada à seção KPIs Financeiros do Projeto para definir que somente a função Supervisor Financeiro possa exibir a seção.
Usando a condição a seguir, o campo KPI Vendido só ficará visível quando o projeto for concluído. Essa lógica é aplicada diretamente ao campo, em vez de a uma seção de formulário. Não há necessidade de especificar qual função pode exibir o campo, pois ele já está definido na seção em que o campo está.
IF({status}="CPL", true)
Definir lógica de exibição avançada
-
Clique no ícone Menu Principal
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário.
-
Selecione o campo ao qual aplicar lógica e clique em Adicionar Lógica.
-
Selecione a guia Exibição no construtor de lógica.
-
Ative o Modo avançado.
Essa opção pode ser ativada automaticamente em campos que não oferecem suporte ao modo simples da lógica de exibição.
-
Crie a condição de exibição no editor.
Para obter mais informações sobre cálculos e expressões, consulte Adicionar campos calculados a um formulário e Visão geral de expressões de dados calculadas.
-
Clique em Aplicar.
A lógica é aplicada ao campo e o ícone da lógica de exibição é adicionado no designer do formulário.
note note NOTE A lógica de exibição avançada não é compatível com o modo de visualização do designer de formulário.
Adicionar lógica de salto a um formulário personalizado
A lógica de salto define campos de formulário personalizados que são ignorados quando o usuário seleciona um valor específico em um campo de múltipla escolha. Os campos ignorados estão ocultos no formulário. A lógica é aplicada ao campo de definição onde a seleção é feita, não aos campos que são ignorados.
-
Clique no ícone Menu Principal
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário. O campo de definição para a lógica de salto deve ser um campo de múltipla escolha (botão de opção, lista suspensa ou caixa de seleção).
-
Selecione o campo de definição e clique em Adicionar lógica no canto inferior esquerdo da tela.
-
Selecione a guia Ignorar no construtor de lógica.
-
Clique em Adicionar Regra de salto.
-
Siga as etapas abaixo para criar a instrução lógica no construtor.
-
O campo de definição é mostrado no construtor. É o campo que você selecionou para aplicar a lógica de salto.
-
A primeira opção é escolher o valor da seleção. Somente os valores já definidos para o campo estão disponíveis.
-
A segunda opção é Selecionada ou Não Selecionada. Escolher Selecionado significa que quando o valor é selecionado, o campo de destino é exibido e os campos intermediários são ignorados. Escolher Não selecionado significa que quando qualquer outro valor é selecionado no campo de definição, o campo de destino é exibido e os campos intermediários são ignorados.
-
A terceira opção é o campo de destino ou para onde pular. Selecione um nome de campo ou Fim do formulário. Talvez seja necessário clicar na palavra "vazio" primeiro antes de selecionar uma opção.
-
Para adicionar uma regra Or à instrução lógica, clique em Adicionar regra próximo à parte inferior do construtor de lógica. Em seguida, selecione as opções seguindo os mesmos prompts para criar a regra. Quando uma regra Or é atendida, o campo de destino é exibido.
-
-
Clique em Aplicar quando terminar de criar a instrução lógica.
Os ícones de lógica de salto são adicionados ao campo de destino e ao campo de definição no designer do formulário.
Adicionar lógica de valor padrão a um formulário personalizado
A lógica do valor padrão permite configurar valores padrão para campos de formulário personalizados, usando fórmulas. O valor padrão é exibido quando as condições definidas são atendidas. Um valor padrão pode ser um valor estático ou dinâmico que faz referência a outros campos no objeto. Embora o valor padrão possa fazer referência a outros campos, ele não será alterado à medida que outros campos no formulário forem alterados.
Você pode aplicar lógica avançada de valor padrão aos seguintes tipos de campo: texto de linha única, parágrafo, lista suspensa de seleção única, lista suspensa de seleção múltipla, pesquisa externa, pesquisa externa de seleção múltipla. referência de campo nativo, digitação antecipada, grupo de caixas de seleção e botões de opção.
Exemplo
Usando a fórmula a seguir, o campo suspenso de várias seleções ao qual a lógica é aplicada obterá seu valor padrão da descrição do projeto quando o status do projeto for Planning.
IF({status} = 'PLN', ARRAY({description}, ','))
Quando o formulário personalizado é anexado a um projeto e o status do projeto é Planning, o valor do campo de descrição do projeto é usado como o valor padrão no campo de seleção múltipla. Como é um campo de seleção múltipla, mais de um valor pode ser extraído quando os valores correspondem à descrição. Se o valor da descrição não corresponder a nenhuma das opções de valor de seleção múltipla, o campo de seleção múltipla não terá um valor padrão e o usuário poderá selecionar um valor na lista suspensa.
Definir a lógica do valor padrão
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário.
-
Selecione o campo ao qual aplicar lógica e clique em Adicionar Lógica.
-
Selecione a guia Valor padrão no construtor de lógica.
-
Crie a condição de valor padrão no editor.
Para obter mais informações sobre cálculos e expressões, consulte Adicionar campos calculados a um formulário e Visão geral de expressões de dados calculadas.
-
Clique em Aplicar.
A lógica é aplicada ao campo no designer do formulário.
note note NOTE A lógica de valor padrão não tem suporte no modo de visualização do designer de formulário.
Adicionar lógica de validação a um formulário personalizado
A lógica de validação é criada usando fórmulas e você pode tornar a lógica tão simples ou complexa quanto necessário. A validação pode ser baseada nos valores de outros campos ou no status dos objetos, e você pode fornecer uma mensagem de erro para quando a validação falhar.
Se o campo com a lógica aplicada atender às condições de validação definidas quando um usuário preencher o formulário personalizado, o campo será realçado e a mensagem de erro será exibida.
Você pode aplicar a lógica de validação aos seguintes tipos de campo: texto de linha única, parágrafo, lista suspensa de seleção única, lista suspensa de seleção múltipla, pesquisa externa, pesquisa externa de seleção múltipla, digitação antecipada, data, grupo de caixas de seleção e botões de opção.
Exemplos
Usando a condição a seguir, o campo Budget exibe uma mensagem abaixo do campo quando o usuário insere um valor que aciona a mensagem. Por exemplo, se o valor inserido for negativo, a primeira mensagem será exibida. Se o usuário tentar alterar o status do projeto para Atual antes de inserir um valor de orçamento, a segunda mensagem será exibida.
IF({DE:Budget Field} < 0,
"Budget cannot be negative",
IF({DE:Budget Field} == 0 && {status} == "CUR", "Budget must be specified before moving to Current status")
)
Outro exemplo simples é que um campo de número de telefone deve conter um determinado número de dígitos para ser válido.
Um exemplo adicional para validação com base em outros campos é um campo para tamanho da sala de reunião (pequeno, médio ou grande) e um campo separado para o número de participantes da reunião. O número de pessoas para cada tamanho de quarto é escrito na fórmula de validação. Se o número de participantes que o usuário digita for muito grande para a sala de reunião escolhida, a mensagem de erro será exibida.
Para obter mais exemplos de lógica de validação, consulte Exemplos de lógica avançada em formulários personalizados.
Definir lógica de validação
-
Clique no ícone Menu Principal
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário.
-
Selecione o campo ao qual aplicar lógica e clique em Adicionar Lógica.
-
Selecione a guia Validação no construtor de lógica.
-
Crie a condição de validação no editor, incluindo a mensagem de erro a ser exibida quando a validação não for atendida.
Para obter mais informações sobre cálculos e expressões, consulte Adicionar campos calculados a um formulário e Visão geral de expressões de dados calculadas.
-
Clique em Aplicar.
A lógica é aplicada ao campo no designer do formulário.
note note NOTE Não há suporte para a lógica de validação no modo de visualização do designer de formulário.
Adicionar lógica de formatação a um formulário personalizado
A lógica de formatação destaca um valor de campo quando atende às condições definidas. A formatação aplicada funcionará em vários campos de uma só vez.
Você pode aplicar lógica de formatação aos seguintes tipos de campo: texto de linha única, parágrafo, lista suspensa de seleção única, lista suspensa de seleção múltipla, pesquisa externa, pesquisa externa de seleção múltipla, digitação antecipada, calculada, data, grupo de caixas de seleção e botões de opção.
A formatação aplicada aos formulários personalizados é separada da formatação aplicada a listas e relatórios. Para obter informações sobre a formatação do relatório, consulte Usar formatação condicional nas exibições.
Exemplo
Usando a condição a seguir, o campo Budget aparece em vermelho quando o usuário insere um valor de 1000 ou mais. O campo aparece em amarelo quando o usuário insere um valor de 500 ou mais.
Para adicionar uma definição de sobreposição da formatação, use o campo Instruções no formulário personalizado. Por exemplo, uma mensagem no campo Orçamento poderia dizer "Insira um orçamento dentro de um intervalo razoável. Valores acima de 500 são avisos de advertência e acima de 1000 são considerados muito altos."
IF(
{DE:Budget Field} >=1000,
FORMAT($$NEGATIVE),
IF({DE:Budget Field} >= 500, FORMAT($$NOTICE))
)
Definir lógica de formatação
-
Clique no ícone Menu Principal
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário.
-
Selecione o campo ao qual aplicar lógica e clique em Adicionar Lógica.
-
Selecione a guia Formatação no construtor de lógica.
-
Crie a condição de formatação no editor.
Você pode adicionar até cinco regras de formatação por campo.
As opções de cor de realce do campo são:
$$POSITIVE (green)$$INFORMATIVE (blue)$$NEGATIVE (red)$$NOTICE (orange)
As opções de formatação de texto são:
$$BOLD$$ITALIC$$UNDERLINE
Somente uma opção de cor pode ser usada por função, juntamente com até três opções adicionais de formatação de texto. Se nenhuma opção de cor for especificada, a cor padrão do sistema será aplicada.
Para obter mais informações sobre cálculos e expressões, consulte Adicionar campos calculados a um formulário e Visão geral de expressões de dados calculadas.
-
Clique em Aplicar.
A lógica é aplicada ao campo no designer do formulário.
note note NOTE A lógica de formatação não tem suporte no modo de visualização do designer de formulário.
Adicionar lógica de editabilidade a um formulário personalizado
A lógica da capacidade de edição determina se um campo de formulário personalizado pode ser editado ou se é somente leitura. Essa lógica é criada usando fórmulas e, quando o campo atende às condições definidas, pode ser definido como editável ou somente leitura.
Você pode aplicar lógica de editabilidade aos seguintes tipos de campo: texto de linha única, parágrafo, texto com formatação, lista suspensa de seleção única, lista suspensa de seleção múltipla, pesquisa externa, pesquisa externa de seleção múltipla, digitação antecipada, data, grupo de caixas de seleção e botões de opção.
Exemplo
Usando a fórmula a seguir, o campo com lógica aplicada só poderá ser editado quando outro campo chamado Rádio tiver a opção Ativado selecionada.
IF({DE:Radio} = "Enabled", true)
Usando a fórmula a seguir, o campo Descrição só poderá ser editado quando estiver em branco. Depois que um valor é inserido, ele se torna somente leitura.
IF(ISBLANK({DE:Description}), true)
Usando a fórmula a seguir, o campo com lógica aplicada só poderá ser editado quando um usuário com a função de trabalho de Gerenciador de Recursos visualizar o formulário.
IF($$USER.{role}.{name}="Resource Manager", true)
Definir lógica de editabilidade
-
Clique no ícone Menu Principal
-
Clique em Forms Personalizado.
-
Crie um novo formulário personalizado ou abra um formulário existente. Consulte Criar um formulário personalizado para obter detalhes.
-
Adicione campos ao formulário conforme necessário.
-
Selecione o campo ao qual aplicar lógica e clique em Adicionar Lógica.
-
Selecione a guia Editabilidade no construtor de lógica.
-
Crie a condição de editabilidade no editor.
Para obter mais informações sobre cálculos e expressões, consulte Adicionar campos calculados a um formulário e Visão geral de expressões de dados calculadas.
-
Clique em Aplicar.
A lógica é aplicada ao campo no designer do formulário.
note note NOTE A lógica de capacidade de edição não é compatível com o modo de visualização do designer de formulário.