Ir para o conteúdo principal
Documentação
Documentação
Adaptive Planning
Última atualização: 2025-03-14
Definir regras de validação de dados de planilha modelada

Definir regras de validação de dados de planilha modelada

  • Marque a caixa de seleção
    Validações de dados em planilhas
     na página
    Preferências visuais
     de
    Administração
    .
  • Remova todos os espaços dos códigos de coluna em
    Gerenciamento de modelos
     para as colunas que você quer usar em regras de validação.
  • Para usar aplicativos do gerenciador de configuração do Planning para gerenciar planilhas modeladas validadas por dados, selecione
    Plano no Adaptive Planning
     para
    a finalidade
     do seu aplicativo na tarefa
    Gerenciar configuração de planejamento de pessoal
     . Você não pode alterar essa seleção em candidaturas existentes.
  • Segurança: permissão
    Modelo inclui: planilhas, contas, dimensões e fórmulas
     .
Como administrador de modelos, você pode criar regras de validação de dados para dados inseridos pelo usuário em células de planilhas modeladas para garantir:
  • Precisão dos dados
  • Consistência de dados
Você pode aplicar essas regras de validação em:
  • Planilhas modeladas
  • Planilhas modeladas em painéis.
  • Importações de API de dados de planilha modelada.
  • Carregadores de dados do Planning que são importados para planilhas modeladas.
Essas regras se aplicam a todas as versões das planilhas modeladas. Se você cria regras de validação para uma planilha com dados existentes, validamos os dados na próxima vez que você abrir ou atualizar a planilha.
Quando você aciona validações, exibimos:
  • Bordas vermelhas ao redor das linhas que acionam avisos críticos. Não permitimos que você salve a planilha até corrigir os dados inválidos.
  • Bordas laranja ao redor das linhas que acionam avisos flexíveis. Você pode salvar a planilha com esses dados inválidos.
Você pode configurar as validações para exibir um texto de ajuda personalizado para corrigir os dados inválidos. Você também pode filtrar dados inválidos para correções mais rápidas.
  1. Selecione
    Gerenciamento de modelos
     no menu principal.
  2. Para acessar o construtor de planilhas da sua planilha modelada, selecione:
    • Planilhas atribuídas a nível
    • Planilhas atribuídas a usuário
  3. Selecione
    Editar
     ao lado da planilha modelada.
  4. Selecione
    Regras de validação de dados
    .
  5. Durante a criação ou edição de regras de validação, considere:
    Opção Descrição
    Expressão
    Insira sua expressão booliana de notação de ponto de linha manualmente nesse campo ou use o
    Construtor de expressões
    . Quando você faz referência a colunas na sua expressão, use os códigos dessas colunas. Avaliamos seus dados com base nos códigos destas colunas:
    • Colunas de atributos.
    • Colunas de dimensão.
    • Colunas de entrada de dados de saldo inicial, que avaliamos com base no código da conta correspondente.
    • Colunas de entrada de dados do Seletor de texto.
    As regras de validação de dados verificam se os dados estão dentro dos valores aceitáveis dessa expressão. Se os dados estão fora dos valores aceitáveis, acionamos uma violação para essa célula.
    As cadeias de caracteres são automaticamente minúsculas quando você as salva. Esse uso de minúsculas não afeta suas validações porque as cadeias de caracteres não diferenciam maiúsculas de minúsculas.
    Exemplo: sua planilha modelada inclui uma coluna ID de linha e você quer que todas as IDs de linha contenham quatro caracteres. Insira
    Length (ROW.ID) = 4
    .
    Construtor de expressões
    Clique no ícone
    do Construtor de expressões
     para que você possa:
    • Insira sua expressão booliana de notação de ponto de linha manualmente. Você pode consultar as opções disponíveis nos menus suspensos para garantir que inseriu a expressão da fórmula corretamente.
      Exemplo: visualize o menu suspenso
      Coluna
       para garantir que você use os códigos corretos para suas colunas.
    • Use os menus suspensos para inserir as diferentes partes da sua expressão booliana de notação por pontos de linha.
    Texto de ajuda
    Insira um texto de ajuda com menos de 128 caracteres.
    Nome
    Insira um nome de regra com menos de 65 caracteres.
    Tipo
    • Verdadeiro
      : exibimos o erro quando os dados falham nas condições. Exemplo: para uma regra que verifica se a taxa de pagamento é superior a 100.000, exibimos o erro quando a taxa de pagamento é inferior a 100.000.
    • Falso
      : exibimos o erro quando os dados atendem às condições. Exemplo: para uma regra que verifica se a taxa de pagamento é superior a 100.000, exibimos o erro quando a taxa de pagamento é superior a 100.000.
    Ação
    • Crítico
      : exibimos bordas vermelhas ao redor das linhas. Não permitimos que você salve a planilha até corrigir os dados inválidos.
    • Aviso
      : exibimos bordas laranja ao redor das linhas. Você pode salvar a planilha com esses dados inválidos.
  6. (Opcional) Ative ou desative as regras de validação nos menus Mais ações das regras.
    Podem existir somente 15 regras ativas. Você pode usar regras inativas como rascunhos.
Aplicamos validações somente às linhas que exibimos atualmente na sua visualização de planilha. Para salvar uma linha válida quando houver erros críticos, altere a visualização da planilha para filtrar as linhas inválidas e salve.
Se você adiciona, altera ou exclui regras de validação para uma planilha que um usuário já carregou, esse usuário deve atualizar a planilha para aplicar as alterações.
Quando você aciona validações, pode passar o mouse sobre os dados inválidos para visualizar:
  • Se esta é uma validação crítica ou de aviso.
  • O texto de ajuda da validação para essa regra.
Quando você importa dados de planilha modelada usando a API importConfigurableModelData, pode optar por aplicar ou ignorar as regras de validação. Quando você opta por aplicar regras de validação, analisamos os dados e identificamos todas as células que falham nas regras antes da importação. Se houver erros críticos, nós:
  • Não importar.
  • Forneça uma lista de linhas com erros para que você possa acessar sua fonte de dados e corrigir os problemas.
Para usar regras de validação em importações de dados, você deve marcar a caixa de seleção
Validações de dados na importação de dados (requer validações de dados em planilhas)
 na página
Preferências visuais
 de
Administração
.