# 독립 실행형 보고서 디자이너 시작하기

## Content

독립 실행형 보고서 디자이너는 새 보고서 템플릿을 작성하거나 기존 보고서 템플릿을 수정하기 위한 기본 도구인 크로스 플랫폼 데스크톱 응용 프로그램입니다.

### **설치**

Windows, Mac, Linux를 위한 독립 실행형 보고서 디자이너를 지원합니다. 패키지를 다운로드하고, 다운로드한 압축 파일의 압축을 풀고, `designer` 폴더에서 설치 프로그램 파일을 찾아 실행합니다.

* [ActiveReportsJS 다운받기](https://www.grapecity.co.kr/download/activereportsjs)

| **운영체제** | **설치 프로그램 파일** | **설치 프로그램 유형** |
| ---- | ---------- | ---------- |
| Windows | ActiveReportsJS-Designer.exe | [Windows Installer](https://en.wikipedia.org/wiki/Windows_Installer) |
| Mac OS | ActiveReportsJS-Designer.dmg | [Apple Disk Image](https://en.wikipedia.org/wiki/Apple_Disk_Image) |
| Desktop Linux | ActiveReportsJS-Designer.AppImage | [App Image](https://appimage.org/) |

### **구성**

응용 프로그램에 대한 보고서를 작성하기 시작할 때 독립 실행형 보고서 디자이너, 보고서 독자 시스템의 브라우저와 내보낸 PDF 문서 간에 보고서가 일관되게 출력되어야 합니다. 이렇게 하려면 적절한 [글꼴 구성](/activereportsjs/docs/v6.2/GettingStarted/FontConfiguration#configure-the-standalone-designer-application)을 설정하는 것이 가장 좋은 방법입니다.
또한 문제가 생긴 경우에는 독립 실행형 보고서 디자이너의 디버그 모드를 켜려고 할 수도 있습니다. 자세한 내용은 [트러블슈팅 페이지](/activereportsjs/docs/v6.2/GettingStarted/troubleshooting)를 참조하십시오.
추가로, 독립 실행형 보고서 디자이너에 대한 [보고서 항목 템플릿](/activereportsjs/docs/v6.2/DeveloperGuide/ActiveReportsJSDesignerComponent/custom-init-templates)을 구성할 수 있습니다. 첫 번째 실행 후 앱은 `App files` 디렉터리 내에 `Defaults` 폴더를 만듭니다.

* Windows: `%AppData%\ActiveReportsJS Designer`
* macOS: `~/Library/Application Support/ActiveReportsJS Designer`
* Linux: `~/.config/ActivereportsJS Designer`

`Default` 폴더는 다음의 보고서 항목 템플릿을 포함합니다.

* `cplImperialTemplates.rdlx-json` \- 야드파운드법\(Imperial units\)을 사용하는 연속 페이지 레이아웃 보고서 항목
* `fplImperialTemplates.rdlx-json` \- 야드파운드법\(Imperial units\)을 사용하는 고정 페이지 레이아웃 보고서 항목
* `cplMetricTemplates.rdlx-json` \- 미터법\(Metric units\)을 사용하는 연속 페이지 레이아웃 보고서 항목
* `fplMetricTemplates.rdlx-json` \- 미터법\(Metric units\)을 사용하는 고정 페이지 레이아웃 보고서 항목

### AI 지원 기능 구성

독립형 리포트 디자이너는 데이터로부터 AI를 사용해 [보고서 항목(테이블, 태블릭스, 차트)을 생성](/activereportsjs/docs/v6.2/ReportAuthorGuide/Report-Designer-Interface#explore-기능)할 수 있습니다. AI 제공업체로 전송되는 것은 데이터의 구조, 즉 데이터 세트의 필드 이름과 유형뿐이며, 실제 데이터 값은 사용자의 컴퓨터를 벗어나지 않습니다. 이 기능은 기본적으로 꺼져 있으며, 디자이너를 AI 제공업체에 연결해야 사용할 수 있습니다.
이 기능을 활성화하려면 위에서 설명한 것과 동일한 `app files` 디렉터리에 `ai-config.json` 파일을 추가하세요:

* Windows: `%AppData%\ActiveReportsJS Designer`
* macOS: `~/Library/Application Support/ActiveReportsJS Designer`
* Linux: `~/.config/ActiveReportsJS Designer`

이 파일에는 `provider` 속성과 해당 제공업체에 필요한 연결 설정이 포함되어야 합니다. 지원되는 제공업체는 `openAI`, `azureOpenAI`, `google`, `ollama`입니다.
**OpenAI**

```json
{
  "Provider": "OpenAI",
  "ApiKey": "9JwEkCBx...",
  "Model": "gpt-4o",
  "Timeout": "90000",
}
```

**Azure OpenAI**

```json
{
  "Provider": "AzureOpenAI",
  "ApiKey": "9JwEkCBx...",
  "Model": "gpt-4o",
  "Timeout": "90000",
  "DeploymentName": "gpt-4o-deployment",
  "Endpoint": "..."
}
```

**Google Gemini**

```json
{
  "Provider": "gemini",
  "ApiKey": "AQ.Ab8R...",
  "Model": "gemini-3.7-flash",
  "Timeout": "90000",
}
```

**Ollama (local)**

```json
{
  "Provider": "ollama",
  "Model": "qwen2.5",
  "Timeout": "90000",
  "Endpoint": "http://localhost:11434",
}
```

`apiKey`와 `model`은 선택한 제공업체에 따라 다릅니다. Azure OpenAI는 추가로 `endpoint`와 `deploymentName`이 필요하며, Ollama는 로컬 서버에서 실행되므로 `apiKey`는 필요 없지만 대신 `endpoint`가 필요합니다.
`ai-config.json` 파일을 준비한 후 독립형 리포트 디자이너를 재시작하면, [리포트 디자이너 인터페이스](/activereportsjs/docs/v6.2/ReportAuthorGuide/Report-Designer-Interface)에서 AI 지원 작업을 사용할 수 있게 됩니다.

>type=warning
> **보안 팁**: `ai-config.json`은 AI 제공업체의 API 키를 평문(Plain text)으로 저장합니다. 소스 관리 시스템이나 여러 사용자가 공유하는 위치에 두지 마세요.

### **사용자 인터페이스**

독립 실행형 보고서 디자이너의 사용자 인터페이스는 여러 부분으로 구성되어 있습니다.

* 보고서 템플릿을 작성하기 위한 [보고서 디자이너 인터페이스](/activereportsjs/docs/v6.2/ReportAuthorGuide/Report-Designer-Interface)
* 보고서 출력을 미리 보기 위한 [보고서 뷰어 인터페이스](/activereportsjs/docs/v6.2/ReportAuthorGuide/Report-Viewer-Interface)
* 다음 항목을 포함한 `주 메뉴`

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4ed8c11f-8d09-4226-9c37-dd4595797443/reportauthor-guide/GetStartedWithStandaloneReportDesigner/UISchema.png)

### 열기, 저장 및 다른 이름으로 저장 버튼

이러한 버튼은 [파일 메뉴](/activereportsjs/docs/v6.2/ReportAuthorGuide/QuickStart/Get-Started-With-Designer-App#%ED%8C%8C%EC%9D%BC-%EB%A9%94%EB%89%B4)의 표준 `열기`, `저장` 및 `다른 이름으로 저장...` 명령에 대한 바로 가기입니다.

### 미리 보기 버튼

이 버튼은 보고서 출력 내용을 확인할 수 있는 미리 보기 모드로 독립 실행형 보고서 디자이너를 전환합니다. 왼쪽 상단에 있는 `왼쪽 화살표` 아이콘을 클릭하면 디자인 모드로 되돌아갈 수 있습니다. 보고서 출력을 탐색하는 방법을 알아보려면 [보고서 뷰어 인터페이스](/activereportsjs/docs/v6.2/ReportAuthorGuide/Report-Viewer-Interface) 문서를 참조하십시오.
DOC-DETAILS-TAG-OPEN
DOC-SUMMARY-TAG-OPEN
확장하여 실행 중인 디자인 모드와 미리 보기 모드 간 전환 보기
DOC-SUMMARY-TAG-CLOSE
![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4ed8c11f-8d09-4226-9c37-dd4595797443/reportauthor-guide/GetStartedWithStandaloneReportDesigner/SwitchDesignAndPreview.gif)
DOC-DETAILS-TAG-CLOSE

### 파일 메뉴

`파일 메뉴`는 다음 작업을 수행할 수 있는 사이드 바를 엽니다.

* [연속 레이아웃](/activereportsjs/docs/v6.2/ReportAuthorGuide/보고서-구성/Report-Layouts#continuous-page-layout) 및 [고정 레이아웃](/activereportsjs/docs/v6.2/ReportAuthorGuide/보고서-구성/Report-Layouts#fixed-page-layout) 템플릿에서 선택하여 보고서 `새로 만들기`
* 기본 보고서 템플릿 `열기`
* 현재 보고서 템플릿을 `다른 이름으로 저장`
* 제품 버전에 `정보`를 확인하고 라이선스 키 설정. 자세한 내용은 [라이선싱 페이지](/activereportsjs/docs/v6.2/GettingStarted/Licensing#licensing-the-designer-application)를 참조하십시오.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4ed8c11f-8d09-4226-9c37-dd4595797443/reportauthor-guide/GetStartedWithStandaloneReportDesigner/FileMenu.png)