# Nuxt.js에서 ActiveReportsJS 보고서 뷰어 시작하기

## Content

[Nuxt.js](https://nuxtjs.org/) 는 개발 프로세스 및 최종 애플리케이션을 더 빠르게 만드는 최적화와 함께 애플리케이션에 잘 정의된 구조를 제공하는 Vue 기반 프레임워크입니다. 이 자습서에서는 보고서 뷰어 구성 요소를 사용하여 간단한 보고서의 출력을 표시하는 Nuxt.js 애플리케이션을 빌드합니다.

### Nuxt.js 애플리케이션 만들기

Nuxt.js 애플리케이션을 생성하는 가장 쉬운 방법은 `Nuxt CLI`(nuxi) 도구를 사용하는 것입니다. 명령 프롬프트나 터미널에서 다음 명령을 실행하여 Nuxt.js 프로젝트를 생성하세요.

```bash
# with npx(included by default with npm v5.2+)
npx nuxi@latest init arjs-nuxtjs-viewer-app

# with pnpm
pnpm dlx nuxi@latest init arjs-nuxtjs-viewer-app
```

### NPM 패키지 설치

Vue Report Viewer 컴포넌트는 `@mescius/activereportsjs-vue` NPM 패키지를 통해 배포되며, 이는 핵심 기능을 포함하는 `@mescius/activereportsjs` 패키지에 의존합니다. 이러한 패키지의 최신 버전을 설치하려면 응용 프로그램의 루트 폴더에서 다음 명령을 실행하세요.

```bash
# with npm
npm i @mescius/activereportsjs-vue@latest

# with yarn
yarn add @mescius/activereportsjs-vue@latest
```

### Nuxt.js 구성

응용 프로그램의 루트 폴더에 있는 `nuxt.config.ts` 파일을 열고, 다음 내용으로 파일의 내용을 교체하세요:

```ts
export default defineNuxtConfig({
  ssr: false,
  devtools: { enabled: true },
})
```

### 응용 프로그램에 ActiveReportsJS 보고서 추가

ActiveReportsJS는 [JSON](https://www.json.org/json-en.html) 형식과 `rdlx-json`보고서 템플릿 파일의 확장자를 사용합니다. 응용 프로그램의 `static`폴더에서 라는 새 파일을 만들고 `report.rdlx-json`다음 JSON 콘텐츠를 삽입합니다.

```json
{
  "Name": "Report",
  "Body": {
    "ReportItems": [
      {
        "Type": "textbox",
        "Name": "TextBox1",
        "Value": "Hello, ActiveReportsJS Viewer",
        "Style": {
          "FontSize": "18pt"
        },
        "Width": "8.5in",
        "Height": "0.5in"
      }
    ]
  }
}
```

### 응용 프로그램에 Vue 보고서 뷰어 구성 요소 추가

`app.vue` 파일을 열고 기본 내용을 다음 코드로 교체하세요. 이 코드는 [Vue 보고서 뷰어](/activereportsjs/docs/DeveloperGuide/ActiveReportsJSViewer/Integration/Vue-Component)를 통합하여 이전 단계에서 추가한 리포트 템플릿을 표시합니다. 또한 기본 보고서 [뷰어 컴포넌트 스타일](/activereportsjs/docs/DeveloperGuide/ActiveReportsJSViewer/Themes)을 가져오며, 뷰어의 호스팅 요소에 대한 스타일을 정의합니다.

```html
<template>
  <div id="viewer-host">
      <ClientOnly>
        <Viewer v-bind:report="{ Uri: 'report.rdlx-json' }" />
      </ClientOnly>  
  </div>
</template>

<script lang="ts">
import {PdfExport} from '@mescius/activereportsjs';
import {Viewer} from '@mescius/activereportsjs-vue';
const pdf = PdfExport;

export default {
  name: "IndexPage",
  components: {
    Viewer
  },
};
</script>

<style
  src="node_modules/mescius/activereportsjs/styles/ar-js-ui.css"
></style>

<style
  src="node_modules/mescius/activereportsjs/styles/ar-js-viewer.css"
></style>

<style scoped>
#viewer-host {
  height: 100vh;
  width: 100%;
}
</style>
```

### 애플리케이션 실행 및 테스트

`yarn dev` 명령을 사용하여 응용 프로그램을 실행할 수 있습니다 기본적으로 프로젝트는 `http://localhost:3000/`에서 실행됩니다. 이 URL을 탐색하면 `ActiveReportsJS Report Viewer`이 페이지에 나타납니다. 뷰어는 `Hello, ActiveReportsJS Viewer` 텍스트를 보여주는 보고서를 표시합니다. [보고서 뷰어 사용자 인터페이스](/activereportsjs/docs/ReportAuthorGuide/Report-Viewer-Interface)를 사용하여 기본 기능을 테스트할 수 있습니다 .