조직의 사용자가 보고서 템플릿을 만들 수 있도록 하려면 Microsoft Office용 Qlik 추가 기능을 배포하고 설치합니다.추가 기능으로 만들어진 보고서 템플릿을 Qlik Cloud 응용 프로그램에 업로드하여 보고서 작업에서 보고서 출력을 만듭니다.
Microsoft Office용 Qlik 추가 기능은 Microsoft 365 내에서 Excel, PowerPoint, Word의 호환 가능한 웹 및 데스크톱 버전용으로 배포 및 설치할 수 있습니다.
추가 기능은 매니페스트 파일을 사용하여 설치됩니다.이 매니페스트 파일은 Microsoft 365 관리자(또는 특정 설치 방법에서는 사용자)가 자신이나 조직의 사용자를 위해 추가 기능을 배포하고 설치하는 데 필요합니다.매니페스트 파일을 사용하면 단일 Qlik Cloud테넌트에 대한 추가 기능을 설치할 수 있습니다.
정보 메모매니페스트 파일과 링크를 생성하려면 OAuth 클라이언트 구성이 필요합니다.지침은 다음을 참조하십시오 추가 기능 매니페스트 준비 및 획득.
Microsoft Office용 Qlik 추가 기능은 무엇입니까?
Microsoft Office용 Qlik 추가 기능은 다음과 같습니다:
Microsoft Excel용 Qlik 추가 기능
Microsoft PowerPoint용 Qlik 추가 기능
Microsoft Word용 Qlik 추가 기능
추가 기능 전반에 걸쳐 기능이 유사합니다. 추가 기능 창에서 테이블, 이미지, 변수, 표현식 형태의 응용 프로그램 콘텐츠를 추가할 수 있습니다. 추가 기능을 사용하여 콘텐츠를 추가한 후, 기본 Microsoft Office 기능을 사용하여 서식 지정 및 스타일 지정을 위한 여러 가지 옵션이 있습니다.
설치 워크플로 선택
매니페스트 파일 또는 URL을 얻은 후, 애드인을 배포하려는 방식에 맞는 워크플로를 선택합니다.
워크플로 1: Microsoft 365 관리자에 의한 관리형 배포를 위한 중앙 집중식 배포.워크플로 1: 중앙 집중식 배포 참조.
Microsoft Office용 Qlik 추가 기능은 Qlik Cloud 정부 또는 Qlik Cloud 정부 - DoD 테넌트의 응용 프로그램을 대상으로 보고서 템플릿을 개발하는 데 지원됩니다.
Qlik 추가 기능을 설치하고 사용하려면 사용자는 다음 요구 사항을 충족해야 합니다.
Microsoft Excel용 Qlik 추가 기능
Windows 설치의 경우:
Windows 10 v.1903 이상
Microsoft 365 v.16.0.11629 이상
macOS 설치의 경우:
macOS v.14 이상
Microsoft 365 v.16.83 이상
또한, Microsoft Excel용 Qlik 추가 기능을 실행하려면 ExcelAPI 1.9 이상이 설치된 Microsoft Excel이(가) 설치되어 있어야 합니다.Excel 설치가 규정을 준수하는지 확인하려면 Excel JavaScript API 요구 사항 집합에서 Microsoft 공식 문서를 참조하십시오.
ExcelAPI가 필요한 최소 버전보다 낮은 경우 Qlik 추가 기능에 최신 버전의 Microsoft Excel이 필요하다는 오류가 표시됩니다.
추가 기능 설치 중 오류 메시지의 예
오류를 확인하려면 Microsoft Excel 오른쪽의 흰색 영역을 클릭하고 F5 키를 눌러 페이지를 업데이트해야 할 수도 있습니다.
이 오류가 표시되면 Microsoft Excel 설치를 업그레이드합니다.
Microsoft PowerPoint용 Qlik 추가 기능
Windows 설치의 경우:
Windows 10 v.1903 이상
Microsoft 365 버전 2504(빌드 18730.20030) 이상
macOS 설치의 경우:
macOS v.14 이상
Microsoft 365 v.16.96 이상
Microsoft Word용 Qlik 추가 기능
Windows 설치의 경우:
Windows 10 v.1903 이상
Microsoft 365 버전 2208(빌드 15601.20148) 이상
macOS 설치의 경우:
macOS v.14 이상
Microsoft 365 v.16.64 이상
요구사항 2: OAuth 클라이언트 생성
Microsoft Office용 Qlik 추가 기능을 설치하려면 OAuth 클라이언트 구성이 필요합니다.추가 기능은 보고서 개발자가 Qlik Cloud를 사용한 응용 프로그램 내 보고용 보고서 템플릿을 준비하는 데 사용됩니다.
추가 기능에서 OAuth가 작동하려면 OAuth 클라이언트가 아래 표시된 정확한 구성으로 구성되어야 합니다.
다음과 같이 하십시오.
Qlik Cloud에서 클릭합니다.왼쪽 상단 모서리에
선택 관리.
OAuth으로 이동합니다.
새로 만들기를 클릭합니다.
클라이언트 유형 드롭다운 메뉴에서 단일 페이지 앱을 선택합니다.더 많은 필드가 나타납니다.
이름을 삽입합니다.설명은 선택 사항입니다.
최소한 user_default 범위를 포함하려면 확인란을 선택합니다.구성에 다른 범위를 포함할 수 있지만 user_default가 없으면 설치가 작동하지 않습니다.
리디렉션 URL 추가 필드에 Qlik Cloud 테넌트의 URL과 이 고정 문자열을 차례로 삽입합니다: /office-add-ins/oAuthLoginSuccess.html
결과는 다음과 같아야 합니다. https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html예시: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html
추가를 클릭합니다.
허용된 원본 추가 필드에 테넌트 URL을 입력하고 추가를 클릭합니다.
만들기를 클릭합니다.
클라이언트 ID 복사 창이 나타납니다.클라이언트 ID를 클립보드에 복사하도록 선택하거나 완료를 클릭하여 창을 닫을 수 있습니다.
OAuth 클라이언트를 만든 후, XML 활동 센터에서 업데이트된 매니페스트 관리 링크를 가져옵니다.설정 페이지로 이동하여 이메일 및 보고서 탭을 선택합니다.공유 및 보고서 섹션에서 Microsoft Office용 Qlik 추가 기능을 선택합니다.제공된 링크를 사용하여 추가 기능을 배포하고 설치합니다.
요구 사항 3: 추가 기능 매니페스트 준비 및 획득
Microsoft Qlik 환경에서 Microsoft Office용 추가 기능을 매니페스트 XML 파일 또는 해당 파일에 대한 링크를 사용하여 설치합니다.
중앙 집중식 배포의 경우, 매니페스트는 종종 URL 형식으로 제공되어야 합니다.
자체 관리형 설치의 경우, 매니페스트는 종종 파일 형태로 제공됩니다.
매니페스트 파일은 단일 Qlik Cloud테넌트에만 적용됩니다.Excel, PowerPoint, Word용 추가 기능을 설치하려면 동일한 매니페스트 파일을 사용합니다.
추가 기능을 설치하려면 OAuth 클라이언트 구성이 필요합니다.OAuth 클라이언트를 구성한 후 관리 활동 센터에서 매니페스트 파일 자체와 매니페스트 파일 링크를 가져옵니다.
다음과 같이 하십시오.
필수 구성을 사용하여 Qlik Cloud 테넌트에 OAuth 클라이언트를 만듭니다.전체 지침은 OAuth 클라이언트 생성을(를) 참조하십시오.
Qlik Cloud에서 클릭합니다. 왼쪽 상단 모서리에 있습니다.
관리 선택
설정으로 이동합니다.
공유 및 보고서 섹션에서 QlikMicrosoft Office용 추가 기능으로 이동합니다.
드롭다운 메뉴에서 추가 기능에서 OAuth를 활성화하기 위해 설정한 OAuth 클라이언트 구성을 선택합니다.
다운로드를 클릭하여 매니페스트를 다운로드하거나, 복사를 클릭하여 해당 링크를 복사하세요.
워크플로 1: 중앙 집중식 배포
Microsoft Office용 Qlik 추가 기능은 중앙 집중식 배포 및 설치를 통해 사용할 수 있도록 하는 것이 좋습니다.중앙 집중식 배포에는 조직의 Microsoft 365 관리자의 조치가 필요합니다.
중앙 집중식 배포를 사용하면 추가 기능 매니페스트가 조직의 Microsoft 365 관리 센터에 로드되고 사전 구성된 설치로 사용자에게 배포됩니다.배포는 특정 보안 그룹의 구성원으로 제한될 수 있습니다.
정보 메모중앙 집중식 배포를 통해, 추가 기능은 Excel, PowerPoint, 그리고 Word에 설치됩니다.애드인을 개별적으로 설치하는 옵션은 없습니다.
이 워크플로를 사용하는 경우:
조직 구성원을 위해 추가 기능을 영구적으로 설치하려고 합니다.
조직 구성원에 대한 배포를 관리하려고 합니다.
경고 메모Microsoft Office용 Qlik 추가 기능 배포는 Qlik Cloud 테넌트에 대한 액세스와 연결되지 않습니다.Qlik Cloud에 대한 액세스 권한이 없는 사용자에게 추가 기능을 배포하면 해당 사용자는 추가 기능을 보고 시작할 수 있습니다.그러나 추가 기능은 사용자에게 Qlik Cloud에 로그인하라는 메시지를 표시합니다.로그인에 실패하면 기능이 차단됩니다.
다음 섹션을 순서대로 완료하세요.
Microsoft 365 관리 센터를 통해 배포 및 설치
중앙 집중식 배포는 Microsoft 365 시스템 관리자가 완료합니다.
다음과 같이 하십시오.
OAuth 클라이언트를 만든 후 추가 기능 매니페스트 파일 또는 매니페스트 URL을 가져옵니다.추가 기능 매니페스트 준비 및 획득 참조.
공식 Microsoft 문서인 Office 추가 기능 배포 및 게시에 따라 추가 기능을 배포합니다.중앙 집중식 배포를 통한 배포는 Microsoft 365 관리 센터를 통해서만 가능합니다.
위의 절차를 통해 추가 기능에 대한 액세스 권한이 부여된 사용자에 대해 추가 기능이 설치됩니다.그런 다음 사용자는 Excel, PowerPoint 또는 Word 버전에서 추가 기능을 활성화합니다.
중앙 집중식 배포 후 추가 기능 활성화
Microsoft 관리자가 조직을 위해 Qlik 추가 기능을 설치한 후, 액세스 권한이 부여된 경우 이를 활성화하고 사용할 수 있습니다.
사용 중인 Microsoft Office 앱 버전에 따라 이 단계는 약간 다를 수 있습니다. 자세한 내용은 공식 Microsoft 설명서를 참조하십시오.
설치에서 중앙 집중식 배포를 사용하는 경우 추가 기능을 제거하지 못할 수도 있습니다.이는 Microsoft 365 관리자가 사용하는 정책에 따라 다릅니다.
워크플로 2-4: 자체 관리형 설치 옵션
테스트 또는 체험 목적으로 추가 기능에 빠르게 액세스할 수 있는 적절한 방법은 사이드로딩 및 네트워크 공유 설치입니다.이는 프로덕션 및 엔터프라이즈 규모 사용 사례에 추가 기능을 배포하는 데 적합한 방법이 아닙니다.
경고 메모사이드 로딩 또는 네트워크 공유를 사용하여 추가 기능을 직접 설치하려면 조직 및 로컬 컴퓨터에서 권한이 필요할 수 있습니다.이러한 권한은 귀하의 조직 또는 Microsoft 365 관리자에 의해 관리될 수 있습니다.추가 기능을 직접 설치할 수 없는 경우, Office 추가 기능에 대한 공식 Microsoft 설명서를 참조하거나 시스템 관리자에게 문의하십시오.
경고 메모매니페스트를 다운로드하고 추가 기능을 사이드로드하는 것은 제한 없이 가능합니다.Qlik Cloud에 대한 액세스 권한이 없어도 매니페스트를 설치할 수 있습니다.그러나 설치 후 Qlik Cloud에 로그인하라는 메시지가 즉시 표시됩니다.로그인하지 않으면 추가 기능이 작동하지 않습니다.
Qlik Cloud 정부 메모
Office 365 Government Community Cloud High(GCCH)에서 Qlik의 Microsoft Office용 추가 기능은 중앙 집중식 배포를 통해서만 설치할 수 있습니다. 사이드로딩이나 네트워크 공유를 통한 설치는 지원되지 않습니다.
Excel, PowerPoint 또는 Word 버전 및 기타 요소에 따라 이러한 방법으로 로드된 추가 기능은 결국 리본 막대에서 제거될 수 있습니다.이 경우 매니페스트를 Microsoft Office 애플리케이션에 다시 업로드합니다.
워크플로 2: 웹에서 추가 기능 사이드로드
웹에서 Excel, PowerPoint 또는 Word를 사용하여 추가 기능을 사이드로드하려면 사용자가 매니페스트 파일을 브라우저에 업로드합니다.
사이드로딩은 Excel, PowerPoint 또는 Word의 Microsoft 365 웹 버전에서 지원됩니다.
추가된 각 Qlik 애드인은 단일 Qlik Cloud테넌트에서 애드인을 사용할 수 있도록 합니다.
동작 및 제한 사항은 다음과 같습니다:
귀하의 Excel, PowerPoint 또는 Word 애플리케이션에서는 단일 Qlik Cloud 테넌트에 연결된 하나의 애드인만 한 번에 사용할 수 있습니다.
여러 Qlik Cloud 테넌트용 추가 기능으로 작업해야 하는 경우, 사용하려는 추가 기능을 사용하기 직전에 직접 배포하거나 설치하여 테넌트 간에 전환해야 합니다.애드인이 이전에 선택한 테넌트에 계속 연결되어 있다면, Office 애플리케이션을 다시 시작하거나 브라우저 페이지를 다시 로드하십시오.
하나의 Qlik Cloud 테넌트에 Qlik 추가 기능을 중앙에서 배포하면 다른 테넌트에는 해당 추가 기능을 사이드로드할 수 없게 될 수 있습니다.
Microsoft Excel, PowerPoint 또는 Word 버전 및 사용 중인 브라우저에 따라 여러 추가 기능이 로드되면 리본 막대에 각 추가 기능에 대한 아이콘이 표시되거나 최근 배포된 인스턴스가 포함된 아이콘 하나만 표시될 수 있습니다.전자는 예를 들어 Microsoft Excel, PowerPoint, 또는 Word의 이전 버전을 사용할 때 발생할 수 있습니다.
Office 365 Government Community Cloud High(GCCH)에서 Qlik의 Microsoft Office용 추가 기능은 중앙 집중식 배포를 통해서만 설치할 수 있습니다. 사이드로딩이나 네트워크 공유를 통한 설치는 지원되지 않습니다. Office 365 GCC 및 GCCH는 단일 Qlik Cloud 정부 또는 Qlik Cloud 정부 - DoD 테넌트와 동시에 작업하는 것을 지원합니다.
사용자가 Microsoft Excel, Microsoft PowerPoint 또는 Microsoft Word용 보고 추가 기능에 인증을 시도할 때 인증 팝업 대화 상자가 비어 있을 수 있습니다. 또는 사용자가 대화 상자에서 오류(특히 12006)를 볼 수도 있습니다.
사용자가 Microsoft Office용 Qlik 추가 기능을 사용하려면 인증 흐름에는 테넌트와 다른 도메인에서 호스팅되는 ID 공급자 간의 리디렉션이 필요합니다. ID 공급자가 제한적인 설정으로 Cross-Origin-Opener-Policy를 설정하고 있습니다. 결과적으로 인증 흐름의 도메인 간 통신 부분이 차단되어 로그인 정보가 추가 기능에 올바르게 반환되지 않습니다.