Introdução ao uso do suplemento Qlik para o Microsoft Excel
Este tópico ajuda você a se familiarizar com algumas informações básicas sobre o suplemento Qlik para o Microsoft Excel, como ativá-lo, abri-lo e conectar-se ao conteúdo do Qlik Sense. Para obter informações sobre como adicionar conteúdo ao seu modelo, consulte Usando o suplemento Qlik para o Microsoft Excel e os tópicos relacionados.
O suplemento deve ser instalado antes de você começar a trabalhar com ele. Para obter informações, consulte Implementando e instalando o suplemento Qlik para o Microsoft Excel.
Requisitos para uso do suplemento
Para usar o suplemento para gerar um modelo de relatório para um aplicativo Qlik Sense em um espaço compartilhado, você deve ter as permissões Pode exibir nesse espaço.
Para usar o suplemento para gerar um modelo de relatório para um aplicativo Qlik Sense em um espaço gerenciado, você deve ter, no mínimo, permissões Tem visualização restrita nesse espaço.
Se você estiver trabalhando com uma versão web do Microsoft Excel para o Microsoft 365, precisará permitir pop-ups nas configurações do seu navegador. No entanto, mantenha o histórico de navegação e os cookies armazenados. Caso contrário, você precisará instalar o suplemento novamente sempre que abrir o Excel.
Ativando o suplemento
Depois que um administrador da Microsoft tiver instalado o suplemento Qlik para sua organização, você poderá ativá-lo e usá-lo se tiver acesso a ele.
Dependendo da sua versão do Microsoft Excel, essas etapas podem ser um pouco diferentes. Consulte a documentação oficial da Microsoft para obter detalhes completos.
Faça o seguinte:
-
Abra a versão para desktop ou Web do Excel.
-
Acesse Iníci > Suplementos > Obter suplementos.
-
Na guia ADMIN MANAGED da caixa de diálogo, selecione o suplemento Qlik.
O ícone do suplemento Qlik é adicionado à barra de opções.
Visualizar, gerenciar e instalar suplementos para programas Microsoft 365
Abrindo o suplemento
Para abrir o suplemento, clique no ícone Qlik na barra da faixa de opções na guia Início.
Conectando-se ao locatário e efetuando login
Ao abrir o suplemento, você será solicitado a se conectar ao Qlik Cloud do Qlik Cloud para o qual o suplemento foi instalado. Lembre-se de que uma única instalação do suplemento configura o suplemento para um locatário específico. Clique em Conectar.
Uma configuração do cliente OAuth é necessária para instalar o suplemento.
Você será solicitado a efetuar login na primeira vez que se conectar ou se a conexão for encerrada no lado do servidor. Ao usar uma versão web do Excel, talvez você precise efetuar login novamente em algum momento posterior, se você não mantiver o histórico de navegação e os cookies armazenados.
Faça o seguinte:
-
Quando solicitado a efetuar login, siga o procedimento de login da sua conta Qlik, usando a configuração do provedor de identidade do seu locatário, conforme aplicável.
-
No diálogo de autorização do aplicativo, autorize o aplicativo com o cliente OAuth clicando em Aprovar. Você só precisa fazer isso após seu primeiro login no locatário.
Selecionando o aplicativo Qlik Sense para o modelo
Após efetuar login, você deve selecionar o espaço do Qlik Sense e o aplicativo que deseja usar como fonte do modelo que está criando. Um modelo de relatório usa um único aplicativo. Você só poderá adicionar objetos de um aplicativo Qlik Sense a cada arquivo de modelo do Excel.
Faça o seguinte:
-
Em Espaço, selecione o espaço do Qlik Cloud Analytics.
-
Em Aplicativo, selecione o aplicativo Qlik Sense no espaço.
-
Clique em Salvar.
Depois que o aplicativo for carregado e seus metadados preenchidos no arquivo, você poderá clicar em para abrir o aplicativo de origem no Qlik Cloud.
Depois que o modelo estiver conectado a um aplicativo de origem, você poderá retornar à guia no suplemento para alterar o aplicativo. Para obter mais informações, consulte Alterando o aplicativo Qlik Sense conectado.
Disponibilidade de pastas no aplicativo
Ao fazer login no suplemento do Qlik para o Microsoft Excel, você verá apenas o conteúdo ao qual tem acesso no aplicativo Qlik Sense de origem. Por exemplo, para um aplicativo em seu espaço pessoal, você pode acessar todo o conteúdo. Para um aplicativo em um espaço compartilhado, você só pode ver e usar conteúdo público no aplicativo ou privado para você. O conteúdo da pasta privada de outro usuário em um aplicativo de espaço compartilhado não pode ser visto ou usado.
Visualizando o relatório
Ao desenvolver um modelo, você provavelmente precisará verificar se a saída criada é a que você deseja. Visualize o relatório para ver como ficará sem configurar tarefas de relatório e enviá-las por e-mail para você mesmo.
Para visualizar seu relatório, clique no ícone na barra de ferramentas superior direita do suplemento. Você tem as seguintes opções:
-
Visualizar como Excel (.xlsx)
-
Visualizar como PDF
Ao abrir uma visualização de relatório em formato PDF, o relatório usa o idioma atual das suas configurações do Excel para aplicar a formatação regional (para datas, números, etc.).
Dependendo da configuração do seu navegador, seu relatório aparecerá em uma janela do navegador ou será baixado para o seu computador. Se você não vir um relatório, verifique se permitiu pop-ups em seu navegador.
Abra o arquivo gerado para verificar os resultados.
Preparando para PDF e saída impressa
Se o seu relatório for gerado em formato PDF ou impresso, talvez seja necessário ajustar as configurações de impressão no seu modelo. Use os recursos nativos do Microsoft Excel para preparar o modelo. Essas configurações provavelmente serão encontradas em Layout de Página.
Algumas dessas configurações de configuração de página podem incluir:
-
Tamanho do papel
-
Orientação da página
-
Área de impressão selecionada
-
Quebras de página
A experiência de navegação para configurar a área de impressão e a configuração da página dependerá da sua versão do Excel, do sistema operacional e, possivelmente, do seu navegador da web. Para obter detalhes sobre esses recursos do Excel, consulte a documentação do Microsoft Excel para seu ambiente específico.
Mais tarde, ao configurar a saída do relatório, você pode definir o local para formatação dependente da região nos relatórios. Isso inclui formatação de datas, números e outras informações. Onde você configura essa configuração dependerá do seu caso de uso:
-
Relatórios baseados em tarefas: Configurações de formato regional ao configurar uma tarefa de relatório.
-
Geração de relatórios sob demanda: configuração de Idioma preferido nas Configurações do perfil.
-
Ao abrir uma visualização de relatório em formato PDF, o relatório usa o idioma atual das suas configurações do Excel para aplicar a formatação regional (para datas, números, etc.).
Abrindo o objeto de origem no Qlik Sense
Se quiser ver o objeto de origem no Qlik Sense, selecione o item na pasta de trabalho do Excel. Em seguida, em Aplicativo de origem no suplemento, clique em .
Se o objeto de origem for um gráfico, você será levado ao aplicativo Qlik Sense para visualizar a pasta correspondente. Talvez seja necessário efetuar login no Qlik Cloud novamente para que o aplicativo seja aberto.
Salvando seu trabalho
Salve a pasta de trabalho do Excel normalmente. Você pode reabrir o arquivo .xlsx normalmente, e verá seu modelo.
Encontrando a versão do suplemento e o endereço do servidor conectado
Você pode encontrar a versão do suplemento e o endereço do Qlik Cloud do Qlik Cloud(servidor).
Faça o seguinte:
-
Na janela do suplemento, clique na guia na barra de ferramentas.
-
Ao lado de Aplicativo de origem, clique em .
-
Clique em Sobre.
-
Exiba a URL do locatário e a versão do suplemento do Office, bem como o espaço e o nome do aplicativo Qlik Sense.
Sincronizando o suplemento com o locatário do Qlik Cloud
Se houver alterações no locatário do Qlik Cloud conectado, o documento do Excel que usa o suplemento não será atualizado automaticamente. Por exemplo, talvez seja necessário atualizar:
-
A lista de espaços disponíveis com os quais você pode trabalhar.
-
A lista de aplicativos disponíveis com os quais você pode trabalhar.
-
A lista de entidades disponíveis no aplicativo Qlik Sense selecionado.
-
As imagens do gráfico que você usou no modelo. Por exemplo, se você fez seleções no aplicativo Qlik Sense de origem, talvez queira que as imagens do seu gráfico reflitam as seleções nos espaços reservados de imagem.
-
O status das imagens e tabelas que você usou no modelo (por exemplo, porque foram excluídas ou seus títulos foram alterados).
Siga as etapas abaixo para atualizar os metadados da conexão.
Faça o seguinte:
-
Na janela do suplemento, clique na guia na barra de ferramentas.
-
Ao lado de Aplicativo de origem, clique em .
-
Clique em Atualizar todas as imagens.
Isso aplica uma atualização global. Você também pode realizar atualizações de algumas entidades e objetos individuais nas outras guias do suplemento. O ícone está presente quando estes estão disponíveis.
Os dados e objetos em um modelo não serão atualizados quando o aplicativo Qlik Sense for editado, a menos que uma atualização seja aplicada.
Compartilhando arquivos de modelo de relatório do Excel
Os arquivos de modelo contêm apenas tags de tabela e imagens de visualização. Se outro usuário quiser editar e visualizar o modelo, ele deverá ter:
-
O suplemento Qlik instalado em sua versão do Microsoft Excel.
-
Acesso ao locatário do Qlik Cloud.
-
Se o aplicativo estiver em um espaço compartilhado: Pode visualizar ou aumentar a função do espaço no espaço ou no aplicativo (para que eles possam se conectar ao aplicativo no suplemento e acessar seus dados).
-
Se o aplicativo estiver em um espaço gerenciado: Tem visualização restrita ou aumentar a função do espaço no espaço ou no aplicativo (para que eles possam se conectar ao aplicativo no suplemento e acessar seus dados).
No entanto, um modelo de relatório é uma pasta de trabalho do Excel normal que contém os dados disponíveis quando a visualização foi criada. Você pode compartilhar o arquivo de modelo com qualquer pessoa, mas somente usuários com acesso ao aplicativo de origem poderão conectar-se a ele no suplemento e aplicar atualizações. Para obter mais informações sobre atualizações globais, consulte Sincronizando o suplemento com o locatário do Qlik Cloud.
Alterando o aplicativo Qlik Sense conectado
Um modelo de relatório do Excel pode gerar relatórios a partir de um único aplicativo Qlik Sense. Você pode alterar o aplicativo Qlik Sense conectado antes ou depois de adicionar conteúdo ao modelo.
Para modelos com conteúdo já adicionado, o novo aplicativo deve conter os mesmos IDs de objeto que o aplicativo ao qual o modelo está conectado no momento. Este fluxo de trabalho destina-se a aplicativos duplicados, movidos entre espaços ou locatários ou publicados em um espaço gerenciado.
Antes de alterar a conexão do modelo, é recomendável criar uma cópia de backup do modelo.
Conectando-se a um aplicativo diferente no locatário
Faça o seguinte:
Na janela do suplemento, clique na guia na barra de ferramentas.
Ao lado de Aplicativo de origem, clique em .
Clique em Editar aplicativo de origem.
Selecione o Espaço e Aplicativo e clique em Salvar.
Alterando o locatário e o aplicativo
Na janela do suplemento, clique na guia na barra de ferramentas.
Ao lado de Aplicativo de origem, clique em .
Clique em Editar aplicativo de origem.
O locatário atual do Qlik Cloud é mostrado. Clique em Alterar locatário.
Insira os novos IDs de locatário do Qlik Cloud e aplicativo Qlik Sense.
Nota de dicaVocê pode copiar e colar o ID do aplicativo diretamente da URL quando o aplicativo estiver aberto.Clique em Salvar.
Feche o suplemento ou atualize a página.
Se você alterar o locatário, o arquivo de manifesto do novo locatário deverá ser instalado para poder editar o modelo.
Alterando o aplicativo conectado no Qlik Sense
Como alternativa, é possível alterar o aplicativo conectado dentro da seção Relatórios no novo aplicativo Qlik Sense. Isso é útil quando você tiver criado uma nova cópia do aplicativo Qlik Sense original. Por exemplo, você publicou o aplicativo em um espaço gerenciado ou o duplicou, migrou ou transferiu.
Para obter mais informações, consulte Fazendo upload de um modelo de relatório.
Procurando objetos do Qlik Sense no suplemento
Você pode encontrar um objeto do Qlik Sense específico expandindo e rolando a lista que aparece à direita após clicar no botão adicionar ou pode inserir uma string no formulário de pesquisa. Após pressionar Enter, ele irá procurar a string nos seguintes campos do aplicativo Qlik Sense inserido:
-
ID do objeto
-
Nome do objeto (pastas incluídas)
-
Tipo de gráfico
Para encontrar o objeto correto rapidamente, é importante usar convenções de nomenclatura corretas ao desenvolver aplicativos Qlik Sense.
Acessando mensagens de erro
Existem mensagens de erro nativas no suplemento Excel. Para auxiliar no relatório de erros ao entrar em contato com a Qlik, verifique as mensagens de erro nas ferramentas de desenvolvedor do seu navegador, no console JavaScript e nas guias Rede.
Práticas recomendadas para nomenclatura de objetos de aplicativos
A maneira como você nomeia os objetos no aplicativo Qlik Sense pode afetar a eficácia e a usabilidade dos seus modelos de relatório. Para obter uma lista de práticas recomendadas, consulte Melhores práticas para relatórios no aplicativo.