Migrando marcadores do QlikView para locatários do Qlik Cloud

O QlikView Object Migration for Cloud é uma ferramenta que migra os marcadores de servidor para aplicativos do QlikView em espaços gerenciados de um locatário do Qlik Cloud.

Marcadores de servidor não são incluídos quando documentos do QlikView são adicionados a um locatário do Qlik Cloud. O QlikView pode atribuir a propriedade do marcador entre usuários do Active Directory no QlikView Server e os usuários no locatário do Qlik Cloud. O QlikView Object Migration for Cloud mapeia esses usuários para que você possa atribuir a eles a propriedade dos marcadores de servidor. Durante o processo de migração, o QlikView Object Migration for Cloud entra em contato com o serviço do Active Directory, obtém informações de ID e endereço de e-mail dos seus usuários e os vincula a usuários no locatário do Qlik Cloud de acordo com o endereço de e-mail. Você também pode mapear manualmente os usuários, para que um marcador possa pertencer a um usuário diferente. Os marcadores são armazenados em um arquivo QMT e, em seguida, migrados para um aplicativo no locatário do Qlik Cloud.

Ao executar o QlikView Object Migration for Cloud, você:

1. Copia arquivos compartilhados (.TShared ou .Shared) com os marcadores em uma pasta de trabalho.

2. Carrega nomes de arquivos e metadados na pasta de trabalho.

3. Seleciona um arquivo compartilhado e seleciona todos os marcadores no arquivo ou um subconjunto deles. Esses são exportados para um novo arquivo compartilhado.

4. Faz upload do arquivo compartilhado selecionado em um aplicativo do QlikView no seu locatário do Qlik Cloud.

Você pode migrar seus marcadores usando um documento do QlikView, CloudMigrationApp, incluído com o QlikView Object Migration for Cloud. O documento CloudMigrationApp gerencia os scripts, arquivos e comandos para migrar seus marcadores. Você também pode migrar seus marcadores usando o prompt de comando para executar os arquivos do QlikView Object Migration for Cloud.

QlikView Object Migration for Cloud está disponível desde Downloads de produtos.

Antes de começar

Antes de baixar e executar o QlikView Object Migration for Cloud, certifique-se de atender aos seguintes requisitos:

• Você deve ter o QlikView Desktop instalado.

• Você adicionou os documentos do QlikView aos quais deseja adicionar os marcadores de servidor compartilhados no locatário do Qlik Cloud.

• Você deve ter um usuário com Direito Professional.

• Você tem o acesso ao centro de atividades de Administração para seu locatário do Qlik Cloud.

• Você deve gerar uma chave API no seu locatário do Qlik Cloud para uso com o QlikView Object Migration for Cloud.

• Você deve ter uma das seguintes permissões no espaço gerenciado de destino:

  • É proprietário
  • Pode exibir
  • Pode contribuir
  • Pode gerenciar

• Você deve ter IDs de aplicativo para os aplicativos do QlikView de destino para os marcadores. Um ID de aplicativo pode ser obtido na string depois de document= na URL do aplicativo.

  Por exemplo, na URL de aplicativo do QlikView, https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6, e74ebae5-5659-4211-a4de-add8e49768f6 é o ID do aplicativo. Qlik CloudQlik Cloud

• O QlikView Object Migration for Cloud requer o Módulo do Windows Active Directory. Se este não estiver instalado, o QlikView Object Migration for Cloud o instalará automaticamente.

Fazendo download e configurando o QlikView Object Migration for Cloud

Faça o seguinte:

1. Faça o download do QlikView Object Migration for Cloud no Downloads de produtos.

   Para obter mais informações, consulte Fazendo download de arquivos de instalação (somente em inglês).

2. Navegue até %ProgramData%\QlikTech.

3. Crie uma pasta chamada QlikViewMigrationTool e copie os arquivos do QlikView Object Migration for Cloud para ela.

4. Opcionalmente, crie uma pasta e adicione os arquivos compartilhados contendo os marcadores que você deseja migrar para seu locatário.

Migrando marcadores para um aplicativo do QlikView com CloudMigrationApp

Faça o seguinte:

1. Navegue até a pasta QlikView Object Migration for Cloud descompactada e abra o documento CloudMigrationApp no QlikView Desktop.

2. Leia e concorde com os termos e condições do QlikView Object Migration for Cloud.

3. Clique em Configurações > Preferências do usuário.

4. Na guia Salvar, selecione Salvar antes de carregar. Isso impedirá que o QlikView limpe os dados de entrada após o carregamento.

5. Na guia Segurança, selecione as seguintes configurações e clique em OK:

   • Script (Permitir Comandos de Gravação e Execução na Banco de Dados)

6. Siga as instruções no documento do QlikView para cada pasta:

   1. Em 1. Inicializar, selecione a pasta onde você armazenou os arquivos compartilhados e a pasta para a qual deseja enviar as cópias carregadas no locatário.

   2. Em 2. Obter dados do usuário, defina os parâmetros necessários para corresponder os proprietários do marcador compartilhado com os usuários no locatário do Qlik Cloud.

   3. Em 3. Visualizar arquivo de mapeamento de usuários, revise o mapeamento.

      Opcionalmente, edite o mapeamento no arquivo OnPremToCloudMap.csv. Para mapear usuários do QlikView para usuários do Qlik Cloud, adicione os valores de ID do usuário e Requerente do IdP dos usuários do Qlik Cloud de Administração do Qlik Cloud para as entradas de usuários do QlikView. Quando terminar, clique em Recarregar na pasta.

   4. Em 4. Visão geral, verifique se você carregou o arquivo correto.

   5. Em 5. Filtrar metadados, opcionalmente, use os filtros para restringir o escopo dos marcadores compartilhados a serem migrados para o locatário.

   6. Em 6. Preparar novos arquivos compartilhados para a nuvem, selecione o arquivo compartilhado do aplicativo cujos marcadores você deseja migrar. Opcionalmente, selecione os IDs dos marcadores que você deseja incluir. Se não selecionar nada, todos os marcadores disponíveis serão incluídos.

   7. Em 7. Fazer upload na nuvem, defina o aplicativo de destino no locatário e carregue os marcadores.

7. Repita as etapas 5. Filtrar metadados, 6. Preparar novos arquivos compartilhados para a nuvem e 7. Fazer upload na nuvem para cada aplicativo adicional para o qual você deseja migrar marcadores.

8. Salve e feche CloudMigrationApp.

   CloudMigrationApp mantém as entradas que você adicionou ao aplicativo ao salvá-lo.

Migrando marcadores para um aplicativo do QlikView pelo Prompt de Comando

Faça o seguinte:

1. Abra o Prompt de Comando como administrador.

2. Navegue até a pasta QlikView Object Migration for Cloud: C:\ProgramData\QlikTech\QlikViewMigrationTool.

3. Digite o seguinte comando para copiar os arquivos compartilhados e os metadados para a pasta de saída: QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

   Substitua as variáveis: 

   • $(vInputFolder): O caminho para a pasta em que os arquivos compartilhados estão armazenados.

   • $(vOutputFolder): o caminho do arquivo para a pasta na qual você deseja armazenar os arquivos de migração.

4. Insira o seguinte comando para obter os dados do usuário do Active Directory: QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)".

   Substitua as seguintes variáveis:

   • $(vDCServer): a URL do servidor do controlador de domínio.

   • $(vADOutputfile): o caminho de arquivo para a pasta na qual armazenar sua lista de usuários do QlikView Server, incluindo o nome do arquivo e .csv.

5. Digite o seguinte comando para obter os dados de usuário do locatário do Qlik Cloud: QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)".

   Substitua as seguintes variáveis:

   • $(vCloudURL): a URL do seu locatário do Qlik Cloud.

   • $(vApiKey). A chave de API do seu locatário do Qlik Cloud.

   • $(vUserIdMapLocation): o caminho de arquivo para a pasta na qual armazenar sua lista de usuários do locatário, incluindo o nome do arquivo e .csv.

6. Crie um novo arquivo CSV denominado OnPremToCloudMap.csv com as seguintes colunas:

   • Owner
   • subject
   • id

7. Em OnPremToCloudMap.csv, adicione valores da coluna Owner no arquivo <app>.qvw.tshared.xlsx, presente na pasta de saída na etapa 3 com os valores de subject e id correspondentes do .csv criado na etapa 5.

8. Crie um novo arquivo CSV e adicione uma única lista de colunas dos IDs de marcadores do arquivo compartilhado que você deseja migrar para seu locatário do Qlik Cloud. Você encontra os IDs de favoritos no arquivo <app>.qvw.tshared.xlsx, presente na pasta de saída na etapa 3.

9. No Prompt de Comando, crie o arquivo QMT contendo os marcadores que serão carregados no locatário, inserindo o seguinte comando: QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)".

   Substitua as seguintes variáveis:

   • $(OriginalSharedFile): o caminho completo, incluindo o nome do arquivo, de onde o arquivo compartilhado está localizado.
   • $(csvFile): o caminho completo, incluindo o nome do arquivo, do arquivoCSV contendo os IDs dos marcadores.
   • $(OnPremToCloudMap.csv): o caminho completo, incluindo o nome do arquivo, para OnPremToCloudMap.csv.
   • $(Updated): o caminho para a pasta na qual o arquivo QMT será armazenado..
   • $(vApiKey): a chave de API do seu locatário do Qlik Cloud.

10. Execute o seguinte comando, substituindo as variáveis: qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)".

    Substitua as seguintes variáveis:

    • $(vCloudURL): a URL do seu locatário do Qlik Cloud.

    • $(vAppId): o ID do aplicativo para o qual você está migrando marcadores.

    • $(vApiKey): a chave de API do seu locatário do Qlik Cloud.

    • $(vSharedFileToUpload): o caminho completo, incluindo o nome do arquivo, para o arquivo QMT que contém os marcadores..

    • $(vHandledDirectory): o caminho completo da pasta em que seu arquivo QMT será armazenado depois de migrado para a nuvem.

    Nota informativaÉ exibida uma mensagem: “Log de parâmetros gravado em C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt". Verifique o log para garantir que a migração foi bem-sucedida.

Limitações

O QlikView Object Migration for Cloud tem as seguintes limitações:

• O QlikView Object Migration for Cloud não oferece suporte à migração de marcadores para aplicativos do QlikView em espaços pessoais. Você pode migrar marcadores para aplicativos do QlikView em espaços compartilhados, mas eles não estão disponíveis para os usuários.

• Caminhos UNC não têm suporte para as pastas de entrada ou saída. Há suporte para pastas compartilhadas mapeadas para unidades locais.

• O número de arquivos XLSX na pasta 4. Visão geral pode ser diferente em comparação com o número de arquivos reais na pasta. Isso ocorre porque arquivos de metadados vazios não são visíveis no aplicativo.

• Se você já tiver migrado os marcadores de um arquivo compartilhado, deverá excluir os arquivos gerados anteriormente do diretório manipulado antes de copiar os arquivos desse arquivo compartilhado novamente.

• Se você já migrou favoritos de um arquivo compartilhado, não poderá migrá-los novamente se eles tiverem sido compartilhados no Qlik Cloud.