01. DADOS GERAIS
| Linha de Produto: | RM |
|---|
| Segmento: | Educacional |
|---|
| Módulo: | TOTVS Educacional |
|---|
| Função: | Fórmula para o Valor Auxiliar |
|---|
| Ticket: |
|
|---|
| Requisito/Story/Issue (informe o requisito relacionado) : |
|
|---|
02. SITUAÇÃO/REQUISITO
Em função da evolução do TOTVS Educacional para permitir a criação de valor auxiliar para "Bolsa" e "Desconto por Antecipação" é necessário que seja disponibilizado novas funções de fórmula que deverão ser executadas sobre o contexto das tabelas SBOLSALAN e SLANDESCPONTUAL.
03. SOLUÇÃO
Disponibilizamos novas funções de fórmulas que tem como objetivo exclusivo de auxiliar na implementação de novas fórmulas que serão utilizadas no processamento do valor auxiliar para bolsa ou desconto por antecipação.
| Expandir |
|---|
| title | Funções para valor auxiliar aplicados em “Bolsa” ou “Desconto por Antecipação” |
|---|
|
As funções de fórmula abaixo poderão ser utilizadas em ambos contexto, seja para processamento do valor auxiliar de bolsa ou desconto por antecipação. Todas as funções abaixo terão como contexto a informação de processamento corrente da tabela SBOLSALAN (para bolsas) ou SLANDESPONTUAL (para descontos por antecipação) processada para a parcela do contrato do aluno.
| Nome | Descrição | Parâmetros | Exemplo |
|---|
| VAUXTABCONTRATO | Tem como objetivo retornar o conteúdo de um determinado campo do contrato do aluno (tabela: SCONTRATO). | - Nome do campo.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABCONTRATO('IDHABILITACAOFILIAL','I') | | VAUXTABPARCELA | Tem como objetivo retornar o conteúdo de um determinado campo da parcela do contrato do aluno (tabela: SPARCELA). | - Nome do campo.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABPARCELA('DTVENCIMENTO','D') | | VAUXTABFLAN | Tem como objetivo retornar o conteúdo de um determinado campo do lançamento financeiro vinculado a parcela do contrato do aluno (tabela: FLAN). | - Nome do campo.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABFLAN('VALORORIGINAL','V') | | VAUXVLRINTEGRACAOLAN | Tem como objetivo retornar o valor de integração processado para o lançamento financeiro vinculado a parcela do contrato do aluno. | - Identificador do campo do valor de integração.
| VAUXVLRINTEGRACAOLAN(45) 45 corresponde ao id. do campo do valor de integração cadastrado no TOTVS Gestão Financeira. |
|
| Expandir |
|---|
| title | Funções especificas para valor auxiliar aplicados em “Bolsa” |
|---|
|
As funções de fórmula abaixo poderão ser utilizadas especificamente para processar valores auxiliares do aplicados em bolsa. O contexto para processamento da fórmula corresponde aos dados da tabela SBOLSALAN que serão gerados durante a criação do lançamento financeiro processado para a parcela do contrato do aluno. | Informações |
|---|
| Se a parcela do contrato do aluno possuir a "BOLSA A" e "BOLSA B" internamente ao gerar o lançamento financeiro o sistema vai incluir dois registros na tabela SBOLSALAN e consequentemente para cada registo será processada a fórmula vinculada ao valor auxiliar. |
| Nome | Descrição | Parâmetros | Exemplo |
|---|
| VAUXTABBOLSALAN | Tem como objetivo retornar o conteúdo de um determinado campo da tabela SBOLSALAN | - Nome do Campo
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABBOLSALAN('VALOR', 'V') | | VAUXTABBOLSA | Tem como objetivo retorna o conteúdo de um determinado campo do cadastro da bolsa (tabela: SBOLSA) | - Nome do campo:
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABBOLSA('CODBOLSA', 'S') | | VAUXTABBOLSACOMPL | Tem como objetivo retornar o conteúdo de um determinado campo complementar do cadastro da bolsa (tabela:SBOLSACOMPL) | - Nome do campo complementar.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABBOLSACOMPL('TIPOX', 'S') | | VAUXDESCPARCELABOLSALAN | Tem como objetivo retornar o valor de desconto da parcela vinculada a bolsa processada. Obs..: Caso tenhamos uma parcela com mais de um responsável financeiro será retornado o desconto aplicado ao lançamento do contexto corrente da bolsa processada. | - Tipo valor: Tipo do valor de retorno (V=Valor/ P=Percentual)
| VAUXDESCPARCELABOLSALAN('V') | | VAUXVALORAUXBOLSA | Tem como objetivo retornar o conteúdo do valor auxiliar já processado para a bolsa . Se o código da bolsa não for informado será considerado a bolsa do contexto corrente da SBOLSALAN. | - Código do valor auxiliar
- Código da bolsa
| VAUXVALORAUXBOLSA('CODAUX001', 'BOLSAX') |
| Dica |
|---|
| Quando utilizar esta função de fórmula recomendamos que ao cadastrar o valor auxiliar o campo "Ordem de processamento" seja preenchido estabelecendo um critério de ordem de processamento. Exemplo: Valor auxiliar: VAUX001 - Ordem 1 Valor auxiliar: VAUX002 - Ordem 2 Desta forma posso na fórmula do valor auxiliar "VAUX002" utilizar a função VAUXVALORAUXBOLSA('VAUX001', 'BOLSAXPTO') , pois o valor auxiliar "VAUX001" já vai ter processado. |
|
|---|
| VAUXTOTALBOLSASPORCAMPOCOMPL | Tem como objetivo retornar o somatório dos valores das bolsas conforme conteúdo do campo complementar informado. | - Nome do campo complementar da bolsa;
- Conteúdo do campo complementar que se deseja filtrar;
- Tipo valor: Tipo de valor de retorno (V =Valor/ P= Percentual)
| VAUXTOTALBOLSASPORCAMPOCOMPL('FIES', 'T', 'P') |
| Dica |
|---|
| title | VAUXTOTALBOLSASPORCAMPOCOMPL |
|---|
| Exemplo: Bolsa 1 | Campo Complementar: Classificação = A | Valor da Bolsa R$ 100,00 Bolsa 2 | Campo Complementar: Classificação = A | Valor da Bolsa R$ 100,00 Bolsa 3 | Campo Complementar: Classificação = B | Valor da Bolsa R$ 100,00
Baseado no exemplo acima poderíamos utilizar a função de fórmula assim: VAUXTOTALBOLSASPORCAMPOCOMPL('Classificação', 'A','V') O resultado da execução será de R$ 200,00 |
|
|
| Deck of Cards |
|---|
|
| Card |
|---|
| id | BOLSA |
|---|
| label | Funções para Valor Auxiliar de Bolsa |
|---|
| Discriminamos abaixo as funções de fórmulas que poderão ser utilizadas somente na construção de fórmula para valor auxiliar de bolsa, neste caso estas fórmulas serão executadas sobre o contexto das informações da tabela SBOLSALAN. | Nome | Descrição | Parâmetros | Exemplo |
|---|
| VAUXTABBOLSALAN | Retorna o conteúdo de um determinado campo da tabela SBOLSALAN | - Campo: Nome do campo que deseja pesquisa na tabela SBOLSALAN.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABBOLSALAN('VALOR', 'V') | | VAUXTABBOLSA | Retorna o conteúdo de um determinado campo da tabela SBOLSA | - Campo: Nome do campo que deseja pesquisa na tabela SBOLSA.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABBOLSA('CODBOLSA', 'S') | | VAUXTABBOLSACOMPL | Retorna o conteúdo de um determinado campo da tabela de campos complementares da bolsa (SBOLSACOMPL) | - Campo: Nome do campo que deseja pesquisa na tabela SBOLSACOMPL.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABBOLSACOMPL('TIPOX', 'S') | | VAUXDESCPARCELABOLSALAN | Retorna o valor de desconto da parcela referente ao contexto do lançamento gerado pela aplicação de uma bolsa. (SBOLSALAN) Obs.: Caso tenhamos uma parcela com mais de um responsável financeiro será retorno o desconto aplicado ao lançamento do contexto corrente e não da parcela. | - Tipo valor: Tipo do valor de retorno (V=Valor/ P=Percentual)
| VAUXDESCPARCELABOLSALAN('V') | | VAUXVALORAUXBOLSA | Retorna o conteúdo do valor auxiliar já processado para a bolsa . Se o código da bolsa não for informado será considerado a bolsa processada no contexto corrente da SBOLSALAN. | - Código do valor auxiliar
- Código da bolsa
| VAUXVALORAUXBOLSA('CODAUX001', 'BOLSAX') | | VAUXTOTALBOLSASPORCAMPOCOMPL | Retorna o somatório dos valores das bolsas conforme conteúdo do campo complementar informado. | - Nome do campo complementar da bolsa;
- Conteúdo do campo complementar que se deseja filtrar;
- Tipo valor: Tipo de valor de retorno (V =Valor/ P= Percentual)
| VAUXTOTALBOLSASPORCAMPOCOMPL('FIES', 'T', 'P') |
|
| Card |
|---|
| id | DESCONTOPORANTECIPACAO |
|---|
| label | Funções para Valor Auxiliar de Desconto por Antecipação |
|---|
| Discriminamos abaixo as funções de fórmulas que poderão ser utilizadas somente na construção de fórmula para valor auxiliar de desconto por antecipação, neste caso estas fórmulas serão executadas sobre o contexto das informações da tabela SLANDESCPONTUAL. | Nome | Descrição | Parâmetros | Exemplo |
|---|
| VAUXTABLANDESCPONTUAL | Retorna o conteúdo de um determinado campo da tabela SLANDESCPONTUAL | - campo: Nome do campo que deseja pesquisa na tabela SLANDESCPONTUAL.
- Tipo: Tipo do valor do campo informado.
- "V": Valor
- "I": Inteiro
- "D": Data
- "S": Texto
| VAUXTABLANDESCPONTUAL('VALORDESCONTOCALCULADO', 'V') | | VAUXDESCANTECIPACAOLANDESCPONTUAL | Retorna o valor do desconto por antecipação do contexto corrente (SLANDESCPONTUAL). | - Tipo: Tipo de retorno do valor do desconto por antecipação.
(V =Valor/ P=Percentual) | VAUXDESCANTECIPACAOLANDESCPONTUAL('V') | | VAUXVALORAUXDESCANTECIPACAO | Retorna o conteúdo do valor auxiliar já processado para o desconto por antecipação conforme o número de vencimento informado. Caso seja informado o número de vencimento com valor "0" (Zero) será retornado o valor do valor auxiliar do desconto por antecipação do contexto corrente. Exemplo: 1º Vencimento (Até o dia 5) => Vencimento = 1
2º Vencimento (Até o dia 10) => Vencimento = 2
3º Vencimento (Até o dia 15) => Vencimento = 3
4º Vencimento (Até o dia 20) => Vencimento = 4 | - Código do valor auxiliar.
- Nº vencimento: Número do vencimento que deseja recuperar a informação.
| VAUXVALORAUXDESCANTECIPACAO('CODAUX005', 3) |
|
|
| Card documentos |
|---|
| Informacao | Recomendamos priorizar a utilização das funções de fórmula que relatamos anteriormente ao invés de carregar as informações através de consulta SQL, pois as funções de fórmula utilizam mecanismo de cache que tem como objetivo melhorar a performance da execução. |
|---|
| Titulo | IMPORTANTE! |
|---|
|
| HTML |
|---|
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after {
background: #FF9900; !important
}
.menu-item.active-tab {
border-bottom: none !important;
}
</style>
|
