--- title: "스킬 매트릭스" slug: "skill-matrix" updated: 2026-10-22T17:13:53Z published: 2026-10-22T17:13:53Z canonical: "support.tulip.co/skill-matrix" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 스킬 매트릭스 :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## 스킬 매트릭스 위젯이란 무엇인가요? **스킬 매트릭스 위젯을** 사용하면 매트릭스 형식의 표에서 사용자의 스킬과 업무 역량 수준을 시각화하고, 필터링하며, 관리할 수 있습니다. ![Screenshot 2025-08-08 at 17.32.49.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-08-08%20at%2017.32.49.png) ### 이 위젯을 사용하여 다음을 수행할 수 있습니다: - 운영자의 기술을 추적하고 부족한 부분을 파악 - 사용자, 그룹, 작업 또는 수준별로 기술 확인 - 기술 데이터를 동적으로 필터링 - 매트릭스 셀을 조작하여 상세 기록을 확인하거나 작업을 실행 이 가이드에서는 **Tulip에서** ‘기술 매트릭스(Skill Matrix)’ 위젯을 설정하고 사용하는 방법을 설명합니다. --- ## 필수 준비 사항 시작하기 전에 다음 사항이 준비되어 있는지 확인하십시오: - **Tulip 계정** 접속 권한 - **서비스 계정을 조회하고** **테이블을 관리할** 수 있는 권한 - **Tulip 계정 URL** 및 **워크스페이스 ID** --- ## 1. 필수 매개변수 구성 ### 1.1 서비스 계정 확인 Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. Tulip 화면 우측 상단의 **사용자 아이콘을** 클릭합니다. 2. **'계정 설정**'으로 이동합니다. 3. 왼쪽 메뉴에서 **‘Tulip API’를** 클릭합니다. 4. **'서비스 계정 생성'을** 클릭합니다. 5. 서비스 계정 이름을 지정하세요(예: `SkillMatrixWidget`). 6. 다음 범위를 할당하세요: 7. `table-queries:read` 8. `tables:read` 9. `tables:write` 10. `users:read` 11. **'생성'을** 클릭하십시오. 12. **인증 헤더** 를 복사하되, `'Basic'이라는` 단어와 그 뒤에 있는 공백은 **제거하십시오**. 13. 위젯을 구성할 때: **서비스 계정에** 대해 **'변수'와** **'정적 값'** 중 하나를 선택하라는 메시지가 표시되면 **'정적 값'을** 선택하고 자격 증명 **(Basic 제외)** 을 필드에 직접 붙여 넣으세요. Caution Never share your Service Account credentials publicly. --- ### 1.2 Tulip 계정 URL 찾기 계정 URL은 대개 다음과 같은 형식입니다: `your-account.tulip.co` --- ### 1.3 작업 테이블 ID 찾기 1. Tulip의 **‘테이블(Tables** )’ 섹션으로 이동합니다. 2. 해당 **작업 테이블**을 클릭하세요. 3. 상세 정보 섹션에서 **테이블 UID** 를 복사합니다. --- ### 1.4 필드 ID 확인 다음 항목에 대한 **필드 ID** 를 찾으십시오: - 사용자(예: 이름 또는 사용자 ID) - 기술/작업 이름 - 기술 수준 필드의 ID를 찾으려면: 1. 테이블을 엽니다. 2. 열 머리글을 클릭합니다. 3. 속성 패널에서 **필드 ID** 를 확인합니다. Tip There are no enforced default names for these fields; you must decide which of your fields will be treated as user/skill/level when configuring the widget. --- ## 2. 선택적 매개변수 구성 다음 선택적 매개변수를 사용하여 위젯을 더욱 세부적으로 사용자 지정할 수 있습니다: - **그룹 필드 ID**: 팀, 부서 등으로 데이터를 분류합니다. - **설계 상태**: 상태(예: 활성, 완료)별로 필터링합니다. - **레벨 색상**: 다양한 숙련도 수준에 사용자 지정 색상을 할당합니다. --- ### 2.1 필터 매트릭스에 표시될 데이터를 사용자 정의하기 위해 선택적 필터를 추가할 수 있습니다. | 필터 | 설명 | | --- | --- | | **제목** | 기본적으로 **'제목'** 필터는 일반적으로 그룹, 기술 이름 또는 작업 범주 필드를 가리킵니다. | | **표시** | 레코드의 표시 여부를 제어합니다. 기본값은 `true입니다`. | :::(정보) (참고) 필터는 선택 사항이며 사용 사례에 맞게 설정해야 합니다. 여러 ‘ fields ’에 대한 필터를 구성할 수 있으며, 설정 후 필요 없는 필터는 쉽게 비활성화할 수 있습니다. 활성화된 필터만 데이터에 영향을 미칩니다. ::: --- ### 2.2 고급 구성 #### API 쿼리 필터 사용자 정의 API 필터 쿼리를 사용하여 표시될 레코드를 제어할 수 있습니다. Note When you apply multiple filter conditions, they are combined using a logical **AND**. This means **all conditions must be true** for a record to be returned. **쿼리 예시:**`json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}` **API 제한:** 로드되는 행 수를 제한합니다. ### 2.3. 워크스페이스 ID 설정 - **워크스페이스 ID는** Tulip URL의 `/w/` 뒤에 있습니다 `.` 예:`https://your-account.tulip.co/w/DEFAULT` → 워크스페이스 ID는 `DEFAULT입니다.` - 기본 워크스페이스의 경우 `DEFAULT를` 사용하거나 필드를 비워 둡니다. ## 3. 스킬 매트릭스 위젯 사용 ### 3.1. 스킬 데이터 보기 설정이 완료되면 위젯에는 다음 항목으로 구성된 매트릭스가 표시됩니다: - 사용자 - 작업 또는 기술 - 해당 기술 수준 내장된 드롭다운 필터(그룹, 기술, 레벨)를 사용하여 표시 범위를 좁힐 수 있습니다. ### 3.2. 새로 고침 및 필터 적용 - **'필터 지우기'를** 클릭하여 모든 필터 선택 항목을 제거하십시오. - **'다시 불러오기'를** 클릭하여 데이터를 업데이트하십시오. ### 3.3. 사전 필터링 사전 필터는 다음을 기준으로 데이터를 동적으로 필터링합니다: - 현재 로그인된 사용자 - 선택된 팀 또는 부서 - 날짜 범위 또는 근무 교대 Tip Use pre-filters to personalize views for operators or supervisors. ## 4. 대화형 동작을 위한 트리거 추가 사용자가 셀을 클릭할 때 작업이 실행되도록 위젯을 구성할 수 있습니다. 1. **'트리거** ' 패널을 엽니다. 2. 셀을 클릭할 때 **레코드 ID** 에 대한 동작을 설정합니다. 3. **'레코드 불러오기'를** 활성화하여 사용자 또는 기술에 대한 자세한 정보를 표시합니다. ## 팁 - 오타가 없도록 **테이블** 및 **필드 ID를** 다시 한 번 확인하십시오. - 필터를 사용하여 역할별로 대시보드를 맞춤 설정하세요. - 실제 환경에 적용하기 전에 모의 데이터로 테스트하십시오. ## 문제 해결 | 문제 | 가능한 원인 | 권장 해결 방법 | | --- | --- | --- | | 매트릭스가 로드되지 않음 | API 자격 증명 또는 URL이 올바르지 않음 | 인증 정보/URL을 다시 확인하십시오 | | 데이터가 표시되지 않음 | 필터 조건이 너무 엄격함 | 필터를 제거하거나 조건을 완화하십시오 | | "정의되지 않음" 필드 | 잘못된 필드 ID 사용 | 테이블 필드 ID를 확인하십시오 | | 셀을 클릭할 수 없음 | 트리거가 구성되지 않았습니다 | 위젯에서 트리거 설정 | ## 추가 정보: [Tulip Table](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[레코드 목록](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[Tulip API 설정 방법](https://support.tulip.co/docs/set-up-a-tulip-api)