Conceito
Bi Calc é uma ferramenta de armazenamento e cálculo para estruturas de dados em árvore:
Exemplos de dados em árvore
- Plano de contas contábil e financeiro
- Demostrativos (DRE, Centro de custo, produção, fluxo de caixa, etc)
Exemplos de cálculos:
Liquides Imediata = Disponível / Passivo Circulante
Elemento
Um elemento é a dimensão dentro da estrutura de uma árvore de dados.
Exemplo:
Uma estrutura de plano de contas a conta de Receita operacional bruta
é considerada um elemento no nível analítico da estrutura.
- Resultado do Exercício
- Receita operacional líquido
Receita operacional bruta
- Receita operacional líquido
TIP
Pense que elementos são como contas que podem exibir valores e são distribuidas dentro de uma hierarquia de árvore, por isto o plano de contas contábil é o melhor exemplo.
Estrutura
Uma estrutura é um conjunto de colunas
que será relacionada a um elemento.
As colunas
representam os valores que o elemento pode receber.
Exemplo de colunas de uma estrutura:
Estrutura filial com suas colunas
- Filial 01
- Filial 02
- Consolidado = Filial 01 + Filial 02
Colunas
A coluna
recebera um valor que pode ser uma importação, digitação ou cálculo matemático.
Período
O período que um valor pode ser armazenado pode ser:
- Anual
- Mensal
- Diário
Valor
O valor
é a informação mais importante, pois mensura o fato ocorrido e categoriza o tipo que este valor é.
Para um valor ser armazenado ele precisa de três ligações:
- Elemento
- Coluna
- Data
Um valor
pode ser representado da seguinte forma:
valor = elemento.coluna.data
Calculos matemáticos devem ser feitos nas colunas e usam a representação da seguinte forma:
Calculo de colunas feito dentro do mesmo elemento não precisam referenciar o elemento na formula.
colunaC = (colunaA.data + colunaB.data)
Calculos de colunas que referenciam elementos diferentes da sua estrutura devem incluir o elemento na formala:
elemento.colunaC = (elemento.colunaA.data * elemento99.coluna.data)
WARNING
Em uma estrutura de dados os valores geralmente devem ser importados ou digitados no nível analítico e o BI Calc calcula os valores nas contas sintéticas.
DANGER
Os valores agrupados no nivel analítico já devem vir sumarizados. Um exemplo seria armazenar dados de faturamento onde o nível analítico da árvore de dados é o cliente.
Links
Links são usados para referenciar um elemento em outra árvore.
A necessidade de agrupar em uma árvore de dados determinados elementos são facilmente feitos atraves de link do elemento.
Exemplos de uso para links:
Demostrativos de dados como DRE são feitos facilmente criando um esquelo de contas com os elementos e depois linkado os elementos que são as contas de um plano de contas que é outra árvore de dados.
Instalação
Primeiros Passos
Requisitos Mínimos
- Windows Server 2012 R2 ou superior
- SQL Server 2017 ou superior
- .NET Framework 4.7.2
NOTA
Para esse tutorial presume-se que o SQL Server já esteja instalado e configurado
Instalação
Executar no Powershell como Adminstrador:
#Define a política de execução de scripts baixados da internet
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
#download script
Invoke-WebRequest -Uri "https://gurusistemasreports.blob.core.windows.net/external/setup/Guru.BI.Server.ps1" -OutFile Guru.BI.Server.ps1
#run
./Guru.BI.Server.ps1
2
3
4
5
6
7
8
9
Sobre as políticas de execução scripts do Powershell você poder ler aqui:
Configuração básica
É necessário configuração a conexão com banco de dados. Edite o arquivo de configuração, execute no cmd:
notepad.exe C:\Guru Sistemas\Guru.BI.Server\config\config.json
2
O arquivo de configuração genérico é:
[
{
"logging": [{ "type": "file" }],
"connection": "Server=<SERVERNAME>;Database=Guru.BI.Server;User id=<USERNAME>;Password=<PASSOWORD>",
"host": {
"tcp": 5001,
"http": 5002,
"ipv4": ["0.0.0.0"],
"ipv6": []
},
"db_server": 5000,
"instance": "<INSTANCE_NAME>",
"auth": {
"key": "Jct8S4KEjsbPAFCRk5WwBQ0NGfnz3V1y"
}
}
]
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Você precisa apenas definir as propriedadesconnection e instance com os valores corretos do banco de dados e o nome que quer a sua instância. Se tudo estiver correto você pode executar o Guru BI com o comando no PowerShell:
Start-Service "Guru BI"
E verificar seu status em: http://localhost:5002/api/server/status