Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Introdução:


Este documento tem por objetivo auxiliar na criação de um layout simples no Gerador de Saídas, para exemplificação de uso da ferramenta.

Neste exemplo será criado um relatório de Funcionários e seus dependentes, que pode ser seguido e depois adaptado para as necessidades do usuário.

Nota
titleManual

Esta documentação tem como objetivo resumir o uso do Gerador de Saídas em um exemplo

...

Incluir um layout:

...

simples e prático. Aqui não serão explicados termos e componentes da ferramenta. Para acesso à estas e mais informações, acesse: Manual do Gerador de Saídas

Incluindo um novo Layout


  • Primeiramente, iremos acessar a visão do Gerador de Saídas (Contida em Gestão → Ferramentas de Análise → Gerador de Saída) e então, cadastrar um novo Layout do Gerador de Saídas. Determinaremos o Nome como "Funcionários e seus Dependentes" e então, selecionaremos uma categoria em que o usuário utilizado possui permissões

...

  • :

Image Removed

Editar e parametrizar um layout:

...

Image Added


  • Agora, vamos abrir o Layout recém criado para podermos editá-lo. Isso pode ser feito clicando duas vezes sobre o Layout cadastrado. Logo após, é apresentada a tela de parametrização do gerador de Saídas

...

  • :

Image Added

Editando e Parametrizando o Layout


  • Com a tela de parametrização aberta, iremos adicionar primeiramente um novo Contexto. Para este exemplo utilizaremos uma Consulta SQL simples, mas você pode utilizar toda a gama de Contextos diferentes suportados pelo Gerador de Saídas

Adicionando um Contexto


Dica
titleContexto

Para aprender mais sobre o que é um contexto e a importância dele para o Gerador de Saídas, acesse: Manual - Contextos

  • Para adicionar o Contexto, iremos clicar em Contextos no canto inferior esquerdo da tela (Ou apertar F5 no teclado), acessar a aba recém habilitada Adicionar Contexto e então, selecionar Consulta SQL:

Image Added


  • Agora basta selecionar a Consulta SQL cadastrada no sistema:

Image Added


Informações
titleConsulta SQL

Abaixo a Consulta SQL que está sendo utilizada

Assim Vamos adicionar um CONTEXTO por CONSULTA SQL:

Image Removed

Image Removed

Será exibida a caixa de pesquisa para adicionar a Sentença SQL já cadastrada no cadastro de Sentenças SQL do sistema:

...

:

Bloco de código
languagesql
SELECT PFUNC.CHAPA, PFUNC.NOME, PFDEPEND.NOME AS 'NOME DEPENDENTE', PFDEPEND.DTNASCIMENTO, PFDEPEND.SEXO
FROM PFUNC INNER JOIN PFDEPEND ON PFUNC.CODCOLIGADA =
PFDEPEND.CODCOLIGADA
AND PFUNC.CHAPA = PFDEPEND.CHAPA
Dica
titleParâmetros na Consulta SQL

É possível também utilizar parâmetros na consulta SQL conforme exemplo abaixo:

Bloco de código
languagesql
SELECT CHAPA FROM PFUNC
WHERE CODCOLIGADA = :$CODCOLIGADA
Aviso
titleAtenção

Ao utilizar filtros de visão que fazem o uso da condição (In SQL) onde a consulta SQL possua parâmetros, os parâmetros precisam começar com a Letra F e logo após um número identificando o parâmetro. 

Exemplo:

Bloco de código
languagesql
SELECT * FROM PFUNC WHERE CHAPA = :

...

F1 AND CODCOLIGADA = :

...

F2 
Dica
iconfalse

Variáveis de contexto não precisam seguir este padrão:


Bloco de código
languagesql
SELECT * FROM PFUNC WHERE CHAPA = :

...

F1 AND CODCOLIGADA = :$CODCOLIGADA

...


  • Após

...

  • a

...

  • seleção da Consulta SQL, podemos notar que no Contexto recém adicionado já constam os campos da

...

  • sentença SQL

Image Added

Agora finalizamos a etapa de seleção de Contexto e iremos adicionar um Layout.

Adicionando um Arquivo


Dica
titleContexto

Para aprender mais sobre o que é um arquivo e a importância dele para o Gerador de Saídas, acesse: Manual - Configuração do Arquivo


  • Para adicionar um Arquivo, primeiramente iremos acessar novamente a aba Layout, presente no canto inferior esquerdo da tela (Ou apertando F4):

Image Added


  • Logo então selecionaremos na árvore chamada Layout o item Arquivos. Assim, os botões Adicionar Arquivo Adicionar Registro serão liberados. Selecionamos Adicionar Arquivo para adicionar um novo arquivo ao Layout do Gerador de Saídas:

Image Added

...


Informações
  • No campo Nome, definimos o Nome deste arquivo que será gerado.
  • Nas Propriedades

...

  • iremos determinar o caractere "|" como separador de campos e linhas:

Image Added


  • E após a criação do Arquivo, é necessário determinar os Registros que serão impressos.

Adicionando um Registro


Dica
titleContexto

Para aprender mais sobre o que é um registro e a importância dele para o Gerador de Saídas, acesse: Manual - Configuração do Registro

  • Assim como com os Arquivos, selecionaremos na árvore chamada Layout o item Registros e então,  Adicionar Registro para adicionar um novo registro ao Layout do Gerador de Saídas.

Criação dos Campos do Registro

Âncora
campos
campos

Um registro pode conter vários campos. Para criar os campos

...

, selecione

...

o registro com duplo-clique.


Informações
iconfalse

No painel

...

demonstrado abaixo são apresentadas as informações sobre o registro selecionado

...

:

Image Added


Nos Campos (na parte inferior da tela) poderão ser criados os campos do layout.

O botão Image Modified criará campos visíveis que serão gravados no arquivo texto.

O botão Image Modified criará campos invisíveis.

Estes servem somente para executar cálculos e utilizarem expressões e não são gravados no arquivo texto.

Utilize o botão Image Modified para excluir campos.

Os botões Image Modified e Image Modified auxiliam na movimentação de campos criados na ordem incorreta.

Dica

...

Crie campos com nomes que estejam relacionados ao seu conteúdo. Para

...

informar mais a respeito dos campos utilize o campo Descrição.

...

  •  Iremos então adicionar um novo campo, utilizando o botão Image Added. Devemos informar o tamanho, se o campo é obrigatório e o tipo de dados que ele receberá:

Image Added


Informações

A propriedade Modo pode assumir os seguintes valores:

• Primeiro valor
• Último valor
• Chave Primária
• Contar
• Somar
• Média

...


  • Agora é necessário realizar a atribuição do campo à sua propriedade no contexto, mas antes de realizar essa atribuição, devemos atrelar o contexto que será fornecedor dos campos ao registro. Para isso, iremos selecionar a aba Contexto no canto inferior esquerdo da tela, selecionar a tabela da consulta SQL e arrastá-la até a propriedade Ligação do Registro:

Image Added


Dica
Se for necessário adicionar dois

...

Contextos do tipo

...

Conjunto de

...

Dados ou Consulta SQL a um mesmo registro é aconselhável que estes contextos sejam revistos. Provavelmente eles possuem relação entre si e podem ser transformados em um contexto apenas.
  • Por fim, vamos atrelar então as colunas da tabela proveniente da Consulta SQL aos Campos do Registro do Gerador de Saídas.

...

Associando informações do contexto aos campos do registro:

...

  • Para fazer isso, iremos selecionar a coluna desejada na aba de Contexto e arrastá-la até a propriedade Ligação do campo do Registro:

Image Added

Nota
iconfalse

Após a associação, não se esqueça de definir o Tipo de Dados, Tamanho e Modo do campo.


  • Por fim adicionamos mais duas colunas aos seus respectivos campos e estamos prontos para realizar a geração:

Image Added

  • Agora toda a configuração do Layout do Gerador de Saídas está feita. Iremos então realizar a geração deste Layout.

Gerando o Layout Configurado


  • Para realizar a geração deste Layout iremos retornar a visão do Gerador de Saídas, selecionaremos o Layout e na aba Processos, iremos clicar em Geração de Saídas:


Image Added


  • Seremos então apresentados ao Assistente de Geração de Saídas. Aqui iremos determinar as informações de acordo com a necessidade de onde gerar o arquivo e afins:

Image Added

Nota
titleGeração no Servidor

Âncora
geracaoServidor
geracaoServidor

A partir da versão 12.1.2406.155, caso o ambiente esteja com a tenantização ativa (A tag TENANTPATHENABLED esteja marcada como true), gerações do Gerador de Saídas que estiverem marcadas para Gerar arquivos no servidorpermitirão apenas a determinação do caminho relativo em que o arquivo deverá ser salvo no servidor, por razões de segurança e privacidade de informações. Nestes casos o arquivo será gerado de acordo com o determinado na tag FileServerPath (ou na pasta compartilhada padrão do sistema caso a tag não tenha sido fornecida), dentro de uma pasta chamada Saidas e por fim, dentro do caminho relativo fornecido:

Image Added


  • Em um cenário hipotético que a pasta do servidor seja "\\MinhaMaquinaDeArquivos\DiretorioCompartilhado", e o caminho relativo fornecido seja "Departamento\Equipe", a saída será gerada no caminho:
Informações
iconfalse

\\MinhaMaquinaDeArquivos\DiretorioCompartilhado\NomeDoTenant\Saidas\Departamento\Equipe


Para gerações que deverão ser salvas no mesmo dispositivo-cliente (Sem a marcação Gerar arquivos no servidor), o usuário poderá escolher livremente onde na sua própria máquina, deseja salvar os arquivos provenientes da geração.


Layouts marcados com Usa Diretório Padrão também serão salvos de forma tenantizada, com a possibilidade de determinar o caminho relativo em que deverão ser salvos.


  • E por fim, após a execução, podemos notar que o arquivo salvo no diretório determinado (Neste caso não marcamos para Gerar arquivos no servidor) possui os registros dais quais determinamos na configuração do Gerador de Saídas:

Image Added


...

Associando uma Fórmula aos campos do registro

...


  • Ao adicionar um campo ele pode ser vinculado a vários tipos de ligação

...

  • .

Image Added


  • Ao selecionar o tipo Fórmula, será apresentada a visão com as Fórmulas do RM.

...

Image Added


Aviso
titleProibido selecionar Fórmula na coligada Zero

Caso seja selecionada alguma Fórmula que esteja na coligada Zero, será apresentado um aviso informando que não é permitido, portanto deve ser selecionada outra Fórmula.
Quando for possível identificar será apresentado qual o Registro e o Campo, que a Fórmula esta vinculada.

Ao editar o Layout e tentar salvar o aviso de erro será apresentado, sendo possível identificar qual o Registro, Campo e Fórmula a ser corrigida!

Image Added


Informações
titlePara maiores informações:


Image Modified COMUNIDADE  @FRAMEWORK


Canais de Atendimento:

Chamado: Através do Portal Totvs www.suporte.totvs.com.br

Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 4 – (BI) e 3 –  (Gerador de Relatórios e Planilha);

Informações
titleÍndice

Índice

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Processo: Gerador de Saídas

Informações
iconfalse
Informações
iconfalse
titleStatus

 

Estado
colourGreen
titleCONCLUÍDO