【TECH COLUMN】kintoneのデータからPDFを生成し、OPROARTS Driveに格納してウェブ配信する – OPSS - 株式会社オプロ

本記事では、D3Worker経由で作成したPDFをOPROARTS Driveに保存し、保存先URLをメール配信する方法についてご紹介します。

D3Workerの以下のサービスを使用します。

OPROARTS: kintoneから渡されたCSVデータを用いてPDFを生成します。
OPROARTS Drive [配送] - ワーク実行: PDFをOPROARTS Driveにアップロードし、別の処理(今回は保存先URLをメール配信)を実行します。
ダミー文書: 保存先URLをメール送信する際に使用する文書化サービスです。
メール送信: PDFの保存先URLを本文に含んだメールを送信します。

D3Workerの設定

D3Workerの設定は、

①PDFを生成してOPROARTS Driveに送るためのワーク
②保存先URLをメール配信するためのワーク

の2つに分けて行います。

①のワークに属するサービスの中で②のワークを設定するため、
先に②に使用するサービス、エンベロープ、ワークを設定します。

保存先URLをメール配信するための設定

サービス設定

「ダミー文書」を選択してサービスを作成します。

詳細はこちらの記事をご参照ください。

次に、「メール送信」を選択してサービスを作成します。

詳細はこちらの記事をご参照ください。

エンベロープ設定

文書化サービスに「ダミー文書」を基に作成したサービスを指定します。

配送サービスに「メール送信」を基に作成したサービスを指定します。
ここでは例として、エンベロープパラメータ「URL」(ここにOPROARTS Driveの保存先URLが入る)を含めた本文を設定しています。

ワーク設定

データソース: このワークではOPROARTS Driveの保存先URLを受け取るため、そのためのフィールドを1つ用意します。ここではURLとしています。

エンベロープ: 作成したエンベロープを選択し、エンベロープフィールドにURLを、「アクティブ化するフィールド」に「エンベロープフィールド」を指定します。また「ELSEとして使用する」にチェックを入れます。

文書とデータのマッピング: このワークで文書の生成は行われない（「ダミー文書」サービスを用いる）ので、全項目を空のままにします。

PDFを生成してOPROARTS Driveに送るための設定

サービス設定

「OPROARTS」を選択してサービスを作成します。

詳細はこちらの記事をご覧ください。
リンク先記事では「OPROARTS（別アカウント）」を使用していますが、設定は同様です。

次に、「OPROARTS Drive [配送] - ワーク実行」を選択してサービスを作成します。

詳細はこちらの記事をご参照ください。

エンベロープ設定

文書化サービスに「OPROARTS」を基に作成したサービスを指定します。

配送サービスに「OPROARTS Drive [配送] - ワーク実行」を基に作成したサービスを指定します。

ワーク設定

※本記事で扱う処理に必要な設定のみ記載しています。ワーク設定の詳細はこちらの記事の「D3Workerの設定手順」をご覧ください。

データソース: kintoneから受け取るデータのフィールドを定義します。

エンベロープ: 作成したエンベロープを選択し、「エンベロープフィールド」に帳票を区別するデータフィールド（ここではQuotationNumber）を、「アクティブ化するフィールド」にエンベロープフィールドを指定します。また「ELSEとして使用する」にチェックを入れます。

文書とデータのマッピング: 帳票テンプレートのCSVフィールドと、データソースのフィールドをマッピングします。

テンプレート名には"live_"を先頭につけて「live_{作成したテンプレート名}」と入れてください。

kintoneの設定

作成したワークをkintoneのレコード画面から実行するために、kintoneの設定をします。

アプリ、プラグインの追加

2つのZIPファイルをこちらのページよりダウンロードし、それらを基に「D3Worker Connector for kintone」のアプリとプラグインの両方をkintone組織に追加します。

アプリインストール

アプリの追加＞テンプレートファイルを読み込んで作成で「D3W Connector for kintone 1.0.0.2019.08.05.zip」を選択し、「アプリを作成」をクリックします。

プラグインインストール

kintoneシステム管理＞プラグイン＞読み込むで「plugin_d3w_1.0.0.20191223a.zip」を選択し、「読み込む」をクリックします。

アプリの設定

D3W Connector for kintoneアプリを開き、以下のように設定します。

アカウントの種類「ランタイム」と「管理者」の2つについて、以下の設定で1レコードずつ作成します。
D3WorkerのURL：https://d3w.ap.oproarts.com/d3w/api/xxxxxxx/
※xxxxxxxはお客様ごとのテナントになります。
ユーザ：D3Worker連携を行う、または管理するユーザ
UID、UPW：D3Worker用のUID、UPW
アカウントの種類が「管理者」である方のレコード画面を開き、「D3Workerと同期」をクリックします。
アプリ設定の「追加」をクリックし、項目を利用したいアプリのIDを指定します。
「追加」をクリックすると列が追加されますので、利用するワークを指定します。
※先にD3Workerの設定を行っていないとワークに表示されません。
送信フィールドマッピングのマッピングをクリックするとD3Workerのデータソースとkintone項目のマッピング画面が表示されます。
データソースとkintoneアプリの項目の紐づけを行います。
図では、データソースの「QuotationNumber」にkintoneアプリの「QuotationNumber」が、
「CustomerName」にkintoneアプリの「CustomerName」、、、、、、のように設定されております。

※サブテーブル、もしくは関連レコードを明細として利用する場合は「送信フィールド(サブテーブル/関連レコード) マッピング」をご利用ください。
設定が完了したら「保存」をクリックして設定を保存します。

プラグインの設定

D3Workerと連携をしたいkintoneアプリの設定＞プラグイン＞プラグインの追加でD3Worker Connector for kintoneを選択し、「追加」をクリックします。
D3Worker Connector for kintoneの設定から設定画面を開きます。
「OPROARTS Connector for kintone を選択」で先ほど設定したD3Worker Connector for kintoneを選択します。
「ボタン設置設定」の「追加」をクリックし、先で作成したボタンを指定します。
ボタンの追加が済んだら「保存」をクリックします。
アプリ設定画面で「アプリの更新」をクリックします。