Yer işaretlerini QlikView ve Qlik Cloud kiracıları arasında taşıma

Bulut için QlikView Nesne Geçişi, bir Qlik Cloud kiracısındaki yönetilen alanlarda QlikView uygulamalarına sunucu yer aktaran bir araçtır.

Bir Qlik Cloud kiracısına QlikView belgeleri eklendiğinde sunucu yer işaretleri dahil edilmez. QlikView, QlikView Server üzerindeki Active Directory kullanıcıları ile Qlik Cloud kiracısındaki kullanıcılar arasında yer işareti sahipliğini atayabilir. Bulut için QlikView Nesne Geçişi bu kullanıcıları eşler, böylece onlara sunucu yer işaretlerinin sahipliğini atayabilirsiniz. Geçiş işlemi sırasında, Bulut için QlikView Nesne Geçişi Active Directory hizmetinizle iletişim kurar ve kullanıcılarınız için kimlik ve e-posta adresi bilgilerini alıp, bunları e-posta adresine göre Qlik Cloud kiracısındaki kullanıcılara bağlar. Kullanıcıları manuel olarak da eşleyebilirsiniz, böylece bir yer işareti farklı bir kullanıcıya ait olabilir. Yer işaretleri bir QMT dosyasında depolanır ve ardından Qlik Cloud kiracısındaki bir uygulamaya aktarılır.

Bulut için QlikView Nesne Geçişi öğesini çalıştırdığınızda:

1. Paylaşılan dosyaları (.TShared veya .Shared) yer işaretleriyle birlikte bir çalışma klasörüne kopyalarsınız.

2. Dosya adlarını ve meta verileri çalışma klasörüne yüklersiniz.

3. Paylaşılan bir dosya seçer, ardından dosyadaki yer işaretlerinin tümünü veya bir alt kümesini seçersiniz. Bunlar yeni bir paylaşılan dosyaya aktarılır.

4. Seçilen paylaşılan dosyayı Qlik Cloud kiracınızdaki bir QlikView uygulamasına yüklersiniz.

Bulut için QlikView Nesne Geçişi eklenmiş bir QlikView belgesi (CloudMigrationApp) kullanarak yer işaretlerinizi taşıyabilirsiniz. CloudMigrationApp, yer işaretlerinizi taşımak için komut dosyalarını, dosyaları ve komutları yönetir. Bulut için QlikView Nesne Geçişi dosyalarını çalıştırmak için Komut İstemi'ni kullanarak yer işaretlerinizi de taşıyabilirsiniz.

Bulut için QlikView Nesne Geçişi, Ürün İndirmeleri üzerinden edinilebilir.

Başlamadan önce

Bulut için QlikView Nesne Geçişi öğesini indirip çalıştırmadan önce aşağıdaki gereksinimleri karşıladığınızdan emin olun:

• QlikView Desktop yüklü olmalıdır.

• Paylaşılan sunucu yer işaretlerini eklemek istediğiniz QlikView belgelerini Qlik Cloud kiracısına eklemiş olmanız gerekir.

• Professional yetkilendirmesi adına sahip bir kullanıcınız bulunmalıdır.

• Qlik Cloud kiracınızda Yönetim Konsolu erişiminiz vardır.

• Bulut için QlikView Nesne Geçişi ile kullanmak için Qlik Cloud kiracınızda bir API anahtarı oluşturmanız gerekir.

• Yönetilen hedef alanda aşağıdaki izinlerden birine sahip olmanız gerekir:

  • Uygulama sahibi
  • Görüntüleyebilir
  • Katkıda bulunabilir
  • Yönetebilir

• Yer işaretleri için, hedef QlikView uygulamalara yönelik uygulama kimliklerine sahip olmanız gerekir. Bir uygulama kimliği, uygulama URL'sinde document= ifadesinin ardından gelen dizeden elde edilebilir.

  Örneğin, QlikView uygulama URL'si olan https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6 adresinde, e74ebae5-5659-4211-a4de-add8e49768f6 kısmı uygulama kimliğidir. Uygulama kimliklerinin biçimi, bulut hub'ında yayınlanmış veya doğrudan bulut hub'ına yüklenmiş olmalarına bağlı olarak biraz farklılık gösterebilir.

• Bulut için QlikView Nesne Geçişi, Windows Active Directory Modülü gerektirir. Kurulu değilse, Bulut için QlikView Nesne Geçişi otomatik olarak yükler.

Bulut için QlikView Nesne Geçişi indirme ve kurma

Aşağıdakileri yapın:

1. Bulut için QlikView Nesne Geçişi aracını Ürün İndirmeleri adresinden indirin.

   Daha fazla bilgi için bkz. Yükleme dosyalarını indirme (yalnızca İngilizce).

2. %ProgramData%\QlikTech bölümüne gidin.

3. QlikViewMigrationTool adlı bir klasör oluşturun ve Bulut için QlikView Nesne Geçişi dosyalarını bu klasöre kopyalayın.

4. İsteğe bağlı olarak, bir klasör oluşturun ve taşımak istediğiniz yer işaretlerini içeren paylaşılan dosyaları kiracınıza ekleyin.

CloudMigrationApp ile yer işaretlerini bir QlikView uygulamasına taşıma

Aşağıdakileri yapın:

1. Açılmış Bulut için QlikView Nesne Geçişi klasörüne gidin ve CloudMigrationApp belgesini QlikView Desktop içinde açın.

2. Bulut için QlikView Nesne Geçişi şartlar ve koşullarını okuyup kabul edin.

3. Ayarlar > Kullanıcı tercihleri'ne tıklayın.

4. Kaydet sekmesinde, Yeniden yüklemeden önce kaydet'i seçin. Bu, yeniden yükledikten sonra giriş verilerinin QlikView tarafından silinmesini önleyecektir.

5. Güvenlik sekmesinde aşağıdaki ayarları seçin ve Tamam'a tıklayın:

   • Kod (Veritabanı Yazma ve İfade Yürütmeye İzin Ver)

6. Her sayfa için QlikView belgesindeki yönergeleri izleyin:

   1. 1. Başlat, paylaşılan dosyaları depoladığınız klasörü ve kiracıya yüklenen kopyaların çıktısını almak istediğiniz klasörü seçin.

   2. 2. Kullanıcı Verilerini Al, paylaşılan yer işareti sahiplerini Qlik Cloud kiracısındaki kullanıcılarla eşleştirmek için gereken parametreleri ayarlayın.

   3. 3. Kullanıcı eşleme dosyasını görüntüle, eşlemeyi inceleyin.

      İsteğe bağlı olarak, OnPremToCloudMap.csv dosyasındaki eşlemeyi düzenleyin. QlikView kullanıcılarını Qlik Cloud kullanıcılarıyla eşlemek için, kullanıcıların Kullanıcı Kimliği ve IdP konusu değerlerini Qlik Cloud Yönetim Konsolu öğesinden QlikView kullanıcı varlıklarına ekleyin. İşiniz bittiğinde, sayfada Yeniden Yükle'ye tıklayın.

   4. 4. Genel bakış, doğru dosyayı yüklediğinizi onaylayın.

   5. 5. Meta verileri filtrele, isteğe bağlı olarak, kiracıya taşınacak paylaşılan yer işaretlerinin kapsamını daraltmak için filtreleri kullanın.

   6. 6. Bulut için yeni paylaşılan dosyaları hazırla, yer işaretlerini taşımak istediğiniz uygulamadan paylaşılan dosyayı seçin. İsteğe bağlı olarak, eklemek istediğiniz yer işaretlerinin kimliklerini seçin. Hiçbiri seçeneğini belirlerseniz, mevcut tüm yer işaretleri dahil edilir.

   7. 7. Buluta yükle, kiracıda hedef uygulamayı ayarlayın ve yer işaretlerini yükleyin.

7. Adımları tekrarla 5. Meta verileri filtrele, 6. Bulut için yeni paylaşılan dosyaları hazırla ve 7. Yer işaretlerini taşımak istediğiniz her ek uygulama için Bulut'a yükleyin.

8. CloudMigrationApp'i kaydedin ve kapatın.

   CloudMigrationApp, kaydettiğinizde uygulamaya eklediğiniz girdileri saklar.

Komut İsteminden bir QlikView uygulamasına yer işaretlerini taşıma

Aşağıdakileri yapın:

1. Yönetici olarak Komut İstemi'ni açın.

2. Bulut için QlikView Nesne Geçişi klasörüne gidin: C:\ProgramData\QlikTech\QlikViewMigrationTool.

3. Paylaşılan dosyaları ve meta verileri çıktı klasörüne kopyalamak için aşağıdaki komutu girin: QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

   Değişkenleri değiştirin: 

   • $(vInputFolder): – Paylaşılan dosyaların saklanacağı klasörün yolu.

   • $(vOutputFolder): Taşıma dosyalarını depolamak istediğiniz klasörün yolu.

4. Active Directory'den kullanıcı verilerini almak için aşağıdaki komutu girin: QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)".

   Aşağıdaki değişkenleri değiştirin:

   • $(vDCServer): Etki Alanı Denetleyicisi sunucu URL'si.

   • $(vADOutputfile): Dosya adı ve .csv dahil olmak üzere QlikView Server kullanıcıları listenizin depolanacağı klasörün dosya yolu.

5. Qlik Cloud kiracısından kullanıcı verilerini almak için aşağıdaki komutu girin: QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)".

   Aşağıdaki değişkenleri değiştirin:

   • $(vCloudURL): Qlik Cloud  kiracınızın  URL'si.

   • $(vApiKey)değişkenlerini silin. Qlik Cloud kiracınızdan gelen API anahtarı.

   • $(vUserIdMapLocation): Dosya adı ve .csv dahil olmak üzere kiracı kullanıcılar listenizin depolanacağı klasörün dosya yolu.

6. Aşağıdaki sütunları içeren, OnPremToCloudMap.csv adında yeni bir CSV dosyası oluşturun:

   • Owner
   • subject
   • id

7. OnPremToCloudMap.csviçinde, 3. adımda çıktı klasöründe bulunan <app>.qvw.tshared.xlsx dosyasındaki Owner sütununun değerlerini, 5. adımda oluşturulan .csv dosyasındaki ilgili konu ve kimlik değerleriyle ekleyin.

8. Yeni bir CSV dosyası oluşturun ve Qlik Cloud kiracınıza taşımak istediğiniz paylaşılan dosyadan yer işareti kimliklerinin tek sütunlu bir listesini ekleyin. Yer imi kimliklerini, 3. adımdaki çıktı klasöründe bulunan <app>.qvw.tshared.xlsx dosyasında bulabilirsiniz.

9. Komut İsteminde, kiracıya yüklenecek yer işaretlerini içeren QMT dosyasını oluşturmak için şu komutu girin: QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)".

   Aşağıdaki değişkenleri değiştirin:

   • $(OriginalSharedFile): Dosya adı dahil olmak üzere, paylaşılan dosyanın tam yolu.
   • $(csvFile): Yer işareti kimliklerini içeren CSV dosyasının dahil tam yolu (dosya adı dahil).
   • $(OnPremToCloudMap.csv): OnPremToCloudMap.csv dosyasının tam yolu (dosya adı dahil).
   • $(Updated): QMT dosyasının saklanacağı klasörün yolu.
   • $(vApiKey): Qlik Cloud kiracınızdan gelen API anahtarı.

10. Değişkenleri değiştirmek için şu komutu çalıştırın: qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)".

    Aşağıdaki değişkenleri değiştirin:

    • $(vCloudURL): Qlik Cloud  kiracınızın  URL'si.

    • $(vAppId): Yer işaretlerini taşıdığınız uygulamanın uygulama kimliği.

    • $(vApiKey): Qlik Cloud kiracınızdan gelen API anahtarı.

    • $(vSharedFileToUpload): Yer imlerini içeren QMT dosyasının, dosya adı dahil tam yolu.

    • $(vHandledDirectory): QMT dosyanızın buluta geçirildikten sonra depolanacağı klasörün tam yolu.

    Bilgi notuBir mesaj görüntülenir: "C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt içine yazılan parametre günlüğü". Geçişin başarılı olduğundan emin olmak için günlüğü kontrol edin.

Sınırlamalar

Bulut için QlikView Nesne Geçişi şu sınırlamalara sahiptir:

• Bulut için QlikView Nesne Geçişi, yer işaretlerinin kişisel alanlardaki QlikView uygulamalara taşınmasını desteklemez. Yer işaretlerini paylaşılan alanlardaki QlikView uygulamalarına taşıyabilirsiniz, ancak bunlar kullanıcılar tarafından kullanılamaz.

• UNC yolları giriş veya çıkış klasörleri için desteklenmez. Yerel sürücülerle eşlenen paylaşılan klasörler desteklenir.

• Sayfa 4'teki XLSX dosya sayısı. Genel bakış, klasördeki gerçek dosya sayısına göre farklılık gösterebilir. Bunun nedeni, uygulamada boş meta veri dosyalarının görünmemesidir.

• Zaten paylaşılan bir dosyadan yer işaretlerini taşıdıysanız, dosyaları o paylaşılan dosyadan tekrar kopyalamadan önce işlenen dizindeki önceden oluşturulmuş dosyaları silmelisiniz.

• Yer imlerini zaten paylaşılan bir dosyadan taşıdıysanız, bunlar Qlik Cloud içinde paylaşılıyorsa tekrar geçiremezsiniz.