Microsoft Excel용 Qlik 추가 기능 배포 및 설치

조직의 사용자가 보고서 템플릿을 만들 수 있도록 하려면 Microsoft Excel용 Qlik 추가 기능을 배포하고 설치합니다. 추가 기능으로 만들어진 보고서 템플릿을 Qlik Cloud 앱에 업로드하여 보고서 작업에서 보고서 출력을 만듭니다.

Qlik 추가 기능은 Microsoft 365 내에서 Microsoft Excel의 호환 가능한 웹 및 데스크톱 버전용으로 배포 및 설치할 수 있습니다.

추가 기능은 매니페스트 파일을 사용하여 설치됩니다. 이 매니페스트 파일은 Microsoft 365 관리자(또는 특정 설치 방법에서는 사용자)가 자신이나 조직의 사용자를 위해 추가 기능을 배포하고 설치하는 데 필요합니다. 매니페스트 파일을 사용하면 단일 Qlik Cloud 테넌트에 대한 추가 기능을 설치할 수 있습니다.

매니페스트 파일이나 URL을 가져오는 후, 추가 기능을 배포하고 설치하는 두 가지 방법이 있습니다.

• 중앙 집중식 배포: 중앙 집중식 배포, 설치 및 활성화

• 사이드로딩: 사이드로딩 또는 네트워크 공유를 사용하여 추가 기능 설치

추가 기능 매니페스트 준비 및 가져오기

Qlik Excel 추가 기능은 매니페스트 파일을 사용하여 Microsoft 환경에 설치됩니다. 이는 XML 파일입니다. 중앙 집중식 배포의 경우 Microsoft 관리자가 매니페스트 파일의 URL을 제공해야 할 수 있습니다.

매니페스트 파일은 단일 Qlik Cloud 테넌트에만 적용됩니다.

추가 기능을 설치하려면 OAuth 클라이언트 구성이 필요합니다. OAuth 클라이언트를 구성한 후 관리 활동 센터에서 매니페스트 파일 링크와 매니페스트 파일 자체를 가져옵니다.

다음과 같이 하십시오.

1. 필수 구성을 사용하여 Qlik Cloud 테넌트에 OAuth 클라이언트를 만듭니다. 전체 지침은 Microsoft Excel용 Qlik 추가 기능에 대한 OAuth 클라이언트 만들기를 참조하십시오.

2. 관리 활동 센터로 이동하여 매니페스트 링크를 생성합니다. 대체 사용 사례를 위해 매니페스트 파일을 직접 다운로드할 수도 있습니다. Microsoft Excel용 Qlik 추가 기능의 설치 매니페스트 관리를 참조하십시오.

Microsoft Excel용 Qlik 추가 기능에 대한 OAuth 클라이언트 만들기

Microsoft Excel용 Qlik 추가 기능을 설치하려면 OAuth 클라이언트 구성이 필요합니다. 추가 기능은 보고서 개발자가 Qlik Sense 앱에서 표 형식 보고서의 출력을 제어하는 보고서 템플릿을 준비하는 데 사용됩니다.

추가 기능에서 OAuth가 작동하려면 OAuth 클라이언트가 아래 표시된 정확한 구성으로 구성되어야 합니다.

다음과 같이 하십시오.

1. 관리 활동 센터의 Qlik Cloud에서 OAuth로 이동합니다.

2. 새로 만들기를 클릭합니다.

3. 클라이언트 유형 드롭다운 메뉴에서 단일 페이지 앱을 선택합니다. 더 많은 필드가 나타납니다.

4. 이름을 삽입합니다. 설명은 선택 사항입니다.

5. 최소한 user_default 범위를 포함하려면 확인란을 선택합니다. 구성에 다른 범위를 포함할 수 있지만 user_default가 없으면 설치가 작동하지 않습니다.

   사용할 수 있는 각 범위에 대한 자세한 설명은 OAuth 클라이언트 만들기를 참조하십시오.

6. 리디렉션 URL 추가 필드에 테넌트의 URL과 고정 문자열을 차례로 삽입합니다. /office-add-ins/oAuthLoginSuccess.html

   결과는 다음과 같아야 합니다. https://YourServer/office-add-ins/oAuthLoginSuccess.html

7. 추가를 클릭합니다.

8. 허용된 원본 추가 필드에 테넌트 URL을 입력하고 추가를 클릭합니다.

9. 만들기를 클릭합니다.

10. 클라이언트 ID 복사 창이 나타납니다. 클라이언트 ID를 클립보드에 복사하도록 선택하거나 완료를 클릭하여 창을 닫을 수 있습니다.

OAuth 클라이언트를 만든 후 관리 활동 센터에서 업데이트된 매니페스트 XML 파일에 대한 링크를 가져옵니다. 설정 페이지로 이동한 후 관리활동 센터 내에서 공유 및 보고서 > Excel 추가 기능으로 이동합니다. 이 링크를 사용하여 추가 기능을 배포하고 설치합니다.

중앙 집중식 배포, 설치 및 활성화

중앙 집중식 배포 및 설치를 통해 Qlik 추가 기능을 사용하는 것이 좋습니다. 중앙 집중식 배포에는 조직의 Microsoft 365 관리자의 개입이 필요합니다.

중앙 집중식 배포를 사용하면 추가 기능 매니페스트가 조직의 Microsoft 365 관리 센터에 로드되고 사전 구성된 설치로 사용자에게 배포됩니다. 배포는 특정 보안 그룹의 구성원으로 제한될 수 있습니다.

다음과 같은 경우 중앙 집중식 배포를 사용해야 합니다.

• 조직 구성원을 위해 추가 기능을 영구적으로 설치하려고 합니다.

• 조직 구성원에 대한 배포를 관리하려고 합니다.

전체 워크플로를 보려면 아래 절차 섹션을 따르십시오.

중앙 집중식 배포 및 설치

중앙 집중식 배포는 Microsoft 365 시스템 관리자가 완료합니다.

다음과 같이 하십시오.

1. OAuth 클라이언트를 만든 후 추가 기능 매니페스트 파일 또는 매니페스트 URL을 가져옵니다. 추가 기능 매니페스트 준비 및 가져오기를 참조하십시오.

2. 공식 Microsoft 문서인 Office 추가 기능 배포 및 게시에 따라 추가 기능을 배포합니다. 중앙 집중식 배포를 통한 배포는 Microsoft 365 관리 센터를 통해서만 가능합니다.

위의 절차를 통해 추가 기능에 대한 액세스 권한이 부여된 사용자에 대해 추가 기능이 설치됩니다. 그런 다음 사용자는 Microsoft Excel 버전에서 추가 기능을 활성화합니다.

중앙 집중식 배포 후 추가 기능 활성화

Microsoft 관리자가 조직에 Qlik 추가 기능을 설치한 후 액세스 권한이 부여된 경우 이를 활성화하고 사용할 수 있습니다.

Microsoft Excel 버전에 따라 이 단계가 약간 다를 수 있습니다. 자세한 내용은 공식 Microsoft 설명서를 참조하십시오.

다음과 같이 하십시오.

1. Excel의 데스크톱 또는 웹 버전을 엽니다.

2. 홈 > 추가 기능 > 추가 기능 다운로드로 이동합니다.

3. 대화 상자의 ADMIN MANAGED 탭에서 Qlik 추가 기능을 선택합니다.

Qlik 추가 기능 아이콘이 리본 막대에 추가됩니다.

Microsoft 365 프로그램용 추가 기능 보기, 관리 및 설치

추가 기능 제거

설치에서 중앙 집중식 배포를 사용하는 경우 추가 기능을 제거하지 못할 수도 있습니다. 이는 Microsoft 365 관리자가 사용하는 정책에 따라 다릅니다.

사이드로딩 또는 네트워크 공유를 사용하여 추가 기능 설치

테스트 또는 체험 목적으로 추가 기능에 빠르게 액세스할 수 있는 적절한 방법은 사이드로딩 및 네트워크 공유 설치입니다. 이는 프로덕션 및 엔터프라이즈 규모 사용 사례에 추가 기능을 배포하는 데 적합한 방법이 아닙니다.

Excel 버전 및 기타 요소에 따라 이러한 방법으로 로드된 추가 기능은 결국 리본 막대에서 제거될 수 있습니다. 이 경우 매니페스트를 Excel에 다시 업로드합니다.

옵션 1: 웹에서 추가 기능 사이드로드

웹에서 Excel 365를 사용하여 추가 기능을 사이드로드하려면 사용자가 매니페스트 파일을 브라우저에 업로드합니다.

사이드로딩은 Microsoft 365에서 제공하는 Excel 웹 버전에서 지원됩니다.

다음과 같은 경우 사이드로딩을 사용해야 합니다.

• 추가 기능에 빠르게 액세스해야 합니다.

• 추가 기능 기능을 별도로 테스트하려고 합니다.

• Microsoft 365 관리자의 개입 없이 추가 기능을 테스트하려고 합니다.

다음과 같이 하십시오.

1. 매니페스트 파일을 준비하고 다운로드합니다. 추가 기능 매니페스트 준비 및 가져오기를 참조하십시오.

2. 웹사이트(https://office.live.com/)에서 Microsoft Office를 엽니다.

3. 새 Excel 문서를 엽니다.

4. 리본에서 삽입 탭을 열고 추가 기능 섹션에서 Office 추가 기능을 선택합니다.

5. Office 추가 기능 대화 상자에서 내 추가 기능 탭을 선택하고 내 추가 기능 관리를 선택한 다음 내 추가 기능 업로드를 선택합니다.

6. 추가 기능 매니페스트 파일을 탐색한 다음 업로드를 선택합니다.

7. 필요한 경우 Qlik Cloud 계정에 로그인합니다.

사이드로드된 추가 기능 제거

사이드로드된 추가 기능을 제거하려면 해당 추가 기능을 사용 중인 웹 브라우저의 캐시를 지웁니다.

옵션 2: Windows 네트워크 공유를 사용하여 Excel 데스크톱 버전에 추가 기능 설치

중앙 집중식 배포 없이 Excel 데스크톱 버전에 추가 기능을 설치하려면 네트워크 공유를 설정하고 여기에 매니페스트를 로드하면 됩니다. 이 작업은 Windows 운영체제에서만 수행할 수 있습니다.

네트워크 공유를 통해 추가 기능을 사이드로드하려면 아래 지침을 따르십시오. 지침은 공식 Microsoft 설명서에서 채택되었습니다. 자세한 내용은 네트워크 공유에서 테스트하기 위한 사이드로드 Office 추가 기능 또는 기타 Microsoft 리소스를 참조하십시오.

1단계: 폴더 만들기 및 공유

다음과 같이 하십시오.

1. Qlik 추가 기능을 호스팅할 폴더를 만듭니다. 예: C:\Qlik Excel add-in

2. Windows 파일 탐색기에서 공유 폴더 카탈로그로 사용하려는 폴더의 상위 폴더 또는 드라이브 문자로 이동합니다. 예: C:\

3. 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성을 선택합니다.

4. 공유 탭을 열고 공유... 버튼을 클릭합니다.

   

5. 대화 상자 창에서 자신과 추가 기능을 공유할 다른 사용자 및/또는 그룹을 추가합니다. 폴더에 대해 최소한 읽기/쓰기 권한이 필요합니다. 공유할 사용자 선택을 마친 후 공유를 클릭합니다.

6. 폴더가 공유되었다는 확인 메시지가 표시되면 폴더 이름 바로 뒤에 표시되는 전체 네트워크 경로를 기록해 두십시오. 완료를 클릭하여 대화 상자 창을 닫습니다.

   

7. 닫기를 클릭하여 속성 대화 상자 창을 닫습니다.

2단계: 공유 폴더를 신뢰할 수 있는 카탈로그로 수동으로 구성

다음과 같이 하십시오.

1. 1. Excel 데스크톱 버전에서 새 통합 문서를 엽니다.

2. 파일 탭을 클릭한 다음 왼쪽 아래에서 옵션을 클릭합니다.

3. 보안 센터를 클릭한 다음 보안 센터 설정... 버튼을 클릭합니다.

   

4. 신뢰할 수 있는 추가 기능 카탈로그를 클릭합니다.

   

5. 카탈로그 URL 상자에 이전에 공유한 폴더의 전체 네트워크 경로를 입력합니다.

6. 카탈로그 추가를 클릭합니다.

7. 새로 추가된 항목에 대해 메뉴에 표시 확인란을 선택한 다음 확인을 클릭하여 보안 센터 대화 상자 창을 닫습니다.

   

8. 확인을 클릭하여 대화 상자 창을 닫습니다.

9. 변경 내용이 적용되도록 Excel을 닫았다가 다시 엽니다.

3단계: 추가 기능 사이드로드

다음과 같이 하십시오.

1. 추가 기능 매니페스트 XML 파일을 공유 폴더에 추가합니다.

2. Excel에서 리본의 삽입 탭에 있는 내 추가 기능을 클릭합니다.

3. Office 추가 기능 대화 상자 상단에서 공유 폴더를 클릭합니다.

4. 추가 기능을 삽입하려면 Qlik을 선택합니다.

5. 다음과 같은 대화 상자 창이 나타날 수 있습니다. Qlik이 새 창을 표시하려고 합니다. 허용을 클릭합니다.

네트워크 공유를 통해 설치된 추가 기능 제거

다음과 같이 하십시오.

1. Excel이 열려 있으면 닫습니다.

2. 이 폴더의 콘텐츠를 삭제합니다. %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

옵션 3: macOS용 Excel 데스크톱 버전의 추가 기능 사이드로드

macOS의 경우 추가 기능을 Microsoft 365의 Excel 데스크톱 버전에 설치할 수 있습니다. 시스템 및 소프트웨어 요구 사항은 시스템 및 소프트웨어 요구 사항을 참조하십시오.

전체 지침은 다음의 공식 Microsoft 문서를 참조하십시오. Mac의 Office에서 추가 기능 사이드로드

다음과 같이 하십시오.

1. 컴퓨터에서 Finder 응용 프로그램을 엽니다.

2. 다음 키보드 조합을 입력합니다. Command+Shift+G

   폴더로 이동 메뉴가 열립니다.

3. 다음 경로를 입력합니다.

   /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   wef 폴더가 컴퓨터에 아직 존재하지 않을 수도 있습니다. 그렇다면 이 위치에 만듭니다.

4. wef 폴더에 XML 매니페스트 파일의 복사본을 추가합니다.

5. Microsoft Excel를 엽니다. 이미 열려 있는 경우 다시 시작해야 합니다.

6. 리본 막대에서 홈 > 추가 기능으로 이동합니다.

7. Qlik 추가 기능을 선택합니다.

이제 리본 막대에서 Qlik 추가 기능을 사용할 수 있습니다.

macOS용 Excel 데스크톱 버전에서 사이드로드된 추가 기능 제거

Qlik 추가 기능을 제거하려면 컴퓨터에서 Office 캐시를 지워야 합니다. 자세한 내용은 다음을 참조하십시오.

• 사이드로드된 추가 기능 제거

• Office 캐시 지우기

Microsoft Excel에 여러 Qlik 추가 기능 추가

추가된 각 Qlik 추가 기능을 사용하면 단일 Qlik Cloud 테넌트에 추가 기능을 사용할 수 있습니다. 다중 테넌트로 작업하려면 각 개별 테넌트에 대한 추가 기능 매니페스트를 배포해야 합니다. 중앙 집중식 배포는 하나의 Qlik Cloud 테넌트에만 지원됩니다.

Microsoft Excel 버전과 사용 중인 브라우저에 따라 여러 추가 기능이 로드되면 리본 막대에 각 추가 기능에 대한 아이콘이 표시되거나 최근 배포된 인스턴스가 포함된 아이콘 하나만 표시될 수 있습니다.

다음과 같이 하십시오.

1. Microsoft 365 관리 센터를 사용하여 추가 기능을 중앙에서 배포하는 경우 권장 워크플로를 사용하여 최대 하나의 Qlik Cloud 테넌트에 대한 추가 기능을 설치합니다. 중앙 집중식 배포, 설치 및 활성화를 참조하십시오.

2. 나머지 테넌트의 경우 사이드로드를 사용하여 추가 기능을 설치하고 배포합니다. 사이드로딩 또는 네트워크 공유를 사용하여 추가 기능 설치를 참조하십시오.

테넌트 추가 기능이 리본 막대에 표시되지 않는 경우 해당 특정 테넌트에 대한 설치 절차를 반복하고 브라우저 페이지를 새로 고칩니다.

문제 해결

이 섹션에서는 일반적인 배포 및 설치 문제를 해결하기 위한 팁을 제공합니다.

추가 문제해결 팁은 문제 해결 - 앱 내 보고를 참조하십시오.

Microsoft Excel: Qlik 추가 기능 배포 후 인증 중에 표시되는 빈 대화 상자

사용자가 추가 기능에 인증을 시도할 때 인증 팝업 대화 상자가 비어 있을 수 있습니다. 또는 사용자가 대화 상자에서 오류(특히 12006)를 볼 수도 있습니다.

가능한 원인  

사용자가 Microsoft Excel용 Qlik 추가 기능을 사용하려면 인증 흐름에는 테넌트와 다른 도메인에서 호스팅되는 ID 공급자 간의 리디렉션이 필요합니다. ID 공급자가 제한적인 설정으로 Cross-Origin-Opener-Policy를 설정하고 있습니다. 결과적으로 인증 흐름의 도메인 간 통신 부분이 차단되어 로그인 정보가 추가 기능에 올바르게 반환되지 않습니다.

제안 조치  

다음 해결 방법은 ID 공급자 설정을 담당하는 네트워크 관리자가 수행해야 합니다.

다음과 같이 하십시오.

• IDP에서 대화 상자로의 응답 헤더를 다음과 같이 설정합니다.

  Cross-Origin-Opener-Policy: unsafe-none

자세한 내용은 공식 Microsoft 문서인 Office 대화 상자 API - 규칙 및 정보를 참조하십시오.