Í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".



Imagem 1 - 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 Dados: Define a ligação d

Caminho: . 

Caminho da Imagem: 





Imagem 2 - Propriedades importantes de um componente Imagem.


Propriedades que Definem a Apresentação de uma Imagem


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:

N°

Nome

Descrição

1Caminho da ImagemParâ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.
2ImagemParâ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.
3URL de NavegaçãoParâmetros, campo de Tabela ou Consulta SQL.

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

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.

1.2 - Cuidados ao Preencher as Propriedades de um Componente Imagem

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


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:

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.


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


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.




Imagem 8 - Relatório gerado com a imagem.


   

Produto: Framework

Versão: 12.01.XX

Processo: Adicionando uma Imagem

Status: Finalizado

Data: 10/10/2017

Autores:

Douglas Maxwell de Oliveira

Karina Dos Santos Costa

SARAH ROLAND CAMPOS LISBOA

Stella Gleyse Macedo Vilaca

Wesley Avelino De Carvalho