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 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



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:

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.

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