QlikView에서 Qlik Cloud 테넌트로 북마크 마이그레이션

클라우드용 QlikView 개체 마이그레이션는 Qlik Cloud 테넌트의 관리되는 공간에 있는 QlikView 앱으로 서버 북마크를 마이그레이션하는 도구입니다.

QlikView 문서가 Qlik Cloud 테넌트에 추가될 때 서버 북마크는 포함되지 않습니다. QlikView는 QlikView Server의 Active Directory 사용자와 Qlik Cloud 테넌트의 사용자 간에 북마크 소유권을 할당할 수 있습니다. 클라우드용 QlikView 개체 마이그레이션는 서버 북마크의 소유권을 할당할 수 있도록 이러한 사용자를 매핑합니다. 마이그레이션 프로세스 중에 클라우드용 QlikView 개체 마이그레이션는 Active Directory 서비스에 연결하여 사용자의 ID 및 이메일 주소 정보를 가져와 이메일 주소로 Qlik Cloud 테넌트의 사용자에게 연결합니다. 다른 사용자가 북마크를 소유할 수 있도록 사용자를 수동으로 매핑할 수도 있습니다. 북마크는 QMT 파일에 저장된 다음 Qlik Cloud 테넌트의 앱으로 마이그레이션됩니다.

클라우드용 QlikView 개체 마이그레이션를 실행하면 다음을 수행합니다.

1. 북마크가 있는 공유 파일(.TShared 또는 .Shared)을 작업 폴더에 복사합니다.

2. 작업 폴더에 로드 파일 이름과 메타데이터를 로드합니다.

3. 하나의 공유 파일을 선택하고 파일에서 북마크 전체 또는 하위 집합을 선택합니다. 새 공유 파일로 내보내집니다.

4. 선택한 공유 파일을 Qlik Cloud 테넌트의 QlikView 앱에 업로드합니다.

클라우드용 QlikView 개체 마이그레이션에 포함된 QlikView 문서, CloudMigrationApp을 사용하여 북마크를 마이그레이션할 수 있습니다. CloudMigrationApp은 북마크를 마이그레이션하는 스크립트, 파일 및 명령을 관리합니다. 명령 프롬프트를 사용하여 북마크를 마이그레이션하여 클라우드용 QlikView 개체 마이그레이션 파일을 실행할 수도 있습니다.

클라우드용 QlikView 개체 마이그레이션은 제품 다운로드에서 사용할 수 있습니다.

시작하기 전에

클라우드용 QlikView 개체 마이그레이션를 다운로드하고 실행하기 전에 다음 요구 사항을 충족하는지 확인합니다.

• QlikView Desktop을 설치했어야 합니다.

• 공유 서버 북마크를 Qlik Cloud 테넌트에 추가하려는 QlikView 문서를 추가했습니다.

• 전문가 권한이 있는 사용자가 있어야 합니다.

• Qlik Cloud 테넌트에서 관리 활동 센터에 대한 액세스 권한이 있습니다.

• Qlik Cloud 테넌트에서 클라우드용 QlikView 개체 마이그레이션와 함께 사용할 API 키를 생성해야 합니다.

• 대상 관리 공간에서 다음 권한 중 하나가 있어야 합니다.

  • 소유자
  • 볼 수 있음
  • 기여할 수 있음
  • 관리할 수 있음

• 북마크의 대상 QlikView 앱에 대한 앱 ID가 있어야 합니다. 앱 ID는 앱 URL의 document= 다음 문자열에서 얻을 수 있습니다.

  예를 들어 QlikView 앱 URL https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6에서 e74ebae5-5659-4211-a4de-add8e49768f6이 앱 ID입니다. 앱 ID는 게시되었는지 아니면 Qlik Cloud에 직접 업로드되었는지에 따라 형식이 약간 다를 수 있습니다.

• 클라우드용 QlikView 개체 마이그레이션에는 Windows Active Directory 모듈이 필요합니다. 설치되어 있지 않으면 클라우드용 QlikView 개체 마이그레이션가 이 모듈을 자동으로 설치합니다.

클라우드용 QlikView 개체 마이그레이션 다운로드 및 설정

다음과 같이 하십시오.

1. 클라우드용 QlikView 개체 마이그레이션은 제품 다운로드에서 다운로드합니다.

   자세한 내용은 설치 파일 다운로드 (영어로만 제공)를 참조하십시오.

2. %ProgramData%\QlikTech로 이동합니다.

3. QlikViewMigrationTool이라는 폴더를 만들고 해당 폴더에 클라우드용 QlikView 개체 마이그레이션 파일을 복사합니다.

4. 선택적으로 폴더를 만들고 마이그레이션하려는 북마크가 포함된 공유 파일을 테넌트에 추가합니다.

CloudMigrationApp을 사용하여 북마크를 QlikView 앱으로 마이그레이션

다음과 같이 하십시오.

1. 압축을 푼 클라우드용 QlikView 개체 마이그레이션 폴더로 이동하여 QlikView Desktop에서 CloudMigrationApp 문서를 엽니다.

2. 클라우드용 QlikView 개체 마이그레이션 사용 약관을 읽고 동의합니다.

3. 설정 > 사용자 기본 설정을 클릭합니다.

4. 저장 탭에서 다시 로드하기 전에 저장을 선택합니다. 이렇게 하면 QlikView가 다시 로드한 후 입력 데이터가 지워지지 않습니다.

5. 보안 탭에서 다음 설정을 선택하고 확인을 클릭합니다.

   • 스크립트(데이터베이스 쓰기 및 실행 명령문 허용)

6. 각 시트에 대한 QlikView 문서의 지침을 따르십시오.

   1. 1. 초기화에서 공유 파일을 저장할 폴더와 테넌트에 업로드된 복사본을 출력할 폴더를 선택합니다.

   2. 2. 사용자 데이터 가져오기에서 공유 북마크 소유자를 Qlik Cloud 테넌트의 사용자와 일치시키는 데 필요한 매개변수를 설정합니다.

   3. 3. 사용자 매핑 파일 보가에서 매핑을 검토합니다.

      선택적으로 OnPremToCloudMap.csv 파일에서 매핑을 편집합니다.QlikView 사용자를 Qlik Cloud 사용자에 매핑하려면 Qlik Cloud 관리 활동 센터의 사용자에 대한 사용자 ID 및 IdP 주체 값을 QlikView 사용자 항목에 추가합니다. 완료되면 시트에서 다시 로드를 클릭합니다.

   4. 4. 개요에서 올바른 파일을 로드했는지 확인합니다.

   5. 5. 메타데이터 필터링에서 선택적으로 필터를 사용하여 테넌트로 마이그레이션할 공유 북마크의 범위를 좁힙니다.

   6. 6. 클라우드용 새 공유 파일 준비에서 북마크를 마이그레이션하려는 앱에서 공유 파일을 선택합니다. 선택적으로 포함할 북마크의 ID를 선택합니다. 없음을 선택하면 사용 가능한 모든 북마크가 포함됩니다.

   7. 7. 클라우드에 업로드에서 테넌트에 대상 앱을 설정하고 북마크를 업로드합니다.

7. 북마크를 마이그레이션할 각 추가 앱에 대해 5. 메타데이터 필터링, 6. 클라우드용 새 공유 파일 준비 및 7. 클라우드에 업로드를 반복합니다.

8. CloudMigrationApp을 저장하고 닫습니다.

   CloudMigrationApp은 앱을 저장할 때 앱에 추가한 입력을 유지합니다.

명령 프롬프트에서 QlikView 앱으로 북마크 마이그레이션

다음과 같이 하십시오.

1. 명령 프롬프트를 관리자로 엽니다.

2. 클라우드용 QlikView 개체 마이그레이션 폴더로 이동합니다. C:\ProgramData\QlikTech\QlikViewMigrationTool.

3. 다음 명령을 입력하여 공유 파일과 메타데이터를 출력 폴더에 복사합니다. QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

   변수를 바꿉니다. 

   • $(vInputFolder): – 공유 파일이 저장된 폴더의 경로입니다.

   • $(vOutputFolder): 마이그레이션 파일을 저장할 폴더의 경로입니다.

4. Active Directory에서 사용자 데이터를 가져오려면 다음 명령을 입력합니다. QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)"

   다음 변수를 바꿉니다.

   • $(vDCServer):도메인 컨트롤러 서버 URL입니다.

   • $(vADOutputfile): 파일 이름 및 .csv를 포함하여 QlikView Server 사용자 목록을 저장하기 위한 폴더의 파일 경로입니다.

5. Qlik Cloud 테넌트에서 사용자 데이터를 가져오려면 다음 명령을 입력합니다. QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)"

   다음 변수를 바꿉니다.

   • $(vCloudURL): Qlik Cloud 테넌트의 URL입니다.

   • $(vApiKey)에서 관리합니다. Qlik Cloud 테넌트의 API 키입니다.

   • $(vUserIdMapLocation): 파일 이름 및 .csv를 포함하여 테넌트 사용자 목록을 저장하기 위한 폴더의 파일 경로입니다.

6. 다음 열로 OnPremToCloudMap.csv라고 이름이 지정된 새 CSV 파일을 만듭니다.

   • Owner
   • subject
   • id

7. OnPremToCloudMap.csv에서 3단계의 출력 폴더에 있는 파일 <app>.qvw.tshared.xlsx의 Owner 열 값을 5단계에서 만든 .csv의 해당 제목 및 id 값과 함께 추가합니다.

8. 새 CSV 파일을 만들고 Qlik Cloud 테넌트로 마이그레이션하려는 공유 파일에서 북마크 ID의 단일 열 목록을 추가합니다. 3단계의 출력 폴더에 있는 <앱>.qvw.tshared.xlsx 파일에서 북마크 ID를 찾습니다.

9. 명령 프롬프트에서 다음 명령을 입력하여 테넌트에 업로드할 북마크가 포함된 QMT 파일을 만듭니다. QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)"

   다음 변수를 바꿉니다.

   • $(OriginalSharedFile): 공유 파일이 있는 전체 경로(파일 이름 포함)입니다.
   • $(csvFile): 북마크 ID가 포함된 CSV 파일에 대한 전체 경로(파일 이름 포함)입니다.
   • $(OnPremToCloudMap.csv): OnPremToCloudMap.csv에 대한 전체 경로(파일 이름 포함)입니다.
   • $(Updated): QMT 파일이 저장될 폴더의 경로입니다.
   • $(vApiKey): Qlik Cloud 테넌트의 API 키입니다.

10. 다음 명령을 실행하여 변수를 바꿉니다. qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)".

    다음 변수를 바꿉니다.

    • $(vCloudURL): Qlik Cloud 테넌트의 URL입니다.

    • $(vAppId): 북마크를 마이그레이션할 앱의 앱 ID 입니다.

    • $(vApiKey): Qlik Cloud 테넌트의 API 키입니다.

    • $(vSharedFileToUpload): 북마크가 포함된 QMT 파일의 전체 경로(파일 이름 포함)입니다.

    • $(vHandledDirectory): 클라우드로 마이그레이션된 후 QMT 파일이 저장될 폴더의 전체 경로입니다.

    정보 메모"C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt에 기록된 매개 변수 로그"라는 메시지가 표시됩니다. 로그를 확인하여 마이그레이션이 성공했는지 확인합니다.

제한 사항

클라우드용 QlikView 개체 마이그레이션 다음과 같은 제한 사항이 있습니다.

• 클라우드용 QlikView 개체 마이그레이션는 개인 공간의 QlikView 앱으로 북마크 마이그레이션을 지원하지 않습니다. 북마크를 공유 공간의 QlikView 앱으로 마이그레이션할 수 있지만 사용자는 사용할 수 없습니다.

• UNC 경로는 입력 또는 출력 폴더에 대해 지원되지 않습니다. 로컬 드라이브에 매핑된 공유 폴더가 지원됩니다.

• XLSX 파일 수(시트 4. 개요에 있음)는 폴더의 실제 파일 수와 다를 수 있습니다. 빈 메타데이터 파일이 앱에 표시되지 않기 때문입니다.

• 이미 공유 파일에서 북마크를 마이그레이션한 경우 해당 공유 파일에서 파일을 다시 복사하기 전에 처리된 디렉터리에서 이전에 생성된 파일을 삭제해야 합니다.

• 공유 파일에서 이미 마이그레이션한 북마크는 Qlik Cloud에서 공유한 경우 다시 마이그레이션할 수 없습니다.