Trabalhando com tarefas de relatório
Como desenvolvedor de relatórios, você pode criar configurações para a geração centralizada de relatórios com tarefas de relatório. Crie e gerencie tarefas de relatório na guia Tarefas de relatório na seção Relatórios de um aplicativo.
Uma tarefa de relatório converte o modelo de relatório na saída do relatório. A tarefa pode ser executada manualmente ou de acordo com um agendamento.
Uma tarefa de relatório é onde os blocos de construção de relatórios – modelo, filtros e lista de distribuição – se reúnem para gerar a saída. Ao criar uma tarefa de relatório, você também define os nomes dos arquivos do relatório, os usuários e grupos que recebem a saída, os detalhes do e-mail ou da pasta de saída e o agendamento para quando seus relatórios são gerados.
A guia Tarefas de relatório na seção Relatórios de um aplicativo
Com a ajuda de filtros de relatório, você pode usar uma única tarefa de relatório para administrar e empregar um caso de uso de expansão de relatórios. A expansão de relatórios permite gerar relatórios com informações variadas com diferentes subconjuntos de dados para diferentes destinatários. Para obter mais informações, consulte Relatórios intermitentes usando filtros de relatório.
Como funciona a geração de relatórios
Você deve definir uma lista de distribuição para o aplicativo antes de poder criar tarefas de relatório.
Em uma tarefa de relatório, você seleciona os destinatários e grupos da sua lista de distribuição para os quais deseja gerar relatórios. Ao adicionar destinatários como destinatários da saída da tarefa, você adiciona o destinatário como um emparelhamento de filtro de usuário que corresponde a um único filtro de nível de destinatário que foi aplicado a eles na lista de distribuição. Você não pode combinar vários filtros em nível de destinatário no mesmo relatório de usuário, mas pode adicionar cada emparelhamento usuário-filtro individualmente na configuração da tarefa para que um relatório separado seja gerado e enviado ao mesmo usuário para cada filtro.
Quando uma tarefa de relatório é executada, um relatório exclusivo é gerado para cada filtro distinto no nível do destinatário aplicado a todos os usuários adicionados à tarefa de relatório.
Uma tarefa de relatório pode gerar no máximo 100 relatórios exclusivos.
Você pode optar por enviar os relatórios gerados por e-mail, armazená-los em uma pasta do Microsoft SharePoint ou ambos. Ao entregar relatórios por meio de uma pasta de distribuição do Microsoft SharePoint, os relatórios não são enviados diretamente aos destinatários e um relatório separado é armazenado para cada filtro definido nos destinatários incluídos na tarefa. Para mais detalhes, consulte Geração de relatórios com pastas de distribuição.
Requisitos para entrega de e-mail
Para enviar a saída da tarefa de relatório por e-mail, ative a opção E-mail em Distribuir no diálogo ao criar a tarefa de relatório.
Se você estiver enviando os relatórios por e-mail, um servidor SMTP deverá ser configurado para o locatário do Qlik Cloud. Para obter instruções sobre como configurar isso, consulte Configurando e-mail para relatórios e notificações.
Requisitos para armazenar relatórios em pastas do Microsoft SharePoint
Se você precisar salvar automaticamente os relatórios gerados em uma pasta na sua rede do Microsoft SharePoint, ative a opção Pasta em Distribuir no diálogo ao criar a tarefa de relatório.
Para armazenar a saída do relatório em uma pasta do Microsoft SharePoint, uma conexão com o conector do Office 365 Sharepoint deve ser criada no espaço. Para obter mais informações, consulte Entregando relatórios para uma pasta de distribuição.
Criando uma tarefa de relatório
Para criar uma configuração de relatório baseada em tarefas, siga as seções abaixo em ordem.
Parte 1: Crie a tarefa
Faça o seguinte:
Abra a guia Tarefas de relatório na seção Relatórios do aplicativo Qlik Sense.
Clique em Criar tarefa de relatório. O diálogo da tarefa de relatório é aberto.
Insira um Título para sua tarefa de relatório.
Como opção, adicione uma Descrição.
Parte 2: Selecione um modelo
Em seguida, você precisa definir o modelo que foi criado com o suplemento Qlik para o Microsoft Excel.
Faça o seguinte:
Na guia do diálogo Modelo, clique em Adicionar modelo existente. Selecione um modelo que você já carregou.
Como alternativa, clique em Carregar novo se ainda não tiver carregado o modelo que deseja usar.
Clique em Próximo. O diálogo passa para a guia Saída.
Parte 3: Configure a saída
A configuração de saída consiste em:
Definir as propriedades dos relatórios gerados.
Definir a localização dos elementos do relatório (somente para saída PDF). Os usuários que abrirem um relatório do Excel verão a formatação dependente da região (datas, números e outras informações) de acordo com suas configurações do Excel.
Aplicando um filtro de nível de tarefa.
Faça o seguinte:
Na guia de diálogo Saída, digite um Nome de arquivo para a saída do relatório. Este é o nome do arquivo que seus destinatários verão.
Nota informativaSe você adicionar qualquer um dos seguintes elementos de texto ao nome do arquivo, eles serão removidos dos nomes dos arquivos de saída:
\ / < > : " ' ? *
Caracteres de controle ASCII
Espaço em branco no início e no final do nome do arquivo
Selecione um formato de Carimbo de data/hora. Isso é anexado ao Nome do arquivo que você digitou acima.
Se você selecionou a saída PDF, defina as Configurações de formato regional para o PDF. Esta configuração controla a localidade em que datas, números e outras informações são formatadas nos relatórios.
Se você precisar executar outras configurações para preparar para PDF ou imprimir a saída, retorne à criação do modelo. Consulte Preparando para PDF e saída impressa.
Selecione um Filtro para aplicar aos relatórios.
Esse filtro se aplica a toda a tarefa de relatório, diferentemente dos filtros adicionados a destinatários individuais. Para obter mais informações sobre como os filtros no nível da tarefa e no nível do destinatário interagem entre si, consulte Usando filtros em relatórios.
Clique em Avançar para prosseguir para a guia do diálogo Distribuir.
Parte 4: Configurar a distribuição
Agora você deve estar na guia Distribuir no diálogo.
Faça o seguinte:
Adicione os destinatários e grupos da sua lista de distribuição que receberão a saída do relatório. Observe que um destinatário separado deve ser adicionado para cada filtro de nível de destinatário para o qual você deseja gerar relatórios. Consulte Como funciona a geração de relatórios.
Especifique como distribuir e entregar seus relatórios. Ative pelo menos uma das seguintes opções:
Para entregar seus relatórios por e-mail, deixe a opção E-mail ativada. Este é o método de entrega padrão.
Para entregar seus relatórios em uma pasta do Microsoft SharePoint, ative o botão Pasta.
Para obter detalhes sobre como configurar opções de e-mail e pasta de distribuição, consulte Requisitos para entrega de e-mail e Requisitos para armazenar relatórios em pastas do Microsoft SharePoint.
Preencha os campos obrigatórios para saída de E-mail e/ou Pasta conforme necessário.
Clique em Avançar para prosseguir para a guia do diálogo Programar.
Parte 5: Agendar entrega de relatório
Faça o seguinte:
Na guia do diálogo Programação, configure a programação de distribuição de relatórios. Os relatórios podem ser enviados sempre que os dados são atualizados ou em uma programação diária, semanal, mensal ou anual.
Clique em Salvar.
Seu relatório será enviado aos destinatários no horário programado. Você também pode enviar a saída da tarefa de relatório a qualquer momento. Consulte Enviando relatórios manualmente.
Enviando relatórios manualmente
Você pode executar uma tarefa de relatório manualmente quando precisar que os destinatários recebam os relatórios imediatamente.
Isso também é útil quando você testa a configuração do seu relatório.
Faça o seguinte:
Abra a guia Tarefas de relatório na seção Relatórios de um aplicativo.
Clique em
ao lado da tarefa de relatório que você deseja executar.Clique em
Enviar agora.
Requisitos para que uma tarefa de relatório seja executada com êxito
O criador do modelo de relatório cria um modelo com base no acesso ao conteúdo do aplicativo. No entanto, uma tarefa de relatório é executada com base no acesso ao aplicativo do proprietário da tarefa de relatório. Portanto, se um usuário criar um modelo com base em uma pasta de aplicativo que seja particular para ele, a tarefa de relatório não poderá ser executada com êxito.
Também existem requisitos relacionados à propriedade da tarefa de relatório.Para obter mais informações, consulte Propriedade de tarefas de relatório.
Editando tarefas de relatório
Você pode alterar a configuração da tarefa de relatório após sua criação.
Faça o seguinte:
Abra a guia Tarefas de relatório na seção Relatórios de um aplicativo.
Clique em
ao lado da tarefa de relatório.Clique em
Editar.
Excluindo uma tarefa de relatório
Faça o seguinte:
Abra a guia Tarefas de relatório na seção Relatórios de um aplicativo.
Clique em
ao lado da tarefa de relatório que você deseja excluir.Clique em
Excluir.
Os administradores de locatários podem excluir e gerenciar tarefas de relatório na seção Assinaturas do centro de atividades de Administração. Consulte Habilitando e gerenciando relatórios e assinaturas do usuário.
Habilitando ou desabilitando uma tarefa de relatório
Uma tarefa de relatório pode ser habilitada ou desabilitada. Quando habilitada, a tarefa de relatório gera saídas de acordo com a programação configurada e pode ser executada manualmente conforme necessário. Quando desabilitada, a tarefa de relatório não pode gerar saídas na programação, mas ainda pode ser executada manualmente conforme necessário.
É possível habilitar ou desabilitar a tarefa de relatório manualmente. Existem também situações em que uma tarefa de relatório será automaticamente desabilitada.
Faça o seguinte:
Abra a guia Tarefas de relatório na seção Relatórios de um aplicativo.
Clique em
ao lado da tarefa de relatório que você deseja ativar ou desativar.Clique em
Habilitar ou 
Desabilitar.
Se você for um administrador de locatários, poderá ativar e desativar a tarefa de relatório na seção Assinaturas do centro de atividades de Administração. Para obter mais informações, consulte Habilitando e gerenciando relatórios e assinaturas do usuário.
Cancelando uma tarefa de relatório atualmente em execução
Pode haver um momento em que uma tarefa de relatório esteja em execução, mas você precise cancelá-la. Isso pode ocorrer quando há um erro no servidor ou quando a tarefa está demorando muito.
Faça o seguinte:
Abra a guia Tarefas de relatório na seção Relatórios de um aplicativo.
Clique em
ao lado da tarefa de relatório que você deseja cancelar.Clique em
Cancelar.
Considerações sobre acesso à seção
Se o aplicativo usar acesso à seção, a geração de relatórios funcionará de maneira diferente. Para obter mais informações, consulte Relatórios no aplicativo e acesso à seção.
Propriedade de tarefas de relatório
Ao criar uma tarefa de relatório, você se torna seu proprietário. Os administradores podem alterar o proprietário de uma tarefa de relatório. Para obter mais informações, consulte Habilitando e gerenciando relatórios e assinaturas do usuário. Em um espaço compartilhado, para transferir a propriedade de uma tarefa de relatório para outro usuário, esse usuário precisa ter as permissões Pode editar no espaço.
Qualquer pessoa com acesso Pode editar ao espaço pode executar uma tarefa de relatório, mas se o proprietário da tarefa de relatório não tiver acesso Pode editar ao espaço, a tarefa de relatório não poderá ser executada com êxito. Portanto, se o usuário que possui uma tarefa de relatório perder o acesso Pode editar ou for removido do espaço ou do locatário, a propriedade da tarefa de relatório precisará ser alterada ou a tarefa de relatório deverá ser recriada por alguém com permissões suficientes.
Tenha em mente que se você alterar o proprietário de uma tarefa de relatório para um aplicativo que usa acesso à seção, determinados comportamentos poderão ser esperados. Para obter mais informações, consulte Relatórios no aplicativo e acesso à seção.
Filtros de relatório e propriedade de tarefa de relatório
Os filtros de relatório também possuem proprietários correspondentes. O criador de um filtro de relatório é seu primeiro proprietário. A alteração do proprietário de uma tarefa de relatório não altera o proprietário de nenhum filtro de relatório usado pela tarefa de relatório.
Permissões para tarefas de relatório
O gerenciamento das tarefas de relatórios de um aplicativo requer funções específicas. Os requisitos de permissões variam dependendo do tipo de espaço em que seu aplicativo está localizado.
Requisitos para aplicativos em espaços compartilhados
Você precisa do acesso Pode editar ao espaço para executar as seguintes ações em uma tarefa de relatório no aplicativo:
Exibir
Criar
Executar
Excluir
Habilitar
Desabilitar
Para obter mais informações, consulte Gerenciando permissões em espaços compartilhados.
Requisitos para aplicativos em espaços gerenciados
Os usuários com as funções de espaço Proprietário (direito de Professional, Full User ou Analyzer), Pode gerenciar (direito de Professional, Full User ou Analyzer) ou Pode operar (Direito de usuário Professional ou Full User somente) no espaço gerenciado podem executar as seguintes ações em uma tarefa de relatório de dentro do aplicativo:
Exibir
Criar
Executar
Excluir
Habilitar
Desabilitar
Para obter mais informações, consulte Gerenciando permissões em espaços gerenciados.
Requisitos para um aplicativo em seu espaço pessoal
Você deve ter a função de usuário Private Analytics Content Creator no locatário para visualizar, criar, editar e excluir tarefas de relatório.
Administrando tarefas de relatório no centro de atividades de Administração
Como administrador, você gerencia tarefas de relatório na seção Assinaturas do centro de atividades de Administração.Consulte Habilitando e gerenciando relatórios e assinaturas do usuário.