¶ 1. Resumen
El manual de T6 Planning ofrece una visión integral sobre el uso de fórmulas y funciones en el software, destacando la versatilidad desde cálculos simples hasta operaciones avanzadas. Explora la ejecución automática de fórmulas en respuesta a cambios en los datos, incluyendo la capacidad de ejecución manual mediante un asistente. El capítulo de rendimiento proporciona consejos prácticos para optimizar el uso de fórmulas, identificando cuellos de botella y problemas en ciclos. Además, el manual aborda las funciones disponibles y los tipos de parámetros, buscando proporcionar a los usuarios una comprensión detallada de las propiedades y características de las fórmulas para un uso eficiente en el contexto de T6 Planning.
¶ 2. Fórmulas y Funciones
El módulo de fórmulas permite escribir todas las reglas de negocio según el mapeo creado a partir del modelo en Excel. Siempre que sea posible o necesario, se crearán cuentas de apoyo para demostrar la memoria de cálculo de las cuentas; sin embargo, esto no es una regla y se puede optar por el cálculo directo de una cuenta cuando esta forma sea matemáticamente más optimizada o ya exista una función interna disponible.
¶ 2.1 Visión General
Las fórmulas de T6 Planning son una poderosa herramienta para la ejecución de cálculos sobre los datos del modelo.
T6 Planning permite desde la creación de fórmulas simples con operaciones básicas, hasta fórmulas complejas con condicionales o cálculos avanzados. Además, ofrece al usuario una amplia gama de funciones listas para auxiliar aún más en la elaboración y creación de cálculos complejos. Este manual describe detalladamente las propiedades y características de las fórmulas disponibles en la solución T6 Planning, con el objetivo de proporcionar una mayor comprensión sobre el uso de configuraciones avanzadas.
¶ 3. Fórmulas
¶ 3.1. Visión General
En este tema explicaremos un poco más sobre la estructura y la creación de las fórmulas de T6, sus características y funcionalidades.
Las fórmulas son herramientas sumamente importantes para la realización de cálculos sobre los datos y a través de ellas el T6 hace posible la realización de manipulaciones avanzadas sobre los datos guardados en las tablas de Hechos.
¶ 3.2. Requisitos Previos
Para poder crear, visualizar y ejecutar fórmulas dentro de T6, necesitaremos tener habilitadas las siguientes funcionalidades:
Funcionalidades de usuario
- Gestor:
- Analista:
Funcionalidad de grupo global
¶ 3.2.1. Estructura de las Fórmulas
La estructura básica de una fórmula está compuesta por cuatro etapas de configuración, que se muestran en pestañas en el panel de fórmulas: Fórmula, Alcance, Descriptivo y Datos.
¶ 3.2.2. Fórmula
Es la primera etapa del proceso de creación de la fórmula. De llenado obligatorio; dentro de fórmula, tendremos Aplicación, Tipo, Grupo de fórmulas, Posición, Nombre de la fórmula y Expresión;
-
Aplicación: Campo que informa en qué aplicación se creará la fórmula. Después de la creación no será posible editar esta información;
-
Tipo: Campo de llenado obligatorio donde se selecciona el tipo de la fórmula:
- Especial: Fórmulas que calculam em todo escopo no qual foram configuradas ou quando alterações impactam membros presentes nela;
- In-Memory: Fórmulas que no se persisten en la base de datos. Se calculan solo en el alcance visible al usuario en el formulario o reporte. Son útiles para cálculos puntuales;
-
Grupo de fórmulas: Campo opcional donde seleccionaremos el grupo de la fórmula (funcionalidad para agrupar fórmulas dentro de T6, utilizada para organizar las fórmulas por contexto, categoría o finalidad);
-
Posición: Campo no editable; Indica el posicionamiento de la fórmula en relación con las demás; El posicionamiento se refiere al orden en que se ejecutarán las fórmulas, generado automáticamente por T6 durante la publicación del cubo;
T6 tiene en cuenta las nuevas fórmulas creadas o posibles cambios que hayan ocurrido en las fórmulas ya existentes. Es posible realizar el posicionamiento manual de ordenación de las fórmulas en la Lista de Fórmulas; sin embargo, al publicar el Cubo, T6 las reposicionará según el mejor orden de ejecución.
Ejemplo:
| Posição | Fórmula |
|---|---|
| 1 | [A] = [B] + [C] |
| 2 | [B] = [D] + [E] |
La fórmula de la posición 1 tiene un miembro [B] que es calculado por otra fórmula. Sin embargo, por el ordenamiento, la fórmula que calcula [B] está en la segunda posición. Al publicar el Cubo, T6 automáticamente reposicionará la fórmula [B] = [D] + [E] antes de la fórmula [A] = [B] + [C], ya que solo después de calcular [B] será posible calcular el valor de [A].
-
Nome da fórmula: Campo obrigatório, deve ser preenchido com o nome da fórmula.
- Dica: Procure sempre utilizar um nome que remeta ao objetivo da fórmula, por exemplo, “Cálculo de impostos trabalhistas”;
-
Expresión: Campo donde se realiza el detalle de la fórmula, representa la expresión que la fórmula realizará en su ejecución. Se asemeja a una expresión matemática, contiene un operando igualado a una secuencia de operandos y operadores intercalados, siempre comenzando y terminando con un operando.
Exemplo:
[C1] = [C2] + [C3]
[C1]: Operando que receberá o resultado da expressão. Este operando também é conhecido operando resultante;
[C2]: Operando que será utilizado no cálculo da expressão;
+ : Operador a ser utilizado no cálculo da expressão;
[C3]: Operando que será utilizado no cálculo da expressão.
En este ejemplo, el valor de [C1] será igual al valor de [C2] más el valor de [C3].
En una expresión, los operandos pueden ser: Membro, Número, Función y Bloco;
El operando resultante debe ser obligatoriamente un miembro, donde el mismo puede o no poseer alcance.
Entre los operadores tenemos: Suma (+), Resta (-), Multiplicación (*), División (/) y Potencia (^);
En el campo de expresión, podremos utilizar el autocompletado ingresando al menos 3 caracteres (después de 1 segundo se mostrarán las sugerencias), o haciendo clic en CTRL + ESPACIO para mostrar las sugerencias de inserción.
Tenemos un botón que muestra las Funciones disponibles para selección:
.
Las funciones son los auxiliares para la creación de fórmulas, permitiendo cálculos más elaborados, además de ofrecer acceso a diversas informaciones del modelo.
Para información complementaria referente a las funciones en T6, acceda a: Fórmulas y Funciones
¶ 3.2.3. Alcance
Permite filtrar el contexto de ejecución de una fórmula. Con esto, la ejecución de la fórmula se realizará de acuerdo con los filtros insertados.
Usando el alcance es posible filtrar en qué miembros de la dimensión se ejecutará la fórmula. Si no se inserta ningún filtro en la dimensión, la fórmula se ejecutará en todos los miembros.
Los filtros de ejecución en la pestaña de alcance se muestran como checkboxes, en los filtros tendremos:
- Ejecutar Automáticamente: Permite ejecutar la fórmula automáticamente al guardar datos en un formulario.
Las fórmulas con esta propiedad activa se denominan Fórmulas Online; las fórmulas en las que la propiedad está desactivada se denominan Fórmulas Off-line.
Cada vez que la premisa de una fórmula tenga su valor alterado, directa o indirectamente, la fórmula se ejecutará, modificando sus valores y dejando la expresión de la fórmula verdadera nuevamente.
-
Ejecutar Solo en lo Planeado: Esta opción está disponible solo en aplicaciones de Planificación y permite ejecutar la fórmula solo en el escenario planeado. Cuando esta propiedad esté activada, el cálculo de la fórmula se realizará solo en los períodos configurados como planeado.
-
Ejecutar Solo en lo Realizado: Esta opción está disponible solo en aplicaciones de Planificación y permite ejecutar la fórmula solo en el escenario realizado. Cuando esta propiedad esté activa, el cálculo de la fórmula se realizará solo en los períodos configurados como realizado.
Si desea ejecutar la fórmula en ambos escenarios, Planeado y Realizado, desmarque ambas las casillas de selección.
-
Permitir Persistir Cero: Al seleccionar el checkbox, la fórmula podrá guardar el valor cero en la tabla de hechos; Normalmente, en T6 el valor cero no se guarda en la tabla de hechos, pero en algunos casos específicos esto es necesario.
-
Ejecutar en las Agregaciones: Esta opción está disponible solo para fórmulas de tipo In-Memory. Cuando esta propiedad esté activa, el cálculo de la fórmula se realizará en los niveles agregados.
-
Ejecutar en las Hojas: Esta opción está disponible solo para fórmulas de tipo In-Memory. Cuando esta propiedad esté activa, el cálculo de la fórmula se realizará en los niveles hoja.
-
Cálculo en Vivo: Cuando esta propiedad esté activa, el cálculo de la fórmula se realizará cada vez que una de las premisas sea alterada por el usuario, sin necesidad de guardar los datos.
¶ 3.2.4. Descriptivo
Permite describir la función de la fórmula o sus objetivos, con el fin de proporcionar una descripción detallada sobre la fórmula.
¶ 3.2.5. Datos
Permite visualizar información referente al alcance de ejecución de la fórmula, haciendo posible analizar cada expresión generada por la fórmula y la visualización de datos de estas expresiones; en la pestaña de datos, tenemos: Expresión, Distintos y Resultado;
-
Expresión: En expresión, podemos ver el alcance de ejecución de la fórmula, mostrando cada una de las premisas de forma separada;
-
Distintos: En distintos, podemos visualizar la combinación única de los miembros modificados por la expresión; en distintos tendremos Cuenta, Tiempo, Escenario y Entidad, de este modo podremos visualizar dónde están siendo modificados los datos por esa expresión;
-
Resultado: En resultado, podemos hacer una vista previa de los datos que tenemos en el modelo basándonos en la expresión seleccionada;
¶ 3.3. Creación de Fórmula
Para crear una nueva fórmula, siga los siguientes pasos:
- En el menú principal de T6, seleccione la opción Explorer con un doble clic;
- Seleccione el lugar donde se creará la nueva fórmula;
- Después de seleccionar el lugar, en la ribbon haga clic en Nuevo Item, haga clic en Modelado y seleccione la opción Fórmula;
- Un nuevo objeto del tipo Fórmula será mostrado en la lista;
- Seleccione el objeto creado y haga clic en
; - Se abrirá un panel lateral con cuatro pestañas (Fórmula, Alcance, Descriptivo y Datos);
- En la pestaña Fórmula, tendremos los siguientes campos para completar:
- Aplicación: Indica la aplicación en la que se creará la fórmula;
- Tipo: Indica el tipo de la fórmula (Especial o In-Memory);
- Grupo de la fórmula: Campo opcional, donde podremos seleccionar un grupo para la fórmula;
- Posición: Indica el posicionamiento de la fórmula en relación con las demás. El posicionamiento se refiere al orden de ejecución de las fórmulas (no editable, será modificado conforme al orden de ejecución definido en la lista de fórmulas);
- Nombre de la Fórmula: Campo donde podemos cambiar el nombre de la fórmula; por defecto, trae el nombre definido al crear el objeto en el Explorer;
- Expresión: Campo de llenado obligatorio, donde deberemos informar el detalle de la fórmula;
- Si es necesario, para ayudar con el llenado del texto de la fórmula, podremos usar el asistente de llenado. Para esto, presionaremos CTRL + ESPACIO, y visualizaremos las posibles alternativas según el contexto actual de la expresión;
- Buscar Función: Nos permite elegir una función para usar en la fórmula; al elegir esta opción, seremos dirigidos a la lista de funciones disponibles, donde seleccionaremos la función deseada y seremos dirigidos a la pantalla de edición de funciones donde agregaremos los parámetros de la función (también tiene asistente de llenado, con las opciones Buscar dimensión y Buscar miembro cuenta);
- Buscar Dimensión: Muestra una lista con las dimensiones existentes en la Aplicación y nos permite seleccionar una dimensión;
- Buscar miembro cuenta: Nos permite realizar la selección de un miembro de la dimensión cuenta, ya sea un miembro padre o un miembro hijo; la visualización de los miembros se hace en forma de árbol jerárquico;
Toda nueva fórmula recibe un posicionamiento automático temporal. Después de la publicación del cubo, T6 ajusta el posicionamiento de todas las fórmulas de forma automática.
Con la expresión configurada podemos pasar al alcance; no hay impedimento para navegar entre las pestañas, pero para configurar el alcance necesitamos tener la expresión configurada.
- En la pestaña Alcance marcaremos los checkboxes correspondientes al tipo de filtro que deseamos habilitar en la ejecución de la fórmula; tenemos los siguientes checkboxes:
- Ejecutar automáticamente: Permite ejecutar la fórmula automáticamente al guardar datos en un formulario;
- Executar nas agregações: Esta opção está disponível apenas para fórmulas do tipo In-Memory. Quando esta propriedade estiver ativa, o cálculo da fórmula será realizado nos níveis agregados;
- Executar apenas no planejado: Esta opção está disponível apenas em aplicações de Planejamento e permite executar a fórmula apenas no cenário planejado;
- Executar nas folhas: Esta opção está disponível apenas para fórmulas do tipo In-Memory. Quando esta propriedade estiver ativa, o cálculo da fórmula será realizado nos níveis folha;
- Executar apenas no realizado: Esta opção está disponível apenas em aplicações de Planejamento e permite executar a fórmula apenas no cenário realizado;
- Cálculo vivo: Quando esta propriedade estiver ativa, o cálculo da fórmula será realizado sempre que uma das premissas for alterada pelo usuário, sem a necessidade de salvar os dados;
- Permitir persistir zero;
- Aún en la pestaña Alcance, haremos clic en la línea de la dimensión que deseamos seleccionar y luego en
para seleccionar los miembros y atributos que compondrán el alcance de la fórmula;
- Se mostrará la lista con los miembros de la dimensión seleccionada, donde se podrá realizar la selección de miembros y atributos para filtrado.
- En la pestaña Descriptivo describiremos la finalidad de la fórmula o sus objetivos;
- En la pestaña Datos visualizaremos la información referente al alcance de ejecución de la fórmula (esta pantalla es muy utilizada para identificar posibles errores o problemas en los cálculos de la fórmula);
- Aún en la pestaña Datos, tendremos los campos Expresión, Distintos y Resultado;
- Expressão: O campo Expressão exibe uma lista com todas as expressões dos operandos e blocos de operandos da fórmula.
- Por exemplo: em uma fórmula
A = B + C, será exibido na listaB,CeB + C;
- Por exemplo: em uma fórmula
- Distintos: Muestra una lista con los valores distintos de las tuplas donde existen datos para la expresión seleccionada;
- Resultado: Muestra una lista con los valores encontrados en diversas tuplas para la expresión seleccionada.
- Expressão: O campo Expressão exibe uma lista com todas as expressões dos operandos e blocos de operandos da fórmula.
Después de crear una fórmula, es necesario publicar el cubo para que pueda ser utilizada!
¶ 3.4 Accediendo a las Fórmulas de la Aplicación
A lista de fórmulas existentes na aplicação pode ser acessada a partir da tela principal do T6 Planning, através do Menu -> Modelagem -> Fórmulas.
O sistema exibirá a tela Fórmulas, a qual contém a listagem de todas as fórmulas da aplicação.
¶ 3.5 Configuración y Uso de las Funcionalidades
A configuração de fórmulas é feita a partir da tela Fórmulas.
Esta tela contém várias funcionalidades e, entre outras funções, permitirá que você ordene, adicione, edite, remova e execute fórmulas, além de visualizar ciclos ou intersecções nas fórmulas.
Para um melhor entendimento, observe as funcionalidades numeradas e destacadas na imagem abaixo, e a seguir, acompanhe o detalhamento e a utilização de cada funcionalidade.
-
Lista de Fórmulas: Trata-se de uma grid que exibe a listagem das fórmulas existentes no modelo e que contém as seguintes colunas:
- Pos: Indica o posicionamento da fórmula em relação às demais. O posicionamento se refere à ordem em que as fórmulas serão executadas.
- Tipo: Indica qual é o tipo da fórmula (Especial ou In-Memory).
- Grupo: Grupo da fórmula.
- Nome: Nome que identifica a fórmula.
Configuração da listagem e uso das funcionalidades:
- Para configurar uma determinada fórmula basta dar um duplo clique sobre ela, na lista de fórmulas. Será exibida a tela de Criação e Edição de Fórmula. Para ver mais detalhes, consulte o tópico Criar e Editar Fórmulas, neste Manual.
- Para que você possa utilizar as funcionalidades localizadas na parte inferior da tela, onde se encontram o Menu de Ações e os Botões de Ação, é necessário a seleção prévia de uma determinada fórmula na listagem, clicando uma vez sobre ela. Em seguida clique na funcionalidade desejada.
- Para utilizar as funcionalidades do Menu Ferramentas, localizado na parte superior da tela, não há necessidade de uma seleção prévia na lista de fórmulas, já que o uso de tais opções reflete sobre todas as fórmulas da listagem.
-
Tipo: Trata-se de combobox que permite filtrar as fórmulas com base no tipo selecionado, exibindo apenas as fórmulas referentes ao grupo selecionado.
-
Grupo de Fórmula: Trata-se de combobox que permite filtrar a listagem das fórmulas com base no Grupo selecionado, exibindo apenas as fórmulas referentes ao grupo selecionado.
-
Aplicação: Trata-se de combobox que permite filtrar as fórmulas com base na aplicação selecionada, exibindo apenas as fórmulas referentes a aplicação selecionada.
-
Executar fórmulas automaticamente: Trata-se de uma checkbox, a qual deverá ser desmarcada quando você desejar desabilitar temporariamente a execução automática das fórmulas. O uso desta funcionalidade reflete em toda a lista de fórmulas.
-
Botões de Ação: São os botões localizados no canto inferior direito da tela.
Uso dos botões:
- O uso de tais botões implica em antes selecionar um item na lista de fórmulas, clicando uma única vez sobre uma determinada fórmula e, a seguir, clicar no botão desejado.
Opções dos botões:
- Adicionar: Permite criar e adicionar uma nova fórmula à listagem existente. Ao clicar no botão, será exibida a tela de Criação e Edição de Fórmulas. Para mais detalhes veja o tópico Criar e Editar Fórmulas, neste manual.
- Editar: Permite editar uma fórmula já existente na listagem. Ao clicar no botão será exibida tela de Criação e Edição de Fórmulas. Para mais detalhes, veja o tópico Criar e Editar Fórmulas, neste manual.
- Remover: Permite remover uma fórmula previamente selecionada na listagem.
- Histórico: Exibe todas as execuções de uma fórmula previamente selecionada na listagem. Para mais detalhes, veja o tópico Histórico do Modelo, no capítulo Execução de Fórmulas, deste manual.
-
Menu Ações: É o menu de opções localizado no canto inferior direito da tela.
Opções do menu ações:
- Mover Acima: Permite movimentar uma fórmula previamente selecionada na listagem, para uma posição acima da atual.
- Mover Abaixo: Permite movimentar uma fórmula previamente selecionada na listagem, para uma posição abaixo da atual.
-
Menu Ferramentas: É o menu de opções localizado no canto superior direito da tela. O menu ferramentas contém funcionalidades que, quando utilizadas, afetam automaticamente todo o conteúdo da lista de fórmulas. Assim sendo, não é preciso fazer a seleção prévia de uma determinada fórmula na listagem.
Opções do menu ferramentas:
- Reordenar: Permite reordenar automaticamente todas as fórmulas, levando em conta sua precedência e informando sempre que ocorrer alguma referência circular.
- Executar Fórmulas Especiais: Permite executar uma ou mais fórmulas. Ao clicar sobre esta opção você irá iniciar o Assistente para Execução de Fórmulas. Para mais detalhes, veja o tópico Execução de Fórmulas Especiais, no capítulo Execução, deste manual.
- Ciclos: Exibe as fórmulas que possuem ciclos. Para mais detalhes, veja o tópico Ciclos, no capítulo Desempenho, deste manual.
- Intersecções: Exibe as fórmulas que possuem Intersecções. Para mais detalhes, veja o tópico Intersecções, no capítulo Desempenho, deste manual.
¶ 3.6 Crear y Editar Fórmulas
Utilize esta funcionalidade para criar uma nova fórmula ou alterar as propriedades de uma fórmula já existente.
- Para Adicionar Fórmula: Na tela Ordenar Fórmulas, utilize o botão Adicionar, localizado no canto inferior direito da tela.
- Para Editar Fórmula: Na tela Ordenar Fórmulas, selecione a fórmula que deseja editar, clicando sobre ela na lista de fórmulas. Em seguida clique no botão Editar, localizado no canto inferior direito da tela.
Os botões Adicionar e Editar estão em destaque na imagem acima. Ao clicar nos botões Adicionar ou Editar, será exibida a tela Fórmula. Nesta tela constam as 4 etapas de configuração da fórmula, conforme destaque na imagem a seguir.
Para dar início a configuração, tanto para Adição quanto para Edição de uma fórmula, utilize os seguintes passos:
Na tela Fórmula – Aba FÓRMULA:
-
Aplicação: Indica em qual aplicação a fórmula foi criada.
-
Tipo: Indica o tipo da fórmula.
-
Grupo da Fórmula: Campo opcional, no qual você poderá selecionar um grupo para a fórmula.
-
Posição: Indica o posicionamento da fórmula em relação às demais. O posicionamento se refere à ordem em que as fórmulas serão executadas.
-
Nome da Fórmula: Campo de preenchimento obrigatório, onde você deverá inserir o nome da fórmula.
-
Funções: Seu uso está atrelado ao campo Expressão. Ao clicar sobre este campo, será exibida a tela Lista de Funções. Você poderá selecionar uma função, considerando a sua necessidade com base na descrição da mesma. Para maiores detalhes sobre as funções existentes, consulte o Capítulo Funções, neste manual.
-
Expressão: Campo de preenchimento obrigatório, onde deverá ser informado o detalhamento da fórmula. Observe alguns pontos que vão facilitar o detalhamento:
- Caso você deseje escolher uma função para preencher a expressão da fórmula, basta clicar no botão Funções, localizado no canto superior direito da tela. Confira a listagem de funções disponíveis, no capítulo Funções.
- Caso você necessite de ajuda no preenchimento do texto da fórmula, você poderá usar o assistente de preenchimento. Para isto, pressione Ctrl + espaço, e visualize as possíveis alternativas de acordo com o contexto atual da expressão. Observe que:
- Procurar Função: Permite que você escolha uma função para utilizar na fórmula, escolhendo esta opção, você será direcionado para uma lista de funções disponíveis, após escolher a função desejada, você será direcionado para a tela de “Edição de Função” que permite a edição dos parâmetros de uma função.
- Edição do Escopo do Membro: Permite a edição do escopo do membro.
- Procurar Membro ou Dimensão: Permite a busca de um membro ou dimensão.
Na imagem a seguir, os destaques em vermelho apontam os campos de preenchimento obrigatório. O destaque em azul mostra o assistente de preenchimento do campo Expressão.
Observe que toda nova fórmula recebe um posicionamento automático temporário. Após publicar o Cubo, o T6 Planning irá acertar o posicionamento de todas as fórmulas.
Para finalizar, clique em OK. A lista de fórmulas será atualizada.
Na tela Fórmula – Aba ESCOPO:
- Marque a checkbox correspondente ao tipo de filtro com o qual você deseja executar a fórmula. Para mais detalhes sobre filtros, consulte o tópico Escopo, no capítulo Fórmulas, deste manual.
- Clique sobre a linha da dimensão para selecioná-la. Em seguida, clique no botão Editar e selecione os membros que irão compor o escopo. Assim, a lista apresentará o Nome da Dimensão, o Escopo (ou Membros) e os Atributos Selecionados.
Na tela Fórmula – Aba DESCRITIVO:
- No campo Descritivo, descreva a finalidade da fórmula ou seus objetivos.
Na tela Fórmula – Aba DADOS:
- Nesta tela você apenas visualiza informações referentes ao Escopo de Execução da fórmula. É possível analisar cada expressão gerada pela fórmula e a visualização de dados destas expressões. Esta tela é muito usada para identificar possíveis erros ou problemas nos cálculos da fórmula. Para ver mais detalhes, confira o tópico Identificando Problemas em Cíclos, no capítulo Desempenho, deste manual.
- O campo Expressão exibe uma lista com todas as expressões dos operandos e blocos de operandos da fórmula. Por exemplo: em uma fórmula A = B + C, será exibido na lista A, B e A + B.
- O campo Distintos exibe uma lista com os valores distintos das tuplas onde existem dados para a expressão selecionada.
- O campo Resultado exibe uma lista com os valores encontrados em diversas tuplas para a expressão selecionada.
¶ 3.6.1 Duplicando una Fórmula
Visando facilitar a cópia de fórmulas sem alterar a estrutura original, o T6 Planning disponibiliza um botão que permite que uma nova fórmula seja criada, idêntica a atual. O botão Duplicar permite replicar uma fórmula e otimizar o tempo de criação de fórmulas.
- Na listagem de fórmulas, clique sobre a fórmula que você deseja duplicar, e na barra de opções clique no botão Duplicar.
- A fórmula duplicada será exibida na listagem de fórmulas. Renomeie a mesma.
¶ 3.7 Crear y Editar Grupo de Fórmulas
Utilize esta funcionalidade para criar grupos de fórmulas e melhor organizar as Fórmulas por contexto, categorias ou finalidade.
Para adicionar um Grupo de Fórmulas:
-
No menu T6 Planning, acesse Explorer -> Navegador.
-
No lado esquerdo da tela, você encontrará a listagem de pastas do sistema.
-
Selecione a pasta na qual você deseja salvar o Grupo de Fórmulas.
-
Na barra de opções, clique em Novo Item, expanda o item Modelagem clicando sobre ele, e depois clique em Grupo de Fórmulas.
-
O novo Grupo de Fórmulas irá aparecer na parte central da tela, na lista de grupo de fórmulas.
-
Nomeie o grupo.
Para Editar um Grupo de Fórmulas:
-
Na lista de grupo de fórmulas, selecione o Grupo de Fórmulas que deseja editar, clicando sobre o mesmo.
-
Em seguida, na barra de opções, clique no botão Editar.
-
Será exibida uma janela pop-up. O campo aplicação já está definido, você deve então informar o nome do grupo que está sendo criado, sendo o campo Nome de preenchimento obrigatório. Em seguida clique em Ok.
¶ 4. Ejecución de Fórmulas
¶ 4.1 Visión General
Sempre que uma alteração ou inserção de dados é realizada, o T6 Planning identifica as fórmulas envolvidas no cálculo destes dados e as executa. Caso haja uma dependência entre alguma dessas fórmulas, ela também será executada.
O T6 Planning utiliza este sistema de identificação para evitar que todas as outras fórmulas existentes sejam recalculadas sem que tenha ocorrido qualquer alteração nos dados.
Este capítulo irá mostrar como funcionam os ciclos, dependências, parâmetros e execução de fórmulas no T6 Planning.
¶ 4.2 Dependencias, Ciclos y Recursiones
Quando a aplicação possui diversas fórmulas que interagem entre si, ou quando há uma dependência entre elas, este conjunto de fórmulas é chamado de ciclo.
Ao publicar o cubo, o T6 Planning ordena as fórmulas de acordo com as dependências. Caso a fórmula esteja em um ciclo. A fórmula irá permanecer na mesma posição em relação as fórmulas que se encontram no ciclo. Ou seja, as fórmulas devem ser ordenadas dentro de um ciclo manualmente.
Os ciclos de fórmulas podem ser visualizados em: -> janela Ordernar Fórmulas –> Ferramentas –> Ciclos. Esta visualização é utilizada para verificar quando algum ciclo é criado sem querer e caso seja necessário apagar alguma fórmula, sabendo onde isso irá impactar.
Ejemplo:
Em uma aplicação temos os membros: A, B e C, e iremos criar duas fórmulas:
Fórmula 1:
[C] = [A] + [B]
Fórmula 2:
A = Lag([C], -1)
(Clique no link a seguir caso tenha dúvidas quanto à Função Lag.)
-
Após publica-las vamos voltar para a tela fórmulas.
-
Em ferramentas, dentro da tela de fórmulas, teremos a opção Ciclos, ao clicarmos, serão exibidos os ciclos existentes entre as fórmulas.
Na exibição do ciclo, teremos as fórmulas que criamos anteriormente, e ao lado do seu nome, uma numeração entre parênteses, que estará definindo o elo de dependência entre as fórmulas.
É exibido também, ao lado do nome do ciclo, se temos Recursão e/ou se temos Referência Circular.
Temos um parâmetro da aplicação chamado Iteração Máxima em Fórmulas que tem como valor padrão 1, alterar esse valor pode gerar uma grande perca de performance na sua aplicação.
¶ 4.2.1 Dependencias entre Fórmulas
A dependência entre fórmulas pode ser caracterizada como direta ou indireta, conforme os percursos entre as fórmulas.
- Direta: Quando uma fórmula depende das premissas do formulário após os dados serem salvos, para ser executada. Por exemplo, ao inserir dados em um formulário que calcula o total de despesas mensais.
- Indireta: Quando o cálculo de um resultado depende do cálculo de outro, para ser executado. Por exemplo, um formulário que calcula o total de despesas anuais, com base na soma de despesas mensais.
¶ 4.2.2 Ciclos de Fórmulas
Um ciclo é um grupo de formulas onde a execução das mesmas pode ocorrer com recursão e/ou referência circular.
¶ 4.2.3 Recursión de Fórmulas
A recursão é um percurso da dependência mútua de um ciclo onde ocorrem variações nas dimensões do modelo, e onde todas as fórmulas do ciclo são executadas a cada membro folha da dimensão, alterando apenas o resultado naquele contexto.
Na execução de um ciclo com recursão, a cada membro folha da dimensão, todas as fórmulas do ciclo são executadas. Podemos citar como exemplo a dimensão Tempo, que pode apresentar uma referência a um período anterior, executando todas as fórmulas do ciclo mês a mês, e contendo cálculos em que o saldo inicial del mes corriente é o resultado do saldo final do mês anterior. Já o saldo final del mes corriente será o saldo inicial mais um movimento qualquer.
Quando é uma recursão, temos pelo menos um caminho onde teremos que trocar um membro da dimensão horizontalmente, ou seja, quando temos um Lag o ponto de conexão entre as fórmulas é um Lag, isso quer dizer que estamos andando de lado em um contexto, fazendo uma iteração em membros de mesmo nível em uma dimensão. (caso não seja definida uma dimensão, o Lag automaticamente selecionará a dimensão Tempo)
- Na hora de rodar, a recursão troca o texto da fórmula e bota desde o primeiro mês válido até o último mês válido e roda na ordem das fórmulas do ciclo.
EXEMPLO:
([C],[2024].[Janeiro]) = ([A],[2024].[Janeiro]) + ([B],[2024].[Janeiro])
- Será feito o cálculo no contexto específico do mês, sempre quando não tivermos a dimensão tempo, ou, uma função envolvidas.
([A],[2024].[Janeiro]) = ([C],[2023].[Dezembro])
A recursão torna a execução da fórmula mais lenta conforme o número de períodos a serem calculados, quanto mais períodos, mais lenta.
¶ 4.2.4 Fórmulas con Referencia Circular
Quando há uma fórmula dependendo de outra sem que haja variação na dimensão, ocorre uma referência circular. Na execução de um ciclo com referência circular, todas as fórmulas do ciclo são executadas N vezes, onde N é definido na tabela de parâmetros da aplicação, através do parâmetro MaximumFormulasIteration, o qual possui como padrão o valor 1.
Neste parâmetro é informado qual será o número máximo de iterações utilizadas para resolver fórmulas com referência circular. Enquanto os valores resultantes continuarem sendo alterados pela execução, o T6 Planning continuará iterando; por isso, o ideal é que este parâmetro permaneça com o valor padrão 1, uma vez que, na maioria dos casos, basta uma única iteração para que o T6 Planning consiga resolver a referência circular.
Temos algumas operações onde queremos realizar vários cálculos no mesmo mês, entretanto, não temos uma interação horizontal na dimensão, porém, o cálculo vai mudar de acordo com o número de interações que utilizamos.
Por exemplo: No caso da dimensão Tempo, quando todo o cálculo das fórmulas ocorre dentro do mesmo mês. Neste caso, o sistema executa as fórmulas para todos os meses diversas vezes, conforme as interações vão acontecendo.
¶ 4.2.5 Intersección
A intersecção acontece quando temos duas ou mais fórmulas calculando a mesma célula em um formulário;
Podemos através do wizard de fórmulas, em ferramentas, selecionar a opção intersecção, que irá listar as fórmulas que estão calculando o mesmo ponto del cubo.
NUNCA VAMOS QUERER TER INTERSECÇÃO NO MODELO!
¶ 4.3 Asistente para Ejecución de Fórmulas
É a funcionalidade que permite executar manualmente uma ou mais fórmulas do modelo.Para utilizá-la, siga os passos abaixo.
Na tela Fórmulas:
- No canto superior direito da tela, no menu Ferramentas, clique na opção Executar Fórmulas Especiais.
Na tela Assistente de Execução das Fórmulas Especiais – etapa FÓRMULAS:
- Se desejar exibir apenas as fórmulas de um determinado grupo, selecione-o na dropbox Grupo.
- O campo Fórmulas Especiais Disponíveis exibe a lista de fórmulas disponíveis para execução.
- O campo Fórmulas Especiais Selecionadas exibe a lista de fórmulas selecionadas para execução.
- Para adicionar uma fórmula, clique sobre ela e utilize os botões centrais de movimentação, os quais permitem adicionar e remover uma fórmula selecionada, ou mesmo todas as fórmulas de uma única vez.
- Marque a checkbox Inserir Referências, caso deseje inserir, em tempo de execução, fórmulas que façam referência às fórmulas selecionadas. Desta forma, caso o usuário esqueça ou não adicione tais fórmulas à lista de execução, o T6 Planning então irá inserí-las automaticamente, para que haja consistência nos valores calculados.
- Para avançar, clique em Próximo.
Na tela Assistente de Execução das Fórmulas Especiais – etapa ESCOPO DE EXECUÇÃO:
- Caso deseje restringir o escopo de execução da fórmula, selecione-o na lista de cada respectiva dimensão do modelo.
- Para configurar o escopo de uma determinada dimensão, selecione-a e em seguida clique no botão Editar, no canto inferior direito da grid.
- Para avançar, clique em Próximo.
Na tela Assistente de Execução das Fórmulas Especiais – etapa RESUMO:
- Confirme as fórmulas selecionadas e o escopo de execução das mesmas.
- Para prosseguir, clique em Concluir.
Na tela Assistente de Execução das Fórmulas Especiais – etapa FINALIZADA:
- Esta última etapa exibirá a mensagem de que as fórmulas foram executadas com sucesso.
- Para abrir detalhes sobre a execução de uma fórmula, basta selecioná-la previamente na lista e clicar no botão Visualizar Detalhes, no canto inferior direito da tela.
¶ 4.4 Historial del Modelo
Esta funcionalidade exibe a listagem de execuções de uma determinada fórmula, permitindo que sejam feitas análises para verificar quais fórmulas estão tendo um maior consumo de tempo.
Na tela Fórmulas:
- Para visualizar as execuções de uma fórmula, selecione-a na lista e em seguida clique no botão Histórico, localizado no canto inferior direito da tela.
- Será aberto um popup mostrando todas as execuções da fórmula.
Na tela Execução de Fórmulas, uma listagem exibe em colunas os seguintes detalhes:
- Início: Exibe a data e hora em que a fórmula iniciou sua execução.
- Fim: Exibe a data e hora em que a fórmula terminou sua execução.
- Usuário: Informa o usuário que executou a fórmula.
- Linhas: Informa o total de linhas do banco de dados que foram alteradas pela fórmula.
- Tempos: Informa o tempo total de execução da fórmula.
Para visualizar mais detalhes sobre uma determinada execução, clique no botão Visualizar Detalhes, na linha desejada.
Será aberto um popup com mais detalhes da execução.
É importante ressaltar que, caso o parâmetro EnableLogs não esteja habilitado, será exibida somente a última execução da fórmula, pois os registros das execuções anteriores não serão mantidos. Para mais detalhes sobre os parâmetros do T6 Planning consulte o Manual STD Parâmetros Setup.
¶ 5. Rendimiento
¶ 5.1 Visión General
Neste capítulo serão abordados alguns pontos importantes, que irão lhe ajudar a obter o máximo de desempenho na utilização de fórmulas no T6 Planning.
¶ 5.2 Creación
Para um melhor desempenho das fórmulas, siga as seguintes instruções:
- Tente escrever as fórmulas da maneira mais simples possível.
- Sempre que possível, utilize as funções disponíveis.
- Caso uma expressão seja repetida em diversas fórmulas, crie uma fórmula apenas com esta expressão e passe a utilizá-la quando necessário.
- Evite criar ciclos com recursões e referências circulares desnecessárias.
¶ 5.3 Identificando Cuellos de Botella
Para identificar gargalos de implementação das fórmulas, identifique o formulário que está apresentando lentidão ao salvar os dados e confira os passos a seguir:
-
Limpe a tabela de log de fórmulas com o seguinte SQL:
TRUNCATE TABLE REP_LOGFORMULA
-
Salve dados no formulário que está apresentando lentidão e verifique o tempo total de salvamento em segundos.
-
Para saber o tempo de salvamento das fórmulas em segundos, execute o seguinte SQL:
SELECT SUM((DATEDIFF(MS,datExecutionStart,datExecutionEnd) / 1000)) as Duration FROM REP_LOGFORMULA
-
Para saber o tempo total de execução das fórmulas em segundos, execute o seguinte SQL:
SELECT (DATEDIFF(MS,(SELECT MIN(datExecutionStart) FROM REP_LOGFORMULA),(SELECT MAX(datExecutionEnd) FROM REP_LOGFORMULA)) / 1000) as Duration
-
Para saber o tempo de execução de cada uma das fórmulas em segundos, execute o seguinte SQL:
SELECT (DATEDIFF(MS,datExecutionStart,datExecutionEnd) / 1000) as Duration, dscFormulaName FROM REP_LOGFORMULA ORDER BY Duration DESC
-
Divida o valor encontrado no passo cinco pelo valor encontrado no passo três e multiplique o resultado por cem. Este valor representa a percentagem do tempo utilizado com fórmulas. Caso esta percentagem esteja com um valor muito próximo a cem, veja no resultado do passo cinco quais fórmulas estão contribuindo mais para o problema de desempenho.
-
Divida o resultado do passo quatro pelo passo cinco e multiplique o resultado por cem. Este valor representa a percentagem de execução do SQL Server em relação ao tempo total de execução das fórmulas. Caso este valor não fique próximo a cem, a aplicação pode estar apresentando problemas de desempenho.
¶ 5.4 Identificando Problemas en Ciclos
Para lhe ajudar a identificar problemas específicos em ciclos, iremos descrever algumas ocorrências e como solucioná-las.
-
Cálculo incorreto em um ciclo com recursão de fórmulas mês a mês
- Situação: Quando um determinado formulário que contenha um ciclo com recursão de fórmulas calcula incorretamente um campo cumulativo, como o cálculo do saldo inicial de um mês, baseado no resultado do saldo final do mês anterior.
- Solução: Verificar na lista de fórmulas se alguma delas está ordenada de forma incorreta, como a fórmula que calcula do saldo inicial estar posicionada após a que calcula o saldo final e, em caso positivo, ordená-la manualmente, pois o sistema não reordena as fórmulas que estejam em ciclos. Após a reordenação, deverá ser feita uma nova execução das fórmulas.
- Ejemplo: Um formulário de lançamento de receitas e despesas mensais onde, ao fim de cada mês, é calculado o Saldo Final com base nestes lançamentos. Este resultado passará para o mês seguinte, formando o Saldo Inicial.
Quando o problema citado acima ocorre, o Saldo Inicial é calculado incorretamente.
Após aplicar a solução indicada, o cálculo do Saldo Inicial será realizado com êxito.
-
Cálculo incorreto em um ciclo com recursão de fórmulas dependentes
- Situação: Quando um determinado formulário que contenha um ciclo com recursão de fórmulas calcula incorretamente o resultado de um movimento que depende de outro, dentro do mesmo período.
- Solução: Verificar na lista de movimentos (Contas) se a conta que depende do resultado da outra está ordenada incorretamente, ou seja, posicionada antes dela. Em caso positivo, ordená-las manualmente, posicionando primeiramente a conta que irá calcular o primeiro resultado e, a seguir, a conta que depende deste resultado.
- Ejemplo: Um formulário que calcula o total de despesas mensais, somando as despesas fixas ao cálculo de despesas semanais. Neste caso, os cálculos são baseados em movimentos ou Contas, sendo as despesas semanais o Movimento 1 e as despesas mensais o Movimento 2. Quando estas contas estão ordenadas incorretamente com o posicionamento invertido, no momento em que o sistema executar as fórmulas, somente o valor do Movimento 1 será calculado. Ao executar as fórmulas uma segunda vez, o sistema irá calcular corretamente, pois neste caso, o modelo resolverá a si mesmo, uma vez que o valor do Movimento 1 já havia sido calculado e então resultará no cálculo correto do Movimento 2.
Após aplicar a solução e ordenar corretamente o Movimento 2 após o Movimento 1, os valores serão gerados corretamente sempre que as fórmulas forem executadas.
-
Cálculo incorreto em um ciclo com referência circular
- Situação: Quando um formulário calcula valores diferentes a cada execução da fórmula.
- Solução: Este tipo de ocorrência trata-se de uma referência circular, onde o cálculo do valor de um membro depende da resultante do membro-pai, ou seja, dele próprio. Para corrigir este problema é necessário editar a fórmula e substituir a conta por um membro-filho da conta resultante.
- Ejemplo: Um formulário que calcula um percentual da conta Investimento, utilizando a fórmula: Investimento = Receita + 0,01. Neste caso, a conta Receita é o membro-pai da conta Investimento, e nesta fórmula, o cálculo do Investimento depende da resultante do membro-pai.
Após aplicar a solução indicada e substituir a conta Investimento por um membro-filho da conta Receita, como a conta Produto por exemplo, a referência circular será quebrada, de modo que, ao realizar o cálculo, o sistema estará decompondo uma conta-pai em suas contas-filho.
¶ 5.5 Identificando Otros Problemas
Para verificar se o problema de lentidão no salvamento do formulário está associado às fórmulas:
-
Uma vez identificada quais fórmulas estão com problemas de desempenho, verifique se existe uma melhor maneira de realizar o mesmo cálculo.
-
Verifique se há alguma intersecção interferindo no desempenho dos cálculos. Intersecções são ocorrências onde duas fórmulas ou expressões estão calculando a mesma tupla, o que não pode ocorrer em nenhuma hipótese, pois isto gera recálculo, sobrecarga no banco de dados e degradação da performance.
Sempre que houver necessidade, você pode acessar a tela Ordenar Fórmulas – Intersecções; verificar se há alguma intersecção criada por engano, como uma fórmula duplicada por exemplo, e removê-la.
¶ 6. Funciones
¶ 6.1 Visión General
Neste capítulo serão abordadas as funções disponíveis na aplicação e suas finalidades.
¶ 6.2 Accediendo a la Lista de Funciones
Para acessar a lista de funções no menu principal do T6 Planning acesse Modelagem -> Fórmulas.
Será exibida a tela Fórmulas. Clique no botão Adicionar no lado inferior direito da tela.
- Na aba fórmula, clique no botão Funções (conforme destaque lado direito).
Será exibida a tela que apresenta a Lista de Funções da aplicação. Você poderá navegar entre as funções disponíveis e visualizar a descrição da mesma. Após selecionar a função desejada, clique no botão Ok.
¶ 6.3 Tipos de Parámetros
Neste campo serão apresentados os Tipos de Parâmetos usados nas funções do T6 Planning.
¶ 6.3.1 Atributo
Uma característica aplicável aos membros da dimensão.
Ejemplo:
¶ 6.3.2 Bloco
Conjunto de elementos a serem calculados.
Ejemplo:
(2 + 3 + 4) = Bloco numérico
¶ 6.3.3 Columna
Coluna de uma tabela do banco de dados.
Ejemplo:
¶ 6.3.4 Comparador
Expressão que compara dois valores utilizando os sinais abaixo, e retorna verdadeiro ou falso.
= igual a
!= diferente de
> maior que
>= maior ou igual a
< menor que
<= menor ou igual a
Ejemplo:
¶ 6.3.5 Condicional
Condicional a ser testada. Este parâmetro deve ser uma comparação entre dois operandos. Sua sintaxe deve ser um operando seguido de um comparador seguido de um operando.
O operando deve ser:
- Membro, onde o mesmo pode ou não possuir escopo
- Número
- Constante
- Propriedade de um membro
Ejemplo:
¶ 6.3.6 Dimensión
Uma dimensão é uma hierarquia organizada de categorias, ou membros. As dimensões representam elementos da empresa.
Ejemplo: Os elementos podem ser tangíveis, como Funcionários, Produtos ou Contas, ou podem representar importantes modos de exibição dos dados comerciais, como Processos Empresariais, Tempo e Cenário.
¶ 6.3.7 Jerarquía
Agrupamentos de membros diferentes pertencentes à mesma dimensão.
Ejemplo:
¶ 6.3.8 Miembro
Um membro da dimensão é uma única posição ou um item em uma dimensão. O conjunto formado por um membro de cada dimensão representa um contexto na tabela de fatos.
Ejemplo:
¶ 6.3.9 Miembro con Alcance
É um conjunto de membros, sendo um de cada dimensão.
Ejemplo:
¶ 6.3.10 Nivel
Representa o nível hierárquico entre os membros de uma mesma dimensão. Sendo Pai (Nível 1), Filho (Nível 2), Neto (Nível 3), etc.
Ejemplo:
¶ 6.3.11 Número
Conceito matemático para a representação de medida, ordem ou quantidade.
Ejemplo:
¶ 6.3.12 Número Entero
Os números inteiros são constituídos de todos os números positivos naturais, negativos e o zero.
Ejemplo: Z= {...,−1, −2, −3,−4 ...} or
¶ 6.3.13 Número Entero Positivo
Os números inteiros positivos são constituídos dos números positivos naturais, incluindo o zero.
Ejemplo: Z+=
¶ 6.3.14 Tabla
Tabela de Banco de Dados.
Ejemplo:
¶ 6.3.15 Valor
Números inteiros ou com casas decimais.
Ejemplo:
¶ 7. Funciones Disponibles
En este tema se listarán las funciones disponibles en T6 Planning, descripción, Sintaxis y los parámetros de cada una de ellas.
¶ 7.1 Absolute (Abs)
Descripción:
Retorna el valor absoluto de un número, eliminando el signo negativo si existe. El valor absoluto representa la magnitud del número original, independientemente de su signo. Se utiliza cuando se desea trabajar con valores sin considerar si son positivos o negativos, como en análisis de variaciones, desviaciones o ajustes financieros.
Sintaxis:
ABS(Item)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Item | Valor cujo módulo será calculado | Membro, Membro com Escopo, Bloco | Sí | No |
Haga clic aquí para ver un ejemplo:
| Fórmula | Descrição | Resultado |
|---|---|---|
| ABS([Variação Orçamento]) | Valor absoluto de 500,00 | 500,00 |
| ABS([Variação Orçamento]) | Valor absoluto de -300,00 | 300,00 |
Descripción del Resultado: A função retorna o módulo do valor informado. Para uma variação negativa de R$ -300,00, a função retorna R$ 300,00, desconsiderando o sinal negativo e permitindo comparações de magnitude entre períodos.
¶ 7.2 Adjust
Descripción:
Realiza el reajuste porcentual de un valor base, aplicando una variación positiva o negativa. La fórmula utilizada internamente es Resultado = Valor × (1 + Porcentual / 100). Se utiliza ampliamente en planificación para simular reajustes salariales, aumentos de precio o correcciones de presupuesto a lo largo del tiempo.
Sintaxis:
Adjust(Item, Percentage, Attribute)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Item | Valor base que será reajustado | Membro, Membro com Escopo, Bloco | Sim | Não |
| Percentage | Percentual de reajuste a ser aplicado | Membro, Membro com Escopo | Sí | No |
| Attribute | Atributo da dimensão para segmentação do reajuste | Dimensão, Atributo, Valor | No | Sí |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 5.000,00 | Salário atual (Item) |
| 8% | Percentual de reajuste (Percentage) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| [Salário Reajustado] = Adjust([Salário], [% Reajuste]) | Aplica um reajuste de 8% ao salário atual | 5.400,00 |
Descripción del Resultado: O salário de R$ 5.000,00 é multiplicado por (1 + 8/100) = 1,08, resultando em R$ 5.400,00. Para reajustes negativos (ex.: -5%), o valor seria multiplicado por 0,95.
¶ 7.3 Between
Descripción:
Retorna la suma de los valores de un miembro dentro de un intervalo de períodos definido por una fecha de inicio y una fecha de fin. Solo se consideran en el cálculo los períodos comprendidos entre las dos fechas (inclusive). Se utiliza para calcular totales en ventanas temporales específicas, como el total de salarios pagados entre la admisión y el despido de un colaborador.
Sintaxis:
Between(Value, StartDate, EndDate)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor a ser somado no intervalo de períodos | Membro, Membro com Escopo | Sí | No |
| StartDate | Data ou período de início do intervalo | Membro, Membro com Escopo | Sí | No |
| EndDate | Data ou período de fim do intervalo | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 3.000,00 | Salário mensal (Value) |
| Jan/24 | Data de admissão (StartDate) |
| Mai/24 | Data de demissão (EndDate) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Between([Salário Mensal], [Tempo].[2024].[Janeiro/24], [Tempo].[2024].[Maio/24]) | Soma o salário mensal nos 5 meses entre janeiro e maio de 2024 | 15.000,00 |
Descripción del Resultado: A função soma o salário de R$ 3.000,00 para cada um dos 5 meses do intervalo (jan, fev, mar, abr, mai), retornando el total de R$ 15.000,00. Períodos fora do intervalo informado não são considerados.
¶ 7.4 Cartesian
Descripción:
Crea un producto cartesiano entre un ítem y una o más dimensiones especificadas, distribuyendo o replicando el valor por todas las combinaciones posibles de los miembros de las dimensiones proporcionadas. Se utiliza cuando se desea propagar un valor base a todas las combinaciones de dimensiones, como distribuir un presupuesto total por todas las combinaciones de producto y escenario.
Sintaxis:
Cartesian(Item, Dimension1, Dimension2, ..., DimensionN)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor a ser distribuído pelo produto cartesiano | Membro, Membro com Escopo, Bloco | Sí | No |
| Dimension | Dimensão cujos membros participarão do produto cartesiano | Dimensão | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Dados de Exemplo | ||
|---|---|---|
| Produto | Cenário | Valor de Venda |
| Smartphone | Orçado | R$ 10.000,00 |
| Smartphone | Realizado | R$ 10.000,00 |
| TV | Orçado | R$ 10.000,00 |
| TV | Realizado | R$ 10.000,00 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| [Vendas Total] = Cartesian([Vendas Total], [Produto], [Cenário]) | Distribui o valor de [Vendas Total] para cada combinação de membros das dimensões Produto e Cenário | R$ 10.000,00 replicado em todas as 4 combinações |
Descripción del Resultado: O valor de R$ 10.000,00 é replicado para as quatro combinações geradas pelo produto cartesiano entre Produto e Cenário: Smartphone/Orçado, Smartphone/Realizado, TV/Orçado e TV/Realizado.
¶ 7.5 Ceiling
Descripción:
Redondea un número hacia arriba, retornando el menor entero que sea mayor o igual al valor especificado. Opcionalmente, es posible indicar una precisión decimal para controlar el nivel de redondeo. Se utiliza en cálculos de provisiones, cantidades y presupuestos donde los valores fraccionados deben ser siempre redondeados hacia arriba por criterio de seguridad.
Sintaxis:
Ceiling(Number, Precision)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Number | Número a ser arredondado para cima | Membro, Membro com Escopo, Bloco | Sí | No |
| Precision | Precisão decimal do arredondamento | Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
| Fórmula | Descrição | Resultado |
|---|---|---|
| Ceiling([Qtd Unidades]) | Arredonda 2,3 unidades para cima sem precisão | 3 |
| Ceiling([Custo Unitário], 2) | Arredonda 15,234 para cima com 2 casas decimais | 15,24 |
| Ceiling([Provisão], 0) | Arredonda 1.234,70 para cima sem casas decimais | 1.235 |
Descripción del Resultado: A função garante que valores fracionados sejam sempre redondeados hacia arriba. Com precisão 2, o valor 15,234 se torna 15,24. Sem precisão definida, o arredondamento é realizado para o inteiro imediatamente superior.
¶ 7.6 CGrow
Descripción:
Calcula el crecimiento compuesto de un valor a lo largo de los períodos, aplicando una tasa de crecimiento porcentual sobre el valor acumulado del período anterior y sumando un incremento fijo. La fórmula utilizada es: Resultado = Valor Anterior × (1 + Tasa/100) + Incremento. Se utiliza para proyectar crecimiento de ingresos, salarios o cualquier magnitud que crezca de forma compuesta a lo largo del tiempo.
Sintaxis:
CGrow(Start, Grow, %GrowRate)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Start | Valor base inicial do primeiro período | Membro, Membro com Escopo | Sí | No |
| Grow | Incremento fixo adicionado a cada período | Membro, Membro com Escopo | Sí | No |
| %GrowRate | Taxa percentual de crescimento composto | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 1.000,00 | Valor inicial (Start) |
| 200,00 | Incremento fixo por período (Grow) |
| 10% | Taxa de crescimento composto (%GrowRate) |
| Fórmula | Descrição |
|---|---|
| CGrow([Receita Base], [Incremento Mensal], [% Crescimento]) | Calcula o valor acumulado aplicando crescimento composto e incremento fijo a cada período |
| Conta | Período 1 | Período 2 | Período 3 | Período 4 |
|---|---|---|---|---|
| Valor Inicial (Start) | 1.000,00 | 1.320,00 | 1.682,00 | 2.090,20 |
| Incremento (Grow) | 200,00 | 200,00 | 200,00 | 200,00 |
| Taxa (%GrowRate) | 10% | 10% | 10% | 10% |
| Resultado do Período | 1.320,00 | 1.682,00 | 2.090,20 | 2.559,22 |
Descripción del Resultado: A cada período, o crescimento composto é aplicado sobre o resultado acumulado anterior, somando-se o incremento fijo. O crecimiento es composto, ou seja, cada período cresce sobre um valor já maior do que o anterior.
¶ 7.7 Closing
Descripción:
Calcula el saldo de cierre con base en el saldo de apertura, sumando los valores de entrada y restando los valores de salida. Implementa la fórmula contable clásica: Saldo Final = Saldo Inicial + Entradas - Salidas. Es fundamental en contextos financieros y contables para calcular saldos finales de cuentas, inventarios o flujo de caja a lo largo del tiempo.
Sintaxis:
Closing(Opening, In, Out)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Opening | Saldo inicial do período | Membro, Membro com Escopo | Sí | No |
| In | Movimentos de entrada | Membro, Membro com Escopo | Sí | Sí |
| Out | Movimentos de saída | Membro, Membro com Escopo | No | Sí |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 1.000,00 | Saldo inicial (Opening) |
| 500,00 | Movimentos de entrada (In) |
| 200,00 | Movimentos de saída (Out) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| [Saldo Final] = Closing([Saldo Inicial], [Entradas], [Saídas]) | Calcula o saldo final somando entradas e subtraindo saídas do saldo inicial | 1.300,00 |
| Conta | Período 1 |
|---|---|
| Saldo Inicial (Opening) | 1.000,00 |
| Movimentos de Entrada (In) | 500,00 |
| Movimentos de Saída (Out) | 200,00 |
| Saldo Final | 1.300,00 |
Descripción del Resultado: O saldo final de R$ 1.300,00 é obtido somando o saldo inicial (R$ 1.000,00) às entradas (R$ 500,00) e subtraindo as saídas (R$ 200,00). Múltiplos parâmetros de entrada e saída podem ser informados, todos sendo somados ou subtraídos respectivamente.
¶ 7.8 ClosingVariance
Descripción:
Calcula el saldo de cierre con variación porcentual, una versión más sofisticada de la función Closing. Además de las entradas y salidas directas, aplica porcentuales de variación sobre el saldo inicial y un divisor de amortización. La fórmula es: Saldo Final = Opening + (Opening × In%) - (Opening × Out%) - (Opening ÷ Divider) + Entradas - Salidas. Se utiliza para modelar saldos de financiamientos, provisiones con remuneración y depreciaciones combinadas.
Sintaxis:
ClosingVariance(Opening, OpeningIn%, OpeningOut%, DividerOutput, In, Out)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Opening | Saldo inicial do período | Membro, Membro com Escopo | Sí | No |
| Opening In % | Percentual de variação positiva aplicado ao saldo inicial | Membro, Membro com Escopo, Número | Sí | No |
| Opening Out % | Percentual de variação negativa aplicado ao saldo inicial | Membro, Membro com Escopo, Número | Sí | No |
| Divider Output | Divisor aplicado ao saldo inicial para amortização ou redução | Membro, Membro com Escopo, Número | Sí | No |
| In | Movimentos de entrada adicionais | Membro, Membro com Escopo | Sí | Sí |
| Out | Movimentos de saída adicionais | Membro, Membro com Escopo | No | Sí |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 10.000,00 | Saldo inicial (Opening) |
| 2% | Percentual de juros sobre o saldo (Opening In %) |
| 1% | Percentual de taxa de serviço (Opening Out %) |
| 24 | Prazo de amortização em meses (Divider Output) |
| 500,00 | Aportes adicionais (In) |
| 200,00 | Retiradas (Out) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| [Saldo Final] = ClosingVariance([Saldo], [% Juros], [% Taxa], [Prazo], [Aportes], [Retiradas]) | Calcula o saldo final aplicando juros, taxa e amortização sobre o saldo inicial | 10.383,33 |
Descripción del Resultado: O saldo de R$ 10.000,00 recebe juros de 2% (+R$ 200,00), desconta a taxa de serviço de 1% (-R$ 100,00), desconta a parcela de amortização (10.000 ÷ 24 = -R$ 416,67), soma os aportes (+R$ 500,00) e subtrai as retiradas (-R$ 200,00), resultando em R$ 9.983,33.
¶ 7.9 CumAdjust
Descripción:
Acumula un valor a lo largo de los períodos aplicando operaciones compuestas: suma un incremento, multiplica por una tasa y agrega un incremento post-multiplicación. Utiliza internamente una CTE (Common Table Expression) recursiva para garantizar la propagación correcta del valor acumulado entre períodos. El parámetro Restart permite reiniciar el acumulado a partir de un valor específico en cualquier período.
Sintaxis:
CumAdjust(Increment, Multiplier%, IncrementAfterMultiplier, Restart)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Increment | Valor de incremento adicionado ao acumulado a cada período | Membro, Membro com Escopo | Sí | No |
| Multiplier % | Percentual multiplicador aplicado sobre o valor acumulado | Membro, Membro com Escopo, Número | No | No |
| Increment After Multiplier | Incremento adicionado após a multiplicação | Membro, Membro com Escopo, Número | No | No |
| Restart | Valor que reinicia o acumulado no período seguinte | Membro, Membro com Escopo | No | No |
Haga clic aquí para ver los ejemplos:
Resultado con Incremento
| Dados | Descrição | |
|---|---|---|
| 100 | Acumulado (valor del período anterior, calculado pela própria fórmula) | |
| 100 | Incremento | |
| Fórmula | Descrição | Resultado |
| [Acumulado] = CumAdjust([Increment]) | Soma o incremento ao valor acumulado do período anterior | 200 |
Resultado con Incremento y Multiplicador
| Dados | Descrição | |
|---|---|---|
| 100 | Acumulado (valor del período anterior) | |
| 100 | Incremento | |
| 10% | Multiplicador % | |
| Fórmula | Descrição | Resultado |
| [Acumulado] = CumAdjust([Increment], [Multiplier]) | Soma o incremento e aplica o multiplicador sobre o total | 220 |
Resultado con Incremento después de la Multiplicación
| Dados | Descrição | |
|---|---|---|
| 100 | Acumulado (valor del período anterior) | |
| 100 | Incremento | |
| 10% | Multiplicador % | |
| 100 | Incremento após multiplicação | |
| Fórmula | Descrição | Resultado |
| [Acumulado] = CumAdjust([Increment], [Multiplier], [IncrementAfterMultiplier]) | Soma o incremento, aplica o multiplicador e soma o incremento pós-multiplicação | 320 |
Resultado con Restart
| Dados | Descrição | |
|---|---|---|
| 100 | Acumulado (valor del período anterior) | |
| 100 | Incremento | |
| 10% | Multiplicador % | |
| 100 | Incremento após multiplicação | |
| 0 | Restart | |
| Fórmula | Descrição | Resultado |
| [Acumulado] = CumAdjust([Increment], [Multiplier %], [IncrementAfterMultiplier], [Restart]) | Calcula o acumulado e reinicia no próximo período com o valor de Restart | 320 (atual), 0 (próximo) |
Ejemplo de aplicación del Restart:
Descripción del Resultado: O parâmetro Restart substitui o valor acumulado no período atual, fazendo com que o próximo período inicie com o valor informado em Restart ao invés do valor calculado.
¶ 7.10 Cumulate
Descripción:
Acumula progresivamente los valores de un miembro a lo largo de los períodos, retornando la suma de todos los valores desde el primer período hasta el período actual. En cada período, el resultado es la suma de los valores de todos los períodos anteriores más el valor del período actual. Se utiliza para calcular totales acumulados en el año (YTD), acumulados de ventas o cualquier métrica que deba sumarse progresivamente.
Sintaxis:
Cumulate(Value[, TipoCalculo])
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor a ser acumulado período a período | Membro, Membro com Escopo | Sí | No |
| TipoCalculo | Tipo de cálculo a ser utilizado: "normal" (padrão), "window" ou "windowfull" |
Valor | No | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| Jan: 100,00 | Receita de Janeiro (Value) |
| Fev: 150,00 | Receita de Fevereiro |
| Mar: 120,00 | Receita de Março |
| Fórmula | Período | Resultado Acumulado |
|---|---|---|
| Cumulate([Receita Mensal]) | Janeiro | 100,00 |
| Cumulate([Receita Mensal]) | Fevereiro | 250,00 |
| Cumulate([Receita Mensal]) | Março | 370,00 |
Descripción del Resultado: A função soma todos os valores desde o início até o período atual. Em março, o acumulado de R$ 370,00 representa a soma de janeiro (100,00) + fevereiro (150,00) + março (120,00).
¶ 7.11 Delay
Descripción:
Distribuye un valor de entrada a lo largo de múltiples períodos futuros, aplicando un porcentaje específico a cada período de desfase. Cada parámetro %Period corresponde a un período desplazado en relación al período de la transacción original. Se utiliza ampliamente para modelar morosidad, cobros en cuotas de ventas o pagos distribuidos en el tiempo.
Sintaxis:
Delay(Input, %Period1, %Period2, ..., %PeriodN)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Input | Valor total a ser distribuído pelos períodos | Membro, Membro com Escopo | Sí | No |
| % Period | Percentual a ser aplicado em cada período de defasagem | Membro, Membro com Escopo, Número | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 10.000,00 | Valor da venda (Input) |
| 40% | Recebimento no mês da venda (1º %Period) |
| 35% | Recebimento no mês seguinte (2º %Period) |
| 25% | Recebimento em 2 meses (3º %Period) |
| Fórmula | Período | Resultado |
|---|---|---|
| Delay([Vendas], [% Mês 0], [% Mês 1], [% Mês 2]) | Janeiro (mês da venda) | 4.000,00 |
| Delay([Vendas], [% Mês 0], [% Mês 1], [% Mês 2]) | Fevereiro | 3.500,00 |
| Delay([Vendas], [% Mês 0], [% Mês 1], [% Mês 2]) | Março | 2.500,00 |
Descripción del Resultado: O valor da venda de R$ 10.000,00 é distribuído ao longo de 3 meses: 40% (R$ 4.000,00) recebido no mês da venda, 35% (R$ 3.500,00) no mês seguinte e 25% (R$ 2.500,00) dois meses depois. A soma dos percentuais deve totalizar 100%.
¶ 7.12 Depr
Descripción:
Calcula la depreciación lineal de un bien o activo con base en su valor y tiempo de vida útil. La fórmula es: Depreciación = Valor del Bien ÷ Vida Útil. La depreciación lineal distribuye la pérdida de valor de forma constante y uniforme en cada período. Se utiliza en planificación financiera para provisionar la desvalorización de activos fijos como equipos, vehículos e instalaciones.
Sintaxis:
Depr(Capitalization, Life)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Capitalization | Valor do bem a ser depreciado | Membro, Membro com Escopo | Sí | No |
| Life | Tempo de vida útil do bem (em períodos) | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| 60.000,00 | Valor do veículo (Capitalization) |
| 60 | Vida útil em meses (Life) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Depr([Valor Veículo], [Vida Útil]) | Calcula a depreciação linear mensal do veículo | 1.000,00 por mês |
Descripción del Resultado: O veículo de R$ 60.000,00 é depreciado linearmente ao longo de 60 meses, gerando uma despesa de depreciação de R$ 1.000,00 por mês. Ao final dos 60 meses, o valor total depreciado será igual ao valor original do bem.
¶ 7.13 Descendants
Descripción:
Retorna el valor de los miembros descendientes de un miembro en la jerarquía, excluyendo el valor del propio miembro especificado. Es decir, retorna solo la suma de los miembros hijos y todos los niveles inferiores. Se utiliza cuando se desea obtener el detalle de un total jerárquico sin incluir el valor agregado del nivel padre, como obtener las ventas por región sin incluir el total general.
Sintaxis:
Descendants(Member)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Member | Membro pai cujos descendentes serão retornados | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| Total Vendas: 300.000,00 | Membro pai (não incluído no resultado) |
| Sul: 80.000,00 | Descendente 1 |
| Sudeste: 120.000,00 | Descendente 2 |
| Norte: 100.000,00 | Descendente 3 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Descendants([Total Vendas]) | Retorna os valores de cada região descendente, sem incluir o total | Sul: 80.000, Sudeste: 120.000, Norte: 100.000 |
Descripción del Resultado: A função retorna os valores das três regiões (Sul, Sudeste e Norte) sem incluir o valor agregado de "Total Vendas". Es útil para detalhar componentes individuais de uma hierarquia sem o risco de duplicar o total.
¶ 7.14 DiffFirstValue
Descripción:
Calcula la diferencia entre el valor del miembro actual y el primer valor encontrado en la jerarquía, considerando desplazamientos vertical (nivel padre) y horizontal (período). Se utiliza para análisis comparativos en estructuras jerárquicas, como calcular la variación de cada mes en relación al primer mes del año o de cada producto en relación al producto base de la jerarquía.
Sintaxis:
DiffFirstValue(Item, Parent, Lag, Dimension)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor do membro para o qual se calcula a diferença | Membro, Membro com Escopo, Bloco | Sí | No |
| Parent | Deslocamento vertical na hierarquia (nivel padre) | Número Inteiro Positivo | Sí | No |
| Lag | Deslocamento horizontal (períodos) | Número Inteiro | Sí | No |
| Dimension | Dimensão em que o primeiro valor será buscado | Dimensão, Hierarquia | No | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| Jan/24: 100.000,00 | Receita de Janeiro (primeiro valor na hierarquia Tempo) |
| Fev/24: 120.000,00 | Receita de Fevereiro |
| Mar/24: 140.000,00 | Receita de Março |
| Fórmula | Período | Resultado |
|---|---|---|
| DiffFirstValue([Receita], 0, 0, [Tempo]) | Janeiro | 0 |
| DiffFirstValue([Receita], 0, 0, [Tempo]) | Fevereiro | 20.000,00 |
| DiffFirstValue([Receita], 0, 0, [Tempo]) | Março | 40.000,00 |
Descripción del Resultado: A função subtrai o primeiro valor da hierarquia (Janeiro = R$ 100.000,00) do valor de cada período. Fevereiro apresenta variação de +R$ 20.000,00 e março de +R$ 40.000,00 em relação ao primeiro mês.
¶ 7.15 DiffLastValue
Descripción:
Calcula la diferencia entre el valor del miembro actual y el último valor encontrado en la jerarquía, considerando desplazamientos vertical (nivel padre) y horizontal (período). Se utiliza para análisis de variación en relación al cierre, como comparar cada mes con el resultado final del año o identificar cuánto está cada ítem por debajo o por encima del último valor de referencia.
Sintaxis:
DiffLastValue(Item, Parent, Lag, Dimension)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor do membro para o qual se calcula a diferença | Membro, Membro com Escopo, Bloco | Sí | No |
| Parent | Deslocamento vertical na hierarquia (nivel padre) | Número Inteiro Positivo | Sí | No |
| Lag | Deslocamento horizontal (períodos) | Número Inteiro | Sí | No |
| Dimension | Dimensão em que o último valor será buscado | Dimensão, Hierarquia | No | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| Jan/24: 100.000,00 | Receita de Janeiro |
| Fev/24: 120.000,00 | Receita de Fevereiro |
| Mar/24: 140.000,00 | Receita de Março (último valor na hierarquia Tempo) |
| Fórmula | Período | Resultado |
|---|---|---|
| DiffLastValue([Receita], 0, 0, [Tempo]) | Janeiro | -40.000,00 |
| DiffLastValue([Receita], 0, 0, [Tempo]) | Fevereiro | -20.000,00 |
| DiffLastValue([Receita], 0, 0, [Tempo]) | Março | 0 |
Descripción del Resultado: A função subtrai o último valor da hierarquia (Março = R$ 140.000,00) do valor de cada período. Janeiro apresenta -R$ 40.000,00 e fevereiro -R$ 20.000,00 em relação ao mês de fechamento.
¶ 7.16 DiffPercent
Descripción:
Calcula la variación porcentual entre el valor del período actual y el valor de un período anterior, con base en un paso configurable. La fórmula es: (Valor Actual - Valor Anterior) / Valor Anterior × 100. El parámetro Step define cuántos períodos de desfase considerar (predeterminado: 1). Se utiliza para calcular crecimiento porcentual mes a mes, trimestre a trimestre o entre dos períodos cualesquiera.
Sintaxis:
DiffPercent(Value, Step)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base para calcular a variação percentual | Membro, Membro com Escopo | Sí | No |
| Step | Número de períodos de defasagem para comparação (padrão: 1) | Membro, Membro com Escopo, Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
| Dados | Descrição |
|---|---|
| Jan/24: 100.000,00 | Receita de Janeiro |
| Fev/24: 120.000,00 | Receita de Fevereiro |
| Mar/24: 114.000,00 | Receita de Março |
| Fórmula | Período | Resultado |
|---|---|---|
| DiffPercent([Receita Mensal], 1) | Janeiro | - (sem período anterior) |
| DiffPercent([Receita Mensal], 1) | Fevereiro | 20,00% |
| DiffPercent([Receita Mensal], 1) | Março | -5,00% |
Descripción del Resultado: A função retorna a variação percentual em relação ao período anterior. Fevereiro cresceu 20% sobre janeiro ((120.000 - 100.000) / 100.000 × 100). Março caiu 5% sobre fevereiro ((114.000 - 120.000) / 120.000 × 100). Para o primeiro período não há cálculo pois não existe período anterior de referência.
¶ 7.17 DiffProportion
Descripción:
Calcula la diferencia proporcional entre el valor del período actual y el valor de un período anterior, utilizando la fórmula (actual - anterior) / actual. Útil para análisis de crecimiento relativo, identificando la variación porcentual de un valor en relación al período de referencia.
El parámetro Step controla cuántos períodos atrás se hará la comparación. Cuando se omite, el valor predeterminado es 1 (período inmediatamente anterior).
Sintaxis:
DiffProportion(Value, Step)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor base para o cálculo da diferença proporcional | Membro, Membro com Escopo, Bloco | Sí | No |
| Step | Número de períodos de distância para a comparação | Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
| Período | Receita Mensal |
|---|---|
| Janeiro | R$ 100.000 |
| Fevereiro | R$ 120.000 |
| Março | R$ 150.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| DiffProportion([Receita Mensal], 1) | Calcula a diferença proporcional entre o mês atual e o mês anterior. | Fevereiro: 0,1667 ((120k - 100k) / 120k), Março: 0,2 ((150k - 120k) / 150k) |
Descripción del Resultado: A função retorna a variação proporcional entre os períodos. Para o primeiro período (Janeiro) não há resultado, pois não existe período anterior para comparação.
¶ 7.18 DiffValue
Descripción:
Calcula la diferencia absoluta en valor entre el período actual y un período anterior, utilizando la fórmula actual - anterior. Útil para análisis de variación temporal, identificando el crecimiento o decrecimiento absoluto entre períodos consecutivos o con intervalos personalizados.
El parámetro Step controla cuántos períodos atrás se hará la comparación. Cuando se omite, el valor predeterminado es 1 (período inmediatamente anterior).
Sintaxis:
DiffValue(Value, Step)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base para o cálculo da diferença absoluta | Membro, Membro com Escopo, Bloco | Sí | No |
| Step | Número de períodos de distância para a comparação | Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
| Período | Receita Mensal |
|---|---|
| Janeiro | R$ 100.000 |
| Fevereiro | R$ 120.000 |
| Março | R$ 150.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| DiffValue([Receita Mensal], 1) | Calcula a diferença em valor entre o mês atual e o mês anterior. | Fevereiro: R$ 20.000 (120k - 100k), Março: R$ 30.000 (150k - 120k) |
Descripción del Resultado: A função retorna a variação absoluta entre os períodos. Para o primeiro período (Janeiro) não há resultado, pois não existe período anterior para comparação.
¶ 7.19 Expand
Descripción:
Expande un ítem de un nivel jerárquico a los miembros hijos dentro de un intervalo de niveles especificado, utilizando INNER JOIN en las tablas de jerarquía de la dimensión. Permite distribuir un valor de un nivel superior a todos sus descendientes entre el nivel inicial y el nivel final.
Es posible especificar múltiples pares de dimensión/nivel para trabajar con diferentes dimensiones simultáneamente.
Sintaxis:
Expand(Item, Level Start, Level End)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Item a ser expandido na hierarquia | Membro, Membro com Escopo, Bloco | Sí | No |
| Level Start | Dimensão e nível de início da expansão | Dimensão, Nível | Sí | Sí |
| Level End | Dimensão e nível final da expansão | Dimensão, Nível | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Nível | Membros |
|---|---|
| Região | Sul, Sudeste |
| Estado | Paraná, São Paulo |
| Cidade | Curitiba, Londrina, Campinas, São Paulo (SP) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Expand([Vendas], [Entidade].[Região], [Entidade].[Cidade]) | Expande o valor de [Vendas] do nível Região até o nível Cidade, distribuindo para cada cidade correspondente. | Sul → Curitiba: R$ 300, Londrina: R$ 200; Sudeste → Campinas: R$ 700, São Paulo (SP): R$ 500 |
Descripción del Resultado: A função percorre os níveis da jerarquía de la dimensión Entidade, do nível Região até o nível Cidade, retornando os valores detalhados de cada membro descendente.
¶ 7.20 Filter
Descripción:
Filtra un bloque de valores por los atributos de miembros de una dimensión, utilizando INNER JOIN en las tablas de atributos. Retorna solo los valores cuyos miembros satisfagan las condiciones de atributo informadas.
Permite aplicar múltiples filtros simultáneamente, combinando diferentes atributos de diferentes dimensiones para refinar el conjunto de datos retornado.
Sintaxis:
Filter(Item, Attribute)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Bloco de dados a ser filtrado | Bloco | Sí | No |
| Atributo | Dimensão, atributo e valor pelo qual filtrar os membros | Dimensão, Atributo, Valor | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Produto | Categoria | Vendas |
|---|---|---|
| Smartphone | Eletrônicos | R$ 10.000 |
| TV | Eletrônicos | R$ 15.000 |
| Geladeira | Eletrodomésticos | R$ 8.000 |
| Máquina de Lavar | Eletrodomésticos | R$ 7.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Filter([Vendas], [Produto].[Categoria].[Eletrônicos]) | Filtra o bloco [Vendas] para incluir apenas produtos com atributo Categoria igual a Eletrônicos. | Smartphone: R$ 10.000, TV: R$ 15.000 |
| Filter([Vendas], [Produto].[Categoria].[Eletrodomésticos]) | Filtra o bloco [Vendas] para incluir apenas produtos com atributo Categoria igual a Eletrodomésticos. | Geladeira: R$ 8.000, Máquina de Lavar: R$ 7.000 |
Descripción del Resultado: A função Filter percorre os membros da dimensão Produto e retorna somente os valores dos membros cujo atributo Categoria corresponde ao valor especificado.
¶ 7.21 First Value
Descripción:
Retorna el primer valor de un ítem dentro de una jerarquía, considerando desplazamientos vertical (cuántos niveles arriba en la jerarquía) y horizontal (cuántos períodos de offset). Útil para buscar el valor inicial de una secuencia dentro de un grupo jerárquico.
El parámetro Dimension permite especificar explícitamente la dimensión sobre la cual navegar; cuando se omite, utiliza la dimensión de tiempo predeterminada.
Sintaxis:
FirstValue(Item, Parent, Lag, Dimension)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Item do qual se deseja buscar o primeiro valor | Membro, Membro com Escopo, Bloco | Sí | No |
| Parent | Deslocamento vertical na hierarquia (número de níveis acima) | Número Inteiro Positivo | Sí | No |
| Lag | Deslocamento horizontal (offset de períodos) | Número Inteiro | Sí | No |
| Dimension | Dimensão e hierarquia para navegação | Dimensão, Hierarquia | No | Sí |
Haga clic aquí para ver un ejemplo:
| Semestre | Trimestre | Mês | Receita |
|---|---|---|---|
| 1S/25 | 1T/25 | Janeiro/25 | R$ 50.000 |
| 1S/25 | 1T/25 | Fevereiro/25 | R$ 60.000 |
| 1S/25 | 1T/25 | Março/25 | R$ 55.000 |
| 1S/25 | 2T/25 | Abril/25 | R$ 70.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| FirstValue([Receita], 1, 0, [Tempo].[Mensal]) | Retorna o primeiro mês de cada trimestre (1 nível acima = Trimestre), sem offset horizontal. | 1T/25: R$ 50.000 (Janeiro), 2T/25: R$ 70.000 (Abril) |
Descripción del Resultado: A função identifica o primeiro valor dentro del grupo determinado pelo nivel padre (Trimestre), retornando a Receita do mês inicial de cada trimestre.
¶ 7.22 Floor
Descripción:
Redondea un número hacia abajo, retornando el mayor valor entero (o con la precisión especificada) que sea menor o igual al valor proporcionado. Utiliza la función SQL FLOOR() internamente.
A diferencia del redondeo convencional, el Floor siempre redondea en dirección al menos infinito, independientemente de la parte decimal del número. El parámetro Precisión define el número de decimales a mantener; cuando se omite, redondea al entero más próximo hacia abajo.
Sintaxis:
Floor(Number, Precision)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Number | Valor numérico a ser arredondado para baixo | Membro, Membro com Escopo, Bloco | Sí | No |
| Precision | Número de casas decimais a preservar | Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
| Produto | Preço Calculado |
|---|---|
| Produto A | R$ 43,14 |
| Produto B | R$ 18,89 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Floor([Preço Calculado], 1) | Arredonda para baixo com 1 casa decimal. | Produto A: R$ 43,10; Produto B: R$ 18,80 |
| Floor([Preço Calculado]) | Arredonda para baixo sem casas decimais. | Produto A: R$ 43,00; Produto B: R$ 18,00 |
Descripción del Resultado: A função Floor garante que os valores sejam sempre redondeados hacia abajo, nunca ultrapassando o valor original. Útil para cálculos de precificação e regras financeiras que exigem valores conservadores.
¶ 7.23 GetApplicationData
Descripción:
Lee e integra datos de otra aplicación (cubo de planificación) en la fórmula actual. Permite referenciar valores calculados o almacenados en un cubo diferente, realizando el mapeo de las dimensiones entre las aplicaciones automáticamente.
Si la aplicación de destino posee el mismo ID de dimensión que la aplicación de origen, los datos se traen manteniendo el mapeo. Las dimensiones presentes en la aplicación de destino pero ausentes en la de origen se completan con el valor -1 (no aplicable).
Sintaxis:
GetApplicationData(Aplicação, Membro)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Aplicação | Aplicação de origem dos dados | Aplicação | Sí | No |
| Membro | Membro da aplicação de origem que contém os dados | Membro, Membro com Escopo | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Dado | Descrição |
|---|---|
| Planejamento Comercial | Aplicação de origem |
| [Conta].[Receita Bruta] | Membro da dimensão Conta na aplicação de origem |
| Fórmula | Descrição | Resultado |
|---|---|---|
| [Conta].[Receita Consolidada] = GetApplicationData([Planejamento Comercial], [Conta].[Receita Bruta]) | Carrega os valores do membro Receita Bruta da aplicação Planejamento Comercial para o membro Receita Consolidada na aplicação atual. | Os valores de Receita Bruta são copiados para Receita Consolidada, com as dimensões mapeadas automaticamente. |
Si en la aplicación de destino existe el mismo ID de dimensión que la aplicación configurada en el parámetro "Aplicación", los datos serán traídos y mantenidos iguales. Si el ID de la dimensión existe en la aplicación de destino pero no en la de origen, se colocará en -1 (no aplicable).
¶ 7.24 GetDataTableData
Descripción:
Lee e integra datos almacenados en una Tabla de Datos (DataTable) en la fórmula actual. Permite consultar datos externos o de referencia sin necesidad de almacenarlos directamente en las estructuras dimensionales del cubo.
Si la tabla de datos posee una columna vinculada a una dimensión, el sistema realiza el mapeo automáticamente. Las dimensiones no informadas en el alcance se tratan como "No aplicable".
Sintaxis:
GetDataTableData(Tabela, Coluna)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Tabela | Tabela de dados de origem | Tabela | Sí | No |
| Coluna | Coluna da tabela de dados que contém os valores ou o mapeamento dimensional | Coluna | No | Sí |
Haga clic aquí para ver un ejemplo:
| Tabela de Dados | Coluna | Valor |
|---|---|---|
| Total de Itens Vendidos | Valor | 500 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| ([Conta].[Produtos], [Tempo].[Março/25], [Cenário].[Planejado]) = GetDataTableData([Total de Itens Vendidos], [Valor]) | Carrega o valor da coluna Valor da tabela Total de Itens Vendidos para o escopo definido. | Carrega o valor 500 para o membro Produtos no mês Março/25, cenário Planejado. |
En dimensiones no informadas en el alcance, el sistema asume No aplicable.
Si la tabla de datos posee una columna vinculada (link) a una dimensión, no es necesario informar esa dimensión en el alcance — el sistema hará el mapeo automáticamente.
Ejemplo de fórmula utilizando link para dimensión tiempo: ([Produtos], [Cenário].[Planejado]) = GetDataTableData([Total de Itens Vendidos]). En este ejemplo, la tabla de datos posee una columna vinculada a la dimensión tiempo.
¶ 7.25 Group
Descripción:
Agrega valores de un bloque a un nivel jerárquico superior de la dimensión, utilizando SUM e INNER JOIN en las tablas de niveles. La función asciende en la jerarquía, consolidando los valores de los miembros hijos en sus respectivos miembros padre en el nivel especificado.
Los pares de dimensión y nivel pueden repetirse para agrupar por múltiples dimensiones simultáneamente.
Sintaxis:
Group(Item, Level)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Bloco de dados a ser agrupado | Bloco | Sí | No |
| Level | Dimensão e nível de destino para o agrupamento | Dimensão, Nível | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Cidade | Estado | País | Vendas |
|---|---|---|---|
| Ubatuba | São Paulo | Brasil | R$ 10.000 |
| Campinas | São Paulo | Brasil | R$ 8.000 |
| Niterói | Rio de Janeiro | Brasil | R$ 12.000 |
| Fórmula | Resultado | |
|---|---|---|
| Group([Vendas], [Entidade].[País]) | País | Total |
| Brasil | R$ 30.000 |
| Fórmula | Resultado | |
|---|---|---|
| Group([Vendas], [Entidade].[Estado]) | Estado | Total |
| São Paulo | R$ 18.000 | |
| Rio de Janeiro | R$ 12.000 |
Descripción del Resultado: A função Group consolida los valores das ventas por diferentes niveles jerárquicos de la dimensión Entidad, sumando los valores dos miembros hijos en el nivel informado.
¶ 7.26 HasValue
Descripción:
Verifica si un ítem tiene valor registrado (diferente de nulo), retornando 1 si el valor existe y 0 en caso contrario. Utiliza LEFT JOIN y CASE internamente para identificar la presencia de datos en el cubo.
Útil para identificar la presencia de datos en análisis, especialmente cuando se desea filtrar o contar celdas con valores significativos en reportes.
Sintaxis:
HasValue(Valor)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Valor | Item a ser verificado quanto à existência de valor | Membro, Membro com Escopo, Bloco | Sí | No |
Haga clic aquí para ver un ejemplo:
| Produto | Janeiro/25 | Fevereiro/25 | Março/25 |
|---|---|---|---|
| Produto A | R$ 500 | R$ 700 | - (NULL) |
| Produto B | - (NULL) | - (NULL) | - (NULL) |
| Produto C | R$ 300 | - (NULL) | R$ 900 |
| Fórmula | Produto | Janeiro/25 | Fevereiro/25 | Março/25 |
|---|---|---|---|---|
| HasValue([Vendas]) | Produto A | 1 | 1 | 0 |
| Produto B | 0 | 0 | 0 | |
| Produto C | 1 | 0 | 1 |
Descripción del Resultado: A função HasValue retorna 1 para celdas que possuem valores registrados e 0 para celdas nulas. Es útil para identificar la presencia de datos e construir fórmulas condicionales basadas en la existencia de valores.
¶ 7.27 IIF
Descripción:
Función condicional que evalúa una expresión lógica y retorna un valor si la condición es verdadera u otro valor si la condición es falsa. Es posible encadenar múltiples condiciones usando lógica AND.
La condición está formada por tres elementos: el operando izquierdo, un comparador y el operando derecho. Cuando el parámetro Else se omite, la función retorna nulo para el caso falso.
Sintaxis:
IIF(Condition Left Comparator Condition Right, Then, Else)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Condition Left | Operando esquerdo da condição | Membro, Membro com Escopo, Número | Sí | No |
| Comparador | Operador de comparación (=, <>, <, >, <=, >=) | Comparador | Sí | No |
| Condition Right | Operando direito da condição | Membro, Membro com Escopo, Número | Sí | No |
| Then | Valor retornado quando a condición es verdadera | Membro, Membro com Escopo, Número, Condicional | Sí | No |
| Else | Valor retornado quando a condición es falsa | Membro, Membro com Escopo, Número, Condicional | No | No |
Comentarios: Nem todas as combinações possíveis entre operandos e comparadores são válidas. Segue abaixo a lista de combinações válidas:
Haga clic para expandir las posibles combinaciones
- Membro, Menor o Igual, Membro- Membro, Mayor o Igual, Membro
- Membro, Diferente, Membro
- Membro, Igual, Membro
- Membro, Menor, Membro
- Membro, Mayor, Membro
- Membro, Menor o Igual, Número
- Membro, Mayor o Igual, Número
- Membro, Diferente, Número
- Membro, Igual, Número
- Membro, Menor, Número
- Membro, Mayor, Número
- Número, Menor o Igual, Membro
- Número, Mayor o Igual, Membro
- Número, Diferente, Membro
- Número, Igual, Membro
- Número, Menor, Membro
- Número, Mayor, Membro
- Membro, Menor o Igual, Propriedade
- Membro, Mayor o Igual, Propriedade
- Membro, Diferente, Propriedade
- Membro, Igual, Propriedade
- Membro, Menor, Propriedade
- Membro, Mayor, Propriedade
- Propriedade, Menor o Igual, Membro
- Propriedade, Mayor o Igual, Membro
- Propriedade, Diferente, Membro
- Propriedade, Igual, Membro
- Propriedade, Menor, Membro
- Propriedade, Mayor, Membro
- Número, Menor o Igual, Propriedade * **
- Número, Mayor o Igual, Propriedade * **
- Número, Diferente, Propriedade * **
- Número, Igual, Propriedade * **
- Número, Menor, Propriedade * **
- Número, Mayor, Propriedade * **
- Propriedade, Menor o Igual, Número * **
- Propriedade, Mayor o Igual, Número * **
- Propriedade, Diferente, Número * **
- Propriedade, Igual, Número * **
- Propriedade, Menor, Número * **
- Propriedade, Mayor, Número * **
- Constante, Diferente, Propriedade * ***
- Constante, Igual, Propriedade * ***
- Propriedade, Diferente, Constante * ***
- Propriedade, Igual, Constante * ***
* Válido solo si los parámetros True (y False si existe) son miembros.
** Válido solo si el tipo de la propiedad es compatible con un número.
*** Válido solo si el tipo de la propiedad es compatible con un texto.
Haga clic aquí para ver un ejemplo:
| Produto | Vendas | Meta |
|---|---|---|
| Produto A | R$ 50.000 | R$ 40.000 |
| Produto B | R$ 5.000 | R$ 40.000 |
| Produto C | R$ 30.000 | R$ 40.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| IIF([Vendas] >= 10000, [Vendas], 0) | Retorna [Vendas] quando maior ou igual a R$ 10.000; caso contrário, retorna 0. | Produto A: R$ 50.000, Produto B: 0, Produto C: R$ 30.000 |
| IIF([Vendas] > [Meta], [Vendas], [Meta]) | Retorna [Vendas] se superar a [Meta]; caso contrário, retorna [Meta]. | Produto A: R$ 50.000, Produto B: R$ 40.000, Produto C: R$ 40.000 |
Descripción del Resultado: A função IIF evalúa la condición para cada miembro del alcance e retorna el valor correspondente ao resultado verdadero o falso. Útil para aplicar reglas de negocio condicionales directamente en las fórmulas, sin necesidad de fórmulas separadas para cada caso.
¶ 7.28 IPMT
Descripción:
Calcula el valor de los intereses pagados en un período específico de un préstamo o financiamiento, basado en pagos periódicos constantes y tasa de interés constante. Útil para determinar cuánto de cada cuota corresponde a intereses en un cronograma de amortización.
Sintaxis:
IPMT(Taxa, Período, Nper, Valor Presente, Valor Futuro, Tipo)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Taxa | Tasa de interés por período | Membro, Membro com Escopo | Sí | No |
| Período | Número do período para o qual se deseja calcular os juros | Membro, Membro com Escopo | Sí | No |
| Nper | Número total de períodos (parcelas) | Membro, Membro com Escopo | Sí | No |
| Valor Presente | Valor presente do empréstimo (principal) | Membro, Membro com Escopo | Sí | No |
| Valor Futuro | Saldo desejado ao final do contrato (predeterminado: 0) | Membro, Membro com Escopo | No | No |
| Tipo | Momento del vencimiento: 0 = final del período, 1 = inicio del período | Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
| Fórmula | Descrição | Resultado |
|---|---|---|
| IPMT(0.02, 5, 12, -10000, 0, 0) | Calcula os intereses pagados na 5ª cuota de um empréstimo de R$ 10.000 com taxa de 2% ao mês, 12 parcelas, pagamentos ao final del período. | R$ 142,83 |
| Parâmetro | Valor | Descrição |
|---|---|---|
| Taxa | 0,02 (2%) | Tasa de interés mensal aplicada. |
| Período | 5 | Período para o qual os juros serão calculados. |
| Nper | 12 | Número total de parcelas. |
| Valor Presente | -10.000 | Valor do empréstimo (negativo = salida de caja). |
| Valor Futuro | 0 | Saldo zero ao final — empréstimo totalmente quitado. |
| Tipo | 0 | Pagamentos ao final de cada período. |
Descripción del Resultado: Os juros da 5ª cuota são calculados sobre o saldo deudor restante después de los 4 primeros pagos, multiplicado pela tasa mensual. Neste caso, os intereses pagados no 5º período totalizan R$ 142,83.
¶ 7.29 Lag
Descripción:
Desplaza los valores de un bloque de datos por un número especificado de períodos a lo largo de una dimensión, utilizando una tabla de diferencias dimensionales (diff table). Valores positivos desplazan hacia el futuro (atraso); valores negativos desplazan hacia el pasado (anticipación).
Cuando el parámetro Dimensión se omite, el desplazamiento se aplica sobre la dimensión de tiempo predeterminada de la aplicación.
Sintaxis:
Lag(Item, Período[, Padding[, Dimensão]])
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Bloco de dados a ser deslocado nos períodos | Bloco, Membro, Membro com Escopo | Sí | No |
| Período | Número de períodos a deslocar (positivo = futuro, negativo = passado) | Número Inteiro, Membro, Membro com Escopo | Sí | No |
| Padding | Valor a ser adicionado nos períodos de origem que ficam sem valor após o deslocamento | Membro, Membro com Escopo | No | No |
| Dimensão | Dimensão sobre a qual aplicar o deslocamento (padrão: dimensión de tiempo) | Dimensão, Hierarquia | No | No |
Haga clic aquí para ver un ejemplo:
| Mês | Receita |
|---|---|
| Maio/25 | R$ 10.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Lag([Receita], 3) | Desloca o valor 3 meses para o futuro. | R$ 10.000 em Agosto/25 |
| Lag([Receita], -3) | Desloca o valor 3 meses para o passado. | R$ 10.000 em Fevereiro/25 |
Descripción del Resultado: A função Lag move o valor del período de origem para o período de destino calculado. El período original queda sin valor e el período de destino recibe o valor. Útil en planificación financeiro para modelar pagos diferidos o anticipados.
¶ 7.30 LastNonEmpty
Descripción:
Retorna el último valor no nulo (no vacío) de un miembro al recorrer la jerarquía de la dimensión especificada. Útil para recuperar el valor más reciente disponible en series temporales con lagunas de datos, como saldos acumulados o precios de la última actualización.
Sintaxis:
LastNonEmpty(Item[, Dimensão])
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Membro do qual se deseja obter el último valor no vacío | Membro, Membro com Escopo, Bloco | Sí | No |
| Dimensão | Dimensão na qual a busca pelel último valor no vacío será realizada (padrão: dimensión de tiempo) | Dimensão | No | No |
Haga clic aquí para ver un ejemplo:
| Período | Saldo de Caixa |
|---|---|
| Janeiro | R$ 5.000 |
| Fevereiro | R$ 8.000 |
| Março | - (NULL) |
| Abril | R$ 10.000 |
| Maio | - (NULL) |
| Fórmula | Descrição | Resultado |
|---|---|---|
| LastNonEmpty([Saldo de Caixa]) | Retorna el último valor no vacío do Saldo de Caixa na hierarquia da dimensión de tiempo. | R$ 10.000 (último valor não nulo, referente a Abril) |
Descripción del Resultado: A função LastNonEmpty recorre la jerarquía da dimensión de tiempo e retorna el último valor registrado que não seja nulo. No exemplo, Abril é o último mes con valor, por lo tanto el resultado é R$ 10.000.
¶ 7.31 LastValue
Descripción:
Retorna el último valor de un ítem dentro de una jerarquía, considerando desplazamientos vertical (cuántos niveles arriba en la jerarquía) y horizontal (cuántos períodos de offset). Útil para buscar el valor final de una secuencia dentro de un grupo jerárquico.
El parámetro Dimension permite especificar explícitamente la dimensión sobre la cual navegar; cuando se omite, utiliza la dimensión de tiempo predeterminada.
Sintaxis:
LastValue(Item, Parent, Lag, Dimension)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Item do qual se deseja buscar o último valor | Membro, Membro com Escopo, Bloco | Sí | No |
| Parent | Deslocamento vertical na hierarquia (número de níveis acima) | Número Inteiro Positivo | Sí | No |
| Lag | Deslocamento horizontal (offset de períodos) | Número Inteiro | Sí | No |
| Dimension | Dimensão e hierarquia para navegação | Dimensão, Hierarquia | No | Sí |
Haga clic aquí para ver un ejemplo:
| Semestre | Trimestre | Mês | Receita Bruta |
|---|---|---|---|
| 1S/25 | 1T/25 | Janeiro/25 | R$ 100.000 |
| 1S/25 | 1T/25 | Fevereiro/25 | R$ 110.000 |
| 1S/25 | 1T/25 | Março/25 | R$ 105.000 |
| 1S/25 | 2T/25 | Abril/25 | R$ 120.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| LastValue([Receita Bruta], 1, 0, [Tempo].[Mensal]) | Retorna o último mês de cada trimestre (1 nível acima = Trimestre), sem offset horizontal. | 1T/25: R$ 105.000 (Março), 2T/25: R$ 120.000 (Abril) |
Descripción del Resultado: A função LastValue identifica el último valor dentro del grupo determinado pelo nivel padre (Trimestre), retornando a Receita Bruta do mes final de cada trimestre.
¶ 7.32 LGrow
Descripción:
Aplica crecimiento lineal a un valor a lo largo de los períodos, agregando un incremento fijo más un factor creciente en cada etapa. La fórmula aplicada es: Start + Grow + (Grow × paso × %Grow Rate), donde paso es el número secuencial del período calculado automáticamente.
Útil para modelar proyecciones de crecimiento donde tanto el valor base como la tasa de crecimiento son constantes a lo largo del tiempo.
Sintaxis:
LGrow(Start, Grow, % Grow Rate)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Start | Valor inicial (base de partida) | Membro, Membro com Escopo | Sí | No |
| Grow | Incremento fixo adicionado a cada período e usado como base para o factor de crecimiento | Membro, Membro com Escopo | Sí | No |
| % Grow Rate | Taxa de crescimento percentual aplicada sobre o incremento a cada período | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Parâmetro | Valor |
|---|---|
| Start | R$ 10.000 |
| Grow | R$ 1.000 |
| % Grow Rate | 5% (0,05) |
| Fórmula | Período | Resultado |
|---|---|---|
| LGrow([Start], [Grow], [% Grow Rate]) | Janeiro (passo 0) | R$ 11.000 (10.000 + 1.000 + 1.000 × 0 × 0,05) |
| Fevereiro (passo 1) | R$ 12.050 (10.000 + 1.000 + 1.000 × 1 × 0,05) | |
| Março (passo 2) | R$ 13.100 (10.000 + 1.000 + 1.000 × 2 × 0,05) |
Descripción del Resultado: A função LGrow projeta valores crecientes a lo largo de los períodos. O crecimiento es lineal: en cada período el valor crece pelo incremento fijo (Grow) mais o efecto de la tasa porcentual multiplicada por el número de paso.
¶ 7.33 List
Descripción:
Verifica el valor de una cuenta con lista y retorna un valor específico para cada ítem correspondiente. La función recorre los pares (Ítem de la Lista, Valor) proporcionados y, para cada ítem de la lista que coincida con el valor probado, retorna el valor asociado. Es útil para mapear categorías o tipos predefinidos a valores numéricos distintos dentro de una fórmula.
Sintaxis:
List(Valor a Testar, Item da Lista, Valor, ...)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Valor a Testar | Membro cujo valor será comparado com os itens da lista | Membro, Membro com Escopo | Sí | No |
| Item da Lista | Item da lista vinculado predefinida que será comparado | Lista | Sí | Sí |
| Valor | Valor retornado quando o item da lista coincidir com el valor probado | Membro, Membro com Escopo, Número | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Colaborador | Tipo de Benefício |
|---|---|
| João | Vale Alimentação |
| Maria | Vale Transporte |
| Pedro | Plano de Saúde |
| Fórmula | Descrição | Resultado |
|---|---|---|
| List([Tipo de Benefício], "Vale Alimentação", 300, "Vale Transporte", 150, "Plano de Saúde", 450) | Para cada colaborador, retorna el valor correspondente ao tipo de benefício cadastrado. | João: 300 | Maria: 150 | Pedro: 450 |
Descripción del Resultado: A função List evalúa el miembro Tipo de Benefício de cada colaborador y retorna el valor monetario associado al beneficio correspondiente. Os pares lista-valor são percorridos secuencialmente hasta encontrar una coincidencia.
¶ 7.34 LN
Descripción:
Calcula el logaritmo natural (base e ≈ 2,71828) de un valor. El logaritmo natural es ampliamente utilizado en modelos financieros y estadísticos que involucran tasas de crecimiento continuo, cálculo de intereses compuestos o transformaciones de escala para análisis de datos.
Sintaxis:
LN(Item)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor ou membro do qual se deseja calcular o logaritmo natural | Membro, Membro com Escopo, Bloco | Sí | No |
Haga clic aquí para ver un ejemplo:
| Conta | Valor |
|---|---|
| Receita Bruta | 1.000 |
| Receita Líquida | 10.000 |
| Lucro Operacional | 100.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| LN([Receita Bruta]) | Logaritmo natural de 1.000 | ≈ 6,908 |
| LN([Receita Líquida]) | Logaritmo natural de 10.000 | ≈ 9,210 |
| LN([Lucro Operacional]) | Logaritmo natural de 100.000 | ≈ 11,513 |
Descripción del Resultado: A função LN retorna el exponente ao qual e debe ser elevado para producir el valor informado. Es útil para normalizar distribuciones assimétricas de datos financieros ou calcular tasas de crecimiento continuo entre períodos.
¶ 7.35 LoadData
Descripción:
Carga valores de una tabla de datos dentro del cubo, mapeando las columnas de la tabla a las dimensiones correspondientes. La función vincula cada fila de la tabla al contexto dimensional correcto, permitiendo importar datos externos — como resultados de sistemas transaccionales o planillas — directamente en las celdas del cubo durante el cálculo de la fórmula.
Sintaxis:
LoadData(Table, Column Value, Dimension, Dimension Column, ...)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Table | Tabela de origem dos dados | Tabela | Sí | No |
| Column Value | Coluna da tabela que contém o valor a ser carregado | Coluna | Sí | No |
| Dimension | Dimensão del cubo para mapear a coluna | Dimensão | Sí | Sí |
| Dimension Column | Coluna da tabela correspondente à dimensão | Coluna | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Tabela: tb_vendas | ||
|---|---|---|
| cd_produto | cd_periodo | vl_vendas |
| Produto A | 2024-01 | 10.000 |
| Produto B | 2024-01 | 15.000 |
| Produto A | 2024-02 | 12.000 |
| Produto B | 2024-02 | 18.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| LoadData([tb_vendas], [vl_vendas], [Produto], [cd_produto], [Tempo], [cd_periodo]) | Carrega o valor de vendas mapeando pelas dimensões Produto e Tempo. | Valores carregados para cada combinação de produto e período en el cubo. |
Descripción del Resultado: A função LoadData lê cada fila de la tabla tb_vendas, localiza la celda del cubo correspondente usando as columnas de mapeo e rellena el valor da coluna vl_vendas. Múltiples pares Dimensão/Coluna podem ser informados para um mapeo multidimensional.
¶ 7.36 Log
Descripción:
Calcula el logaritmo de un valor en una base especificada. Internamente, la fórmula se calcula como Log(Item) / Log(Base). Es útil en modelos financieros que requieren transformaciones logarítmicas en bases específicas, como base 2 para crecimiento binario o base 10 para escalas de órdenes de magnitud.
Sintaxis:
Log(Item, Base)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Item | Valor ou membro do qual se deseja calcular o logaritmo | Membro, Membro com Escopo, Bloco | Sí | No |
| Base | Base do logaritmo | Número, Membro, Membro com Escopo, Bloco | Sí | No |
Haga clic aquí para ver un ejemplo:
| Conta | Valor |
|---|---|
| Receita Bruta | 1.000 |
| Margem de Contribuição | 8 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Log([Receita Bruta], 10) | Logaritmo de 1.000 na base 10 | 3 |
| Log([Margem de Contribuição], 2) | Logaritmo de 8 na base 2 (2³ = 8) | 3 |
| Log([Receita Bruta], 2) | Logaritmo de 1.000 na base 2 | ≈ 9,966 |
Descripción del Resultado: A função Log calcula o exponente al cual la base debe ser elevada para resultar en el valor informado. A expressão Log(1000, 10) = 3 significa que 10³ = 1.000.
¶ 7.37 Log10
Descripción:
Calcula el logaritmo de base 10 (logaritmo decimal) de un valor. Equivale a Log(Item, 10) y es útil para analizar magnitudes que crecen en órdenes de magnitud, como volúmenes de ventas, poblaciones o cualquier métrica que varíe en múltiplos de 10.
Sintaxis:
Log10(Item)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Item | Valor ou membro do qual se deseja calcular o logaritmo na base 10 | Membro, Membro com Escopo, Bloco | Sí | No |
Haga clic aquí para ver un ejemplo:
| Conta | Valor |
|---|---|
| Vendas Pequenas | 100 |
| Vendas Médias | 10.000 |
| Vendas Grandes | 1.000.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Log10([Vendas Pequenas]) | Log₁₀ de 100 (10² = 100) | 2 |
| Log10([Vendas Médias]) | Log₁₀ de 10.000 (10⁴ = 10.000) | 4 |
| Log10([Vendas Grandes]) | Log₁₀ de 1.000.000 (10⁶ = 1.000.000) | 6 |
Descripción del Resultado: A função Log10 retorna la potencia de 10 que produz o valor informado. Cada incremento de 1 no resultado representa una multiplicación por 10 no valor original, facilitando la comparación entre magnitudes de escalas muy diferentes.
¶ 7.38 LookupProperty
Descripción:
Busca el valor de un atributo (propiedad) de un miembro de dimensión y retorna el valor numérico correspondiente, grabándolo en la dimensión de destino informada. Es útil para traducir atributos descriptivos de miembros — como códigos, tasas o índices registrados como propiedades de dimensión — en valores numéricos utilizables en cálculos de fórmula.
Sintaxis:
LookupProperty(Context, Property, Dimension)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Context | Membro ou bloco do qual se deseja ler a propriedade | Membro, Membro com Escopo, Bloco | Sí | No |
| Property | Dimensão e atributo que contém o valor a ser recuperado | Dimensão, Atributo | Sí | No |
| Dimension | Dimensão de destino onde o valor recuperado será gravado | Dimensão | Sí | No |
Haga clic aquí para ver un ejemplo:
| Dimensão: Centro de Custo | Atributo: Taxa de Rateio (%) |
|---|---|
| CC-001 Administrativo | 30 |
| CC-002 Comercial | 50 |
| CC-003 Operações | 20 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| LookupProperty([CC-001 Administrativo], [Centro de Custo].[Taxa de Rateio], [Conta]) | Recupera a taxa de rateio do centro de custo Administrativo e grava na dimensão Conta. | 30 |
| LookupProperty([CC-002 Comercial], [Centro de Custo].[Taxa de Rateio], [Conta]) | Recupera a taxa de rateio do centro de custo Comercial e grava na dimensão Conta. | 50 |
Descripción del Resultado: A função LookupProperty localiza o atributo Tasa de Prorrateo en el miembro de Centro de Costo informado e retorna su valor numérico para ser utilizado en cálculos en la dimensión Cuenta.
¶ 7.39 Mapping
Descripción:
Mapea datos de una tabla externa al cubo, realizando un INNER JOIN entre los miembros de las dimensiones del cubo y las columnas de origen y destino de la tabla. Para cada dimensión informada, la función asocia la columna de origen (clave de entrada) a la columna de destino (clave de salida), permitiendo transformar y redistribuir valores entre miembros de dimensiones distintas con base en atributos comunes.
Sintaxis:
Mapping(Table, Dimension, Source Column, Destination Column, ...)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Table | Tabela de mapeamento a ser utilizada | Tabela | Sí | No |
| Dimension | Dimensão del cubo a ser mapeada | Dimensão | Sí | Sí |
| Source Column | Coluna da tabela que representa a chave de origem (entrada) | Coluna | Sí | Sí |
| Destination Column | Coluna da tabela que representa a chave de destino (saída) | Coluna | Sí | Sí |
Haga clic aquí para ver un ejemplo:
| Tabela: tb_mapeamento_conta | ||
|---|---|---|
| cd_conta_origem | cd_conta_destino | cd_empresa |
| Receita Produto A | Receita Total | Empresa BR |
| Receita Produto B | Receita Total | Empresa BR |
| Receita Serviços | Receita Total | Empresa BR |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Mapping([tb_mapeamento_conta], [Conta], [cd_conta_origem], [cd_conta_destino], [Empresa], [cd_empresa], [cd_empresa]) | Mapeia cuentas de origen para a conta destino Receita Total, filtrando pela empresa. | Valores de Receita Produto A, B e Serviços consolidados em Receita Total para Empresa BR. |
Descripción del Resultado: A função Mapping realiza um INNER JOIN entre os membros da dimensión Cuenta e as colunas cd_conta_origem / cd_conta_destino da tabela, redistribuyendo los valores das cuentas de origen para a cuenta de destino mapeada.
¶ 7.40 MAvgAbsCenter
Descripción:
Calcula el promedio móvil centralizado usando conteo absoluto de períodos. Para cada período corriente, la función considera N períodos anteriores y N períodos posteriores (ventana centrada), calculando el promedio aritmético de todos los valores de la ventana. El parámetro Cantidad define el número total de períodos yn la ventana (incluyendo el período corriente).
Sintaxis:
MAvgAbsCenter(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor ou membro base para o cálculo da média | Membro, Membro com Escopo | Sí | No |
| Quantity | Número total de períodos na janela (incluindo atual, anteriores e posteriores) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Receita (R$) |
|---|---|
| Janeiro/24 | 1.000 |
| Fevereiro/24 | 1.200 |
| Março/24 | 1.100 |
| Abril/24 | 1.300 |
| Maio/24 | 1.250 |
| Fórmula | Período Corrente | Cálculo | Resultado |
|---|---|---|---|
| MAvgAbsCenter([Receita], 3) | Março/24 | (1.200 + 1.100 + 1.300) / 3 | R$ 1.200 |
Descripción del Resultado: Para o período Março/24 com janela de 3 períodos centrada, a função considera Febrero/24 (1 anterior), Marzo/24 (corriente) e Abril/24 (1 posterior), somando os três valores e dividiendo por 3.
¶ 7.41 MAvgAbsLast
Descripción:
Calcula el promedio móvil de los últimos N períodos usando conteo absoluto. Para el período corriente, la función considera los N períodos inmediatamente anteriores (inclusive el período corriente) y retorna el promedio aritmético de los valores en esa ventana. La variante "Abs" utiliza conteo absoluto de períodos, independientemente de la jerarquía de tiempo.
Sintaxis:
MAvgAbsLast(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor ou membro base para o cálculo da média | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos anteriores (incluindo o corrente) a considerar | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 1.000 |
| Fevereiro/24 | 1.200 |
| Março/24 | 1.100 |
| Abril/24 | 1.300 |
| Maio/24 | 1.250 |
| Fórmula | Período Corrente | Cálculo | Resultado |
|---|---|---|---|
| MAvgAbsLast([Vendas], 3) | Abril/24 | (1.200 + 1.100 + 1.300) / 3 | R$ 1.200 |
Descripción del Resultado: Para Abril/24 com janela de 3 períodos retroativos, a função considera Febrero/24, Marzo/24 y Abril/24, somando seus valores e dividiendo por 3. Períodos anteriores ao início da série são ignorados.
¶ 7.42 MAvgAbsNext
Descripción:
Calcula el promedio móvil de los próximos N períodos usando conteo absoluto. Para el período corriente, la función considera los N períodos inmediatamente posteriores (inclusive el período corriente) y retorna el promedio aritmético de los valores en esa ventana. La variante "Abs" utiliza conteo absoluto de períodos, independientemente de la jerarquía de tiempo.
Sintaxis:
MAvgAbsNext(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor ou membro base para o cálculo da média | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos posteriores (incluindo o corrente) a considerar | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 1.000 |
| Fevereiro/24 | 1.200 |
| Março/24 | 1.100 |
| Abril/24 | 1.300 |
| Maio/24 | 1.250 |
| Fórmula | Período Corrente | Cálculo | Resultado |
|---|---|---|---|
| MAvgAbsNext([Vendas], 3) | Fevereiro/24 | (1.200 + 1.100 + 1.300) / 3 | R$ 1.200 |
Descripción del Resultado: Para Febrero/24 com janela de 3 períodos futuros, a função considera Febrero/24 (corriente), Marzo/24 y Abril/24, sumando los valores e dividiendo por 3. Períodos além do fim da série são ignorados.
¶ 7.43 MAvgCenter
Descripción:
Calcula el promedio móvil centralizado relativo a la jerarquía de tiempo. Para cada período corriente, la función considera N períodos anteriores y N períodos posteriores conforme a la jerarquía definida, calculando el promedio aritmético de todos los valores en la ventana. Se diferencia de MAvgAbsCenter por respetar la estructura jerárquica de la dimensión de tiempo al navegar por los períodos.
Sintaxis:
MAvgCenter(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor ou membro base para o cálculo da média | Membro, Membro com Escopo | Sí | No |
| Quantity | Número total de períodos na ventana centralizada | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Receita Bruta (R$) |
|---|---|
| Janeiro/24 | 1.000 |
| Fevereiro/24 | 1.200 |
| Março/24 | 1.100 |
| Abril/24 | 1.300 |
| Maio/24 | 1.250 |
| Fórmula | Período Corrente | Cálculo | Resultado |
|---|---|---|---|
| MAvgCenter([Receita Bruta], 3) | Março/24 | (1.200 + 1.100 + 1.300) / 3 | R$ 1.200 |
Descripción del Resultado: Para Marzo/24 com janela de 3 períodos, a função considera Febrero/24 (1 anterior), Marzo/24 (corriente) e Abril/24 (1 posterior) respeitando a hierarquia da dimensión de tiempo, retornando el promedio aritmético dos três valores.
¶ 7.44 MAvgLast
Descripción:
Calcula el promedio móvil de los últimos N períodos relativos a la jerarquía de tiempo. Para el período corriente, la función considera los N períodos inmediatamente anteriores (inclusive el corriente) conforme a la jerarquía de la dimensión de tiempo y retorna el promedio aritmético. Se diferencia de MAvgAbsLast por navegar por los períodos respetando la estructura jerárquica.
Sintaxis:
MAvgLast(Value, Quantity)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor ou membro base para o cálculo da média | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos anteriores (incluindo o corrente) a considerar | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 1.000 |
| Fevereiro/24 | 1.200 |
| Março/24 | 1.100 |
| Abril/24 | 1.300 |
| Maio/24 | 1.250 |
| Fórmula | Período Corrente | Cálculo | Resultado |
|---|---|---|---|
| MAvgLast([Vendas], 3) | Abril/24 | (1.200 + 1.100 + 1.300) / 3 | R$ 1.200 |
Descripción del Resultado: Para Abril/24 com janela de 3 períodos, a função considera Febrero/24, Marzo/24 y Abril/24 (los 3 períodos más recientes até o corrente), calculando el promedio aritmético desses valores respeitando a hierarquia de tempo.
¶ 7.45 MAvgNext
Descripción:
Calcula el promedio móvil de los próximos N períodos relativos a la jerarquía de tiempo. Para el período corriente, la función considera los N períodos inmediatamente posteriores (inclusive el corriente) conforme a la jerarquía de la dimensión de tiempo y retorna el promedio aritmético. Se diferencia de MAvgAbsNext por navegar por los períodos respetando la estructura jerárquica.
Sintaxis:
MAvgNext(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor ou membro base para o cálculo da média | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos posteriores (incluindo o corrente) a considerar | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 1.000 |
| Fevereiro/24 | 1.200 |
| Março/24 | 1.100 |
| Abril/24 | 1.300 |
| Maio/24 | 1.250 |
| Fórmula | Período Corrente | Cálculo | Resultado |
|---|---|---|---|
| MAvgNext([Vendas], 3) | Fevereiro/24 | (1.200 + 1.100 + 1.300) / 3 | R$ 1.200 |
Descripción del Resultado: Para Febrero/24 com janela de 3 períodos futuros, a função considera Febrero/24 (corriente), Marzo/24 y Abril/24, calculando el promedio aritmético desses valores respeitando a hierarquia de tempo.
¶ 7.46 Max
Descripción:
Retorna el valor máximo entre múltiples ítems informados. La función acepta miembros, miembros con alcance o bloques como argumentos, comparando todos los valores proporcionados y devolviendo el mayor. Opcionalmente, es posible informar dimensiones adicionales para que la búsqueda del máximo recorra todos los miembros de esas dimensiones.
Sintaxis:
Max(Item, Item, ..., Dimension, ...)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor ou membro a ser comparado | Membro, Membro com Escopo, Bloco | Sí | Sí |
| Dimension | Dimensão a percorrer na búsqueda del valor máximo (opcional) | Dimensão | No | Sí |
Haga clic aquí para ver un ejemplo:
| Vendedor | Vendas (R$) |
|---|---|
| Maria | 8.000 |
| João | 10.000 |
| Paulo | 7.000 |
| Pedro | 12.000 |
| Julia | 9.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Max([Vendas Maria], [Vendas João], [Vendas Paulo], [Vendas Pedro], [Vendas Julia]) | Retorna o maior valor de vendas entre os cinco vendedores. | 12.000 |
Descripción del Resultado: A função Max compara todos los valores fornecidos e retorna el mayor de eles. No exemplo, o valor máximo de ventas é R$ 12.000, registrado para el vendedor Pedro.
¶ 7.47 Min
Descripción:
Retorna el valor mínimo entre múltiples ítems informados. La función acepta miembros, miembros con alcance o bloques como argumentos, comparando todos los valores proporcionados y devolviendo el menor. Opcionalmente, es posible informar dimensiones adicionales para que la búsqueda del mínimo recorra todos los miembros de esas dimensiones.
Sintaxis:
Min(Item, Item, ..., Dimension, ...)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor ou membro a ser comparado | Membro, Membro com Escopo, Bloco | Sí | Sí |
| Dimension | Dimensão a percorrer na búsqueda del valor mínimo (opcional) | Dimensão | No | Sí |
Haga clic aquí para ver un ejemplo:
| Vendedor | Vendas (R$) |
|---|---|
| Maria | 8.000 |
| João | 10.000 |
| Paulo | 7.000 |
| Pedro | 12.000 |
| Julia | 9.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Min([Vendas Maria], [Vendas João], [Vendas Paulo], [Vendas Pedro], [Vendas Julia]) | Retorna o menor valor de vendas entre os cinco vendedores. | 7.000 |
Descripción del Resultado: A função Min compara todos los valores fornecidos e retorna el menor de eles. No exemplo, o valor mínimo de ventas é R$ 7.000, registrado para el vendedor Paulo.
¶ 7.48 MMaxCenter
Descripción:
Calcula el valor máximo dentro de una ventana de períodos centralizada en el período corriente. Para cada período, la función considera N períodos anteriores y N períodos posteriores, retornando el mayor valor encontrado en esa ventana. El parámetro Cantidad define el número total de períodos yn la ventana.
Sintaxis:
MMaxCenter(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor ou membro base para determinar o máximo | Membro, Membro com Escopo | Sí | No |
| Quantity | Número total de períodos na ventana centralizada | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 10.000 |
| Março/24 | 7.000 |
| Abril/24 | 12.000 |
| Maio/24 | 9.000 |
| Fórmula | Período Corrente | Janela | Resultado |
|---|---|---|---|
| MMaxCenter([Vendas], 3) | Março/24 | Fevereiro/24, Março/24, Abril/24 | 12.000 |
Descripción del Resultado: Para Marzo/24 com janela de 3 períodos centrada, a função analisa Febrero/24 (10.000), Marzo/24 (7.000) e Abril/24 (12.000), retornando el mayor valor da janela: R$ 12.000.
¶ 7.49 MMaxLast
Descripción:
Calcula el valor máximo de los últimos N períodos anteriores al período corriente (inclusive). Para cada período, la función recorre los N períodos más recientes y retorna el mayor valor encontrado en esa ventana retroactiva. Es útil para identificar picos de valores en ventanas históricas de planificación.
Sintaxis:
MMaxLast(Value, Quantity)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor ou membro base para determinar o máximo | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos anteriores (incluindo o corrente) a considerar | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 10.000 |
| Março/24 | 7.000 |
| Abril/24 | 12.000 |
| Fórmula | Período Corrente | Janela | Resultado |
|---|---|---|---|
| MMaxLast([Vendas], 3) | Abril/24 | Fevereiro/24 (10.000), Março/24 (7.000), Abril/24 (12.000) | 12.000 |
Descripción del Resultado: Para Abril/24 com janela de 3 períodos retroativos, a função avalia os valores de Febrero/24, Marzo/24 y Abril/24, retornando el mayor valor encontrado: R$ 12.000.
¶ 7.50 MMaxNext
Descripción:
Calcula o valor máximo dos próximos N períodos a partir del período corriente (inclusive). Para cada período, a função recorre los N períodos posteriores e retorna o maior valor encontrado en esa ventana futura. Es útil para identificar o pico de valores projetados em janelas de planejamento futuro.
Sintaxis:
MMaxNext(Value, Quantity)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor ou membro base para determinar o máximo | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos posteriores (incluindo o corrente) a considerar | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo | Vendas (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 10.000 |
| Março/24 | 7.000 |
| Abril/24 | 12.000 |
| Fórmula | Período Corrente | Janela | Resultado |
|---|---|---|---|
| MMaxNext([Vendas], 3) | Janeiro/24 | Janeiro/24 (8.000), Fevereiro/24 (10.000), Março/24 (7.000) | 10.000 |
Descripción del Resultado: Para Janeiro/24 com janela de 3 períodos futuros, a função avalia os valores de Janeiro/24, Fevereiro/24 e Março/24, retornando el mayor valor encontrado: R$ 10.000.
¶ 7.51 MMinCenter
Descripción:
Calcula o valor mínimo em uma janela móvel centralizada en el período corriente. O parâmetro quantidade define quantos períodos adjacentes (para frente e para trás) serão incluídos na janela, além do própriel período corriente. Útil para suavizar variações e identificar mínimos locais ao longo de uma serie temporal.
Sintaxis:
MMinCenter(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base para determinar o valor mínimo | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos adjacentes a considerar em cada direção (antes e depois del período corriente) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
Considerando os seguintes valores de receita mensal:
| Período | Receita (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 5.000 |
| Março/24 | 9.000 |
| Abril/24 | 3.000 |
| Maio/24 | 7.000 |
| Fórmula | Descrição | Cálculo (janela centrada em Março/24) | Resultado |
|---|---|---|---|
| MMinCenter([Receita], 1) | Mínimo dos valores de Febrero/24, Marzo/24 y Abril/24 (1 período antes e 1 depois). | min(5.000, 9.000, 3.000) | R$ 3.000 |
Descripción del Resultado: A função MMinCenter com Quantity = 1 examina el período corriente e 1 período adjacente em cada direção (totalizando 3 períodos). Para Março/24, considera Fevereiro/24 (5.000), Março/24 (9.000) e Abril/24 (3.000), retornando el menor valor: R$ 3.000.
¶ 7.52 MMinLast
Descripción:
Calcula o valor mínimo em uma janela móvel composta pelel período corriente e pelos N períodos anteriores. O parâmetro quantidade define quantos períodos anteriores serão incluídos. É ideal para identificar o menor valor registrado em uma janela histórica recente.
Sintaxis:
MMinLast(Value, Quantity)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor base para determinar o valor mínimo | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos anteriores a incluir na janela (além del período corriente) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Período | Vendas (R$) |
|---|---|
| Janeiro/24 | R$ 8.000 |
| Fevereiro/24 | R$ 10.000 |
| Março/24 | R$ 7.000 |
| Abril/24 | R$ 12.000 |
| Fórmula | Descrição | Cálculo (período corrente: Abril/24) | Resultado |
|---|---|---|---|
| MMinLast([Vendas], 3) | Mínimo dos últimos 3 períodos anteriores al período corriente Abril/24. | min(8.000, 10.000, 7.000) | R$ 7.000 |
Descripción del Resultado: A função MMinLast com Quantity = 3 examina os 3 períodos anteriores al período corriente (Janeiro/24, Fevereiro/24 e Março/24) e retorna o menor valor encontrado: R$ 7.000 (Março/24).
¶ 7.53 MMinNext
Descripción:
Calcula o valor mínimo em uma janela móvel composta pelel período corriente e pelos N períodos futuros. O parâmetro quantidade define quantos períodos seguintes serão incluídos. Es útil para antecipar o menor valor esperado em um horizonte de planejamento futuro.
Sintaxis:
MMinNext(Value, Quantity)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Value | Valor base para determinar o valor mínimo | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos futuros a incluir na janela (além del período corriente) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Período | Vendas (R$) |
|---|---|
| Janeiro/24 | R$ 8.000 |
| Fevereiro/24 | R$ 10.000 |
| Março/24 | R$ 7.000 |
| Abril/24 | R$ 12.000 |
| Fórmula | Descrição | Cálculo (período corrente: Janeiro/24) | Resultado |
|---|---|---|---|
| MMinNext([Vendas], 3) | Mínimo dos 3 períodos seguintes al período corriente Janeiro/24. | min(10.000, 7.000, 12.000) | R$ 7.000 |
Descripción del Resultado: A função MMinNext com Quantity = 3 examina os 3 períodos seguintes al período corriente (Fevereiro/24, Março/24 e Abril/24) e retorna o menor valor encontrado: R$ 7.000 (Março/24).
¶ 7.54 MSumCenter
Descripción:
Calcula a soma móvel em uma ventana centralizada en el período corriente. O parâmetro quantidade define quantos períodos adjacentes (para frente e para trás) serão somados junto al período corriente. Útil para suavizar séries temporais e calcular médias móveis simétricas.
Sintaxis:
MSumCenter(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base para calcular a soma | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos adjacentes a incluir em cada direção (antes e depois del período corriente) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Período (Tempo) | Vendas (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 10.000 |
| Março/24 | 7.000 |
| Abril/24 | 12.000 |
| Maio/24 | 9.000 |
| Fórmula | Descrição | Cálculo (janela centrada em Março/24) | Resultado |
|---|---|---|---|
| MSumCenter([Vendas], 1) | Soma de Febrero/24, Marzo/24 y Abril/24 (1 período antes e 1 depois). | 10.000 + 7.000 + 12.000 | R$ 29.000 |
Descripción del Resultado: A função MSumCenter com Quantity = 1 soma el período corriente (Março/24: 7.000) junto com 1 período anterior (Fevereiro/24: 10.000) e 1 período posterior (Abril/24: 12.000), resultando em R$ 29.000.
¶ 7.55 MSumLast
Descripción:
Calcula a soma móvel dos N períodos anteriores al período corriente, incluindo o própriel período corriente. O parâmetro quantidade define quantos períodos anteriores serão somados. É amplamente utilizado para calcular totales acumulados em janelas deslizantes, como a soma dos últimos 3 ou 12 meses.
Sintaxis:
MSumLast(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base para calcular a soma | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos anteriores a incluir na janela (além del período corriente) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Período (Tempo) | Vendas (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 10.000 |
| Março/24 | 7.000 |
| Abril/24 | 12.000 |
| Maio/24 | 9.000 |
| Fórmula | Descrição | Cálculo (período corrente: Abril/24) | Resultado |
|---|---|---|---|
| MSumLast([Vendas], 2) | Soma de Febrero/24, Marzo/24 y Abril/24 (2 períodos anteriores + período corrente). | 10.000 + 7.000 + 12.000 | R$ 29.000 |
Descripción del Resultado: A função MSumLast com Quantity = 2 soma el período corriente (Abril/24: 12.000) junto com os 2 períodos anteriores (Março/24: 7.000 e Fevereiro/24: 10.000), totalizando R$ 29.000.
¶ 7.56 MSumNext
Descripción:
Calcula a soma móvel del período corriente e dos N períodos futuros seguintes. O parâmetro quantidade define quantlos períodos futuros serão somados. Es útil para calcular totales proyectados em um horizonte de planejamento, como a soma dos próximos 3 ou 6 meses.
Sintaxis:
MSumNext(Value, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base para calcular a soma | Membro, Membro com Escopo | Sí | No |
| Quantity | Número de períodos futuros a incluir na janela (além del período corriente) | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Período (Tempo) | Vendas (R$) |
|---|---|
| Janeiro/24 | 8.000 |
| Fevereiro/24 | 10.000 |
| Março/24 | 7.000 |
| Abril/24 | 12.000 |
| Maio/24 | 9.000 |
| Junho/24 | 4.000 |
| Fórmula | Descrição | Cálculo (período corrente: Abril/24) | Resultado |
|---|---|---|---|
| MSumNext([Vendas], 2) | Soma de Abril/24, Maio/24 e Junho/24 (período corrente + 2 períodos seguintes). | 12.000 + 9.000 + 4.000 | R$ 25.000 |
Descripción del Resultado: A função MSumNext com Quantity = 2 soma el período corriente (Abril/24: 12.000) junto com os 2 períodos seguintes (Maio/24: 9.000 e Junho/24: 4.000), totalizando R$ 25.000.
¶ 7.57 NPV
Descripción:
Calcula o Valor Presente Neto (VPL) de uma série de flujos de caja futuros, descontando-os por uma taxa periódica. O parâmetro Period indica a posição relativa de cada fluxo na linha do tempo (quantos períodos à frente do momento atual), Rate é a tasa de descuento por período, e Value contém o valor do flujo de caja em cada período. Esta função é fundamental en análisis de viabilidade de investimentos e projetos.
Sintaxis:
NPV(Period, Rate, Value)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Period | Posição temporal do flujo de caja (número de períodos a partir do momento atual) | Membro, Membro com Escopo, Número Inteiro Positivo | Sí | No |
| Rate | Tasa de descuento por período | Membro, Membro com Escopo, Número | Sí | No |
| Value | Valor do flujo de caja em cada período | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
Uma empresa deseja calcular o VPL de investimentos futuros com tasa de descuento de 10% ao ano:
| Ano (Tempo) | Período (posição) | Fluxo de Caixa (R$) |
|---|---|---|
| 2024 | 1 | R$ 15.000 |
| 2025 | 2 | R$ 20.000 |
| 2026 | 3 | R$ 25.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| NPV([Período], 10%, [Fluxo de Caixa]) | Calcula o VPL dos fluxos de caixa com tasa de descuento de 10% ao ano. | R$ 46.791,27 |
Descripción del Resultado: A função NPV desconta cada flujo de caja pelo fator 1 / (1 + taxa)^período e soma os resultados: R$ 15.000 / 1,10¹ + R$ 20.000 / 1,10² + R$ 25.000 / 1,10³ = R$ 46.791,27.
¶ 7.58 Opening
Descripción:
Retorna o saldo inicial (de abertura) de um período, que corresponde ao saldo final (de fechamento) do período imediatamente anterior. Esta função implementa o princípio contábil de continuidade: o saldo inicial de um período sempre deve ser igual ao saldo final del período anterior. É amplamente usada em demonstrações de flujo de caja, balanços patrimoniais e controle de estoques.
Sintaxis:
Opening(Closing)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Closing | Membro que contém o saldo final del período | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
Uma empresa deseja calcular o Saldo Inicial de cada mês com base no Saldo Final do mês anterior:
| Mês | Saldo Final (R$) | Saldo Inicial calculado (R$) |
|---|---|---|
| Dezembro/23 | R$ 20.000 | — |
| Janeiro/24 | — | R$ 20.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Opening([Saldo Final]) | Retorna o Saldo Final de Dezembro/23 como Saldo Inicial de Janeiro/24. | R$ 20.000 |
Descripción del Resultado: A função Opening busca o valor de Saldo Final no período anterior (Dezembro/23 = R$ 20.000) e o utiliza como Saldo Inicial de Janeiro/24. Em cada período subsequente, o resultado é automaticamente atualizado com o saldo final do mês anterior.
¶ 7.59 Parent
Descripción:
Retorna o valor de um miembro padre na jerarquía de una dimensión, subindo um número específico de níveis a partir do miembro corriente. É essencial para análises que precisam referenciar ou comparar valores de níveis hierárquicos superiores, como obter o total de uma categoria a partir de um produto específico, ou o total de uma diretoria a partir de um setor.
Sintaxis:
Parent(Item, Dimension, Quantity)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Valor do membro de origem para o qual se deseja buscar o pai | Membro, Membro com Escopo, Bloco | Sí | No |
| Dimension | Dimensão na qual a hierarquia será percorrida | Dimensão, Hierarquia | Sí | No |
| Quantity | Número de níveis a subir na hierarquia | Número Inteiro Positivo | Sí | No |
Haga clic aquí para ver un ejemplo:
Hierarquia da dimensão Produto:
| Nível | Membro | Vendas (R$) | |
|---|---|---|---|
| Nível 0 (raiz) | Todas as Categorias | — | R$ 500.000 |
| Nível 1 | Eletrônicos | — | R$ 200.000 |
| Nível 2 (folha) | Smartphone XYZ | [fórmula] | R$ 45.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Parent([Vendas Smartphone XYZ], [Produto], 1) | Sobe 1 nível na hierarquia de Produto a partir de Smartphone XYZ, retornando el valor do pai Eletrônicos. | R$ 200.000 |
Descripción del Resultado: A função Parent navega 1 nível acima na jerarquía de la dimensión Produto, encontrando o miembro padre de Smartphone XYZ (que é Eletrônicos) e retorna el valor R$ 200.000 associado a esse nível.
Os níveis de uma dimensão iniciam sempre com valor 0, avançando gradativamente (0, 1, 2, 3...).
¶ 7.60 PMT
Descripción:
Calcula o valor fixo de cada parcela de um préstamo o financiamiento, com base em pagos periódicos constantes e tasa de interés fixa. Equivale à função PMT do Excel. Opcionalmente, es posible informar o valor futuro desejado ao final do prazo e se o pagamento ocorre no início ou no final de cada período.
Sintaxis:
PMT(Rate, NPer, PV, FV, Type)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Rate | Tasa de interés por período | Membro, Membro com Escopo | Sí | No |
| NPer | Número total de períodos de pagamento | Membro, Membro com Escopo | Sí | No |
| PV | Valor presente (principal do empréstimo) | Membro, Membro com Escopo | Sí | No |
| FV | Valor futuro desejado ao término do prazo (padrão: 0) | Membro, Membro com Escopo | No | No |
| Type | Indica o vencimento do pagamento: 0 = final del período (padrão), 1 = inicio del período | Número Inteiro | No | No |
Haga clic aquí para ver un ejemplo:
Uma empresa deseja financiar R$ 50.000 em 24 meses com tasa de interés de 1% ao mês:
| Parâmetro | Valor |
|---|---|
| Taxa de Juros (Rate) | 1% ao mês (0,01) |
| Número de Parcelas (NPer) | 24 |
| Valor Presente (PV) | R$ 50.000 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| PMT(0.01, 24, 50000) | Calcula a parcela mensal de um financiamento de R$ 50.000 em 24 meses a 1% a.m. | R$ 2.353,00 |
Descripción del Resultado: A função PMT determina que cada parcela mensal será de aproximadamente R$ 2.353,00 para quitar o financiamento de R$ 50.000 em 24 meses com taxa de 1% ao mês.
¶ 7.61 Property
Descripción:
Retorna o valor numérico de um atributo (propriedade) associado a um membro de uma dimensão, dentro de um contexto específico. A dimensão e o atributo são especificados juntos usando notação de ponto ([Dimensão].[Atributo]), e o contexto indica para qual membro o atributo será consultado. Es útil para incorporar características cadastrais dos membros nos cálculos, como taxas, categorias numéricas ou coeficientes.
Sintaxis:
Property([Dimensão].[Atributo], Contexto)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Dimensão.Atributo | Dimensão e nome do atributo a ser consultado, separados por ponto | Dimensão, Atributo | Sí | No |
| Contexto | Membro ou bloco que define o contexto de consulta do atributo | Membro, Membro com Escopo, Bloco | Sí | No |
Haga clic aquí para ver un ejemplo:
A dimensão Produto possui um atributo Alíquota_ICMS com o percentual de ICMS de cada produto. Deseja-se calcular o valor do ICMS sobre as vendas:
| Produto | Atributo: Alíquota_ICMS | Vendas (R$) |
|---|---|---|
| Notebook Pro | 12% (0,12) | R$ 30.000 |
| Smartphone XYZ | 18% (0,18) | R$ 15.000 |
| Fórmula | Descrição | Resultado (Notebook Pro) |
|---|---|---|
| [Vendas] * Property([Produto].[Alíquota_ICMS], [Produto]) | Multiplica as vendas pelo atributo Alíquota_ICMS do produto corrente. | R$ 30.000 × 0,12 = R$ 3.600 |
Descripción del Resultado: A função Property consulta o valor do atributo Alíquota_ICMS da dimensão Produto para o miembro corriente (Notebook Pro = 0,12) e o utiliza como fator multiplicador, calculando o ICMS de R$ 3.600 sobre vendas de R$ 30.000.
¶ 7.62 Remaining
Descripción:
Calcula o número de parcelas restantes a serem pagas em um contrato de amortização ou financiamento, com base no número total de parcelas informado no bloco de entrada. Suporta configuração de intervalo entre pagamentos (ex.: parcelas trimestrais) e período de carência (períodos iniciais sem pagamento). É utilizada no planejamento de flujo de caja de dívidas e amortizações.
Sintaxis:
Remaining(Item, Interval, GracePeriod, Dimension)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Item | Bloco ou membro que contém o número total de parcelas do contrato | Membro, Membro com Escopo, Bloco | Sí | No |
| Interval | Intervalo entre pagamentos em períodos (padrão: 1 = mensal) | Número Inteiro Positivo | No | No |
| GracePeriod | Número de períodos de carência (sem pagamento) no início do contrato | Número Inteiro Positivo | No | No |
| Dimension | Dimensão de tempo a ser utilizada no cálculo | Dimensão | No | No |
Haga clic aquí para ver un ejemplo:
Um financiamento de 12 cuotas mensuales com 3 meses de carência foi contratado em Janeiro/24:
| Mês | Parcelas Restantes |
|---|---|
| Janeiro/24 (carência) | 12 |
| Fevereiro/24 (carência) | 12 |
| Março/24 (carência) | 12 |
| Abril/24 (1ª parcela) | 11 |
| Maio/24 (2ª parcela) | 10 |
| Fórmula | Descrição | Resultado em Abril/24 |
|---|---|---|
| Remaining([Num Parcelas], 1, 3, [Tempo]) | Calcula as parcelas restantes do financiamento de 12 parcelas com intervalo mensal e 3 meses de carência. | 11 parcelas |
Descripción del Resultado: Em Abril/24 (primeiro mês após a carência), a função Remaining indica que restam 11 parcelas a serem pagas, pois a primeira foi paga neste mês. Durante os 3 meses de carência (Jan-Mar), nenhuma parcela é debitada.
¶ 7.63 Round
Descripción:
Arredonda um número para uma quantidade específica de casas decimais. O comportamento do arredondamento varia conforme o valor de precisão informado:
- Precisão positiva: arredonda para o número de casas decimais indicado (ex.: precisão 2 →
748,476→748,48). - Precisão zero: arredonda para o inteiro mais próximo (ex.:
748,6→749). - Precisão negativa: arredonda à esquerda do ponto decimal (ex.: precisão -2 →
748,47→700,00).
Sintaxis:
Round(Number, Precision)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Number | Número a ser arredondado | Membro, Membro com Escopo, Bloco | Sí | No |
| Precision | Número de casas decimais para arredondamento (pode ser negativo) | Número Inteiro | Sí | No |
Haga clic aquí para ver un ejemplo:
| Número (Dimensão) | Valor Original |
|---|---|
| Receita Norte | 748,476 |
| Receita Sul | 1.234,567 |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Round([Receita Norte], 2) | Arredonda 748,476 para 2 casas decimais. | 748,48 |
| Round([Receita Sul], -2) | Arredonda 1.234,567 para o múltiplo de 100 mais próximo (precisão -2). | 1.200,00 |
Descripción del Resultado: A função Round ajusta o número conforme a precisão especificada. Com precisão positiva (2), arredonda para casas decimais específicas — útil en reportes financeiros. Com precisão negativa (-2), arredonda para centenas — útil en análisis macro.
¶ 7.64 Sum
Descripción:
Soma o valor de entrada ao longo de todos os períodos da dimensión de tiempo (do primeiro ao último), retornando el total agregado por combinação de dimensões não-temporais. Diferentemente de Cumulate, que acumula até o período atual, a função Sum sempre retorna o total completo de todos os períodos, independentemente del período corriente. É utilizada para consolidar totais anuais ou totais de série completa en reportes de planejamento.
Sintaxis:
Sum(Value)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base a ser somado ao longo de todos os períodos | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
Dados de Receita Mensal no ano de 2024:
| Mês | Receita (R$) |
|---|---|
| Janeiro/24 | 10.000 |
| Fevereiro/24 | 12.000 |
| Março/24 | 8.000 |
| Fórmula | Período Corrente | Resultado |
|---|---|---|
| Sum([Receita Mensal]) | Janeiro/24 | R$ 30.000 |
| Sum([Receita Mensal]) | Fevereiro/24 | R$ 30.000 |
| Sum([Receita Mensal]) | Março/24 | R$ 30.000 |
Descripción del Resultado: A função Sum retorna sempre o total de todos os períodos (R$ 30.000), independentemente del período corriente. Isso a diferencia do Cumulate, cujo resultado varia a cada período. Es útil para calcular totais de referência que precisam aparecer de forma constante em todos os períodos.
¶ 7.65 Tier
Descripción:
Categoriza um valor em faixas progresivas e calcula o imposto ou encargo acumulado sobre cada rango. Cadel rango possui um límite superior e um percentual específico; o valor excedente de cada rango é tributado pela alíquota correspondente. O percentual informado no parâmetro % Acima é aplicado ao valor que ultrapassar a últimel rango definida. Impostos progressivos (como IRPF) são o exemplo clássico de uso desta função.
Sintaxis:
Tier(Value, %Above, Tier, %Tier)
Parámetros:
| Nombre | Descripción | Tipos de parámetros | Obligatorio | Repeticiones |
|---|---|---|---|---|
| Value | Valor base a ser categorizado nlos rangos | Membro, Membro com Escopo | Sí | No |
| % Acima | Percentual aplicado ao valor que exceder a últimel rango definida | Membro, Membro com Escopo | Sí | No |
| Tier | Limite superior de cada rango | Membro, Membro com Escopo | Sí | Sí |
| % Tier | Percentual aplicado ao valor dentro de cada rango | Membro, Membro com Escopo | Sí | Sí |
Haga clic aquí para ver un ejemplo:
Tabela de alíquotas progresivas para cálculo de imposto sobre salário:
| Faixa | Limite Superior (R$) | Alíquota |
|---|---|---|
| Faixa 1 | 10.000 | 5% |
| Faixa 2 | 20.000 | 10% |
| Acima de 20.000 | — | 15% |
| Fórmula | Salário | Resultado |
|---|---|---|
| Tier([Salário], 15%, 10000, 5%, 20000, 10%) | R$ 25.000 | R$ 2.750 |
Cálculo Detallado:
- Faixa 1 (até R$ 10.000): R$ 10.000 × 5% = R$ 500
- Faixa 2 (de R$ 10.001 a R$ 20.000): R$ 10.000 × 10% = R$ 1.000
- Acima de R$ 20.000: R$ 5.000 × 15% = R$ 750
- Total: R$ 500 + R$ 1.000 + R$ 750 = R$ 2.750
Descripción del Resultado: A função Tier distribui o salário de R$ 25.000 nlos rangos definidas e aplica o percentual correspondente a cada trecho. O imposto total calculado é R$ 2.750, resultado da soma dos encargos de cada rango progresiva.
¶ 7.66 YTD
Descripción:
Acumula os valores de um membro desde el inicio del año (ou ano fiscal) até el período corriente, calculando o acumulado del año até a data (Year-To-Date). A cada período, o resultado é a soma de todos os valores desde o primer período del año até o período atual. É amplamente utilizado en reportes financeiros para acompanhar o desempeño acumulado ao longo do exercício.
Sintaxis:
YTD(Base)
Parámetros:
| Nome | Descrição | Tipos de parâmetros | Obrigatório | Repetições |
|---|---|---|---|---|
| Base | Valor a ser acumulado desde el inicio del año até el período corriente | Membro, Membro com Escopo | Sí | No |
Haga clic aquí para ver un ejemplo:
| Tempo (Dimensão) | Vendas Mensais (R$) | YTD Vendas (R$) |
|---|---|---|
| Janeiro/24 | 5.000 | 5.000 |
| Fevereiro/24 | 7.000 | 12.000 |
| Março/24 | 6.000 | 18.000 |
| Abril/24 | 8.000 | 26.000 |
| Fórmula | Descrição | Resultado em Abril/24 (R$) |
|---|---|---|
| YTD([Vendas]) | Acumula o valor das vendas de Janeiro/24 até el mes corriente. | R$ 26.000 |
Cálculo Detallado:
- Janeiro/24: R$ 5.000
- Fevereiro/24: R$ 5.000 + R$ 7.000 = R$ 12.000
- Março/24: R$ 12.000 + R$ 6.000 = R$ 18.000
- Abril/24: R$ 18.000 + R$ 8.000 = R$ 26.000
Descripción del Resultado: A função YTD acumula os valores mensais de Vendas a partir do primeiro mês do ano. Em Abril/24, o acumulado é R$ 26.000, correspondendo à soma de todos os meses de Janeiro a Abril.