PCREQ-5814 Exportação Personalizada fase 02

Características do Requisito

Descrição

• O objetivo é permitir que os usuários incluam fórmulas, como opções de campos, para a rotina Exportação Personalizada;
• Desenvolver funções() que recebam os parâmetros previamente cadastrados, no Cadastro de Fórmulas disponível em Atualizações / Configuração / Exportação personalizada JURA023;
• Apresentar as funções na lista de campos da Exportação Personalizada, e ao selecioná-las, o retorno das funções é apresentado no arquivo gerado pela Exportação Personalizada;

Como a fórmula deve ser cadastrada?

Como uma Function ou User Function dentro do RPO do Protheus. Lembrando que seu nome não pode exceder 09 caracteres.

No Cadastro de fórmulas em Configuração / Exportação Personalizada JURA023, para poder executar a fórmula.

Exemplo:

Visualizando no sistema

Image Added

Descrição: Nome do campo visível na planilha e na lista de campos da Exportação Personalizada.

Fórmula: Nome da Function ou User Function;

Parâmetros: Lista de parâmetros separados por vírgula.

Para campos: informe o nome, sem aspas;

Para texto: inclua aspas simples nas informações.

Como a Function deve ser escrita?

Como uma  function para receber os parâmetros conforme o cadastro de fórmulas.

Exemplo:

USER FUNCTION FEXPENV (cCajuri, cTipo)

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_ = ‘ ‘”

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

Procedimento para Utilização

1. Acesse o módulo Gestão Jurídica (SIGAJURI), em Atualizações / Configuração / Exportação Personalizada (JURA108);
2. Selecione a tabela e clique em Alterar;
   
3. Clique na tabela desejada e no grid inferior (Fórmulas), cadastre a fórmula preenchendo a Descrição, Nome da função criada e os Parâmetros necessários para a função;

Exemplo:
                 Descrição: Envolvidos Concatenados
                 Função: FEXPENV
                 Parâmetros: NUQ_CAJURI,1

4. Após cadastrar as fórmulas desejadas, clique em Confirmar;

5. Acesse agora Atualizações / Assuntos Jurídicos / Pesquisa, selecione a Pesquisa, se necessário utilize os campos de filtros, e para continuar clique em Pesquisar;

6. O sistema exibe todos os processos que atendem ao critério de pesquisa;

7. Posicione o cursor no processo desejado e com o botão direito do mouse, clique em Inserir o processo na fila de impressão;

8. Se quiser adicionar mais de um processo, repita o passo descrito no item 7; 

9. Visualize os itens enviados para a fila de impressão na parte inferior da tela;

10. Posicione o cursor em qualquer dos itens e com o botão direito do mouse, clique em Exportação personalizada;

11. Ao visualize a pergunta: Já foi executada a rotina de correção de valores?, clique em Sim ou faça a correção e retorne a este processo de exportação;

12. Observe a tela apresentada pelo sistema;

13. Selecione na opção Tabelas aquela(s) na(s) qual(is) foi(ram) cadastrada(s) a(s) fórmula(s), pela rotina Configuração / Exportação Personalizada;

Exemplo: NUQ, 

14. Visualize todos os campos que esta tabela contêm;

15. O sistema permite incluir todos os campos, utilizando a opção Adicionar Todos>> ou selecionar um a um os campos desejados, clicando em Adicionar>>;

16.Também é possível adicionar mais de uma tabela, repetindo os passos, a partir do item 13;

17. Se preferir manter esta configuração para posterior utilização, utilize o campo superior direito e clique em Salvar Como;

18. Também é possível movimentar os campos selecionados e que estão visíveis no quadro denominado Exportação, posicionado à direita da tela;

19. Com esta finalidade utilize as opções Mover para Cima ou Mover para Baixo; 

20. Após efetuar esta configuração, clique na opção Exportar, disponível na parte inferior direita da tela;

21. O sistema abre nesta ocasião, a área para salvar o arquivo a gerar;

22. Selecione a Pasta para guardar o arquivo gerado, e o nome do arquivo, após concluir esta etapa, clique em Salvar;

23. Neste momento o sistema gera o arquivo com as informações apresentadas e exibe a pergunta: Deseja abrir o arquivo?;

13. Para visualiza-lo, clique em Sim, e para sair sem visualizar, clique em Não;

14. Ao optar por visualizar (opção Sim), o arquivo em formato Excel é aberto;