웹 애플리케이션에 React 보고서 뷰어를 추가하는 방법

ActiveReportsJS는 다양한 프런트 엔드 프레임워크 및 라이브러리에서 사용할 수 있는 클라이언트 측 보고 솔루션입니다. 바닐라 JavaScript에서 NuxtJS에 이르기까지 ARJS는 애플리케이션을 설계하고 해당 구성 요소를 사용할 때 매우 유연합니다. 이 문서에서는 다음 단계에 따라 Visual Studio Code를 통해 React 애플리케이션에서 뷰어 구성 요소를 간단히 추가하고 사용자 지정하는 방법에 대해 설명합니다.
  • Installing the Dependencies
  • Importing the Styles
  • Creating a Report File
  • Integrating the Viewer Component to our App
  • Running the Application

  • 종속성 설치

    If you already have a react app created, let’s start by installing the @grapecity/activereports-react package in your app through the terminal in Visual Studio Code with the following command:

        npm install @grapecity/activereports-react
    

    If you don’t have a react app created, please create one first using the following command:

        npm init react-app arjs-viewer-app
    

    스타일 가져오기

    Once the dependencies are installed into our project, we can add the styles to our App.css file to ensure the viewer component displays nicely. We will also style the #viewer-div element that will be hosting our viewer:

        @import "@grapecity/activereports/styles/ar-js-ui.css";
        @import "@grapecity/activereports/styles/ar-js-viewer.css"; 
    
        #viewer-host {
          width: 100%;
          height: 100vh;
        }
    

    보고서 파일 생성

    For the next step, we want to add an ARJS report file to our application. For now, let’s do this either by creating one through code or by dragging a designer-created report into our project folder. Either way, let’s put the report file into the /public directory within our app.

    Since our reports use the .rdlx-json extension, we can format the properties and controls that will display within our report by using JSON syntax. For example, we can create a new file through the solution explorer by right-clicking the public folder and selecting 'New File'. Let’s name it ‘report-test.rdlx-json’. Within that file, add the following code:

        {
          "Name": "report-test",
          "Body": {
            "ReportItems": [
              {
                "Type": "textbox",
                "Name": "TextBox1",
                "Value": "Testing the textbox!",
                "Style": {
                  "FontSize": "20pt"
                },
                "Width": "8.5in",
                "Height": "1.5in"
              }
            ]
          }
        }
    
    If you’d like information on creating a report through our API, look deeply at our documentation here 런타임 시 보고서에 추가할 수 있는 항목을 확인합니다.

    뷰어 구성 요소를 앱에 통합

    Now in the App.js file, let’s add the following code to get the viewer component to show on our page. This will also link the report we just made to our viewer component.

        import React from "react";
        import "./App.css";
        import { Viewer } from "@grapecity/activereports-react";
    
        function App() {
          return (
            <div id="viewer-host">
              <Viewer report={{ Uri: 'report.rdlx-json' }} />
            </div>
          );
        }
    
        export default App;
    

    애플리케이션 실행

    Occasionally, we will encounter an error that blocks us from using ‘npm start’ while debugging our project. To fix this, change the start script in the package.json file to the following:

        "start": "react-scripts --max_old_space_size=8192 start"
    
    Run the project with the ‘npm start’ command in the terminal. If all goes well, you will see the viewer component on your page and the report file embedded within it. If you run into further issues or errors, please open a ticket 지원팀에 추가 지원을 요청하세요.

    테마 편집기



    보고서 뷰어의 색상, 글꼴 및 테마를 사용자 정의하려면 찾은 테마 편집기를 사용하면 됩니다on our website. 사용할 설정을 선택하고 페이지에서 뷰어 구성 요소를 미리 봅니다. 마음에 드는 테마를 찾으면 페이지 하단의 버튼에서 CSS 스타일을 다운로드하세요. 그런 다음 파일을 애플리케이션 내의 스타일 폴더(node_modules/@grapecity/activereports/styles)로 이동하여 기본 뷰어 테마를 덮어씁니다. 미리 생성된 테마를 대신 사용하려는 경우 배울 수 있는 다양한 항목이 있습니다here .

    최종 점수



    이 연습의 단계를 수행한 후에는 ARJS 반응 애플리케이션에 뷰어 구성 요소를 추가하는 방법을 알아야 합니다. 뷰어는 ARJS에서 제공하는 rich API , customization techniqueslanguage translation 옵션을 제공하므로 보고 요구 사항에 적합합니다. 보다 복잡한 사용 사례에 대해 궁금한 점이 있으면 documentation을 읽어보십시오.

    ActiveReportsJS를 사용해 주셔서 감사합니다!

    좋은 웹페이지 즐겨찾기