> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/dashboard/dashboard.md).

# 대시보드

대시보드에서는 워크스페이스에 업로드한 JSON 파일이나 **스페이스**의 **컬렉션** 데이터를 차트와 KPI로 시각화하는 위젯을 만들고 관리할 수 있습니다.

## 사전 조건

위젯을 만들려면 워크스페이스에 다음 중 하나가 있어야 합니다.

* **파일**에 업로드된 JSON 파일
* **스페이스**에 있는 컬렉션

## 대시보드 열기

1. 워크스페이스 안에서 임의의 탭을 선택하십시오.
2. 사이드바에서 **대시보드**를 클릭하십시오.

## 위젯 만들기

1. 대시보드 화면에서 **새 위젯**을 클릭하십시오.
2. **데이터 소스**에서 **파일** 또는 **컬렉션**을 선택한 뒤, 대상 데이터를 지정하십시오.
3. **컬렉션**을 선택한 경우, 차트로 만들 행을 선택하십시오. 컬렉션의 최상위 행뿐 아니라 필요하면 하위 컬렉션의 행도 선택할 수 있습니다.
4. 차트 종류를 선택하십시오.

   | 종류    | 용도                         |
   | ----- | -------------------------- |
   | 선 차트  | 순서나 시계열 데이터의 추이를 표시합니다     |
   | 막대 차트 | 카테고리별 값을 비교합니다             |
   | 도넛    | 전체에 대한 각 카테고리의 비율을 표시합니다   |
   | 테이블   | 집계 열을 나열하여 데이터를 목록으로 표시합니다 |
   | KPI   | 단일 집계 값을 크게 표시합니다          |
5. 선택한 종류에 따라 X축·Y축·레이블·값·그룹화·열 등의 필드를 설정하십시오.
6. **미리 보기**에서 차트를 확인하고 **저장**을 클릭하십시오.

### AI로 위젯 만들기

1. 위젯 대화상자 오른쪽 위에서 **AI로 위젯 만들기**를 클릭합니다.
2. **데이터 소스**에서 시각화할 파일 또는 컬렉션을 선택합니다.
3. 컬렉션을 선택한 경우, 차트로 만들 행을 선택합니다.
4. 만들고 싶은 차트를 자연어로 설명합니다.
5. **미리 보기**에서 생성된 차트를 확인합니다.
6. 수동으로 세부 설정을 조정하려면 **수동 양식으로 돌아가기**를 클릭합니다.
7. 내용이 괜찮으면 **저장**을 클릭합니다.

{% hint style="info" %}
AI가 업데이트하는 것은 라이브 미리 보기뿐입니다. 위젯은 **저장**을 클릭하기 전까지 실제로 저장되지 않습니다.
{% endhint %}

<figure><img src="/files/bn5sabnzGQVXwWYw2N9g" alt="위젯 만들기 다이얼로그（막대 차트, 미리 보기 표시）"><figcaption><p>위젯 만들기 다이얼로그（막대 차트, 미리 보기 표시）</p></figcaption></figure>

{% hint style="info" %}
**파일**을 데이터 소스로 선택할 때 특정 버전을 지정하면 그 버전이 고정됩니다. 버전을 지정하지 않으면 항상 파일의 최신 버전이 참조됩니다.
{% endhint %}

<figure><img src="/files/TV7SiQ9JWy06vrIxOXlR" alt="대시보드（위젯 목록）"><figcaption><p>대시보드（위젯 목록）</p></figcaption></figure>

## 위젯 관리하기

각 위젯 제목 표시줄 오른쪽 끝의 작업 메뉴(`⋮`)에서 다음 작업을 실행할 수 있습니다.

* **확대 보기**: 위젯을 크게 표시합니다.
* **편집**: 위젯 이름·데이터 소스·차트 설정을 변경합니다.
* **복제**: 같은 설정의 위젯을 대시보드에 추가합니다.
* **크기 조정**: 가로 너비를 **작게 (1/3)**·**중간 (2/3)**·**전체 너비** 중에서 선택합니다.
* **삭제**: 위젯을 대시보드에서 삭제합니다.

### 위젯 순서 변경하기

위젯 왼쪽 끝의 그립 아이콘을 드래그하여 표시 순서를 변경할 수 있습니다.

{% hint style="info" %}
대시보드는 워크스페이스 전체에서 공유됩니다. 위젯의 작성·편집·순서 변경은 워크스페이스의 모든 멤버에게 반영됩니다.
{% endhint %}

## 문제 해결

위젯에 오류가 표시된 경우 다음 표를 참조하십시오.

| 오류 메시지                          | 원인 및 대처                                                   |
| ------------------------------- | --------------------------------------------------------- |
| 소스 파일을 더 이상 사용할 수 없습니다.         | 데이터 소스로 설정한 파일이 삭제되었습니다. 위젯을 편집하여 다른 파일을 선택하십시오.          |
| 고정된 버전을 더 이상 사용할 수 없습니다.        | 고정한 버전이 삭제되었습니다. 위젯을 편집하여 버전을 업데이트하십시오.                   |
| 파일이 너무 커서 시각화할 수 없습니다(1 MB 초과). | JSON 파일이 1 MB를 초과합니다. 파일을 분할하거나 데이터 양을 줄여 다시 업로드하십시오.     |
| 파일을 JSON으로 읽을 수 없습니다.           | 파일이 유효한 JSON 형식이 아닙니다. 파일 내용을 확인하십시오.                     |
| 데이터 행이 너무 많아 시각화할 수 없습니다.       | 배열 행 수가 상한(100,000행)을 초과합니다. 데이터를 분할하여 다시 업로드하십시오.        |
| 이 위젯이 사용하는 필드가 더 이상 데이터에 없습니다.  | 파일 업데이트로 스키마가 변경된 경우에 발생합니다. 위젯을 편집하여 필드를 다시 설정하십시오.      |
| 소스 컬렉션을 더 이상 사용할 수 없습니다.        | 데이터 소스로 설정한 컬렉션이 보관되었거나 삭제되었습니다. 위젯을 편집하여 다른 컬렉션을 선택하십시오. |
| 선택한 행이 더 이상 데이터에 없습니다.          | 선택한 행 소스나 하위 컬렉션을 더 이상 사용할 수 없습니다. 위젯을 편집하여 다른 행을 선택하십시오. |
| 이 위젯이 사용하던 필드가 보관되었습니다.         | 컬렉션 위젯에서 사용하던 필드가 보관되었습니다. 위젯을 편집하여 다른 필드를 선택하십시오.        |

## 참고 링크

* [파일](/features-ko/resources-context/files.md)
* [스페이스](/features-ko/spaces/about-spaces.md)
* [조직 대시보드](/features-ko/settings/organization-settings/organization-dashboard.md)