Get Started with ActiveReportsJS Report Viewer in Nuxt.js

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

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

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

# 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 패키지 설치

MESCIUS는 @mescius/activereportsjs-vue NPM 패키지를 통해 Vue Report Viewer Component를 배포합니다. 이 패키지는 핵심 기능을 포함하는 @mescius/activereportsjs 패키지에 의존합니다.

이러한 패키지의 현재 버전을 설치하려면 애플리케이션의 루트 폴더에서 다음 명령을 실행하십시오.

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

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

Nuxt.js 구성

응용 프로그램의 루트 폴더에 위치한 nuxt.config.ts 파일을 열고, 내용을 다음과 같이 수정합니다.

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

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

ActiveReportsJS는 JSON 형식과 rdlx-json보고서 템플릿 파일의 확장자를 사용합니다. 애플리케이션의 static폴더에서 라는 새 파일을 만들고 report.rdlx-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 보고서 뷰어를](gcdocsite__documentlink?toc-item-id=20395ca9-6289-4435-9ced-ce525ffb6355) 통합하여 이전 단계에서 추가한 보고서 템플릿을 표시합니다. 또한 기본 보고서 뷰어 구성 요소 스타일을 가져오고 뷰어의 호스팅 요소에 대한 스타일을 정의합니다.

<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 run dev 명령을 사용하여 애플리케이션을 실행할 수 있습니다. 기본적으로 프로젝트는 http://localhost:3000/에서 실행됩니다. 이 URL을 탐색하면 ActiveReportsJS 보고서 뷰어가 페이지에 나타납니다. 뷰어는 'Hello, ActiveReportsJS Viewer' 텍스트를 보여주는 보고서를 표시합니다. 보고서 뷰어 사용자 인터페이스를 사용하여 기본 기능을 테스트할 수 있습니다.