Parâmetros do Report.cfg

Informações sobre os parâmetros Report.cfg.

A amostra Report.cfg mostrada em Configurar o conjunto de relatórios contém apenas os parâmetros incluídos no arquivo Report.cfg por padrão. A tabela a seguir fornece descrições de todos os parâmetros de arquivo Report.cfg disponíveis.

Se precisar adicionar mais parâmetros a um arquivo Report.cfg, faça isso usando um editor de texto. Para obter etapas para fazer isso, incluindo exemplos de como definir cada entrada de parâmetro, consulte Editar arquivos Report.cfg existentes.

OBSERVAÇÃO

Os parâmetros nesta tabela estão listados em ordem alfabética. Ao abrir o arquivo Report.cfg no Data Workbench, os vetores são listados em ordem alfabética, seguidos por parâmetros individuais listados em ordem alfabética.

Parâmetro Descrição
Limite de Alerta

Opcional. Esse parâmetro aplica-se somente a relatórios com indicadores de métrica. Número de indicadores de métrica que devem aparecer na planilha antes do envio de um relatório de alerta.

Se apenas uma métrica estiver sendo monitorada na planilha do indicador de métrica, defina o limite como 1. O relatório é gerado quando a métrica na planilha é avaliada como uma seta para cima/para baixo ou um X. Se mais de uma métrica estiver sendo monitorada no relatório, você pode selecionar o número de indicadores de métrica que devem ser avaliados como uma seta para cima/para baixo ou um X antes de o relatório ser gerado. Por exemplo, se duas métricas estiverem sendo monitoradas:

  • Se o limite for definido como 1, o relatório será gerado se qualquer uma das métricas na planilha for avaliada como uma seta para cima/para baixo ou um X.
  • Se o limite for definido como 2, ambas as métricas deverão ser avaliadas como uma seta para cima/para baixo ou como um X antes de o relatório ser gerado.

Para obter mais informações sobre indicadores de métrica, consulte o Guia do Usuário do Data Workbench.

Permitir Regeneração de Relatório

Indica se o Servidor de Relatório gera ou regenera automaticamente relatórios específicos quando você cria ou modifica esses relatórios. As opções são true ou false. Se definido como true, criar ou modificar um espaço de trabalho de relatório fará com que Servidor de Relatório gere novamente esse relatório para a execução mais recente.

Observação: Alterar o arquivo Report.cfg faz com que o Servidor de Relatório regenere todos os relatórios controlados por esse arquivo Report.cfg .

Anexos

Opcional. Identificador de seção para o nome e o tipo de conteúdo de qualquer anexo que sai com relatórios distribuídos por email, incluindo o número de anexos.

Para adicionar um novo anexo:

  1. Abra o arquivo Report.cfg no Data Workbench.
  2. Clique com o botão direito do mouse em Attachments e clique em Add new child > Attachment .

Tipo de conteúdo

Tipo de conteúdo do arquivo a ser anexado.

Exemplo: image/jpeg

FileName

Localização e nome do ficheiro a anexar.

Exemplo: c:\myimage.jpg

Conjunto de cores Identifica o esquema de cores a ser usado para arquivos .png . 0 é para um fundo preto; 1 é para um fundo branco; e 2 é para uma imagem em tons de cinza.
Comando A Ser Executado Opcional. Um comando em lote ou executável executado depois que o conjunto de relatórios é gerado. Se a inicialização do interpretador de shell de comando for necessária, preceda o comando por cmd /c.
Modelo do Excel padrão

Opcional. Nome do arquivo de modelo genérico do Excel ( .xls ou .xlsx ) que você deseja usar ao gerar relatórios como arquivos do Excel. Esse parâmetro suporta caminhos completos de arquivo, como c:\templates\mytemplate.xls .

Esse arquivo é usado para todos os relatórios do Excel, a menos que um modelo tenha sido definido especificamente para um relatório específico. Consulte Usando um arquivo de modelo .

Nome da dimensão Opcional. Nome da dimensão para a qual você deseja gerar um relatório dinamicamente. Se você inserir um nome de dimensão nesse parâmetro, deverá inserir um valor no parâmetro Arquivo de pesquisa ou nos parâmetros Métrica N principais e Valor N superior . A dimensão nomeada nesse parâmetro deve existir no conjunto de dados para o qual os relatórios estão sendo criados.
Somente Email Se Perfeito Opcional. Permite que o usuário especifique que um conjunto de relatórios deve ser enviado somente quando nenhum erro ocorrer durante a execução. As opções são true e false. O valor padrão é false.
Data final

Opcional. A última data e hora em que você deseja que o relatório seja executado. Essa hora é baseada na hora de início do conjunto de dados.

Formato: MM/DD/AAAA fuso horário hh:mm, usando a sintaxe de 24 horas para o tempo

Exemplo: 01/08/2007 12:01 EDT

Para obter mais informações sobre as configurações de fuso horário, consulte o Guia de Configuração de Conjunto de Dados.

Todo(a) Frequência da geração do conjunto de relatórios: dia, semana ou mês.
Tempo limite do vigia do Excel (segundos)

Opcional. O número de segundos que você deseja que o Report Server aguarde até que o Microsoft Excel responda ao gerar um relatório como um arquivo do Excel antes que o Report Server decida que o Excel não está respondendo e encerre o processo. Usar este parâmetro permite que o Servidor de relatórios encerre o Excel quando ele não responde e continue processando seus relatórios não Excel. O padrão é 300.0. Para desativar essa funcionalidade, defina este parâmetro como 0.0.

Certifique-se de que o valor definido seja longo o suficiente para permitir que o relatório seja exportado para o Excel. Caso contrário, o Servidor de relatórios pode encerrar prematuramente o Excel e o seu relatório não será gerado.

Filtrar fórmula

Opcional. Filtro que é aplicado a cada espaço de trabalho no conjunto de relatórios.

Para obter mais informações, consulte a sintaxe para criar filtros .

Correção gama

Configuração de gama para saída de arquivo .png . O padrão é 1.6.

Observação: O Adobe recomenda que você não altere esse valor.

Ocultar logotipos Indica se o Servidor de relatórios oculta os logotipos ao gerar seus relatórios. As opções são true ou false . Se definido como falso , seu relatório é gerado com o logotipo do Relatório. O padrão é false .
Arquivo de pesquisa

Opcional. Quando esse parâmetro é preenchido, o Servidor de relatórios é executado no modo dinâmico e gera relatórios para cada elemento da dimensão especificada no parâmetro Nome do Dimension. Esse arquivo deve conter duas colunas delimitadas por tabulação, sem uma linha de cabeçalho.

  • A coluna 1 contém uma lista de elementos de dimensão.
  • A coluna 2 contém os endereços de email dos recipients do relatório. Um relatório para um determinado elemento na coluna 1 é enviado para o endereço de email na mesma linha da coluna 2. É possível inserir vários endereços de email separando-os por vírgulas (sem espaços). Para que os relatórios não sejam enviados por email, essa coluna pode estar vazia, mas deve existir.

Observação: Se você inserir um valor nesse parâmetro, deverá inserir um valor no parâmetro Nome do Dimension.

Somente notificação Essa configuração do Servidor de relatórios permite configurar o Data Workbench para enviar um email quando um relatório é gerado. Configurar esse valor como true não envia o relatório, mas envia um email notificando o usuário que assinou que o relatório foi gerado.
Relatório de email

Identificador de seção para distribuir relatórios por email. Para distribuir relatórios por email, preencha os seguintes parâmetros para a entrada Relatório de email . Todos os relatórios no conjunto de relatórios são enviados por email em uma mensagem para os endereços de email especificados no parâmetro Recipients .

Observação: O servidor de relatórios envia um email somente quando ele gerou pelo menos um relatório.

Para habilitar o envio de relatórios por email, você deve concluir pelo menos os seguintes parâmetros para essa entrada:

  • Servidor SMTP
  • Destinatários
  • Endereço do remetente
  • Somente notificação

Observação: Para enviar relatórios por email depois de regerar um conjunto de relatórios, consulte Editando arquivos Report.cfg existentes .

O valor Somente notificação está disponível nas versões 5.4x e 5.5x.

Para que um grande conjunto de recipients seja notificado (mais de 20), é altamente recomendável usar listas de distribuição de email.

Modelo XSL do Corpo

Opcional. Caminho do arquivo de modelo XSL a ser aplicado ao arquivo reports.xml . Usar esse parâmetro permite que o Servidor de relatórios envie seus relatórios dentro do email distribuído em vez de enviá-los como anexos. O texto resultante é usado como o corpo da mensagem de email.

Consulte Arquivos de exemplo de relatório para obter um arquivo de amostra.

Para obter informações sobre a Linguagem de folha de estilos extensível (XSLT), consulte A família de linguagem de folha de estilos extensível .

Destinatários Endereços de email das pessoas para as quais você deseja enviar o relatório.
Endereço do remetente Endereço de email do remetente.
Nome do remetente Opcional. Nome do remetente.
Servidor SMTP Endereço da máquina do servidor SMTP e a senha e o nome de usuário necessários para autenticação.
Assunto Opcional. Linha de assunto descrevendo o email a ser enviado.
Somente notificação Permite configurar o Data Workbench para enviar um email quando um relatório em segundo plano é gerado. Configurar esse valor como Verdadeiro não envia o relatório, mas envia um email vinculando o usuário inscrito ao local do relatório.
Raiz de saída

Opcional. Local de saída dos conjuntos de relatórios gerados. O padrão é a pasta <profile name>\Reports no diretório de instalação do Servidor de relatórios.

Para configurar Servidor de relatórios para exportar relatórios para um portal, defina a Raiz de saída para a raiz do documento do servidor Web usado para o portal.

Filtro de Consulta de Pré-carregamento

Opcional. Esse parâmetro se aplica somente ao tipo de relatório Elemento de Dimension superior .

O nome do filtro que você deseja aplicar à query que deve ser executada para determinar os N elementos da dimensão principais antes que o relatório possa ser gerado. O padrão é Broken_Session_Filter . Para obter mais informações sobre o Filtro de Sessão Quebrado , consulte o Guia do Usuário do Data Workbench.

Tipos de relatórios

Formato(s) no qual você deseja gerar a saída. É possível usar qualquer uma ou todas as opções a seguir para exibir o conjunto de relatórios em vários formatos de uma só vez:

  • O Excel cria uma pasta de trabalho do Excel com uma visualização por planilha. Como regra geral, use arquivos Excel para distribuição de email. Consulte Gerando relatórios como arquivos do Excel do Microsoft . Para obter informações sobre como usar um arquivo de modelo, consulte Usando um Arquivo de Modelo .
  • png cria arquivos Portable Network Graphic. Como regra geral, use arquivos .png para exibição em um navegador da Web (portal).
  • A miniatura cria uma miniatura ( arquivo .jpg ) do espaço de trabalho. O tamanho padrão é 240x180. Para alterar o tamanho padrão, edite os parâmetros Miniatura X e Miniatura Y .

Para adicionar um novo tipo de relatório ao editar Report.cfg no Data Workbench, clique com o botão direito do mouse em Tipos de relatório , clique em Adicionar novo filho e selecione o tipo de relatório desejado.

Data inicial

A primeira data e hora em que você deseja que o relatório seja executado. Essa hora é baseada na hora de início do conjunto de dados.

Formato: MM/DD/AAAA fuso horário hh:mm, usando a sintaxe de 24 horas para o tempo.

Para obter mais informações sobre as configurações de fuso horário, consulte o Guia de Configuração de Conjunto de Dados.

Observação: Os relatórios começam a ser executados quando os carimbos de data e hora dos dados no perfil correspondem à data e hora especificadas.

Exemplo:

Se a data de início for 08/08/2006 12:00 EST, os relatórios serão executados para dados com um carimbo de data e hora 08/08/2006 12:00 EST e posterior.

  • Relatórios diários serão executados para 08/08/2006 e, a partir de então, cada dia para dados com hh:mm = 12:00 EST.
  • Relatórios semanais serão executados para 08/08/2006 e para cada 7 dias depois para dados com hh:mm = 12:00 EST.
  • Os relatórios mensais serão executados para 08/08/2006 e para o oitavo dia de cada mês depois para os dados com hh:mm = 12:00 EST.

A métrica Tempo do relatório afeta as dimensões do relatório "Últimos N", como "Últimos 7 dias", "Ontem" e "3 semanas atrás". Para consultas no Servidor de relatórios, a métrica Tempo do relatório ( Tempo do relatório.métrica ) identifica a data e a hora para a qual os relatórios estão sendo executados. Esta é inicialmente a data e a hora especificadas no parâmetro Data inicial , que é incrementado pelo período especificado pelo parâmetro Todas . Para consultas no Data Workbench, a métrica Tempo do Relatório é baseada na meia-noite da métrica de início ( As Of.metric ). Devido à diferença nas definições da métrica Tempo do relatório, se você consultar um espaço de trabalho que usa uma dimensão Último N , poderá receber resultados diferentes no Data Workbench e no Servidor de relatório no mesmo espaço de trabalho.

Miniatura X Opcional. Número inteiro que controla o tamanho (em pixels) do eixo X das miniaturas geradas como saída.
Miniatura Y Opcional. Número inteiro que controla o tamanho (em pixels) do eixo Y das miniaturas geradas como saída.
Métrica N principais

Opcional. Consulte a descrição do parâmetro Valor Superior N.

Observação: Se você inserir um valor nesse parâmetro, deverá inserir um valor no parâmetro Nome do Dimension e no parâmetro Valor Superior N.

Valor N Superior

Opcional. Quando esse parâmetro é preenchido, o Servidor de relatórios é executado no modo dinâmico e gera relatórios para o número superior (especificado neste parâmetro) dos elementos para a dimensão especificada no parâmetro Nome do Dimension, contando pela métrica especificada no parâmetro Métrica Top N.

Exemplo: Se você digitar Página no parâmetro Nome do Dimension, Sessões no parâmetro Métrica dos N principais e 5 nesse parâmetro, o relatório gerado listará as cinco principais páginas com o maior número de sessões.

Observação: Se você inserir um valor nesse parâmetro, deverá inserir um valor no parâmetro Nome do Dimension e no parâmetro Métrica N Superior.

Usar apenas a amostra local Opcional. Indica se você deseja que o Servidor de relatórios gere relatórios utilizando somente a amostra local do conjunto de dados. Configurar esse parâmetro como true permite exibir uma amostra do conjunto de relatórios (sem colocar uma carga em um servidor do Data Workbench) para ver a aparência da saída sem levar todo o tempo necessário para processar os dados por completo. Isso funciona como uma função de teste. As opções são true ou false. O padrão é false.
Caminho do espaço de trabalho

Opcional. Localização de uma coleção de espaços de trabalho para um determinado conjunto de relatórios. Isso é útil para manter uma única cópia dos espaços de trabalho que precisam ser gerados e distribuídos de várias maneiras, usando arquivos Report.cfg para vários conjuntos de relatórios. O diretório raiz desse caminho pode ser qualquer pasta de perfil. Não insira uma barra (\) no início da string do caminho.

Exemplo: Você pode salvar os espaços de trabalho comuns para o Conjunto A e o Conjunto B na pasta Relatórios\Comuns , em seguida, definir os arquivos Report.cfg para dois conjuntos de relatórios diferentes, cada um com configurações de geração e distribuição diferentes. Em ambos os arquivos Report.cfg , você definiria o parâmetro Caminho do espaço de trabalho como nome do perfil\Reports\Common.

Arquivo de saída XSL Opcional. Caminho do arquivo de saída criado quando o Modelo XSL é aplicado ao índice de relatório.
Modelo XSL

Opcional. Caminho do arquivo de modelo XSL a ser aplicado ao índice do relatório. O .xml transformado resultante é gravado no Arquivo de Saída XSL especificado. Consulte Arquivos de exemplo de relatório para obter um arquivo de amostra.

Observação: A menos que você use um template .xsl ao gerar seus relatórios, todos os relatórios são distribuídos por email como anexos.

Nesta página