Executar, programar e compartilhar relatórios

ccppmop1591
O comportamento do relatório é semelhante às rotinas na interface de usuário do
Classic PPM
. Como ocorre com as rotinas, você pode executar um relatório do Jaspersoft imediatamente ou programá-lo para execução em um momento futuro com opções de recorrência.
Direitos de acesso ao relatório
A segurança dos relatórios tem três níveis. A tabela a seguir descreve cada nível de acesso. O administrador do
Classic PPM
concede a você direitos de acesso a recursos específicos.
Nível de acesso
Descrição
Visualizar relatórios
  • Relatórios - Acessar
    - permite abrir a página Relatórios disponíveis.
  • Relatórios - Visualizar saída - Tudo
    - permite visualizar toda a saída do relatório.
  • Você também precisa direitos de instância sobre um ou mais projetos, investimentos e recursos.
Executar relatórios
Esses direitos de acesso permitem executar relatórios, no entanto, eles não permitem definir os parâmetros que filtram as informações em um relatório.
  • O direito de acesso
    Relatório – Executar
    no nível da instância permite executar um relatório específico e visualizar a saída.
  • O direito de acesso global
    Relatórios - Executar - Tudo
    permite aos usuários executar qualquer relatório.
  • Pelo menos um direito de acesso dos Relatórios avançados.
  • Seja adicionado a um dos grupos de Relatórios avançados do PMO do
    Clarity
    ou a um grupo do
    Clarity
    . A inclusão em grupos trata da atribuição de funções necessária do Jaspersoft.
Definir os parâmetros do relatório
Esses direitos de acesso permitem editar a definição de um relatório específico (no nível da instância) ou todos os relatórios (no nível global). É possível fazer alterações nos parâmetros do relatório para filtrar as informações que serão exibidas em um relatório.
  • Relatórios e rotinas - Criar definição
    - permite definir os parâmetros do relatório ou da rotina.
  • Relatórios e rotinas - Editar definição
    - permite editar os parâmetros do relatório ou da rotina.
Segurança em nível de linha em um relatório
Esse nível de acesso ajuda a garantir que as informações sejam fornecidas se você tiver o direito para visualizá-las. O conteúdo da linha exibido em cada relatório varia de acordo com os seus direitos de acesso aos itens contidos no relatório. Por exemplo, caso execute um relatório que liste as informações de vários projetos, apenas os projetos para os quais você possui direitos são exibidos no relatório.
Um relatório compartilhado pode dar ao destinatário maior visibilidade e acesso aos dados do projeto do que ele normalmente teria. Por exemplo, o usuário A tem acesso a 100 projetos e o usuário B tem acesso a 20. O usuário A compartilha um relatório de 100 projetos com o usuário B. O usuário B pode visualizar todos os 100 projetos.
Antes que você possa executar ou programar relatórios, sua conta de usuário deve ser mapeada para um usuário do Jaspersoft com uma ou mais funções. Como administrador, execute as rotinas
Criar e atualizar os usuários do Jaspersoft
e
Sincronizar funções do Jaspersoft
. Consulte
Referência a rotinas
.
Ativar relatórios
Como administrador, configure o acesso do usuário aos relatórios predefinidos e personalizados que sua organização decidir disponibilizar a outros usuários.
  1. Efetue logon na interface de usuário do
    Classic PPM
    como administrador com esses direitos de acesso:
    • Relatórios e rotinas – Acesso de administrador
    • Relatórios e rotinas - Criar definição
      (para definir os parâmetros do relatório ou da rotina)
    • Relatórios e rotinas - Editar definição
      (para editar os parâmetros do relatório ou da rotina)
  2. Selecione
    Administração
    ,
    Administração de dados
    ,
    Relatórios e rotinas
    .
  3. Defina o campo
    Tipo de executável
    como
    Relatório
    e clique em
    Filtrar
    .
  4. Selecione um ou mais relatórios marcando suas caixas de seleção e clique em
    Ativar
    .
    Os relatórios serão exibidos na página
    Relatórios disponíveis
    para que outros usuários os executem, programem, exibam ou compartilhem.
  5. Para ocultar um relatório de outros usuários, clique em
    Desativar
    ou abra-o e desmarque a caixa de seleção
    Ativo
    .
Adicionar relatórios ao portlet Meus relatórios
Você pode adicionar seus relatórios usados com mais frequência ao portlet Meus relatórios. É possível adicionar relatórios a Meus portlets de duas maneiras:
A partir da lista de relatórios disponíveis
  1. Efetue logon na interface do usuário do
    Classic PPM
    .
  2. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Relatórios e rotinas
    .
  3. Selecione um ou mais relatórios marcando suas caixas de seleção e clique em
    Adicionar a Meus relatórios
    .
  4. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Geral
    .
  5. Seus relatórios favoritos serão exibidos no portlet
    Meus relatórios
    , na página
    Visão geral: Gera
    l.
  6. Para adicionar mais relatórios, clique em
    Mais
    .
  7. Para remover os relatórios do portlet
    Meus relatórios
    , selecione um ou mais relatórios marcando suas caixas de seleção e clique em
    Remover
    .
A partir da página Propriedades de relatório
  1. Efetue logon na interface do usuário do
    Classic PPM
    .
  2. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Relatórios e rotinas
    .
  3. Clique no relatório necessário e navegue até a página Propriedades de relatório.
  4. Na seção Parâmetros, clique em
    Salvar parâmetros
    .
  5. Digite o nome no campo
    Nome dos parâmetros salvos
    e marque a caixa de seleção
    Adicionar a Meus relatórios
    . O nome que você digitar no campo Nome dos parâmetros salvos será exibido como o nome do relatório em Meus Portlets.
  6. Clique em
    Salvar e voltar
    .
Executar ou programar um relatório
A página Relatórios disponíveis lista os relatórios do Jaspersoft Studio aos quais você tem acesso e que pode executar imediatamente ou programar para execução posterior. Nessa visualização, é possível selecionar um relatório e definir os parâmetros.
Se você tiver personalizado a página
Visão geral
para exibir o portlet Meus relatórios, será possível adicionar e executar qualquer relatório disponível a partir desse portlet.
Siga estas etapas:
  1. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Relatórios e rotinas
    .
  2. Especifique os critérios de filtro ou clique em
    Mostrar tudo
    para exibir uma lista de todos os relatórios disponíveis.
  3. Clique em um relatório.
  4. Preencha a seção Geral:
    1. Nome do relatório
      : para uma série de relatórios programados, você pode alterar o nome para diferenciar cada instância de relatório. Por exemplo, se o nome original do relatório for Banco de varejo – Extração de taxas, quando você o programar para execução semanal, será possível renomeá-lo para Banco de varejo - Extração de taxas
      semanal
      . Renomeie os relatórios programados mensalmente para Banco de varejo – Extração de taxas
      mensal
      .
    2. Formato
      : selecione um dos seguintes formatos de arquivo de saída de relatório. Por padrão, PDF é selecionado.
      • PDF
        : Adobe Acrobat PDF
      • PPTX
        : Microsoft PowerPoint
      • XLSX
        : Microsoft Excel
  5. Preencha a seção
    Parâmetros
    . Siga estas etapas:
    1. Os parâmetros variam de acordo com o relatório. Clique em
      Salvar parâmetros
      para salvar o conjunto de parâmetros definido para reutilização. Ao salvar os parâmetros, você também pode adicionar um relatório ao portlet Meus relatórios.
    2. Os parâmetros salvos são exibidos na página
      Relatórios disponíveis
      subordinados ao relatório original.
  6. Preencha a seção
    Quando
    para especificar se deseja o relatório definido como Imediatamente ou Programado.
    1. Para executar um relatório programado e configurá-lo para recorrência, clique no link
      Definir recorrência
      . Também é possível definir a recorrência de um relatório programado usando o comando Crontab.
      Para obter mais informações sobre o formato Crontab e o uso de caracteres especiais, consulte a Documentação do Oracle.
    2. Para usar o crontab, selecione
      Use o formato de inserção UNIX crontab
      e insira o cronograma. Por exemplo, a instrução a seguir indica que o relatório será executado à meia-noite do 1º e do 15º dia de cada mês. 0 0 1,15 * * . É possível usar a opção crontab nos sistemas operacionais Linux e UNIX nos quais o
      Classic PPM
      esteja em execução. Ao usar essa opção, a configuração programada usa a hora do servidor em que o
      Classic PPM
      está sendo executado.
  7. Notificar
    : esta
    seção permite especificar os recursos e grupos a serem notificados quando o relatório for executado com êxito ou falha.
    O destinatário precisa ter as notificações de
    Relatórios e rotinas
    ativadas para receber as notificações. Para ativar as notificações, navegue para
    Página inicial, Pessoal, Configurações da conta, Notificações
    .
    Para saber quem recebe as notificações de falha das rotinas, veja este vídeo:

  8. Compartilhamento
    : esta seção é usada para especificar os recursos e grupos com os quais a saída do relatório precisa ser compartilhada. É possível compartilhar somente os relatórios programados.
    O destinatário da saída do relatório precisa ter o direito
    Relatório - Acessar
    para visualizar a página
    Relatórios e rotinas
    . Quando você compartilha um relatório, o aplicativo concede automaticamente o direito
    Relatório - Visualizar - Saída
    aos usuários e grupos destinatários.
  9. Clique em
    Enviar
    .
    1. O relatório
      imediato
      aparece na sua pasta de download do navegador.
    2. Os relatórios
      Programados
      são exibidos na página
      Relatórios programados
      .
    3. Assim que a execução do relatório estiver concluída, você poderá visualizar a saída do relatório na
      Biblioteca de relatórios
      .
Editar as propriedades dos relatórios programados
As propriedades de execução do relatório incluem informações de programação e notificação e quaisquer parâmetros que possam ser personalizados. A página Relatórios programados lista os horários de execução dos relatórios programados e o status da execução do relatório criado por um usuário ou administrador. Um único relatório pode ter muitas execuções programadas. Todas as execuções de relatórios programadas (exceto os relatórios excluídos) são exibidas na lista, independentemente de seu status.
É possível editar as propriedades das execuções dos relatórios programados que tenham o status
Cancelado
ou
Concluído
por meio da página Propriedades de relatório. Caso contrário, só será possível visualizar as propriedades de execução do relatório.
  • Pausar ou retomar um relatório programado
    : pausar a execução de um relatório programado interrompe temporariamente a execução do relatório. Nesse estado, o relatório não pode ser executado no horário programado, até que a execução do relatório não for retomada. Quando você retoma a execução do relatório, ele é executado no próximo horário de execução programada. É possível pausar relatórios que tenham o status
    Programado
    .
  • Cancelar uma instância do relatório programado
    : o cancelamento de execuções programadas interrompe a execução imediatamente e cancela todas as execuções futuras. A execução cancelada permanece listada na página de relatórios programados com o status
    Cancelado
    . Após cancelar uma execução, não será possível alterar o seu status nem editar qualquer uma das suas propriedades.
  • Excluir uma instância de relatório programado
    : é possível excluir execuções programadas que tenham o status
    Cancelado
    ou
    Concluído
    . A exclusão de uma execução programada não exclui o tipo de relatório nem quaisquer relatórios gerados concluídos listados na
    Biblioteca de relatórios
    .
Um relatório programado pode ter um dos seguintes status:
  • Cancelado: o relatório programado e todas as instâncias recorrentes programadas foram canceladas permanentemente.
  • Concluído: o único relatório programado não recorrente foi concluído e a saída de relatório gerada está disponível.
    As instâncias recorrentes do relatório programado nunca exibem o status
    Concluído
    .
  • Pausado: a próxima instância do relatório programado foi interrompida temporariamente.
  • Em execução/Processamento: a instância do relatório programado está em andamento.
  • Programado: a próxima instância do relatório está na fila. A próxima instância do relatório está programada para ser executada na data e hora definidas.
  • Aguardando: o relatório programado não poderá ser iniciado até que um relatório ou rotina incompatível seja concluído.
  • Falha: a instância do relatório programado falhou. Se um relatório falhar, verifique o status das outras instâncias programadas ou entre em contato com o administrador.
Se um relatório estiver programado para ser executado apenas uma vez, as suas propriedades somente poderão ser editadas antes do horário de execução programado.
Siga estas etapas:
  1. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Relatórios e rotinas
    .
  2. Clique na guia
    Relatórios
    e selecione
    Relatórios programados
    .
  3. Marque a caixa de seleção ao lado de um ou mais relatórios programados e clique em Pausar, Retomar, Cancelar rotina ou Excluir rotina. (A palavra
    rotina
    aparece aqui porque os relatórios programados são tratados como rotinas pelo sistema.)
  4. Clique no link Nome do relatório.
  5. Edite quaisquer outras propriedades do relatório. Para entradas do relatório programado, a
    ID da rotina
    e o
    Status da rotina
    somente leitura são exibidos.
  6. Clique em
    Enviar
    .
Visualizar a saída do relatório gerado
A página
Biblioteca de relatórios
lista todas as saídas do relatório gerado. Se houver recorrência do relatório programado, uma instância do log do relatório será gerada para cada recorrência. Por exemplo, se um relatório programado estiver definido com a recorrência mensal, uma instância desse relatório será criada a cada mês.
Para visualizar os relatórios, é necessário que o Adobe Acrobat Reader esteja instalado.
Para todos os relatórios executados imediatamente, é possível exibir o relatório imediatamente. Também é possível salvar o relatório e visualizá-lo mais tarde na página
Biblioteca de relatórios
.
Siga estas etapas:
  1. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Relatórios e rotinas
    .
  2. Clique na guia
    Relatórios
    e selecione
    Biblioteca de relatórios
    .
  3. Clique no ícone
    Abrir relatório
    ao lado do relatório.
  4. (Opcional) Para visualizar os parâmetros predefinidos, as entradas de log e outras propriedades programadas, clique no link Nome do relatório.
  5. Se tiver acesso, o link abrirá e você poderá visualizar o relatório. Se você não tiver acesso, a seguinte mensagem de erro do sistema de gestão de documentos será exibida: DMS-05100: Você não tem permissão para acessar este documento. Entre em contato com o proprietário do documento para obter acesso ao mesmo. Dependendo da política de segurança de dados, solicite o relatório ao usuário por meio de outro método de compartilhamento. Para solicitar direitos de acesso, entre em contato com o administrador.
Excluir relatórios gerados
É possível excluir a saída do relatório gerado conforme necessário. Também é possível programar a execução da rotina
Remover entradas de Registros de rotina e Biblioteca de relatórios
para remover periodicamente os relatórios desatualizados da Biblioteca de relatórios.
Siga estas etapas:
  1. Selecione
    Página inicial
    ,
    Pessoal
    ,
    Relatórios e rotinas
    .
  2. Abra o menu
    Relatórios
    e clique em
    Biblioteca de relatórios
    .
  3. Marque a caixa de seleção ao lado do relatório e clique em
    Excluir
    .
Rotinas que afetam as informações do relatório
Dependendo de seu relatório, uma variedade de rotinas pode afetar diretamente a qualidade dos dados. Todos os relatórios do Jaspersoft Studio acessados no
Classic PPM
contam com a rotina Carregar data warehouse para obter dados atualizados. Os administradores também devem executar as rotinas Criar e atualizar os usuários do Jaspersoft e Sincronizar funções do Jaspersoft. As rotinas devem ser executadas nesta ordem:
  1. Rotina de carregamento do data warehouse
  2. Rotina de carregamento dos direitos de acesso do data warehouse
  3. Rotina Criar e atualizar os usuários do Jaspersoft
  4. Rotina Sincronizar funções do Jaspersoft
As rotinas comuns a seguir também podem afetar os dados de relatório:
  • Registrar planilhas de horas
  • Executar fatias de tempo
  • Atualizar % concluído
  • Atualizar tendência do data warehouse
  • Atualizar totais de custo e valor agregado
Se essas rotinas falharem, os relatórios podem ser afetados. As informações do relatório podem estar obsoletas ou ausentes. Entre em contato com o administrador para obter mais informações.
Executando ou programando relatórios do Jaspersoft no
Clarity
clássico
Você pode executar, programar, compartilhar, verificar o status e visualizar os relatórios do Jaspersoft Studio dentro do
Clarity
. O menu Página inicial inclui a opção de menu Relatórios e rotinas. A página intuitiva de duas guias resultante fornece um local conveniente para os usuários programarem relatórios e rotinas. Com o acesso pré-configurado de administradores, você pode salvar os seus próprios parâmetros de relatório. É possível visualizar apenas os seus próprios relatórios programados ou os relatórios compartilhados por outros usuários.
Nos Relatórios avançados, alguns controles de entrada parecem ter valores padrão apenas quando eles são os primeiros valores da lista. No
Clarity
, esses mesmos filtros são exibidos corretamente e não parecem ter valores padrão. Os filtros Período e Moeda são alguns exemplos.
Programando relatórios com filtros com base em data
Nos Relatórios avançados, você pode usar o recurso de data relativa do Jaspersoft para programar ou executar relatórios que possuem filtros com base na data, como Data de início, Data de término, etc. É possível filtrar informações em um relatório que se baseia em um intervalo de datas que seja relativo à data atual do sistema. Use os filtros com base em data e insira uma expressão de texto que descreva a data relativa ou a extensão de datas que você deseja exibir. Os filtros com base em data usam a funcionalidade de data relativa do Jaspersoft e as datas regulares.
Para as datas relativas, use o formato
<palavra-chave>
+/-
<número>
em que...
  • <palavra-chave>
    indica a extensão de tempo que você deseja usar. As opções são: DIA, SEMANA, MÊS, TRIMESTRE, SEMESTRE e ANO.
  • + ou - indica se a extensão de tempo ocorre antes ou depois da data que você selecionou.
  • <número>
    indica o número de extensões de tempo que você deseja incluir no filtro.
Exemplos
:
Para incluir dados do mês anterior no relatório, use a seguinte expressão:
MONTH-1
Para incluir dados do próximo mês no relatório, use a seguinte expressão:
MONTH+1
Mais informações:
  • Referência a rotinas
    na documentação.