[toc]

概要

本記事では、kintoneのデータを使って生成したPDFファイルをBoxに保存する方法について説明します。
D3Workerの以下のサービスを使用します。

サービス	用途
OPROARTS	kintoneから渡されたCSVデータを用いてPDFを生成します。
Box [配送]	PDFをBoxに保存します。

kintoneアプリの用意

本記事では、ワークを呼び出すkintoneアプリに「見積」アプリを使用します。
テンプレートファイルは、下記記事の「サンプルアプリ」をクリックしてダウンロードしてください。

ドキュトーンのダウンロード

帳票テンプレートの用意

OPROARTS Designerで帳票テンプレートを作成します。
今回は、標準で用意されているサンプルテンプレート「見積書3」を使用します。

本テンプレートは、以下のCSVフィールドを持ちます。

D3Workerの設定

サービス設定

OPROARTS

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

💡

補足

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

D3Workerのサービス設定（OPROARTS連携）

Box [配送] v2

「Box [配送] v2」を選択してサービスを作成します。各設定項目を指定し、サービスを保存します。

基本設定

項目名	内容	必須
名称	サービス名称（ユニークな任意の名称）を入力します。	○
メモ	必要に応じて、簡単なメモを入力します。

Boxへの接続

一度サービスを保存すると、「接続」ボタンが有効になります。「接続」をクリックして、Boxのアカウントでログインしてください。

実行ユーザー

「アカウントID」にサービスの処理を行うユーザーを指定します。ユーザーの指定を省略した場合は、接続したユーザーが実行ユーザーとして使用されます。サービスの実行は、接続したユーザーが「管理者」または「共同管理者」の場合に有効です。

文書の情報

項目名	内容
説明	「フォルダID指定」「フォルダ階層指定」のどちらかを選択します。
保存先フォルダ	フォルダ名で指定する：ファルダ名を指定します。`/` でフォルダの階層を区切って指定できます。フォルダIDで指定する：フォルダIDを指定します。

共有リンク

項目名	内容
対象	リンクを共有するか、共有する場合は対象をファイルとフォルダのどちらにするかを指定します。「共有しない」「ファイル」「フォルダ」から選択します。
共有先	共有リンクからファイルにアクセスできるユーザーを指定します。「リンクを知っている全員」「会社のユーザー」「招待されたユーザーのみ」の3つから選択可能です。
ダウンロード	ダウンロードを「許可する」か「許可しない」かを指定します。
パスワード	「共有先」の指定が「リンクを知っている全員」の場合のみ有効です。こちらのパスワードは、Box側のパスワード要件を満たしている必要があります。
有効期限	共有リンクの有効期限を指定します。日時の指定は、ISO 8601の拡張形式（`2026-07-23T08:01:19Z`）で指定します。

メタデータ

項目名	内容
テンプレート識別子	テンプレートから「属性」を読み込みます。テンプレートの識別子は、Box管理コンソールでメタデータテンプレートを開いた際のURLから取得します。 URL：`https://app.box.com/master/metadata/templates/テンプレート識別子`
属性	テンプレート識別子を読み込むと、名前と値が表示されます。

エンベロープ設定

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

配送サービスに、「Box [配送]」を基に作成したサービスを指定します。

ワーク設定

データソース

kintoneから受け取るデータのフィールドを定義します。
kintoneアプリの各項目のフィールドコードと同じフィールド名を付けることを推奨します。

エンベロープ

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

文書とデータのマッピング

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

kintoneアプリ「見積」には顧客担当者名を保持するフィールドが存在せず、帳票テンプレートの「CustomerCharge」フィールドに受け渡す値が無いため、ここでは3つ目のフィールドを固定値「ご担当者」にしています。

⚠️

注意

テンプレート名には先頭にlive_を付けて、live_{作成したテンプレート名} と入力してください。

💡

補足

ワーク設定の詳細は、下記記事の「D3Workerの設定手順」をご覧ください。

【TECH COLUMN】D3Workerの「BizFAX」機能でFAX送信してみよう

kintoneの設定

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

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

下記記事より、2つのZIPファイルをダウンロードします。

D³Worker Connector for kintoneのダウンロード

D³Worker Connector for kintone 1.3.0.2025.11.10a.zip
d3worker-connector-kintone.plugin.20251110a.zip

上記ファイルを使用して、「D3Worker Connector for kintone」のアプリとプラグインの両方をkintone組織に追加してください。

アプリのインストール

「アプリの追加＞テンプレートファイルを読み込んで作成」で「D³Worker Connector for kintone 1.3.0.2025.11.10a.zip」を選択します。
「アプリを作成」ボタンをクリックします。

プラグインのインストール

「kintoneシステム管理＞プラグイン＞読み込む」で「d3worker-connector-kintone.plugin.20251110a.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アプリの項目の紐づけを行います。 kintoneアプリのフィールドコードとワークのデータソースフィールド名が同じであれば、「自動マッピング」ボタンをクリックすることで項目が自動で紐づけられます。

上記画像では、データソースの「Quotation_Number」にkintoneアプリの「Quotation_Number」を、データソースの「Customer_Name」にkintoneアプリの「Customer_Name」を割り当てる、といった形で設定します。

💡

補足

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

プラグインの設定

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