kintoneでPDF書類を作る

はじめに

DXが叫ばれるこの時代でも、業界によっては紙の書類を作成して提出しないといけない場面が未だ結構あります。kintoneは標準の機能だけでは印刷物作成機能が弱く、せっかく入力して情報共有してもそこから印刷物を作成するWordやExcelなんかに書き直さないといけなくなります。WordやExcelにも欠点があり、開くOS等によってレイアウトが崩れます。ファイルの置き場所やバージョン等の問題もあります。面倒ですね。

今回は、kintoneに入力した情報からPDFを作成することで紙の書類を生成してみます。

下準備

前回の記事の通りセットアップしましょう。正直ここが一番大変。

ライブラリのインストール

プロジェクトに必要なライブラリをインストールします。

$ npm install file-saver

$ npm install html2canvas

$ npm install pdf-lib

html2canvasでreactコンポーネントを画像に変換し、pdf-libで画像をPDFに変換します。それをfile-saverで保存。それだけ。

適当に作ってみる

main.tsx

//main.tsx

import './index.css';
import Document from './Document.tsx';

(() => {
  kintone.events.on('app.record.detail.show', (event: any) => {
    const title = event.record.title.value;
    const container = document.createElement('div');
    kintone.app.record.getSpaceElement('space').append(container);
    const root = createRoot(container);
    root.render(<App zoom={'50%'} title={title} />);
    return event;
  });
})();

(() => {
  kintone.events.on('app.record.print.show', (event: any) => {
    const title = event.record.title.value;
    const recordGaia = document.getElementById('record-gaia');
    recordGaia?.classList.add('displayNone');
    const container = document.querySelector('.contents-gaia');
    const root = createRoot(container!);
    root.render(<Document zoom={'150%'} title={title} />);
    window.print();
    return event;
  });
})();

App.tsx

import html2canvas from 'html2canvas';
import Document from './Document';
import { PDFDocument } from 'pdf-lib';
import { saveAs } from 'file-saver';

function App({ zoom, title }: { zoom: string; title: string }) {
  const pdfDownloadHandler = async () => {
    const target = document.getElementById('pdf-id');
    if (target === null) return;

    const canvas = await html2canvas(target, { scale: 2.5 });
    const image = canvas.toDataURL('image/png');

    const pdfDoc = await PDFDocument.create();
    const page = pdfDoc.addPage();
    const pngImage = await pdfDoc.embedPng(image);
    page.drawImage(pngImage, {
      x: 0,
      y: 0,
      width: page.getWidth(),
      height: page.getHeight(),
    });

    const pdfBytes = await pdfDoc.save();
    const blob = new Blob([pdfBytes], { type: 'application/pdf' });
    saveAs(blob, 'result.pdf');
  };

  return (
    <>
      <button className="pdfButton" onClick={pdfDownloadHandler}>
        PDFを保存する
      </button>
      <Document zoom={zoom} title={title} />
    </>
  );
}

export default App;

Document.tsx

const Document = ({ zoom, title }: { zoom: string; title: string }) => {
  return (
    <section style={{ zoom: zoom }} id="pdf-id">
      <div className="flex_container">
        <h1>{title}</h1>
        <div className="block">
          <p>text</p>
          <p>text</p>
          <p>text</p>
        </div>
        <ul>
          <li>item</li>
          <li>item</li>
          <li>item</li>
          <li>item</li>
          <li>item</li>
        </ul>
        <div className="block">
          <p>text</p>
          <p>text</p>
          <p>text</p>
        </div>
      </div>
    </section>
  );
};

export default Document;

Index.css

@import url('https://fonts.googleapis.com/css2?family=Noto+Serif+JP&display=swap');

* {
  font-family: 'Noto Serif JP', serif;
  box-sizing: content-box;
  margin: 0;
}

.displayNone {
  display: none;
}

.print-header-gaia {
  border-bottom: 1px solid transparent;
  background-color: transparent;
}

section {
  width: 210mm;
  aspect-ratio: 1/1.412;
  border: 1px solid black;
  font-size: 10mm;
  background-color: white;
}

h1 {
  font-size: 15mm;
}

.flex_container {
  display: flex;
  flex-direction: column;
  justify-content: space-around;
  align-items: center;
  gap: 20mm;
  margin: 10mm;
}

.pdfButton {
  margin-left: 10px;
  margin-bottom: 12px;
}

適当ですが、これで3つの機能を実装しています。
・レコード詳細画面でのプレビュー
・ボタンを押した時にPDFを生成し保存
・レコード印刷画面からの印刷

なんの使い道もない書類

ボタンにいい感じのスタイルを当てようと思ってChakra UIをインストールしたら上のアプリアイコンとアプリ名の部分のレイアウトが崩れたのでやめました。色々相性がありそう。

終わりに

レコード印刷画面で四苦八苦して、record-gaiaを非表示にしてcontents-gaiaにコンポーネントを直接マウントしちゃえばいいんだ！と気づいた時は楽しかったですが、A4とA3の書類を同じアプリから印刷したい場面なんかで不便です。素直にReactコンポーネントに対して何らかのアクションを起こすボタンを作ってしまうのがいいと思います。

今回、最初画像をPDFにする場面でjspdfの使用を試みたのですが、なぜか動かず断念しました。

今回はPDFファイルを作成する形を取りましたが、PDFファイルを扱うより紙を印刷する方が多い場合はReactコンポーネントを印刷した方がいい場合もあります。React-to-Printライブラリを用いればそれができそうなので、できたらまた記事にしようと思います。

React周りの知識があれば大して大変でもないですが、複雑怪奇なフロントエンド周りの知識が全くなくても同じことができるプリントクリエイターは偉い。