このセクションの記事

もっと見る

[toc] 
 

概要

本記事では、D3Worker・ViewFramer・kintoneを組み合わせて、BizFAX（NTTコミュニケーションズ提供のクラウド型インターネットFAXソリューション）を利用したFAX送信を行う手順を紹介します。 
帳票の自動作成から配送まで、全体の流れを一元化することで、手動作業を大幅に削減し、業務の効率化が可能になります。

 

前提条件

  • オプロよりお渡しする、認証情報テキスト（OPROARTS認証情報「CID」「UID」「UPW」が記載されたテキストファイル）
  • BizFAXアクセスID、アクセスパスワード、BizFAX加入者ユーザID、加入者ユーザパスワード

 

1. 帳票テンプレートの準備

本記事では、サンプルとしてあらかじめ用意されている「見積書3」を利用する場合の流れを説明します。

オプロのサポートサイトにある「OPROARTS ドキュメント一覧（CSV連携）」から、「操作手順書」の「OPROARTSLiveでテンプレートを作成」の手順に従ってテンプレートを配備します。

使用するテンプレート：見積書3（サンプルテンプレート）


 

 

マッピング情報は以下です。 
「フィールドを定義」で記述されているフィールドに合わせてD3Workerのワーク、ViewFramerのビューとマッピングを設定することになります。

 

2. D3Workerの設定

1. サービスの設定

D3Workerで2つのサービスを作成します。

 

2. エンベロープの設定

エンベロープでは、帳票作成（OPROARTS）と配送（BizFAX）を連携させるための設定を行います。

エンベロープの詳細については「D3Workerの設定手順(Salesforce)」の「エンベロープの設定」をご参照ください。

「属性、保管サービスタブ」は今回使用しないので、設定をスキップします。

 

基本タブ

エンベロープの名称を設定します。

 

文書化サービスタブ

「1. サービスの設定」で作成した「OPROARTS」サービスを選択します。

⚠️
注意

「サービスの設定を用いる」を選択すると、サービス側で設定した値を使用します。エンベロープで値を上書きすることも可能です。

 

配送サービスタブ

「1. サービスの設定」で作成した「BizFAX」サービスを選択します。

 

設定完了後、「保存」をクリックしてエンベロープを保存します。

 

3. ワークの設定

ワークの詳細については「D3Workerの設定手順(Salesforce)」の「ワークの設定」をご参照ください。

ワークを新規作成します。

 

基本タブ

ワークの名称を決定します。

 

データソースタブ

D3Workerが受け取るCSVデータの形式を定義します。 
ViewFramerから受け渡される単票のCSVデータ項目を登録することで、データの整合性が保たれます。

エンベロープタブ

ワークのエンベロープタブの設定概要は「【D3Worker】ワークの「エンベロープ」タブの設定(Salesforce)」をご参照ください。

「2. エンベロープの設定」で作成したエンベロープを選択し、以下の情報を設定します。

  • エンベロープフィールド：Quotation Number
  • アクティブ化するフィールド値：Quotation Number
  • ELSEとして使用する：チェックあり

⚠️
注意

「ELSEとして使用する」にチェックが入っている場合、「アクティブ化するフィールド値」に設定した項目に値が入っていると、エンベロープが動作する状態になります。

 

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

出力されるPDFに利用する情報を設定します。

  • 文書名

    出力されるPDFのファイル名を設定します。

  • テンプレート名

    利用するテンプレート名を指定します。
    帳票テンプレートの準備で作成したテンプレート名を記載します。 テンプレート名の前に必ず「live_」を記載します。

  • マッピング

    デザイナに渡すCSVの形を作成します。 
    本記事の帳票はヘッダー明細の為、データセットを2回追加して、「データセット1」と「データセット2」を作成します。

    データセット1：ヘッダー情報

    • 行の制御：単一行のCSV
    • データセットのフィールド値：デザイナーのヘッダー/フッター部分に渡す項目（顧客情報、見積番号など）

    データセット2：明細情報

    • 行の制御：複数行のCSV
    • データセットのフィールド値：デザイナーの明細部分に渡す項目（商品情報、金額など）

     

設定完了後、「保存」をクリックしてワークを保存します。

 

4. ViewFramer の設定

ViewFramerは、D3workerが必要としているデータ(ワークのデータソース)をkintoneから取得し、D3workerへ渡す設定を行います。

認証情報の入力

ViewFramerにログインして、認証情報を入力します。 このシナリオでは「見積」アプリと「見積商品」アプリの2つのアプリを使用するため、それぞれのAPIトークンを取得して入力することで、データアクセスの準備ができます。

 

ビュー設定

ヘッダービューと明細ビューをそれぞれ作成します。

 

ヘッダービューの出力項目と出力条件設定

以下の画像のように設定します。

 

明細ビューの出力項目と出力条件設定

以下の画像のように設定します。

 

ヘッダービューと明細ビューの両方で、「見積番号」項目が「QuotationNumber」というパラメータ値と一致するレコードを抽出するように設定しています。

この「QuotationNumber」パラメータは、本記事内「5. kintone上でのボタン作成」で使用します。

マッピング設定

マッピングのタイプを「ヘッダー明細型」に指定し、主データと明細データのそれぞれに作成したビューを選択します。

基本設定と主データ

 

明細データ

明細データの設定では、「主データとの結合」で明細データの「QuotationNumber」項目と主データの「QuotationNumber」を紐づけます。

 

「次へ」をクリックして進むと、「D3Worker」タブが表示されます。 URLを入力してワークを選択し、マッピングします。

 

最後に「配備」をクリックすることで、ViewFramerの設定が完了します。

ViewFramerの詳細は以下をご参照ください。

 

5. kintone 上でのボタン作成

D3WorkerおよびViewFramerの設定が完了した後、kintone上にViewFramerを呼び出すボタンを設置することで、アプリ画面からFAX送信を行うことができるようになります。

ボタンの基本設定

ボタン作成手順の詳細は、「ViewFramer(kintone)_Guide2.pdf」の「ボタン作成」セクションをご参照ください。

以下は基本的な設定例です。

 

出力設定

必ず出力設定の「操作指示」で「D3Worker」を選択します。

 

パラメータ設定

「QuotationNumber」パラメータに「見積番号」項目を設定します。 
ヘッダービューと明細ビューの2つ分設定することで、詳細ページでボタンを押下したレコードの見積番号と等しいレコードについてのみViewFramerがレコードを抽出するようになります。

 

8. FAX 送信の実行と確認

設定が完了したら、kintoneのボタンをクリックすることでFAX送信プロセスが開始されます。

 

送信結果の確認

 

BizFAX InternetFAX Web連携サービスにログインして送信履歴を確認することで、FAXが正常に送信されたことを確認できます。

 

関連記事