Migracja zakładek z QlikView do dzierżaw Qlik Cloud

QlikView Object Migration for Cloud to narzędzie, które migruje zakładki serwera do aplikacji QlikView w przestrzeniach zarządzanych w dzierżawie Qlik Cloud.

Zakładki serwera nie są uwzględniane, gdy dokumenty QlikView są dodawane do dzierżawy Qlik Cloud. QlikView może przypisać własność zakładki między użytkownikami usługi Active Directory w QlikView Server a użytkownikami w dzierżawie Qlik Cloud. QlikView Object Migration for Cloud mapuje tych użytkowników, aby można było przypisać im uprawnienie własności zakładek serwera. Podczas migracji QlikView Object Migration for Cloud kontaktuje się z usługą Active Directory i uzyskuje informacje o identyfikatorach i adresach e-mail użytkowników oraz łączy je z użytkownikami w dzierżawie Qlik Cloud na podstawie adresu e-mail. Możesz także ręcznie mapować użytkowników, dzięki czemu zakładka może być własnością innego użytkownika. Zakładki są przechowywane w pliku QMT, a następnie migrowane do aplikacji w dzierżawie Qlik Cloud.

Kiedy uruchamiasz QlikView Object Migration for Cloud, wykonywane są następujące zadania:

1. Kopiowanie udostępnionych plików (.TShared lub .Shared) z zakładkami do folderu roboczego.

2. Ładowanie nazw plików i metadanych do folderu roboczego.

3. Wybieranie jednego udostępnionego pliku i wybieranie wszystkich zakładek w pliku lub ich podzbioru. Są one eksportowane do nowego udostępnionego pliku.

4. Przesyłanie wybranego pliku udostępnionego do aplikacji QlikView w dzierżawie Qlik Cloud.

Zakładki możesz migrować za pomocą dokumentu QlikView, CloudMigrationApp dołączonego do QlikView Object Migration for Cloud. CloudMigrationApp zarządza skryptami, plikami i poleceniami w celu migracji zakładek. Możesz także przenieść zakładki za pomocą wiersza polecenia w celu uruchomienia plików QlikView Object Migration for Cloud.

Oprogramowanie QlikView Object Migration for Cloud udostępnia Pobieranie produktów.

Czynności wstępne

Przed pobraniem i uruchomieniem QlikView Object Migration for Cloud sprawdź, czy spełnione są następujące wymagania:

• Zainstalowano QlikView Desktop.

• Dodano dokumenty QlikView, do których chcesz dodać udostępnione zakładki serwera w dzierżawie Qlik Cloud.

• Musisz mieć użytkownika mającego Uprawnienie profesjonalne.

• Masz dostęp do Konsola zarządzania w swojej dzierżawie Qlik Cloud.

• Wygenerowano klucz API w dzierżawie Qlik Cloud do używania z QlikView Object Migration for Cloud.

• Jedno z następujących uprawnień w docelowej przestrzeni zarządzanej:

  • Jest właścicielem
  • Może wyświetlać
  • Może współtworzyć
  • Może zarządzać

• Identyfikatory aplikacji docelowych QlikView do zakładek. Identyfikator aplikacji można uzyskać z ciągu następującego po document= w adresie URL aplikacji.

  Na przykład w adresie URL aplikacji QlikView https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6 część e74ebae5-5659-4211-a4de-add8e49768f6 jest identyfikatorem aplikacji. Identyfikatory aplikacji mogą się nieznacznie różnić formatem w zależności od tego, czy zostały opublikowane w hubie w chmurze, czy bezpośrednio przesłane do huba w chmurze.

• QlikView Object Migration for Cloud wymaga modułu Windows Active Directory. Jeśli nie jest zainstalowany, QlikView Object Migration for Cloud instaluje go automatycznie.

Pobieranie i konfigurowanie QlikView Object Migration for Cloud

Wykonaj następujące czynności:

1. Pobierz QlikView Object Migration for Cloud ze strony Pobieranie produktów.

   Więcej informacji zawiera temat Pobieranie plików instalacyjnych (tylko w języku angielskim).

2. Przejdź do %ProgramData%\QlikTech.

3. Utwórz folder o nazwie QlikViewMigrationTool i skopiuj pliki QlikView Object Migration for Cloud do tego folderu.

4. Opcjonalnie utwórz folder i dodaj udostępnione pliki zawierające zakładki, które chcesz przenieść do dzierżawy.

Migracja zakładek do aplikacji QlikView za pomocą CloudMigrationApp

Wykonaj następujące czynności:

1. Przejdź do rozpakowanego folderu QlikView Object Migration for Cloud i otwórz dokument CloudMigrationApp w QlikView Desktop.

2. Przeczytaj i zaakceptuj warunki QlikView Object Migration for Cloud.

3. Kliknij Settings > User preferences.

4. Na karcie Save wybierz Save before reload. Zapobiegnie to usunięciu danych wejściowych przez QlikView po załadowaniu.

5. Na karcie Security wybierz następujące ustawienia i kliknij OK:

   • Script (Allow Database Write and Execute Statements)

6. Postępuj zgodnie ze wskazówkami w dokumencie QlikView w odniesieniu do każdego arkusza:

   1. W 1. Initialize wybierz folder, w którym przechowujesz udostępnione pliki, i folder, w którym chcesz umieścić kopie przesłane do dzierżawy.

   2. W 2. Get User Data ustaw parametry potrzebne do dopasowania właścicieli udostępnionej zakładki do użytkowników w dzierżawie Qlik Cloud.

   3. W 3. View user mapping file sprawdź mapowanie.

      Opcjonalnie edytuj mapowanie w pliku OnPremToCloudMap.csv. Aby zamapować użytkowników QlikView na użytkowników Qlik Cloud, dodaj wartości User ID i IdP subject dla użytkowników z Qlik Cloud Konsola zarządzania do wpisów użytkowników w QlikView. Na zakończenie kliknij Przeładuj w arkuszu.

   4. W 4. Overview sprawdź, czy załadowany został właściwy plik.

   5. W 5. Filter metadata opcjonalnie użyj filtrów, aby zawęzić zakres udostępnionych zakładek do migracji do dzierżawy.

   6. W 6. Prepare new shared files for Cloud wybierz udostępniony plik z aplikacji, którego zakładki chcesz przenieść. Opcjonalnie wybierz identyfikatory zakładek, które chcesz uwzględnić. Jeśli nie wybierzesz żadnego, uwzględnione zostaną wszystkie dostępne zakładki.

   7. W 7. Upload to Cloud ustaw aplikację docelową w dzierżawie i prześlij zakładki.

7. Powtórz kroki 5. Filter metadata, 6. Prepare new shared files for Cloud i 7. Upload to Cloud w przypadku każdej dodatkowej aplikacji, do której chcesz przenieść zakładki.

8. Zapisz i zamknij CloudMigrationApp.

   CloudMigrationApp przechowuje dane wejściowe dodane do aplikacji podczas jej zapisywania.

Migracja zakładek do aplikacji QlikView z wiersza polecenia

Wykonaj następujące czynności:

1. Otwórz wiersz polecenia jako administrator.

2. Przejdź do folderu QlikView Object Migration for Cloud: C:\ProgramData\QlikTech\QlikViewMigrationTool.

3. Wprowadź następujące polecenie, aby skopiować udostępnione pliki i metadane do folderu wyjściowego: QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

   Zastąp zmienne: 

   • $(vInputFolder): ścieżka do folderu, w którym będą przechowywane pliki udostępnione.

   • $(vOutputFolder): Ścieżka do folderu, w którym chcesz przechowywać pliki migracji.

4. Wpisz następujące polecenie, aby pobrać dane użytkowników z Active Directory: QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)".

   Zastąp następujące zmienne:

   • $(vDCServer): adres URL serwera kontrolera domeny.

   • $(vADOutputfile): ścieżka pliku do folderu do przechowywania listy użytkowników QlikView Server, w tym nazwa pliku i .csv.

5. Wprowadź następujące polecenie, aby uzyskać dane użytkowników z dzierżawy Qlik Cloud: QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)".

   Zastąp następujące zmienne:

   • $(vCloudURL): adres URL Twojej dzierżawy Qlik Cloud.

   • $(vApiKey). klucz interfejsu API z Twojej dzierżawy Qlik Cloud.

   • $(vUserIdMapLocation): ścieżka pliku do folderu do przechowywania listy użytkowników dzierżawy, w tym nazwa pliku i .csv.

6. Utwórz nowy plik CSV o nazwie OnPremToCloudMap.csv z następującymi kolumnami:

   • Owner
   • subject
   • id

7. W pliku OnPremToCloudMap.csv dodaj wartości z kolumny Owner w pliku <aplikacja>.qvw.tshared.xlsx, obecnego w folderze wyjściowym z kroku 3, z odpowiadającymi im wartościami subject i id z pliku .csv utworzonego w kroku 5.

8. Utwórz nowy plik CSV i dodaj jednokolumnową listę identyfikatorów zakładek z udostępnionego pliku, który chcesz przenieść do dzierżawy Qlik Cloud. Identyfikatory zakładek znajdziesz w pliku <aplikacja>.qvw.tshared.xlsx obecnym w folderze wyjściowym w kroku 3.

9. W wierszu polecenia utwórz plik QMT zawierający zakładki, które zostaną przesłane do dzierżawy, wpisując następujące polecenie: QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)".

   Zastąp następujące zmienne:

   • $(OriginalSharedFile): pełna ścieżka, w tym nazwa pliku, do miejsca, w którym znajduje się udostępniony plik.
   • $(csvFile): pełna ścieżka, w tym nazwa pliku, do pliku CSV zawierającego identyfikatory zakładek.
   • $(OnPremToCloudMap.csv): pełna ścieżka, w tym nazwa pliku, do OnPremToCloudMap.csv.
   • $(Updated): ścieżka do folderu, w którym będzie przechowywany plik QMT.
   • $(vApiKey): klucz interfejsu API z Twojej dzierżawy Qlik Cloud.

10. Uruchom następujące polecenie, zastępując zmienne: qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)".

    Zastąp następujące zmienne:

    • $(vCloudURL): adres URL Twojej dzierżawy Qlik Cloud.

    • $(vAppId): identyfikator aplikacji, do której przenosisz zakładki.

    • $(vApiKey): klucz interfejsu API z Twojej dzierżawy Qlik Cloud.

    • $(vSharedFileToUpload): Pełna ścieżka, w tym nazwa pliku, do pliku QMT zawierającego zakładki.

    • $(vHandledDirectory): Pełna ścieżka folderu, w którym plik QMT będzie przechowywany po migracji do chmury.

    InformacjaPojawi się komunikat: „Dziennik parametrów zapisany w C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt”. Sprawdź dziennik, aby się upewnić, że migracja przebiegła pomyślnie.

Ograniczenia

QlikView Object Migration for Cloud mają następujące ograniczenia:

• QlikView Object Migration for Cloud nie obsługuje migracji zakładek do aplikacji QlikView w przestrzeniach prywatnych. Możesz migrować zakładki do aplikacji QlikView w przestrzeniach współdzielonych, ale nie są one dostępne dla użytkowników.

• Ścieżki UNC nie są obsługiwane w przypadku folderów wejściowych ani wyjściowych. Obsługiwane są foldery udostępnione mapowane na dyski lokalne.

• Liczba plików XLSX w arkuszu 4. Overview może się różnić w porównaniu z liczbą rzeczywistych plików w folderze. Dzieje się tak, ponieważ puste pliki metadanych nie są widoczne w aplikacji.

• Jeśli zakładki z udostępnionego pliku zostały już przeniesione, musisz usunąć wcześniej wygenerowane pliki z danego katalogu przed ponownym skopiowaniem plików z tego udostępnionego pliku.

• Jeśli zakładki z udostępnionego pliku zostały już przeniesione i udostępnione w Qlik Cloud, nie możesz migrować ich ponownie.