Migrazione dei preferiti da tenant QlikView a Qlik Cloud

QlikView Object Migration per Cloud è uno strumento che trasferisce i preferiti server alle app QlikView negli spazi gestiti in un tenant Qlik Cloud.

I preferiti server non sono inclusi quando i documenti QlikView vengono aggiunti a un tenant Qlik Cloud. QlikView può assegnare la proprietà del preferito tra gli utenti Active Directory in QlikView Server e gli utenti nel tenant Qlik Cloud. QlikView Object Migration per Cloud mappa tali utenti pertanto è possibile assegnare loro la proprietà dei preferiti server. Durante la procedura di migrazione, QlikView Object Migration per Cloud contatta il servizio Active Directory dell'utente e ottiene informazioni su ID e indirizzo e-mail per i propri utenti e li collega agli utenti sul tenant Qlik Cloud mediante l'indirizzo e-mail. È anche possibile mappare manualmente gli utenti, in modo che un preferito possa essere posseduto da un utente diverso. I preferiti vengono archiviati in un file QMT e poi trasferiti in un'app nel tenant Qlik Cloud.

Quando si esegue QlikView Object Migration per Cloud, è possibile:

1. Copiare i file condivisi (.TShared o .Shared) con i preferiti in una cartella di lavoro.

2. Caricare nomi dei file e metadati nella cartella di lavoro.

3. Selezionare un file condiviso e selezionare tutti i preferiti o un sottogruppo nel file. Verranno esportati in un nuovo file condiviso.

4. Caricare il file condiviso selezionato in un'app QlikView nel proprio tenant Qlik Cloud.

È possibile trasferire i propri preferiti usando un documento QlikView, CloudMigrationApp, incluso con QlikView Object Migration per Cloud. CloudMigrationApp gestisce gli script, i file e i comandi per trasferire i propri preferiti. È anche possibile trasferire i propri preferiti usando il Prompt dei comandi per eseguire i file QlikView Object Migration per Cloud.

QlikView Object Migration per Cloud è disponibile da Download di prodotti.

Prima di iniziare

Prima di scaricare ed eseguire QlikView Object Migration per Cloud, assicurarsi di rispettare i seguenti requisiti:

• Deve essere installato QlikView Desktop.

• Si sono aggiunti i documenti QlikView a cui si desidera aggiungere i preferiti server condivisi al tenant Qlik Cloud.

• È necessario essere un utente con diritto Diritto Professional.

• Si dispone dell'accesso alla Console di gestione sul proprio tenant Qlik Cloud.

• È necessario generare una chiave API al proprio tenant Qlik Cloud da usare con QlikView Object Migration per Cloud.

• È necessario disporre di una delle seguenti autorizzazioni nello spazio gestito di destinazione:

  • È proprietario
  • Può visualizzare
  • Può contribuire
  • Può gestire

• È necessario disporre di ID app per le app QlikView di destinazione per i preferiti. È possibile ottenere un ID app dalla stringa che segue document= nell'URL dell'app.

  Ad esempio, nell'URL app QlikView https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6, e74ebae5-5659-4211-a4de-add8e49768f6 è l'ID dell'app. Gli ID app possono variare leggermente nel formato in base al fatto di essere stati pubblicati nell'hub cloud o caricati direttamente nell'hub cloud.

• QlikView Object Migration per Cloud richiede il modulo Windows Active Directory. Se non è installato, QlikView Object Migration per Cloud si installa automaticamente.

Download e configurazione di QlikView Object Migration per Cloud

Procedere come segue:

1. Scaricare QlikView Object Migration per Cloud da Download di prodotti.

   Per ulteriori informazioni, vedere Download dei file di installazione (solo in lingua inglese).

2. Navigare in %ProgramData%\QlikTech.

3. Creare una cartella denominata QlikViewMigrationTool e copiare i file QlikView Object Migration per Cloud in tale cartella.

4. In via opzionale, creare una cartella e aggiungere i file condivisi contenenti i preferiti che si desidera trasferire nel proprio tenant.

Trasferimento dei preferiti in un'app QlikView con CloudMigrationApp

Procedere come segue:

1. Navigare nella cartella QlikView Object Migration per Cloud decompressa e aprire il documento CloudMigrationApp in QlikView Desktop.

2. Leggere e accettare i termini e condizioni QlikView Object Migration per Cloud.

3. Fare clic su Impostazioni > Preferenze utente.

4. Nella scheda Salva, selezionare Salva prima del ricaricamento. Ciò impedirà a QlikView di cancellare i dati inseriti dopo il ricaricamento.

5. Nella scheda Sicurezza, selezionare le seguenti impostazioni e fare clic su OK:

   • Script (Consenti istruzioni di scrittura ed esecuzione database)

6. Seguire le indicazioni nel documento QlikView per ciascun foglio:

   1. In 1. Inizializzare , selezionare la cartella in cui si archiviano i file condivisi e la cartella in cui si desidera generare le copie caricate nel tenant.

   2. In 2. Ottieni dati utente, impostare i parametri necessari per abbinare i proprietari del preferito condiviso agli utenti nel tenant Qlik Cloud.

   3. In 3. Visualizza file mappatura utente, esaminare la mappatura.

      In via opzionale, modificare la mappatura nel file OnPremToCloudMap.csv. Per mappare gli utenti QlikView agli utenti Qlik Cloud, aggiungere i valori ID utente e Oggetto IdP per gli utenti dalle voci utente Qlik Cloud Console di gestione a QlikView. Al termine, fare clic su Ricarica nel foglio.

   4. In 4. Panoramica, verificare di aver caricato il file corretto.

   5. In 5. Filtra metadati, utilizzare in modo opzionale i filtri per restringere l'ambito dei preferiti condivisi da trasferire nel tenant.

   6. In 6. Preparare nuovi file condivisi per il cloud, selezionare il file condiviso dall'app di cui si desidera trasferire i preferiti. In via opzionale, selezionare gli ID dei preferiti che si desidera includere. Se non se ne seleziona nessuno, verranno inclusi tutti i preferiti disponibili.

   7. In 7. Carica nel cloud, impostare l'app di destinazione nel tenant e caricare i preferiti.

7. Ripetere i passaggi 5. Filtra metadati, 6. Preparare nuovi file condivisi per Cloud e 7. Carica nel cloud per ciascuna app aggiuntiva in cui si desiderano trasferire i preferiti.

8. Salvare e chiudere CloudMigrationApp.

   CloudMigrationApp mantiene gli input aggiunti all'app al momento del salvataggio.

Trasferimento dei preferiti in un'app QlikView dal Prompt dei comandi

Procedere come segue:

1. Aprire il Prompt dei comandi come amministratore.

2. Navigare nella cartella QlikView Object Migration per Cloud: C:\ProgramData\QlikTech\QlikViewMigrationTool.

3. Inserire il comando seguente per copiare i file condivisi e i metadati nella cartella di output: QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

   Sostituire le variabili: 

   • $(vInputFolder): – Il percorso alla cartella in cui verranno archiviati i file

   • $(vOutputFolder): Il percorso alla cartella in cui si desidera archiviare i file di trasferimento.

4. Inserire il comando seguente per ottenere i dati utente da Active Directory: QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)".

   Sostituire le seguenti variabili:

   • $(vDCServer): L'URL del server del Controller di dominio.

   • $(vADOutputfile): Il percorso file alla cartella per l'archiviazione del proprio elenco di utenti QlikView Server, incluso il nome file e .csv.

5. Inserire il comando seguente per ottenere dati utente dal tenant Qlik Cloud: QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)".

   Sostituire le seguenti variabili:

   • $(vCloudURL): L'URL del proprio tenant Qlik Cloud.

   • $(vApiKey). La chiave API dal proprio tenant Qlik Cloud.

   • $(vUserIdMapLocation): Il percorso file alla cartella per l'archiviazione del proprio elenco di utenti tenant, incluso il nome file e .csv.

6. Creare un nuovo file CSV denominato OnPremToCloudMap.csv con le seguenti colonne:

   • Owner
   • subject
   • id

7. In OnPremToCloudMap.csv, aggiungere valori dalla colonna Owner nel file <app>.qvw.tshared.xlsx, presente nella cartella di output nel punto 3 con i valori corrispondenti oggetto e id dal file .csv creato nel punto 5.

8. Creare un nuovo file CSV e aggiungere un elenco a colonna singola di ID preferiti dal file condiviso che si desidera trasferire nel proprio tenant Qlik Cloud. Gli ID dei preferiti si trovano nel file <app>.qvw.tshared.xlsx, presente nella cartella di output nel punto 3.

9. Nel Prompt dei comandi, creare il file QMT contenente i preferiti che verranno caricati nel tenant inserendo il seguente comando: QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)"

   Sostituire le seguenti variabili:

   • $(OriginalSharedFile): Il percorso completo, incluso il nome file, alla posizione in cui si trova il file condiviso.
   • $(csvFile): Il percorso completo, incluso il nome file, al file CSV contenente gli ID dei preferiti.
   • $(OnPremToCloudMap.csv): Il percorso completo, incluso il nome file, a OnPremToCloudMap.csv.
   • $(Updated): Il percorso alla cartella in cui verrà archiviato il file QMT.
   • $(vApiKey): La chiave API dal proprio tenant Qlik Cloud.

10. Eseguire il seguente comando, sostituendo le variabili: qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)".

    Sostituire le seguenti variabili:

    • $(vCloudURL): L'URL del proprio tenant Qlik Cloud.

    • $(vAppId): L'ID app dell'app in cui si stanno trasferendo i preferiti.

    • $(vApiKey): La chiave API dal proprio tenant Qlik Cloud.

    • $(vSharedFileToUpload): Il percorso completo, incluso il nome file, al file QMT contenente i preferiti.

    • $(vHandledDirectory): Il percorso completo della cartella in cui verrà archiviato il proprio file QMT una volta trasferito al cloud.

    Nota informaticaViene visualizzato un messaggio: "Registro parametri scritto in C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt". Controllare il registro per verificare che la migrazione sia avvenuta con successo.

Limitazioni

QlikView Object Migration per Cloud presenta le seguenti limitazioni:

• QlikView Object Migration per Cloud non supporta il trasferimento di preferiti alle app QlikView negli spazi personali. È possibile trasferire i preferiti alle app QlikView in spazi condivisi, ma non saranno disponibili agli utenti.

• I percorsi UNC non sono supportati per le cartelle di input o output. Le cartelle condivise mappate in unità locali sono supportate.

• Il numero di file XLSX sul foglio 4. La panoramica può risultare diversa rispetto al numero di file effettivi nella cartella. Ciò si verifica perché i file di metadati vuoti non sono visibili nell'app.

• Se si è già migrato i preferiti da un file condiviso, è necessario eliminare i file precedentemente generati dalla directory gestita prima di copiare nuovamente i file da tale file condiviso.

• Se i preferiti sono già stati migrati da un file condiviso, non è possibile migrarli di nuovo, se sono stati condivisi in Qlik Cloud.