Recursos avançados

Como usuário técnico, além das propriedades gerais, você pode aproveitar recursos avançados para configurar os relatórios, como:

  • Criar queries complexas para processar dados em uma atividade Script. Saiba mais

  • Adicionar um script externo para ser executado no servidor ou no cliente. Saiba mais

  • Chamar um relatório com uma atividade Jump. Saiba mais

  • Adicionar um parâmetro de URL a um relatório para torná-lo mais acessível. Saiba mais

  • Adicionar variáveis que serão usadas no contexto do relatório. Saiba mais

Trabalhar com scripts

Scripts externos de referência

Você pode referenciar códigos JavaScript que serão executados pelo cliente e/ou pelo servidor quando a página do relatório for chamada.

Para fazer isso:

  1. Edite as propriedades do relatório e clique em Scripts.

  2. Clique em Add e selecione o script que será referenciado.

  3. Em seguida, selecione o modo de execução.

    Se adicionar vários scripts, use as setas da barra de ferramentas para definir sua sequência de execução.

Para execução normal pelo cliente, os scripts referenciados devem ser escritos em JavaScript e precisam ser compatíveis com a maioria dos navegadores. Para obter mais informações, consulte esta seção.

Adicionar uma atividade Script

Ao projetar seu relatório, use a atividade Script para processar dados e criar facilmente queries complexos que não habilitam o idioma SQL. Você pode inserir seu query diretamente na janela de script.

A guia Texts permite definir cadeias de texto. Elas podem ser usadas com a seguinte sintaxe: $(Identifier). Para obter mais informações sobre como usar textos, consulte Adicionar um cabeçalho e um rodapé.

CAUTION

NÃO recomendamos o uso do código JavaScript para criar agregações.

Para criar um histórico do relatório, adicione a seguinte linha à sua query JavaScript para salvar os dados arquivados:

if( ctx.@_historyId.toString().length == 0 )

Caso contrário, os dados atuais serão exibidos.

Adicionar um parâmetro de URL

A guia Parameters das propriedades do relatório permite definir configurações adicionais para o relatório: essas configurações serão repassadas para o URL durante a chamada.

CAUTION

Por motivos de segurança, esses parâmetros devem ser usados com muito cuidado.

Para criar uma nova configuração:

  1. Clique no botão Add e digite o nome da configuração.

  2. Se necessário, especifique se a configuração será obrigatória ou não.

  3. Selecione o tipo de configuração que deseja criar: Filter ou Variable.

    A opção Filter entities permite usar um campo do banco de dados como parâmetro.

    Os dados são recuperados diretamente no nível da entidade: ctx/receipt/@account.

    A opção Variable permite criar ou selecionar uma variável que será passada como parâmetro do URL e pode ser usada nos filtros.

O Response HTTP headers permite que você evite o recurso de clickjacking ao incluir a página do seu relatório em uma página HTML usando o iframe. Para evitar o clickjacking, você pode escolher o comportamento X-Frame-options header:

  • None: O relatório não terá X-Frame-options header.
  • Same as origin: Definido por padrão para novos relatórios e relatórios republicados. O nome do host será igual ao URL do relatório.
  • Deny: O relatório não pode ser incluído em uma página HTML usando iframe.

Adição de variáveis

A guia Variables contém a lista de variáveis configuradas no relatório. Essas variáveis são expostas no contexto do relatório e podem ser utilizadas em cálculos.

Clique no botão Add para criar uma nova variável.

Para exibir a definição de uma variável, selecione-a e clique no botão Detail….

Caso de uso: usar variáveis e parâmetros em um relatório

No exemplo do vídeo abaixo, você aprenderá a adicionar um parâmetro "_type" para criar diferentes visualizações de um relatório com base no valor desse atributo.

Descubra este recurso no vídeo

Chamado de outro relatório

Um Jump é como uma transição sem uma seta: permite ir de uma atividade para outra ou acessar outro relatório.

Nesta página