Versões comparadas

Chave

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

Adicionando uma Imagem

...

Produto:

...

TOTVS Reports

...

Versões:

...

12.1.x

...

Ocorrência:

...

 

...

Ambiente:

...

 

...

Passo a passo:

...

Índice:


       

Índice
exclude

...

.*ndice:

Introdução:


     

...

 Com o advento da migração do TOTVS Reports da versão 11.8x para as versões superiores a versão 12.1.4, muitas alterações foram feitas principalmente na geração sobre demanda dos dados vinculados a cada componente presente no relatório.

Em relatórios da versão 11.8x, por exemplo, a geração sobre demanda dos dados era realizada no momento da impressão de cada componente, ao contrário dos das versões mais atuais (12.1.5 ou superiores), onde a geração dos dados é feita através de apenas uma consulta SQL (Fase de Preparação), que é gerada a partir das tabelas e consultas SQL vinculadas ao relatório.

Adicionando uma Imagem


   Utilizaremos o exemplo abaixo para explanarmos o assunto "Adicionando uma Imagem".


Image Added
Imagem 1 -

...

 

Ao se utilizar uma Consulta SQL vinculada a Bandas do Relatório, primeiro precisamos saber:

 Relatório exemplo.


Propriedades Importantes de um Componente Imagem


   Ao adicionar uma imagem em um relatório, devemos nos atentar para algumas propriedades:

Ligação de DadosDefine a ligação de dados (campos de uma Tabela ou Consulta SQL) para cada uma das opções de preenchimento dos dados da imagem.

Caminho: Ao se definir a ligação de dados para uma das opções disponíveis de preenchimento dos dados da imagem, essa propriedade conterá o caminho da ligação escolhida. Caso a propriedade Ligação de Dados não esteja preenchida ela também permite que seja escolhido um caminho de relacionamento de dados.

Caminho da Imagem: Permite escolher o caminho local da imagem.

Imagem: Mostra o nome da imagem escolhida através da propriedade Caminho da Imagem. Caso a Propriedade Caminho da Imagem não seja preenchida, ela permite que se escolha uma imagem através dela própria.

Tabela: Ao se definir a ligação de dados para uma das opções disponíveis de preenchimento dos dados da imagem, essa propriedade conterá a tabela ou consulta SQL da ligação escolhida


Image Added


Propriedades que Definem a Apresentação de uma Imagem:

Informações
iconfalse
Deck of Cards
idI
Card
labelLigação de dados

Através da Propriedade (Ligação de Dados) o usuário poderá escolher uma imagem proveniente de um campo de uma Tabela ou de um campo de uma Consulta SQL.

O usuário poderá escolher entre três formas de se ligar os dados ao componente Imagem:

Caminho da Imagem: Parâmetros, campo de Tabela ou Consulta SQL que contenha um caminho físico na máquina. Permite também escolher um arquivo de imagem diretamente na máquina.

Imagem: Parâmetros, campo de Tabela ou Consulta SQL que contenha uma Imagem (em bytes). Caso o arquivo seja escolhido diretamente na máquina essa propriedade será preenchida automaticamente com a imagem escolhida.

URL de Navegação: Parâmetros, campo de Tabela ou Consulta SQL.

Card
labelCaminho da imagem

Através da propriedade Caminho da Imagem o usuário poderá escolher uma imagem proveniente de um caminho local na máquina.

Image Added

Card
labelCaminho

Através dessa propriedade um relacionamento de dados entre a tabela master do detalhe e a tabela do campo a ser vinculado a imagem é estabelecido fazendo com que a imagem seja devidamente apresentada.

Cuidados ao Preencher as Propriedades de um Componente Imagem:

Informações
iconfalse
Deck of Cards
idI
Card
label1º Cuidado

Ao se preencher a Propriedade (Ligação de Dados) deve se atentar a:

Image Added
Imagem 4 - Vinculo errôneo da Propriedade Caminho da Imagem.

  • Não se deve vincular uma imagem (campos do Tipo BLOB, IMAGE, e outros) proveniente de uma Tabela ou Consulta SQL nas Propriedades Caminho da Imagem e URL de Navegação, pois, a exceção abaixo será apresentada:
Card
label2º cuidado

No momento da geração existe a possibilidade de desmarcar a opção de Parar a Execução do Relatório em Caso de Erros, nesse caso a imagem não será gerada, porém as demais informações do relatório serão apresentados corretamente.

Image Added
Imagem 5 - Exceção levantada devido a vinculação errônea das propriedades Caminho da Imagem ou URL de Navegação.


Card
label3º cuidado

Ao vincular uma Imagem (campos do Tipo BLOB, IMAGE, e outros), proveniente de uma Tabela ou Consulta SQL, à propriedade Imagem, o relatório será gerado com as imagens devidamente preenchidas.


Image Added


Card
labelRelatório com Imagem

Image Added
Imagem 8 - Relatório gerado com a imagem.


   

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.1.XX

Informações
iconfalse

Processo: Adicionando uma Imagem

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: 10/10/2017

Informações
iconfalse

Autores:

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gustavo Naves De Castro

Philippe Fernandes Lima Gonçalves

Wesley Avelino De Carvalho

...

Observações:

...