스킬 매트릭스

Prev Next

:::(Info)To download, visit: Library.
:::

스킬 매트릭스 위젯이란 무엇인가요?

스킬 매트릭스 위젯을 사용하면 매트릭스 형식의 표에서 사용자의 스킬과 업무 역량 수준을 시각화하고, 필터링하며, 관리할 수 있습니다.

Screenshot 2025-08-08 at 17.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레코드 목록Tulip API 설정 방법