4D Doc Center : QR REPORT

4D v14.3

QR REPORT


QR REPORT ( {tabela ;} documento {; hierarquico {; assistente {; pesquisa {; methodName {; *}}}} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela a utilizar para o relatório ou tabela por padrão se for omitido
documento	cadeia	Documento de Relatório Rápido a carregar
hierarquico	Booleano	True = Mostrar as tabelas Muitos relacionadas; se for omitido ou se for False= Não mostrar (por padrão)
assistente	Booleano	True = Mostrar o botão do assistente False ou se for omitido = Não mostrar (por padrão)
pesquisa	Booleano	True = Mostrar as ferramentas de pesquisa e a tabela principal False ou se for omitida = Não mostrar (por padrão)
methodName	cadeia	Name of method to call
*	Operador	Eliminação das caixas de diálogo de impressão

Descrição

QR REPORT imprime um relatório para tabela, criado com o editor de relatórios rápidos que se mostra a continuação.

O editor de relatórios rápidos permite aos usuários criar seus próprios relatórios. Para maior informação sobre a criação de relatórios rápidos com a ajuda do editor de relatórios rápidos, consulte o Manual de Desenho de 4D.

Notas:

O editor não aparece se a tabela tiver sido declarada “Invisível.”
Quando o editor se chama utilizando o comando QR REPORT, a opção Todas as relações automáticas, que permite modificar o estado automático/manual das relações é ocultada. Isso permite ao desenvolvedor administrar ele mesmo esse estado utilizando os comandos SET AUTOMATIC RELATIONS e SET FIELD RELATION.
O editor é chamado em uma janela externa e não é possível utilizar o comando QR ON COMMAND neste contexto. No entanto, pode utilizar o parâmetro nomMetodo para executar código personalizado quando um comando de interface se ativa (ver abaixo).

O parâmetro documento é um documento de relatório que foi criado com o editor de relatórios rápidos e guardado em disco. O documento guarda as especificações do relatório, não os registros a imprimir. Se uma cadeia vazia ("") se passa em documento, QR REPORT mostra uma caixa de diálogo de abertura de arquivos, na qual o usuário pode selecionar o relatório a imprimir.

Se o parâmetro documento especifica um documento que não existe (por exemplo, se passa Char(1) em documento), se mostra o editor de relatórios rápidos.

O parâmetro hierarquico indica se as tabelas Muitos relacionadas são mostradas na lista de seleção de campos. Por padrão, este valor é 0 (as tabelas Muitos não são mostradas).

O parâmetro assistente indica se o botão Abrir o assistente vai ser mostrado no editor de relatórios rápidos, permitindo ou não o aceso ao assistente. Por padrão, este valor é False (não há acesso ao assistente).

O parâmetro pesquisa indica se o botão Nova pesquisa e o menu suspenso Tabela principal aparecerão no editor de relatórios rápidos, portanto permitindo ou não a modificação da tabela atual e da tabela principal atual. Por padrão, este valor é False (não há acesso às ferramentas de pesquisa e a tabela principal).

Uma vez selecionado um relatório, as caixas de diálogo de impressão são mostradas, a não ser que especifique o parâmetro *. Se for especificado este parâmetro, não são mostradas estas caixas de diálogo e se imprime o relatório.

Se não for mostrado o editor de relatórios rápidos, a variável sistema OK toma o valor 1 se for imprimir um relatório; do contrário, toma o valor 0 (zero) (por exemplo, se o usuário clicar em Cancelar nas caixas de diálogo de impressão).

4D Server: este comando pode ser executado no servidor 4D Server no marco de um procedimento armazenado. Neste contexto:

Tenha certeza de que não apareça nenhuma caixa de diálogo na máquina servidor (exceto para um requerimento especifico). Para fazer isso, é necessário chamar o comando com o parâmetro * ou >.
A sintaxe que faz aparecer o editor Quick Report não funciona com 4D Server; neste caso, a variável sistema OK toma o valor 0.
No caso de um problema relacionado com a impressora (sem papel, impressora desconectada, etc.), não se gera um erro.

Exemplo 1

O exemplo a seguir permite ao usuário realizar uma pesquisa na tabela [Pessoas], e depois imprime automaticamente o relatório “Lista detalhada”:

 QUERY([Pessoas])

 If(OK=1)

    QR REPORT([Pessoas];"Detailed Listing";False;False;False;*)

 End if

Exemplo 2

O exemplo a seguir permite ao usuário realizar uma pesquisa na tabela [Pessoas], e depos selecionar o relatório a imprimir:

 QUERY([Pessoas])

 If(OK=1)

    QR REPORT([Pessoas];"";False;False;False)

 End if

Exemplo 3

O exemplo a seguir permite ao usuário realizar uma pesquisa na tabela [Pessoas], e depois mostra o editor de relatórios rápidos de maneira que o usuário possa desenhar, salvar, carregar e imprimir relatórios com ou sem o assistente:

 QUERY([Pessoas])

 If(OK=1)

    QR REPORT([Pessoas];Char(1);False;True)

 End if

Exemplo 4

Consulte o exemplo do comando SET FIELD RELATION.

Exemplo 5

Você deseja converter o conjunto de caracteres utilizado em um relatório rápido chamado utilizando QR REPORT em Mac Roman:

QR REPORT([MyTable];Char(1);False;False;False;"myCallbackMeth")

O método myCallbackMeth converte o relatório quando é gerado:

 C_LONGINT($1;$2)

 If($2=qr cmd generate) //Se geramos um relatório

    C_BLOB($myblob)

    C_TEXT($path;$text)

    QR EXECUTE COMMAND($1;$2) //execução do comando

    QR GET DESTINATION($1;$type;$path) //recuperação do destino

    DOCUMENT TO BLOB($path;$myblob)

  //conversão do texto utilizando UTF-8

    $text:=Convert to text($myblob;"UTF-8")

  //uso do conjunto MacRoman

    CONVERT FROM TEXT($text;"MacRoman";$myblob)

  //Reenvio do relatório convertido

    BLOB TO DOCUMENT($path;$myblob)

 Else //caso contrário, execução do comando

    QR EXECUTE COMMAND($1;$2)

 End if