Qlik Cloud에 앱 연결하기
Qlik Cloud에 앱을 연결해 Lovable 앱에서 Qlik Sense 앱을 둘러보고, 리포트 데이터를 내보내고, Insight Advisor에 질문하고, 리로드를 실행하세요.
Qlik Cloud는 Qlik의 분석 플랫폼으로, Qlik 앱에 데이터 모델, 시트, 차트가 담겨 있습니다. Qlik Cloud 커넥터를 사용하면 Lovable 앱이 테넌트에 있는 Qlik 앱과 데이터 모델의 카탈로그를 읽고, Qlik의 Reporting 서비스를 통해 차트와 표 데이터를 내보내고, 일상 언어로 Insight Advisor에 질문하고, Qlik 앱 리로드(reload)를 실행할 수 있습니다.
Qlik Cloud는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
Qlik Cloud를 사용하면 앱에서 다음과 같은 작업이 가능합니다.
- 테넌트의 Qlik 앱과 스페이스 목록을 조회하고 각 Qlik 앱의 테이블과 필드 읽기
- Qlik의 Reporting 서비스를 통해 차트나 표를 Excel 파일로, 시트 전체를 PDF로 내보내기
- Qlik 앱에 관한 질문을 Insight Advisor에 보내고, 서술형 답변과 함께 반환된 차트가 있으면 표시하기
- Qlik 앱 리로드를 시작하고 리로드 기록 확인하기
분석 팀이 이미 관리하는 Qlik 앱과 데이터가 앱에 필요할 때 Qlik Cloud를 사용하세요. 앱에서 Qlik 데이터를 실시간으로 쿼리할 수는 없습니다. 앱은 데이터 행을 Excel 파일로 내보내 받기 때문에, 이 커넥터는 리포팅, 내보내기, 카탈로그 도구에 적합합니다.
주요 활용 사례 및 예시 앱
Qlik Cloud로 다음과 같은 내부 리포팅·운영 도구를 만들 수 있습니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| Qlik 앱 카탈로그 탐색기 | Qlik Cloud를 사용해서 내 Qlik 앱 목록과 각 앱의 테이블, 필드를 보여 주는 카탈로그 탐색기를 만들어줘. | Qlik에 무엇이 있는지 팀이 한곳에서 보게 합니다. 앱이 테넌트의 Qlik 앱 목록을 보여 주고 각 Qlik 앱의 데이터 모델을 읽습니다. |
| 온디맨드 리포트 내보내기 | Qlik Cloud를 사용해서 내 Qlik 앱의 판매 테이블을 필요할 때 Excel로 내보내고 다운로드 기록을 보여 주는 페이지를 만들어줘. | Qlik을 열지 않고도 팀이 Excel 파일을 받게 합니다. 앱이 리포트 요청을 보내고 Qlik이 파일을 만들 때까지 기다린 뒤 다운로드할 수 있게 합니다. |
| Insight Advisor Q&A 페이지 | Qlik Cloud를 사용해서 질문을 입력하면 내 Qlik 앱에서 답을 보여 주는 Q&A 페이지를 만들어줘. | 지표에 관한 질문에 일상 언어로 답합니다. 앱이 각 질문을 Insight Advisor로 보내고 서술형 답변과 반환된 차트를 보여 줍니다. |
| 리로드 상태 보드 | Qlik Cloud를 사용해서 내 Qlik 앱의 리로드 상태를 보여 주고 리로드를 실행하는 버튼이 있는 페이지를 만들어줘. | 데이터가 최신인지 추적하고 필요할 때 새로 고칩니다. 앱이 각 Qlik 앱의 마지막 리로드와 리로드 기록을 읽고, 버튼을 클릭하면 새 리로드를 시작합니다. |
| 주간 시트 요약 | Qlik Cloud를 사용해서 매주 월요일 KPI 시트를 PDF로 내보내고 최근 8개 사본을 보관하는 페이지를 만들어줘. | 핵심 시트를 날짜별로 보관합니다. 앱이 일정에 따라 시트를 PDF로 내보내고 파일을 저장합니다. |
| 스페이스 인벤토리 | Qlik Cloud를 사용해서 Qlik 스페이스별로 어떤 앱이 있고 언제 마지막으로 리로드됐는지 보여 주는 인벤토리를 만들어줘. | 테넌트가 어떻게 구성되어 있는지 파악합니다. 앱이 Qlik 앱을 스페이스별로 묶고 각 Qlik 앱의 소유자와 마지막 리로드 시간을 보여 줍니다. |
Qlik Cloud 연결 작동 방식
Lovable은 커넥터 게이트웨이를 통해 Qlik Cloud를 호출합니다. 게이트웨이는 자격 증명을 안전하게 저장하고 액세스 토큰을 자동으로 갱신합니다. 앱 코드에는 Qlik 자격 증명이 필요하지 않습니다.
모든 호출은 테넌트에 만든 M2M(machine-to-machine) OAuth 클라이언트로 실행됩니다. Qlik은 모든 M2M 클라이언트를 Tenant Admin 역할의 권한으로 실행하므로, 연결을 쓰는 모든 사람은 게시된 앱을 통한 사용을 포함해 테넌트의 모든 공유 스페이스를 읽을 수 있습니다. 스페이스 멤버십으로는 연결이 읽을 수 있는 범위를 제한할 수 없습니다. 커넥터는 앱 사용자마다 따로 Qlik에 로그인시키지 않습니다.
게이트웨이는 모든 읽기 요청을 테넌트로 전달합니다. 쓰기 요청은 리포트 내보내기 생성, 리로드 시작, Insight Advisor 질문의 세 종류만 전달합니다. 사용자, 스페이스, OAuth 클라이언트 변경 같은 그 밖의 쓰기 요청은 거부되므로 테넌트 관리는 Qlik 안에서만 이루어집니다.
프로젝트 채팅에서 Lovable은 이 세 가지 쓰기 요청을 실행할 때마다 먼저 승인을 요청합니다. Qlik 데이터를 변경하지 않는 리포트 내보내기와 Insight Advisor 질문도 마찬가지입니다. 그 밖의 읽기 요청은 묻지 않고 실행합니다. Always allow를 선택하면 Lovable은 해당 연결에서 리로드도 묻지 않고 시작합니다. 프로젝트 채팅에서 커넥터 작업 승인하기를 참고하세요. 게시된 앱은 승인을 요청하지 않습니다.
Qlik Cloud 연결은 테넌트의 모든 공유 스페이스에 있는 모든 Qlik 앱과 테넌트의 사용자 디렉터리를 읽을 수 있으며, Qlik에서 이 범위를 좁힐 수 없습니다. 이 데이터를 모두 봐도 되는 사람에게만 연결을 공유하세요. 클라이언트에는 user_default 스코프만 주고, Qlik 관리 API까지 앱에 열어 주는 admin_classic 스코프는 피하세요.
Qlik Cloud 연결 방법
Qlik Cloud 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이기 때문입니다.
서로 다른 OAuth 클라이언트로 Qlik Cloud 연결을 여러 개 만들 수 있습니다. Qlik 테넌트를 둘 이상 연결할 때 유용합니다.
연결이 만들어지면 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 요구사항
Qlik Cloud를 연결하기 전에 다음을 준비하세요.
*.qlikcloud.com호스트 이름을 쓰는 Qlik Cloud 테넌트(예:yourtenant.us.qlikcloud.com). Qlik Cloud Government 테넌트나 온프레미스 Qlik Sense 같은 다른 호스트는 커넥터가 받아들이지 않습니다- OAuth 클라이언트를 만들어 줄 Qlik 테넌트 admin. OAuth 클라이언트를 만들려면 Tenant Admin 역할이 필요합니다
- Lovable 워크스페이스에서 연결을 만들 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
Qlik Cloud 구독, 용량, Reporting 서비스 사용 권한은 Lovable 청구와 별개입니다. Qlik은 리포트 생성을 분당 약 10회로 제한하고 생성된 파일을 1시간 뒤에 만료시키므로, 앱에서 나중에 필요한 내보내기 파일은 따로 저장하세요.
1단계: Qlik Cloud에서 M2M OAuth 클라이언트 만들기
Qlik 테넌트 admin에게 다음 단계를 진행해 달라고 요청하세요. 클라이언트는 테넌트에서 Tenant Admin 권한을 가진 서비스 사용자로 동작하므로, 클라이언트 시크릿을 admin 비밀번호처럼 다뤄야 합니다.
OAuth 클라이언트 페이지 열기
Qlik Cloud 테넌트에 로그인하고 Administration 활동 센터를 연 다음 Integration 아래의 OAuth로 이동합니다. Qlik의 OAuth 클라이언트 만들기 가이드를 참고하세요.
클라이언트 만들기
Create new를 클릭합니다. 클라이언트 유형으로 Web을 고르고, Lovable connector 같은 이름을 입력하고, user_default 스코프를 선택한 뒤 **Allow Machine-to-Machine (M2M)**을 활성화합니다. Authentication method는 Client secret으로 둔 채 저장합니다.
클라이언트 ID와 시크릿 복사
Qlik은 클라이언트 시크릿을 클라이언트를 만들 때 한 번만 보여 줍니다. 클라이언트 ID와 클라이언트 시크릿을 복사합니다.
클라이언트 시크릿은 비밀번호처럼 작동합니다. 안전하게 보관하고 Lovable의 연결 양식에만 붙여 넣으세요. 프롬프트나 채팅 메시지, 앱 코드에는 넣지 마세요.
동의 방식을 Trusted로 설정
OAuth 클라이언트 목록에서 새 클라이언트의 메뉴를 열고 Change consent method를 선택한 다음 Trusted를 선택합니다. Qlik은 클라이언트를 만든 뒤에만 이 변경을 허용합니다.
동의 방식이 Trusted가 아닌 클라이언트는 M2M 접근용 토큰을 발급할 수 없으며, Lovable에서 Connect를 클릭하면 Qlik Cloud did not validate your credentials. 메시지와 함께 실패합니다.
테넌트 호스트 이름 확인
Qlik Cloud에서 프로필 아이콘을 클릭하고 About을 선택합니다. Tenant hostname 아래의 값을 복사합니다(예: yourtenant.us.qlikcloud.com). 테넌트에 별칭 호스트 이름이 있더라도 테넌트 호스트 이름을 사용하세요. Qlik은 테넌트 호스트 이름을 절대 바꾸지 않으며 통합에 이 이름을 쓰도록 권장합니다.
2단계: Qlik Cloud를 Lovable에 연결
연결 양식을 열고 1단계에서 준비한 값을 입력합니다.
Connectors에서 Qlik Cloud 열기
Connectors를 열고 Qlik Cloud를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 접을 수 있는 Details, Configure connection, Sharing 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다(예: Qlik Cloud Sales). 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다.
자격 증명 입력
Configure connection 아래에 다음 값을 입력합니다.
- Tenant hostname: 1단계에서 확인한 호스트 이름만 입력합니다. 예를 들어
yourtenant.us.qlikcloud.com입니다.https://나 경로가 포함된 값은 양식에서 거부됩니다 - Client ID: 1단계에서 만든 M2M OAuth 클라이언트의 클라이언트 ID입니다
- Client secret: 클라이언트 ID와 함께 발급된 클라이언트 시크릿입니다
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
접근 권한이 있는 모든 사람은 같은 서비스 사용자로 Qlik을 읽습니다. 자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 테넌트에 토큰을 요청하고 클라이언트 자신의 사용자 레코드를 읽어 자격 증명을 확인합니다.
연결을 프로젝트에 링크한 뒤 Lovable에게 사용 가능한 Qlik 앱 목록을 보여 달라고 요청하세요.
연결되면 프로젝트에서 빌드하는 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 Qlik Cloud에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한에 따라). 그러면 Lovable 앱이 빌드 중에도, 게시한 뒤에도 Qlik 앱과 데이터 모델 목록을 조회하고, 리포트 데이터를 내보내고, Insight Advisor에 질문하고, 리로드를 시작할 수 있습니다.
클라이언트 시크릿이 바뀌면 Lovable에서 연결을 열고 Configure connection 아래의 Update를 클릭해 시크릿을 교체하세요.
제한 사항
Qlik Cloud로 빌드할 때는 다음 제한을 염두에 두세요.
- 지원되는 호스트. 테넌트 호스트 이름은
.qlikcloud.com으로 끝나야 합니다. Qlik Cloud Government와 온프레미스 Qlik Sense를 포함한 다른 호스트는Must be a bare *.qlikcloud.com hostname (no https:// or path)오류와 함께 거부됩니다. - 실시간 쿼리 불가. 표를 필터링하거나 합계를 다시 계산하는 것처럼 앱에서 Qlik 데이터를 실시간으로 쿼리할 수는 없습니다. 데이터 행이 필요하면 앱이 Excel 파일로 내보내야 합니다. Qlik이 파일 하나를 만드는 데 몇 초가 걸립니다.
- 시트·차트 목록 조회 불가. 커넥터는 Qlik 앱 안의 시트와 차트 목록을 조회할 수 없습니다. 시트나 차트를 내보내려면 Lovable에게 해당 ID를 알려 주세요. ID는 차트의 Share → Embed 대화상자와 시트의 Embed sheet 대화상자에서 확인할 수 있습니다.
- 세 종류의 쓰기만 허용. 앱은 리포트 내보내기 생성, 리로드 시작, Insight Advisor 질문만 할 수 있습니다. 연결을 통해 Qlik 앱, 스페이스, 사용자, 기타 테넌트 설정을 만들거나 변경할 수 없습니다.
- 테넌트 전체에 미치는 공유 ID. 연결을 쓰는 모든 사람은 같은 서비스 사용자로 Qlik을 읽으며, 이 사용자는 테넌트의 모든 공유 스페이스를 볼 수 있습니다. 커넥터는 사용자별 Qlik 로그인을 지원하지 않으며 앱 사용자마다 데이터를 제한하지도 않습니다.
- Qlik Answers 테넌트에서는 Insight Advisor 사용 불가. Qlik Answers 에이전트형 경험을 사용하는 테넌트에서는 Qlik이 통합을 포함해 Insight Advisor를 비활성화합니다. Q&A 페이지는 여전히 Insight Advisor를 사용하는 테넌트에서만 만드세요. Qlik은 Qlik 앱에 관해 Qlik Answers에 질문하는 공개 API를 제공하지 않으므로 커넥터가 Qlik Answers를 대신 사용할 수도 없습니다.
- Qlik 시트 임베드 불가. 이 구성은 앱 자체 인터페이스에 쓸 카탈로그 데이터, 내보낸 파일, Insight Advisor 답변을 반환합니다. Qlik 시트나 차트를 앱에 임베드하지는 않습니다.
Qlik Cloud 연결 관리
연결은 Connectors에서 관리합니다. **Qlik Cloud**를 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 사용할 수 있게 두고 특정 프로젝트의 Qlik Cloud 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 링크 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 링크된 모든 프로젝트에서 자격 증명이 제거되고, Qlik Cloud를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.