Conceito: blocos de construção de fórmulas

Termos para descrever fórmulas

Uma fórmula tem:

Operandos: os elementos a serem calculados. Você separa operandos com operadores. Os operandos no Adaptive Planning incluem:

Referências: contas com modificadores, suposições, linhas (colunas de planilhas modeladas).

Constantes: números ou valores de texto que são inseridos diretamente em uma fórmula.

Modificadores: instruções adicionais que especificam a referência a tempo, nível, valor de dimensão ou valor de atributo específicos.

Operadores: especifique o tipo de cálculo a ser executado. Você pode usar:

Símbolos Exemplo: o operador asterisco (*) multiplica números. Você pode localizar a maioria dos símbolos no Assistente de fórmula ou pode digitá-los com o teclado.

Funções: modelos com sintaxe precisa que combinam operandos e operadores. Você deve substituir as variáveis por suas próprias referências, modificadores e expressões. Exemplo: para a função de arredondamento Arredondar (N), substitua N por um cálculo complexo e a função arredonda para o número inteiro mais próximo.

Além disso, estes termos descrevem partes de uma fórmula:

Expressão: descreve uma parte específica de uma fórmula. Exemplo: nesta fórmula lógica Iff ((ACCT.001 > ACCT.002, 1, 0), "ACCT > ACCT.002" é uma expressão.

Termo: a referência, combinada com quaisquer modificadores. Exemplo: ACCT.001 [time = this - 1] é um prazo.

Sintaxe: a maneira como você deve fazer referência aos dados no seu modelo para criar uma fórmula válida. Exemplo: para fazer referência a uma conta, a sintaxe é ACCT.<account_code>.

Notação de ponto: um conjunto avançado de regras de sintaxe que apontam para elementos do seu modelo e permitem funcionalidade adicional. O principal caso de uso da notação de ponto são as instruções Iff. Exemplo: você pode adicionar this.Month.NumberOfDays < 30 a uma instrução Iff para aplicar um cálculo diferente para o mês de fevereiro.

Noções básicas sobre sintaxe na documentação

Algumas observações sobre sintaxe na documentação:

Usamos letras maiúsculas entre parênteses, como (N) ou texto dentro de divisas, como <account_code> para indicar variáveis. Você deve substituir as variáveis por constantes, referências de conta ou expressões de fórmula válidas.

Usamos vírgulas para separar os termos, de acordo com o padrão de muitos países. Se o seu navegador usa vírgulas como pontos decimais, você deve separar os termos com ponto e vírgula.

Adicionamos espaços para facilitar a leitura das fórmulas, embora não sejam necessários. Você também pode adicionar espaços ou omiti-los nas fórmulas.

Usamos maiúsculas em funções, como Divf, e usamos tudo em maiúsculas para elementos, como ACCT, mas as fórmulas não diferenciam maiúsculas de minúsculas.

Exemplo: a sintaxe para adicionar um modificador de nível a uma conta é ACCT.<code> [level = <level_code>]. Você deve:

Usar ACCT. para fazer referência a uma conta.

Substitua <code> por um código de conta real. Certifique-se de remover as divisas também.

Use colchetes para definir os modificadores.

Use level = para modificar por nível.

Substitua <level_name> pelo código real de um nível e remova as divisas.

Operandos: referências e constantes

As referências são um tipo de operando. No Adaptive Planning, a referência extrai um valor de outro local do modelo para a fórmula. Exemplo: você pode fazer referência a uma conta. A referência de conta incorpora o valor dessa conta para uma versão, um nível e um tempo específicos. Você pode adicionar estas referências básicas às fórmulas:

Referência	Sintaxe	Exemplo
Contas do livro-razão, personalizadas ou de métrica.	ACCT.<AccountCode>	ACCT.6113 Em que 6113 é o código da conta.
Contas de cubo e modeladas.	ACCT.<SheetCode.AccountCode>	ACCT.RevenueCube.003 Em que RevenueCube é o código da planilha e 003 é o código da conta.
Contas de suposição	ASSUM.<AccountCode>	ASSUM.123 Em que 123 é o código da conta.
Colunas em uma planilha modelada Disponível somente para contas calculadas modeladas.	ROW.<column_code>	ROW.StartDate Em que StartDate é o código da coluna para o campo Data de início na planilha modelada.
Consultas de valores e de valores difundidos em planilhas modeladas Disponível somente para contas calculadas modeladas.	ROW.<lookup_name>	Row.BenefitLookup Em que BenefitLookup é o nome da tabela de consulta de valores.
Constantes	Qualquer número	500

Você também pode fazer referência a células em uma planilha usando o método de captura, que preenche a fórmula com a conta e quaisquer modificadores presentes, como tempo e níveis. Consulte Conceito: digitação de fórmulas básicas em células de planilha.

Modificadores

Você pode adicionar precisão com modificadores quando faz referência a uma conta ou linha. Os modificadores localizam uma fatia específica dos dados da conta. Exemplo: você quer o valor de uma conta para um nível ou período específico.

Você adiciona modificadores:

Ao lado da referência da conta, sem espaços.

Dentro de colchetes.

Separadas por vírgula ou ponto e vírgula se você usar vírgulas para casas decimais.

Usando os códigos e nomes exatos que existem no seu modelo.

Modificador	Sintaxe	Exemplo
Tempo	[time = <strata_code>]	ACCT.001 [time = 2023] Em que 2023 são os estratos de consolidação do ano. Obtém o valor consolidado de 2023 da conta.
Níveis	[level = <level_code>]	ACCT.001 [level = Sales] Em que vendas é o código do nível. Obtém o valor da conta somente no nível Vendas.
Dimensão personalizada	[<dimension_code> = <dimension_value_code>]	ACCT.001 [produto = camisetas] Em que produto é o código da dimensão e camisetas é o código do valor da dimensão. Obtém os dados da conta marcados com camisetas.
Atributos	[<attribute_code> =<attribute_value_code>]	ACCT.001 [productgroup = tops] Em que productgroup é o atributo da dimensão Produto e tops é o valor do atributo. Extrai os dados da conta marcados com quaisquer valores de dimensão que correspondam ao valor de atributo superior.
Vários modificadores	[<modifier1> = <code>, <modifier2> = <code>, <modifier3> = <code>]	ACCT.001 [tempo = 2023, nível = Vendas, produto = Camisetas] Obtém a consolidação por tempo de 2023 para o nível Vendas de Camisetas.

Você pode ter vários modificadores por referência, mas só pode ter um valor por modificador. Então, quando você quer obter o valor de mais de um nível:

Incorreto: ACCT.001 [level = Sales, Marketing]

Incorreto: ACCT.001 [level = Sales, level = Marketing]

Correto: ACCT.001 [level = Sales] + ACCT.001 [level = Marketing]

Adicionar um modificador pode ser tudo o que você precisa fazer para uma fórmula inteira.

Operadores: símbolos matemáticos comuns

Operadores são símbolos matemáticos que fornecem cálculos. Você pode usar fórmulas matemáticas básicas com as teclas do teclado. No Assistente de fórmula, o primeiro conjunto de botões na barra de ferramentas fornece operadores matemáticos simples que você pode inserir na fórmula entre os termos.

Os operandos mais simples das fórmulas matemáticas são números. Os operadores mais simples são aqueles que você encontra no teclado. Você não precisa de espaços entre operandos e operadores, mas pode adicioná-los para facilitar a leitura da fórmula. Você também pode transformar cálculos simples em fórmulas mais complexas que fazem referência a contas e modificadores.

Aqui estão alguns exemplos de fórmulas matemáticas simples que você pode usar:

Operador matemático	Exemplo de fórmula
Soma (+)	ACCT.001 + ACCT.002
Subtração (-)	ACCT.001 - ACCT.002
Multiplicação (*)	ACCT.001 * ACCT.002
Divisão (Divf)	Divf (ACCT.001, ACCT.002) Divide ACCT.001 (o dividendo) por ACCT.002 (o divisor)
Módulo (%)	10 % 3 Calcula o restante do quociente. Retorna 1 porque 10 dividido 3 = 3 restante 1.
Parêntese ()	(ACCT.001 + ACCT.002) * 12 Determina a ordem da operação: some as contas antes de multiplicar por 12.
Round(N)	Arredondar (ACCT.001) Arredonda para o número inteiro mais próximo. No exemplo, se o valor de ACCT.001 é 5,75, a fórmula retorna 6.

Funções de fórmula

Uma função de fórmula é um modelo que usa diferentes operadores e variáveis. Quando você usa uma função, substitui as variáveis por referências, constantes ou expressões de fórmula completas. As funções raramente funcionam sozinhas; em vez disso, você encadeia funções para criar sua fórmula.

Exemplo: para a conta Despesas, você quer usar o valor do ano passado e aplicar uma taxa de inflação que normalmente armazena em uma conta de suposição. Para evitar fazer referência a células em branco, você pode criar uma instrução IF usando uma instrução lógica. O modelo fica assim: Iff (EXPR, T, F).

Veja como você pode usar a função para criar fórmulas:

Substituir a variável	Exemplo	Descrição
Substitua EXPR pela função lógica IsBlank, criando uma função dentro de uma função.	Iff (isBlank (N) , T, F)	A constante ou a constante na qual os cálculos de Verdadeiro e Falso se baseiam.
Substitua N pela suposição de Taxa de inflação, que tem o código de conta: infl.	Iff (isBlank (ASSUM.Infl ), T, F)	Se a suposição de Taxa de inflação estiver em branco...
Substitua T por um cálculo que seja acionado se EXPR for verdadeiro.	Iff (isBlank (ASSUM.Infl), *ACCT.this [time = this - 12] (1,05)** , F)	Se a suposição de Taxa de inflação estiver em branco, use o valor dessa conta de 12 meses atrás e multiplique por 1,05.
Substitua F por um cálculo que seja acionado se EXPR for falso.	Iff (isBlank (ASSUM.Infl), ACCT.this [time = this - 12] * (1,05), *ACCT.this [time = this - 12] ASSUM.Infl** )	Se a suposição de Taxa de inflação não estiver em branco, use o valor dessa conta de 12 meses atrás e multiplique-o pela suposição de Taxa de inflação.

No Assistente de fórmula, categorizamos as funções de fórmula nestes grupos:

Matemática

Lógica

Data

Cadeia de caracteres

Você pode selecionar uma categoria e preencher previamente o campo de fórmula com os modelos disponíveis. Consulte Referência: funções de fórmula.

Posicionamento na grade

Existe uma fórmula na grade do Adaptive Planning. Uma planilha comum tem dois eixos: contas e tempo. As contas estão nas linhas e o tempo está na coluna. Cada célula representa uma interseção específica entre a conta e o período.

No Adaptive Planning, a grade é multidimensional, o que significa que há mais de dois eixos além da planilha bidimensional que você vê na tela. Exemplo: os dados de Receita existem na interseção do nível Vendas, a versão Orçamento 2025, a conta Receita na hierarquia do livro-razão, o valor da dimensão personalizada Produto, Camisetas, o período temporal de janeiro de 2025 e assim por diante. Quando você faz referência a um ponto de dados em uma fórmula, está se referindo a cada um dos eixos ou dimensões. A menos que você especifique a dimensão, determinados valores por padrão se aplicam, com base na localização da fórmula. Essas dimensões contribuem para cada interseção de dados:

Dimensão	Valor por padrão na referência
Tempo e nível	O mesmo que o local atual, a menos que você modifique sua referência com base em tempo ou nível. Exemplo: uma fórmula para ACCT.001 é ACCT.002 * 10. Para janeiro de 2024, a fórmula usa o valor de ACCT.002 de janeiro de 2024. Para fevereiro de 2024, ele usa o valor de 24 de fevereiro e assim por diante, a menos que você especifique algo diferente para o tempo na fórmula. O mesmo se aplica aos níveis. Os cálculos extraem os valores no mesmo nível que está sendo calculado no momento.
Moeda	A moeda definida do nível atual.
Conta	A conta atual, a menos que você faça referência a outra conta.
Cada dimensão personalizada	O valor da dimensão no local atual. Se não houver valor de dimensão no local atual, o valor por padrão será Sem categoria.