Parâmetros do Report.cfg

IMPORTANTE

Leia mais sobre Datas Workbench Anúncio do fim da vida útil.

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

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

Se você precisar adicionar mais parâmetros a um 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 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 Servidor de relatórios gera ou gera novamente relatórios específicos quando você cria ou modifica esses relatórios. As opções são true ou false. Se definido como true, a criação ou modificação de um espaço de trabalho de relatório causará Servidor de relatórios para gerar novamente esse relatório para a execução mais recente.

Observação: Alteração do Report.cfg causas do arquivo Servidor de relatórios para gerar novamente todos os relatórios controlados por essa Report.cfg arquivo.

Anexos

Opcional. Identificador de seção para o nome e 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 Report.cfg no Data Workbench.
  2. Clique com o botão direito do mouse Anexos e clique em Adicionar novo filho > Anexo .

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 .png arquivos. 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 do conjunto de dados.

Cada 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 Servidor de relatórios aguardar que o Microsoft Excel responda ao gerar um relatório como um arquivo Excel antes de Servidor de relatórios decide que o Excel não está respondendo e encerra o processo. O uso desse parâmetro habilita Servidor de relatórios para encerrar o Excel quando ficar sem resposta e continuar processando seus relatórios que não são do 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, Servidor de relatórios O pode terminar o Excel prematuramente e o 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 o sintaxe para criação de filtros .

Correção gama

Configuração de gama para .png saída do arquivo. 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 estiver definido como false , 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 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 inscrito 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, complete os seguintes parâmetros da variável Relatório de email entrada. 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 após regerar um conjunto de relatórios, consulte Editar 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 reports.xml arquivo. 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 um arquivo de exemplo.

Para obter informações sobre a Linguagem de folha de estilos extensível (XSLT), consulte A Família Extensible Stylesheet Language .

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 é <profile name="">\Pasta Relatórios no diretório de instalação do Servidor de Relatório.

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

Filtro de Consulta de Pré-carregamento

Opcional. Esse parâmetro se aplica somente à variável Elemento Dimension superior tipo de relatório.

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 Quebrada , 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 Gerar relatórios como arquivos 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 .png arquivos para exibição em um navegador da Web (portal).
  • A miniatura cria uma miniatura ( .jpg arquivo ) 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 Tipos de relatórios , 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 do 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.

O Hora do relatório afeta dimensões de relatório "Últimos N", como "Últimos 7 dias", "Ontem" e "Há 3 semanas". Para consultas no servidor de relatórios, a variável Hora do relatório métrica ( 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, o Hora do relatório é baseada na meia-noite da métrica de início ( Em.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 Últimos N , poderá receber resultados diferentes no Data Workbench e Servidor de relatórios para o 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, Servidor de relatórios é executado no modo dinâmico e gera relatórios para o número superior (especificado neste parâmetro) de elementos para a dimensão especificada no parâmetro Nome do Dimension, contando pela métrica especificada no parâmetro Métrica superior 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 deseja Servidor de relatórios para gerar relatórios usando apenas 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 Report.cfg arquivos 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 Relatórios\Comuns , em seguida, defina a Report.cfg arquivos para dois conjuntos de relatórios diferentes, cada um com configurações de geração e distribuição diferentes. Em ambos Report.cfg para arquivos, você definiria o parâmetro Caminho do espaço de trabalho como nome do perfil\Relatórios\Comum.

Arquivo de saída XSL Opcional. Caminho do arquivo de saída criado quando a variável Modelo XSL é aplicada ao índice do relatório.
Modelo XSL

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

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

Nesta página