サインイン
Language
日本語 English

このセクションの記事

  • D3Worker メール送信サービス Microsoft365とのSMTP連携方法(Kintone)
  • 【TECH COLUMN】kintoneのデータからPDFを生成し、OPROARTS Driveに格納してウェブ配信する
  • 【TECH COLUMN】D3Workerの「BizFAX」機能でFAX送信してみよう (kintone版)
  • 【TECH COLUMN】kintoneのデータから生成したPDFをGMOサインに送信する
  • 【TECH COLUMN】kintoneからD3Workerを経由してBoxにファイルを保存する
  • 【TECH COLUMN】請求書配信ソリューション(OPROARTS Drive連携)kintone版
  • 【TECH COLUMN】kintoneのデータから生成したPDFをクラウドサインに送信する
  • 【TECH COLUMN】D3Worker経由で作成したPDFをクラウドサインで電子署名してkintoneへ格納する
  • 【TECH COLUMN】D3Worker経由で作成したPDFをDocuSignで電子署名してkintone等へ格納
  • 【TECH COLUMN】既存のPDFをDocuSignでサインしてkintone等へ格納
もっと見る

【TECH COLUMN】kintoneからD3Workerを経由してBoxにファイルを保存する

Avatar
OPRO Support staff
  • 2024年10月08日 06:27
  • 更新

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

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

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

 

kintoneアプリの用意

本記事では、ワークを呼び出すkintoneアプリに「見積」アプリを使用します。
テンプレートファイルがこちらのページからダウンロード可能です。(「サンプルアプリ」と書かれたリンクをクリックしてください)

見積アプリイメージ

quote_app_image.png

 

帳票テンプレートの用意

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

quotation_sample_template.png

 

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

csv_header_fields.PNGcsv_detail_fields.PNG

 

D3Workerの設定

サービス設定

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

OPROARTS.PNG

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

 

次に、「Box [配送]」を選択してサービスを作成します。

box_service_type.PNG

各設定項目を指定し、サービスを保存します。
項目の説明を以下に記載します。

box_service_settings.PNG

 項目名 必須  内容
 名称  ○  サービス名称(ユニークな任意の名称)を入力します。
 メモ    必要に応じて、簡単なメモを入力します。
 Boxへの接続
 一度サービスを保存すると、「接続」ボタンが有効になります。
「接続」をクリックして、Boxのアカウントでログインしてください。
 接続情報
 タイムアウト  ○   D3Worker - Box間の接続・読込における、タイムアウトするまでの時間を指定します。
 保存先フォルダ定義
 保存先フォルダの指定方法  ○  ・フォルダID指定
・フォルダ階層指定
のどちらかを選択します。
 保存先フォルダID or フォルダ階層指定  ○   「フォルダID指定」を選択した場合はフォルダIDを、「フォルダ階層指定」を選択した場合はフォルダ階層を「/」区切りで指定します。
 ファイル定義
 ファイルのコメント    ファイルにコメントを付与できます。
 ファイルの説明    ファイルの説明を指定できます。
 ファイルの共有リンク定義
 共有リンクの設定有無  ○   ファイルを共有するためのリンクを設定するかどうか指定します。
 アクセスレベル    共有リンクからファイルにアクセスできるユーザーを指定します。
・リンクを知っている全員
・会社のユーザー
・このフォルダ内のユーザー
の3つから選択可能です。
 共有リンクのパスワード    共有リンクからファイルにアクセスするためのパスワードを設定します。
 共有リンクの有効期限    共有リンクの有効期限を指定します。
日付は、以下のフォーマットを使用してください。
・YYYY-MM-DD
・YYYY-MM-DDThh:mm:ss+hh:mm
・YYYY-MM-DDThh:mm:ss-hh:mm
・YYYY-MM-DDThh:mm:ssZ
・YYYY-MM-DDThh:mm:ss.SSSZ
・YYYYMMDD
・YYYYMMDDhhmmss
 共有リンクのダウンロード権限    共有リンクからファイルを開いたときに、ダウンロードを許可するかどうか指定します。
 ファイルのメタデータ定義
 項目名    保存するファイルに付与したいカスタム項目の名前を入力します。
 値    カスタム項目の値を入力します。

 

エンベロープ設定

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

envelope_document.PNG

 

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

envelope_delivery.PNG

 

ワーク設定

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

データソース: kintoneから受け取るデータのフィールドを定義します。kintoneアプリの各項目のフィールドコードと同じフィールド名を付けると、後の設定が楽になるのでおすすめです。

work_datasource.PNG

 

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

work_envelope.png

 

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

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

work_mapping.png

 

kintoneの設定

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

 

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

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

アプリインストール

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

    import_app.png

プラグインインストール

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

    import_plugin.png

 

 

アプリの設定

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

  1. アカウントの種類「ランタイム」と「管理者」の2つについて、以下の設定で1レコードずつ作成します。
    D3WorkerのURL:https://d3w.ap.oproarts.com/d3w/api/xxxxxxx/
    ※xxxxxxxはお客様ごとのテナントになります。
    ユーザ:D3Worker連携を行う、または管理するユーザ
    UID、UPW:D3Worker用のUID、UPW

    connector_records.PNG
  2. アカウントの種類が「管理者」である方のレコード画面を開き、「D3Workerと同期」をクリックします。
  3. アプリ設定の「追加」をクリックし、項目を利用したいアプリのIDを指定します。
  4. 「追加」をクリックすると列が追加されますので、利用するワークを指定します。
    ※先にD3Workerの設定を行っていないとワークに表示されません。

    d3w_app_settings.png
  5. 送信フィールド マッピングのマッピングをクリックするとD3Workerのデータソースとkintone項目のマッピング画面が表示されます。
  6. データソースとkintoneアプリの項目の紐づけを行います。
    kintoneアプリのフィールドコードとワークのデータソースフィールド名が同じであれば、「自動マッピング」をクリックすることで項目が自動で紐づけられます。
    図では、データソースの「Quotation_Number」にkintoneアプリの「Quotation_Number」が、
    「Customer_Name」にkintoneアプリの「Customer_Name」、、、、、、のように設定されております。

    field_mapping_header.png

    ※サブテーブル、もしくは関連レコードを明細として利用する場合は「送信フィールド(サブテーブル/関連レコード) マッピング」をご利用ください。

    field_mapping_detail.png
  7. 設定が完了したら「保存」をクリックして設定を保存します。

 

プラグインの設定

  1. D3Workerと連携をしたいkintoneアプリの設定>プラグイン>プラグインの追加でD3Worker Connector for kintoneを選択し、「追加」をクリックします。

    choose_plugin.png
  2. D3Worker Connector for kintoneの設定から設定画面を開きます。

    setting_plugin.png
  3. 「OPROARTS Connector for kintone を選択」で先ほど設定したD3Worker Connector for kintoneを選択します。
  4. 「ボタン設置設定」の「追加」をクリックし、先で作成したボタンを指定します。
  5. ボタンの追加が済んだら「保存」をクリックします。

    plugin_settings.png
  6. アプリ設定画面で「アプリの更新」をクリックします。

 

実際の流れ

以上を設定したら、ボタンを設置したアプリのレコード画面でボタンをクリックします。

run_work_button.png

 

Boxの画面に移ると、PDFが保存されていることが確認できます。

quote_pdf_saved_in_box.PNG

 

おわりに

D3Workerを用いてPDF作成からBoxへのPDFアップロードまでのプロセスを自動化することで、kintoneのデータを用いて生成したPDFファイルを容易に管理できるようになります。

本記事がD3WorkerとBoxを連携する際の参考になれば幸いです。

 

ページの先頭へ戻る

関連記事

  • 【Excelアドイン】帳票出力に対応している文字コードは何ですか(oproarts/Salesforce)
  • 【TECH COLUMN】SalesforceからD3Workerを経由してBoxにファイルを保存する
  • OPRO Support Service ご利用方法
  • D3Workerのサービス設定(DocuSign)(kintone)
  • リリースノート一覧
株式会社オプロ