このセクションの記事

【TECH COLUMN】kintoneのデータからPDFを生成し、OPROARTS Driveに格納してウェブ配信する

Avatar
OPRO Support staff
  • 更新
フォローする

本記事では、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をメール配信するための設定

サービス設定

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

service_dummy.PNG

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

 

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

service_email.PNG

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

 

エンベロープ設定

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

envelope2_document.PNG

 

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

envelope2_delivery.png

 

ワーク設定

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

work2_datasource.PNG

 

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

work2_envelope.PNGwork2_envelope_detail.PNG

 

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

 

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

サービス設定

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

OPROARTS.PNG

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

 

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

service_oproartsdrive_work.PNG

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

 

エンベロープ設定

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

envelope_document.png

 

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

envelope1_delivery.png

 

ワーク設定

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

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

work1_datasource.PNG

 

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

work1_envelope_field.PNGwork1_envelope_detail.PNG

 

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

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

work1_document_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_connector_worklist.png
  5. 送信フィールド マッピングのマッピングをクリックするとD3Workerのデータソースとkintone項目のマッピング画面が表示されます。
  6. データソースとkintoneアプリの項目の紐づけを行います。
    図では、データソースの「QuotationNumber」にkintoneアプリの「QuotationNumber」が、
    「CustomerName」にkintoneアプリの「CustomerName」、、、、、、のように設定されております。

    kintone_mapping.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. ボタンの追加が済んだら「保存」をクリックします。

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

 

実際の流れ

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

fixed_kintone_execute_button.png

 

OPROARTS Drive画面に移ると、PDFが保存されています。

fleekdrive_quotation_saved.PNG

 

送信されたメールはこちらです。

email.png

 

おわりに

D3Workerを用いてPDF作成からOPROARTS DriveへのPDFアップロード、保存先のURLをメール配信するまでのプロセスを自動化することで、企業間の取引業務等について大幅な時間短縮が期待できます。

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

 

関連記事

コメント

0件のコメント

記事コメントは受け付けていません。