【TECH COLUMN】D3Worker経由で作成したPDFをクラウドサインで電子署名してkintoneへ格納する

本記事では、D3Worker経由で作成したPDFをクラウドサインにアップロードし、署名後kintoneに格納する方法についてご紹介します。

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

OPROARTS: kintoneから渡されたCSVデータを用いてPDFを生成します。
クラウドサイン - ワーク実行: 署名前のPDFをクラウドサインにアップロードし、署名が済み次第別の処理(今回はkintoneにPDFを保存)を実行します。
アップロード文書: クラウドサインから返される署名後のPDFをD3Workerに送ります。
kintone［配送］: 署名後のPDFをkintoneに送り、既存のレコードに添付します。同時に任意の項目の値を更新することも可能です。

D3Workerの設定

D3Workerの設定は、

①PDFを生成してクラウドサインに送るためのワーク
②署名済みPDFをkintoneに保存するためのワーク

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

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

署名済みPDFをkintoneに保存するための設定

サービス設定

「アップロード文書」を選択してサービスを作成します。

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

次に、「kintone［配送］」を選択してサービスを作成します。

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

エンベロープ設定

文書化サービスに「アップロード文書」を基に作成したサービスを指定します。

配送サービスに「kintone［配送］」を基に作成したサービスを指定します。

前のワークから添付先のレコードIDを受け取るため、「レコードID」にエンベロープパラメータ{record_Id}を指定します。

ワーク設定

データソース: このワークでは署名済みPDFを添付するレコードのID受け取るため、そのためのフィールドを1つ用意します。ここでは「レコードID」としています。

エンベロープ: 作成したエンベロープを選択し、エンベロープフィールドにデータソースの行番号を、「アクティブ化するフィールド」に「エンベロープフィールド」を指定します。また「ELSEとして使用する」にチェックを入れます。
エンベロープパラメータ{record_Id}には、データソースのフィールド[レコードID]を割り当てます。

文書とデータのマッピング: 署名されたPDFがアップロードされる(文書を生成しない)ので、全項目を空のままにします。

PDFを生成してクラウドサインに送るための設定

サービス設定

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

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

次に、「クラウドサイン - ワーク実行」を選択してサービスを作成します。

詳細はこちらの記事をご参照ください。
記事では「クラウドサイン [Web Hook] - ワーク実行」と表記されていますが、同様に設定すれば問題ありません。

エンベロープ設定

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

配送サービスに「クラウドサイン - ワーク実行」を基に作成したサービスを指定します。

ワーク設定

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

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

エンベロープ: 作成したエンベロープを選択し、「エンベロープフィールド」にデータソースの行番号を、「アクティブ化するフィールド」にエンベロープフィールドを指定します。また「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/xxxxxxxxxxxx/
※xxxxxxxはお客様ごとのテナントになります。
ユーザ：D3Worker連携を行う、または管理するユーザ
UID、UPW：D3Worker用のUID、UPW
アカウントの種類が「管理者」である方のレコード画面を開き、「D3Workerと同期」をクリックします。
アプリ設定の「追加」をクリックし、項目を利用したいアプリのIDを指定します。
「追加」をクリックすると列が追加されますので、利用するワークを指定します。
※先にD3Workerの設定を行っていないとワークに表示されません。
送信フィールドマッピングのマッピングをクリックするとD3Workerのデータソースとkintone項目のマッピング画面が表示されます。
データソースとkintoneアプリの項目の紐づけを行います。
図では、データソースの「契約内容」にkintoneアプリの「契約内容」が、
「甲_会社名」にkintoneアプリの「甲_会社名」、、、、、、のように設定されております。
設定が完了したら「保存」をクリックして設定を保存します。

プラグインの設定

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