--- title: "타임라인 위젯" slug: "timeline-widget" updated: 2026-10-22T17:18:32Z published: 2026-10-22T17:18:32Z canonical: "support.tulip.co/timeline-widget" --- > ## 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/timeline-widget). ::: ## 목적 타임라인 위젯은 튤립 테이블에 기록된 이벤트를 표시하는 대화형 위젯입니다. 가장 최근의 기록을 상단에 표시하여 항상 최신 정보를 확인할 수 있습니다. ![image](https://tulip.widen.net/content/w9asw7xkxy/web/Timelinewidget.gif?animate=true&u=hhrpm9) ## 설정 필수 입력 항목: - 집계 ID (Tulip 테이블 집계) - API 키 (텍스트) - 시크릿 (텍스트) - 계정 URL (텍스트) 선택 사항:- 흰색 텍스트 (예/아니오) - 글꼴 색상을 흰색으로 변경하려면 "예"로 설정하세요. 기본값은 "아니오"입니다. 이 위젯을 설정하려면 API 키, 시크릿 및 URL(예: `your-account.tulip.co`)을 입력해야 합니다. API 키가 무엇인지 모르신다면 다음 섹션을 참조하십시오.또는 앱 실행 전에 앱 편집기 내에서 위젯 속성에 정보를 직접 입력하여 위젯을 설정할 수도 있습니다.필요한 정보를 입력한 후 위젯을 새로 고침하십시오. 이 시점에서 테이블에 이벤트가 있다면 위젯에 표시되어야 합니다.이 위젯은 집계 기능을 사용합니다. 집계를 통해 위젯에 이벤트 정보가 채워집니다. 이 집계 기능이 없다면, 위젯을 최신 상태로 유지하기 위해 테이블에 이벤트가 삽입될 때마다 위젯을 새로 고쳐야 합니다. ### 서비스 계정 생성 방법 Feature rename Prior to r383, Service Accounts were called "API Tokens". 이벤트 테이블에 액세스하려면 `'테이블: 읽기'` 권한이 있는 서비스 계정이 있어야 합니다. 인스턴스의 설정 섹션으로 이동한 다음 'Tulip API'로 이동하여 해당 계정이 있는지 확인하십시오. 워크스페이스가 설정된 경우, 이 항목은 워크스페이스 설정 아래에 있을 수 있습니다.이미 서비스 계정이 있다면 해당 위치에 목록으로 표시됩니다. '편집'을 클릭하고 범위(scopes) 항목에서 `'테이블: 읽기'가` 선택되어 있는지 확인하십시오. 선택되어 있다면 준비가 완료된 것이며, 그렇지 않다면 범위를 조정하거나 새 서비스 계정을 생성하십시오.서비스 계정이 없는 경우, '서비스 계정 생성' 버튼을 클릭하여 생성하십시오. 원하는 이름을 지정한 후 범위를 선택하고, `'테이블: 읽기'가` 선택되어 있는지 확인하며, 필요에 따라 다른 범위도 선택하십시오. 가급적 필요한 최소한의 권한만 부여하는 것이 좋지만, 확실하지 않은 경우 모든 옵션을 선택해도 됩니다.'생성'을 클릭하면 비밀 키를 저장하라는 안내 창이 나타납니다. 이 안내를 반드시 따르십시오. 비밀 키를 분실하여 다시 생성해야 할 경우, 이전 비밀 키가 사용된 모든 위치에서 새 비밀 키로 업데이트해야 하기 때문입니다. ## 작동 방식 테이블에 새 레코드가 추가되면 위젯이 자동으로 업데이트됩니다. 가장 최근의 이벤트가 맨 위에 표시됩니다. 어두운 배경에서 위젯을 사용하는 경우 글꼴을 변경할 수 있습니다. 이 테이블은 `‘타임라인 이벤트’라고` 하며 다음과 같은 열로 구성됩니다:- ID (텍스트) - 이벤트의 고유 ID로, 자동으로 생성되어야 하며 표시용은 아니지만 필수 항목입니다.- 제목 (텍스트) - 이벤트의 제목으로, 더 크게 표시되므로 간결해야 합니다.- 설명 (텍스트) - 제목만으로는 내용이 충분히 전달되지 않을 경우, 제목 아래에 더 자세한 내용을 추가할 수 있습니다.- 유형 (텍스트) - 다음 중 하나를 선택하거나 비워둘 수 있습니다: `success, error, warning, message, andon, pause, start, stop, msteams` - 유형이 지정되지 않았거나 앞서 언급된 항목 중 어느 것도 아닌 경우 기본 아이콘이 표시됩니다 - 위젯에서는 대소문자를 구분하지 않고 처리됩니다- 생성 날짜 (메타데이터, 숨김) - Tulip table 의 각 레코드에는 수정할 수는 없지만 쿼리에서 사용할 수 있는 메타데이터(생성 날짜 및 업데이트 날짜)가 있습니다.