(Obrigatório)

Informações Gerais

(Obrigatório)

Objetivo

Permitir que usuários incluam fórmulas como opções de campos na Exportação Personalizada.

(Obrigatório)

Definição da Regra de Negócio

Criação de um novo cadastro de fórmulas que deverá ser relacionado a tabela da configuração da exportação personalizada (NQ2), na rotina JURA023, conforme protótipo 01.

Desta forma, além de vincular campos, será possível vincular campos cuja informação é retornada executando uma fórmula, que envolve os campos da tabela.

Alterações no fonte JURA023

Criação de um FormGrid no modelo do fonte JURA023 para utilizar a tabela NZJ que relaciona as fórmulas às tabelas da exportação (NQ2). O novo Grid deve ter relação de mestre-detalhe com o field NQ2DETAIL.

Como a fórmula deve ser cadastrada

A fórmula deve ser uma Function ou User Function dentro do RPO do Protheus e lembramos que seu nome não pode exceder 09 caracteres.

Para que seja possível executar a fórmula, a mesma deve ser incluída na seguinte forma:

Descrição: Nome do campo que aparecerá na planilha

Fórmula: Nome da Function ou User Function

Parâmetros: Lista de parâmetros separados por vírgula. Para campos, basta informar o nome do mesmo, sem aspas. Para texto, colocar as informações utilizando aspas simples.

Alterações no fonte JURA108

O fonte responsável pela exportação personalizada deve ser alterado para que as fórmulas sejam exibidas na lista de campos relacionadas a tabela NQ2. Ver função JA108Camps.

Alterar a função JA108EXPOR e JA108GSQL para tratar os itens que são fórmulas separadamente.

Criar uma função para analisar as informações da fórmula, executar a mesma e retornar a cadeida de caracteres resultante da fórmula.

Alterações no fonte JURXFUN

Criação de function de exemplo.

Functions que deverão ser desenvolvidas e entregues no padrão

Criar as seguintes funções abaixo para que os clientes possam usar por padrão:

Como a Function deve ser escrita

Além dos parâmetros cadastrados para a fórmula, será enviada a função um parâmetro padrão com os filtros que deverão ser analisados e aplicados na operação realizada, conforme necessidade. A função deve retornar sempre um valor do tipo caracter.

USER FUNCTION FEXP_ENVC (aFiltros, cCajuri, cTipo)

/*

Parâmetros recebidos no exemplo

aFiltros {{“NSZ”,”AND NSZ001.NSZ_SITUAC = ‘1’”},{“NT4”,”NT4990.NT4_CATO=’001’”}}}

cCajuri “000000141”

cTipo “1”

*/

Local cRet := ‘’

Local aArea := GetArea()

Local cLista := GetNextAlias()

Local cSQL

cSQL := “SELECT NT9.NT9_NOME FROM “ + RetSQLName(“NT9”) + “ NT9 ”

cSQL += “ WHERE NT9.NT9_CAJURI = ‘” + cCajuri + “’”

cSQL += “ AND NT9.NT9_FILIAL = ‘” + xFilial(‘NT9’) + “’”

cSQL += “ AND NT9.D_E_L_E_T_ = ‘ ‘”

//Inclui os filtros da tela na consulta da fórmula

aEval(aFiltros,{|x| IIF( x[1] == “NT9”,cSQL+= StrTran(x[2],RetSQLName(‘NT9’),’NT9’),)})

cSQL := ChangeQuery(cSQL)

dbUseArea(.T., 'TOPCONN', TcGenQry( ,, cSQL ) , cLista, .T., .F.)

dbSelectArea(cLista)

(cLista)->(dbGoTop())

While (cLista)->(!Eof())

                cRet += (cLista)->NT9_NOME

                if ((cLista)->(!Eof())

                               cRet += “/”

                Endif

(cLista)->(dbSkip())

End

(cLista)->( dbcloseArea() )

RestArea( aArea )

Return cRet

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.