Implementando e instalando suplementos Qlik para o Microsoft Office

Implemente e instale suplementos Qlik para o Microsoft Office para permitir que os usuários da sua organização criem modelos de relatório. Carregue modelos de relatório criados com os suplementos no aplicativo Qlik Cloud para gerar saída do relatório a partir de tarefas de relatório .

Suplementos Qlik para o Microsoft Office podem ser implementados e instalados para versões compatíveis da Web e desktop do Excel, do PowerPoint e do Word no Microsoft 365.

Os suplementos são instalados usando um arquivo de manifesto. Esse arquivo de manifesto é necessário para que o administrador do Microsoft 365 (ou possivelmente um usuário, em determinados métodos de instalação) implemente e instale o suplemento para si mesmo ou para usuários em sua organização. Um arquivo de manifesto permite a instalação do suplemento para um único locatário do Qlik Cloud.

Depois de obter o arquivo manifesto ou URL, há dois métodos diferentes para implementar e instalar suplementos:

• Implementação centralizada: Implementação, instalação e ativação centralizadas

• Carregamento lateral: Instalando os suplementos usando sideload ou compartilhamento de rede

Para obter mais informações, consulte Projetando modelos de relatório com suplementos Qlik para o Microsoft Office.

Requisitos de sistema e software

Nota governamental do Qlik Cloud

Os suplementos Qlik para o Microsoft Office são compatíveis para desenvolver modelos de relatório para aplicativos em locatários do Qlik Cloud Government ou do Qlik Cloud Government - DoD. Os suplementos estão disponíveis somente para o Office 365 Commercial.

Para instalar e usar suplementos Qlik, você deve atender aos seguintes requisitos.

Suplemento Qlik para o Microsoft Excel

Para instalações do Windows:

• Windows 10 v.1903 ou superior

• Microsoft 365 v.16.0.11629 ou superior

Para instalações do macOS:

• macOS v.14 ou superior

• Microsoft 365 v.16.83 ou superior

Além disso, para executar o suplemento Qlik para o Microsoft Excel, você deve ter uma instalação do Microsoft Excel com o ExcelAPI 1.9 ou mais recente. Para verificar se sua instalação do Excel é compatível, consulte a documentação oficial da Microsoft em Conjuntos de requisitos da API JavaScript do Excel.

Se a sua API do Excel for inferior à versão mínima exigida, será exibido um erro indicando que o suplemento Qlik requer uma versão mais recente do Microsoft Excel.

Pode ser necessário clicar na área branca à direita no Microsoft Excel e pressionar F5 para atualizar a página e ver o erro.

Se você vir esse erro, atualize sua instalação do Microsoft Excel.

Suplemento Qlik para o Microsoft PowerPoint

Para instalações do Windows:

• Windows 10 v.1903 ou superior

• Microsoft 365 versão 2504 (build 18730.20030) ou mais recente

Para instalações do macOS:

• macOS v.14 ou superior

• Microsoft 365 v.16.96 ou superior

Suplemento Qlik para o Microsoft Word

Para instalações do Windows:

• Windows 10 v.1903 ou superior

• Microsoft 365 versão 2208 (compilação 15601.20148) ou superior

Para instalações do macOS:

• macOS v.14 ou superior

• Microsoft 365 v.16.64 ou superior

Preparando e obtendo o manifesto do suplemento

Os suplementos Qlik para o Microsoft Office são instalados no ambiente Microsoft usando um arquivo de manifesto. Este é um arquivo XML . Para uma implementação centralizada, provavelmente será necessário fornecer uma URL para o arquivo de manifesto pelo administrador da Microsoft.

Um arquivo de manifesto é específico a um único locatário do Qlik Cloud. Você usa o mesmo arquivo de manifesto para instalar os suplementos para o Excel, o PowerPoint e o Word.

Uma configuração do cliente OAuth é necessária para instalar o suplemento. Depois de configurar o cliente OAuth, obtenha o link do arquivo de manifesto, bem como o arquivo de manifesto em si, no centro de atividades de Administração.

Faça o seguinte:

1. Crie o cliente OAuth no locatário do Qlik Cloud usando a configuração necessária. Para obter instruções completas, consulte Criando clientes OAuth para suplementos Qlik para o Microsoft Office.

2. Navegue até o centro de atividades de Administração e gere o link do manifesto. Você também pode baixar o arquivo de manifesto diretamente para casos de uso alternativos. Consulte Gerenciando manifestos de instalação para suplementos Qlik para o Microsoft Office.

Criando clientes OAuth para suplementos Qlik para o Microsoft Office

Uma configuração do cliente OAuth é necessária para instalar os suplementos Qlik para o Microsoft Office. Suplementos são usados por desenvolvedores de relatório para preparar modelos de relatório para relatórios no aplicativo com o Qlik Cloud.

Para que o OAuth funcione nos suplementos, o cliente OAuth precisa ser definido com a configuração exata mostrada abaixo.

Faça o seguinte:

1. No centro de atividades de Administração, em Qlik Cloud, acesse OAuth.

2. Clique em Criar novo.

3. No menu suspenso Tipo de cliente, selecione Aplicativo de página única. Mais campos aparecerão.

4. Insira um Nome. A Descrição é opcional.

5. No mínimo, marque a caixa de seleção para incluir o escopo user_default. Você pode incluir outros escopos na configuração, mas sem o user_default, a instalação não funcionará.

   Consulte Escopos do OAuth disponíveis para obter uma descrição completa de cada escopo disponível.

6. No campo Adicionar URLs de redirecionamento, insira a URL do seu locatário do Qlik Cloud, seguida da string fixa: /office-add-ins/oAuthLoginSuccess.html

   O resultado deve ficar assim: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Por exemplo: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Clique em Adicionar.

8. No campo Adicionar origens permitidas, insira o URL do seu locatário e clique em Adicionar.

9. Clique em Criar.

10. A janela Copiar sua ID de cliente é exibida. Você pode optar por copiar o ID do cliente para a área de transferência ou clicar em Concluído para fechar a janela.

Depois de criar o cliente OAuth, obtenha o link XML do manifesto atualizado no centro de atividades de Administração. Acesse a página Configurações e selecione a guia E-mail e relatórios. Na seção Compartilhamento e relatórios, selecione Suplementos Qlik para o Microsoft Office. Use o link fornecido para implementar e instalar o suplemento.

Implementação, instalação e ativação centralizadas

Recomenda-se que os suplementos Qlik para o Microsoft Office sejam disponibilizados com implementação e instalação centralizadas. A implementação centralizada requer a ação de um administrador do Microsoft 365 na sua organização.

Com a implementação centralizada, o manifesto do suplemento é carregado no centro de administração do Microsoft 365 da sua organização e distribuído aos usuários como uma instalação pré-configurada. A distribuição pode ser restrita a membros de grupos de segurança específicos.

Você deve usar a implementação centralizada quando:

• Você deseja que o suplemento seja instalado permanentemente para os membros da sua organização

• Você deseja gerenciar a distribuição aos membros da sua organização

Siga as seções de procedimento abaixo para o fluxo de trabalho completo.

Implementação e instalação centralizadas

A implementação centralizada é concluída por um administrador de sistema Microsoft 365.

Faça o seguinte:

1. Obtenha o arquivo de manifesto do suplemento ou a URL do manifesto após criar um cliente OAuth. Consulte Preparando e obtendo o manifesto do suplemento.

2. Distribua o suplemento de acordo com a documentação oficial da Microsoft: Implemente e publique suplementos do Office. Observe que a distribuição por meio de implementação centralizada só é possível usando o centro de administração do Microsoft 365.

Com o procedimento acima, os suplementos são instalados para usuários que têm acesso a eles. Os usuários então ativam os suplementos em sua versão do Excel, do PowerPoint ou do Word.

Para instalar os suplementos em uma versão para desktop do Excel, do PowerPoint ou do Word sem uma implementação centralizada, você pode configurar um compartilhamento de rede e carregar o manifesto nele. Isso só pode ser feito em um sistema operacional Windows.

Ativando um suplemento após uma implementação centralizada

Depois que um administrador da Microsoft tiver instalado um suplemento Qlik para sua organização, você poderá ativá-lo e usá-lo se tiver acesso a ele.

Dependendo da versão do seu aplicativo Microsoft Office, essas etapas podem ser um pouco diferentes. Consulte a documentação oficial da Microsoft para obter detalhes completos.

Faça o seguinte:

1. Abra uma versão para desktop ou Web do Excel, PowerPoint ou Word.

2. Acesse Iníci > Suplementos > Obter suplementos.

3. 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 Excel, PowerPoint e Word

Removendo um suplemento

Se a sua instalação usar uma implementação centralizada, talvez você não consiga desinstalar o suplemento. Isso depende da política usada pelo administrador do Microsoft 365.

Instalando os suplementos usando sideload ou compartilhamento de rede

O sideload e a instalação de compartilhamento de rede são maneiras adequadas de obter acesso rápido aos suplementos para fins de teste ou avaliação. Eles não são métodos adequados para implementar os suplementos para casos de uso de produção e em escala empresarial.

Dependendo da sua versão do Excel, PowerPoint ou Word e de outros fatores, os suplementos carregados com esses métodos podem finalmente ser removidos da barra de opções. Quando isso acontecer, faça upload novamente do manifesto para o aplicativo Microsoft Office.

Opção 2: Instale um suplemento em aplicativos para desktop do Microsoft Office usando um compartilhamento de rede do Windows

Para instalar os suplementos em uma versão para desktop do Excel, do PowerPoint ou do Word sem uma implementação centralizada, você pode configurar um compartilhamento de rede e carregar o manifesto nele. Isso só pode ser feito em um sistema operacional Windows.

Siga as diretrizes abaixo para fazer o sideload dos suplementos por meio do compartilhamento de rede. As instruções foram adaptadas da documentação oficial da Microsoft. Consulte Fazer o sideload de suplementos Office para testar a partir de um compartilhamento de rede ou outros recursos da Microsoft para obter mais informações.

Etapa 1: criar e compartilhar uma pasta

Faça o seguinte:

1. Crie uma pasta para hospedar o suplemento Qlik. Por exemplo: C:\Qlik Office add-ins

2. No Explorador de Arquivos do Windows, vá para a pasta pai, ou letra de unidade, da pasta que deseja usar como catálogo de pastas compartilhadas. Por exemplo: C:\

3. Clique com o botão direito na pasta e selecione Propriedades.

4. Abra a guia Compartilhamento e clique no botão Compartilhar....

   

5. Na janela de diálogo, adicione você mesmo e outros usuários e/ou grupos com quem deseja compartilhar seu suplemento. Você precisará de pelo menos permissão de leitura/gravação na pasta. Depois de escolher as pessoas com quem compartilhar, clique em Compartilhar.

6. Ao ver a confirmação de que sua pasta foi compartilhada, anote o caminho completo da rede que é exibido imediatamente após o nome da pasta. Clique em Concluído para fechar a janela do diálogo.

   

7. Clique em Fechar para fechar a janela do diálogo Propriedades.

Etapa 2: configure manualmente a pasta compartilhada como um catálogo confiável

Faça o seguinte:

1. Abra uma nova pasta de trabalho em branco na versão desktop do Excel, do PowerPoint ou do Word.

2. Clique na guia Arquivo e em Opções no canto inferior esquerdo.

3. Clique em Centro de Confiança e, em seguida, clique no botão Configurações do Centro de Confiança....

   

4. Clique em Catálogos de Suplementos Confiáveis.

   

5. Na caixa URL do Catálogo, insira o caminho de rede completo para a pasta que você compartilhou anteriormente.

6. Clique em Adicionar catálogo.

7. Marque a caixa de seleção Mostrar no Menu do item recém-adicionado e clique em OK para fechar a janela do diálogo Centro de Confiança.

   

8. Clique em OK para fechar a janela do diálogo.

9. Feche e abra novamente o aplicativo para que suas alterações tenham efeito.

Etapa 3: fazer o sideload do suplemento

Faça o seguinte:

1. Adicione o arquivo XML de manifesto do suplemento à pasta compartilhada.

2. No ExcelPowerPoint, ou no Word, clique em Suplementos na guia Início da faixa de opções.

3. Clique em Mais Suplementos.

4. Clique em PASTA COMPARTILHADA na parte superior da caixa de diálogo Suplementos do Office.

5. Selecione Qlik para inserir o suplemento.

6. Você poderá ver uma janela de diálogo que diz algo como o seguinte: O Qlik deseja exibir uma nova janela. Clique em Permitir.

Removendo um suplemento instalado por meio de compartilhamento de rede

Faça o seguinte:

1. Se você tiver o Excel, o PowerPoint ou o Word aberto, feche-o.

2. Exclua o conteúdo desta pasta: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Opção 3: Fazer o sideload de um suplemento em aplicativos para desktop macOS

Para o macOS, os suplementos podem ser instalados em versões para desktop do Microsoft 365 no Excel, PowerPoint ou Word. Para os requisitos de sistema e software, consulte Requisitos de sistema e software.

Siga as diretrizes abaixo. As instruções foram adaptadas da documentação oficial da Microsoft. Para obter instruções completas, consulte a documentação oficial da Microsoft: Fazer o sideload de um add-in no Office no Mac

Faça o seguinte:

1. Abra o aplicativo Finder em seu computador.

2. Digite a seguinte combinação de teclado: Command+Shift+G

   O menu Ir para a pasta é aberto.

3. Insira um dos seguintes caminhos dependendo do aplicativo Microsoft Office:

   • Excel: /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   • PowerPoint: /Users/<username>/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   • Word: /Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

   Pode acontecer que a pasta wef ainda não exista no seu computador. Se sim, crie-o neste local.

4. Na pasta wef, adicione uma cópia do arquivo de manifesto XML.

5. Abra o Excel, o PowerPoint ou o Word. Se já o tiver aberto, será necessário reiniciá-lo.

6. Na barra de fita, navegue até Página inicial > Suplementos.

7. Selecione o suplemento Qlik.

O suplemento Qlik agora deve estar disponível na barra de opções.

Removendo um suplemento transferido de aplicativos macOS para desktop

Para remover o suplemento Qlik, você precisa limpar o cache Office do seu computador. Para obter mais informações, consulte:

• Remover um suplemento transferido por sideload

• Limpar o cache do Office

Solução de problemas

Esta seção fornece dicas para resolver problemas comuns de implementação e instalação.

Para dicas adicionais de solução de problemas, consulte Solução de problemas - relatórios no aplicativo.

Diálogo em branco exibido durante a autenticação após a implementação do suplemento Qlik para o Microsoft Office

Quando um usuário tenta se autenticar em um suplemento de relatório para o Microsoft Excel, Microsoft PowerPoint ou Microsoft Word, a janela de autenticação pode estar em branco. Como alternativa, o usuário pode ver um erro na caixa de diálogo (particularmente, 12006).

Para que um usuário trabalhe com um suplemento Qlik para o Microsoft Office, o fluxo de autenticação requer um redirecionamento entre o seu locatário e o provedor de identidade hospedado em um domínio diferente. Seu provedor de identidade está definindo um Cross-Origin-Opener-Policy com configurações restritivas. Como resultado, a parte de comunicação entre domínios do fluxo de autenticação é bloqueada, impedindo que as informações de login sejam retornadas corretamente ao complemento.

Ação proposta  

A resolução a seguir deve ser realizada por um administrador de rede responsável pela configuração de provedores de identidade.

Faça o seguinte:

• Defina o cabeçalho de resposta do seu IDP para sua caixa de diálogo como:

  Cross-Origin-Opener-Policy: unsafe-none

Para obter mais informações, consulte a documentação oficial da Microsoft: Práticas recomendadas e regras para a API de Diálogo do Office