Produto:
TOTVS Reports
Versões:
12.1.x
Ocorrência:
Ambiente:
Passo a passo:
Conteúdo
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.
1 - Adicionando uma Imagem
Utilizaremos o exemplo abaixo para explanarmos o assunto "Adicionando uma Imagem".
Imagem 1 - Relatório exemplo.
1.1 - Propriedades Importantes de um Componente Imagem
Ao adicionar uma imagem em um relatório, devemos nos atentar para algumas propriedades:
| N° | Nome | Descrição |
|---|---|---|
| 1 | Ligação de Dados | Define a ligação de dados (campos de uma Tabela ou Consulta SQL) para cada uma das opções de preenchimento dos dados da imagem. |
| 2 | 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. |
| 3 | Caminho da Imagem | Permite escolher o caminho local da imagem. |
| 4 | 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. |
| 5 | 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 |
Imagem 2 - Propriedades importantes de um componente Imagem.
1.1.1 - Propriedades que Definem a Apresentação de uma Imagem
a. Ligaçã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:
| N° | Nome | Descrição |
|---|---|---|
| 1 | 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. |
| 2 | 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. |
| 3 | URL de Navegação | Parâmetros, campo de Tabela ou Consulta SQL. |
b. Caminho da Imagem
Através da propriedade Caminho da Imagem o usuário poderá escolher uma imagem proveniente de um caminho local na máquina.
Imagem 3 - Propriedade Caminho da Imagem.
c. Caminho
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:
Imagem 5 - Exceção levantada devido a vinculação errônea das propriedades Caminho da Imagem ou URL de Navegação.
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 6 - Relatório gerado sem a Imagem.
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 7 - Propriedade Imagem devidamente preenchida com campo do tipo IMAGEM, proveniente de uma Consulta SQL.
Imagem 8 - Relatório gerado com a imagem.
Observações: