Índice:

Índice

exclude	.*ndice:

Objetivo:

O objetivo deste documento é trazer uma visão de como funciona a tela de Entidades.

Introdução:

Para determinar quais campos serão utilizados pelo relatório é necessário criar uma entidade de sua Fonte de Dados.

Como criar:

Para criar uma nova Entidade, basta clicar em "+ Novo" e informar os campos abaixo:

Fonte de dados: Informe de qual Fonte de Dados, cadastrada anteriormente, as informações serão buscadas.

Nome da Entidade: Este campo é automaticamente preenchido com o nome da sua Fonte de Dados, mas pode ser alterado.

Informações
O nome da entidade não deve começar com números, ou conter apenas números.

Descrição: Informe uma descrição.

Deck of Cards

id	Entidade

Card

id	1
label	Campos da entidade

Selecione os campos que serão utilizados no relatório.

Dica
Utilize "Pesquisar coluna" para facilitar a busca, caso a entidade tenha muitas colunas.

Dica
Utilize os filtros para buscar pelos campos já selecionados ou sem seleção.

Exemplo prático abaixo:

Image Added

Card

id	2
label	Campos relacionais

Conector de Widget

width	500
url	https://www.youtube.com/watch?v=811e2NMsHY8&feature=youtu.be
height	350

Assista ao vídeo com áudio para compreender a funcionalidade de Campos Relacionais.

Aviso

icon	false

Em seguida, selecione as colunas que serão utilizadas no relatório

Só será possível cadastrar um campo relacional, quando a Fonte de Dados utilizar conexão com um Provedor Integrado e for do tipo Tabela.

Na estrutura do relatório é necessário informar qual será o Membro de Dados (Entidade) de cada detalhe. Quando necessário utilizar um campo na mesma banda do relatório, que não pertence a Fonte de Dados cadastrada, é possível criar um campo relacional.

Ex: No detalhe do relatório será mostrado os dados de um funcionário e de sua seção. Como a tabela de Funcionários não possui os dados completos de sua seção, será necessário criar um campo relacional.

Para cadastrar um ou mais campos relacionais, basta selecionar a guia "Campos Relacionais" e clicar em "+ Adicionar" seguindo os passos abaixo:

Deck of Cards

id	Campos

Card

id	1
label	Inicio

Primeiramente, utilize o lookup para pesquisar a tabela que servirá como fonte de dados para as colunas virtuais.

Prosseguindo com o exemplo citado acima, vamos selecionar a tabela "PSECAO".

Em seguida, selecione os campos que serão utilizados no relatório e clique em "Próximo".

Dica
Utilize "Pesquisar coluna" para facilitar a busca, caso a entidade tenha muitas colunas.

Dica
Utilize os filtros para buscar pelos campos já selecionados ou sem seleção.

Image Added

Card

id	2
label	Passo 2

Na fase dois (“Relação”) há dois caminhos a se seguirem.

O primeiro trata do relacionamento direto: Quando encontrado relacionamento direto, o wizard avançará para a fase 3 (“Resumo”) e apresentará a ligação definida.

Image Added

Card

id	3
label	Passo 3

O segundo trata do relacionamento intermediário: Quando não há um relacionamento direto entre duas tabelas, é possível utilizar uma tabela intermediária.

Utilizamos como exemplo a tabela PFUNC, PPESSOA e GIMAGEM para retornar a imagem do colaborador. As tabelas PFUNC e GIMAGEM não fazem relacionamento direto, então a PPESSOA será intermediária nessa ligação.

Para isso, na fase 1 ("Inicio") pesquise pela tabela onde a informação desejada se encontra. Selecionamos o campo IMAGEM, na tabela GIMAGEM. Clique em próximo.

Image Added

Na fase 2 (“Relação”) selecione no combo a tabela que fará a ligação intermediaria. Feita a seleção, clique em adicionar.

Exemplo prático abaixo:

Image Added

Aviso

icon	false

Quando o relacionamento apresentar mais de uma opção entre a tabela intermediária e final, o sistema criará outro combo. Nesta fase, denominado “Relacionamentos Disponíveis”. Neste momento, escolha o relacionamento entre a tabela intermediária e final do campo relacional.

Finalizada a seleção do caminho, clique em adicionar novamente para que o caminho seja montado e visualizado na parte superior da fase. Clique em próximo para avançar para fase 3. Na fase 3, clique em “Finalizar”.

Image Added

Aviso

icon	false

A opção “Buscar Relacionamentos Diretos” estará sempre disponível na fase 2 (“Relação”). Ela lista todas as tabelas que se relacionam diretamente com a tabela corrente.

Não necessariamente as tabelas listadas vão chegar ao destino final desejado.

Essa opção deve ser utilizada quando o usuário conhecer as tabelas do banco e já souber o caminho desejado para chegar em sua tabela destino.

Image Added

Card

id	3
label	Campos SQL

Campos SQL têm a finalidade de permitir a interação entre os dados de Entidades distintas.

Ex: Uma consulta SQL que retorna determinadas informações de um funcionário, porém precisa de um parâmetro que é o identificador do Funcionário. Sabe-se que existe uma Entidade cadastrada que retorna o campo Identificador do Funcionário.

Dessa forma, através dos Campos SQL é possível ligar os parâmetros da Consulta SQL aos campos de uma ou mais Entidades.

Dica
É importante que na estrutura do Relatório, as Entidades ligadas aos parâmetros estejam na mesma banda ou em bandas superiores a Consulta SQL.

Para cadastrar um ou mais campos SQL, basta selecionar a guia "Campos SQL" e clicar em "+ Adicionar" seguindo os passos abaixo:

Informações

title	Campos SQL

Alias: Informe o alias de sua Consulta SQL

Sentença SQL: Digite a sentença SQL

Seguindo o exemplo citado acima, vamos cadastrar uma Consulta SQL que precisará de dois parâmetros que são retornados pela Entidade "Funcionário" e um parâmetro geral.

Nesta consulta, a tabela PFHSTSAL tem as informações de histórico salarial de um Funcionário e retornará o ultimo salário recebido, antes do salário atual.

Bloco de código

language	sql

SELECT TOP 1 PFHSTSAL.SALARIO
FROM PFHSTSAL
WHERE PFHSTSAL.SALARIO < :SALARIO
  AND PFHSTSAL.CHAPA = :CHAPA
  AND PFHSTSAL.CODCOLIGADA =:CODIGO
ORDER BY PFHSTSAL.SALARIO DESC

Informações

Recomendamos que a consulta retorne resultados 1x1.

Caso a consulta retorne 1xN, somente a primeira linha retornada será exibida no relatório.

Note que a opção "Ligar parâmetros" aparece na tela. Clique nela para vincular os parâmetros da sentença aos parâmetros cadastrados ou aos parâmetros de Entidade.

Deck of Cards

id	Ligação de Parâmetros

Card

id	1
label	Parâmetro Gerais

Continuando com o exemplo citado acima, 1 dos 3 parâmetros da Consulta será buscado dos parâmetros gerais (que são parâmetros cadastrados previamente e podem ter seu valor alterado na hora de geração do relatório).

Nesse caso, o parâmetro "CODIGO" foi ligado à um Parâmetro Geral.

Image Added

Dica
Caso o parâmetro ainda não tenha sido cadastrado, clique na opção "Adicionar parâmetros" para adicionar um novo parâmetro e vincular o mesmo a sua consulta SQL.

Card

id	2
label	Parâmetros de Entidades

Continuando com o exemplo citado acima, 2 dos 3 parâmetros da Consulta serão buscados dos parâmetros de entidades.

Neste caso, deve-se escolher a Entidade e a coluna correspondente em que o valor será buscado.

Image Added

Informações
É recomendado salvar o cadastro da Entidade antes de prosseguir para a etapa de Parâmetros da Entidade, para que assim os dados da Entidade atual sejam exibidos corretamente na listagem.

Aviso
Um mesmo parâmetro só pode ser ligado em uma das abas, ou seja, ele não pode ser ligado à um parâmetro geral e à um parâmetro de entidade ao mesmo tempo.

Image Removed

Informações

icon	false

Informações

icon	false

Produto: Framework

Informações

icon	false

Versão: 12.011.XX22 ou Superiores

Informações

icon	false

Processo: Entidades

Informações

icon	false

Informações

icon	false

Status: Pendente Em elaboração

Informações

icon	false

Data: 08/12/2017

Informações

icon	false

Autores:

Aline Cristina Braz De Oliveira

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gabriel Dias De Oliveira Silva

Gustavo Naves De Castro Philippe Fernandes Lima Gonçalves

SARAH ROLAND CAMPOS LISBOA

Wesley Avelino De Carvalho

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 14

Nova versão Atual

Chave

Índice:

Objetivo:

Introdução:

Como criar:

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 14

Nova versão Atual

Chave

Índice:

Objetivo:

Introdução:

Como criar: