[toc]

概要

本ページでは、ViewFramerを用いてSalesforceのキャンペーンに紐づくキャンペーンメンバーから、ラベル印刷用のExcelを生成する方法を説明します。
Excelアドインの「Z型繰り返し出力」機能を使用したラベル形式での帳票生成プロセスを確認できます。

今回生成するラベル印刷用のExcelは以下です。
例として非常に簡単なものを取り上げているので、必要に応じてデザインや内容は変更してください。

Excelファイルのテンプレート準備

白紙のExcelファイルを用意します。
「ホーム」タブの「アドイン」をクリックし、アドイン検索で「OPRO ドキュメントデザイナー for Office」をインストールします。
インストール後、OPRO ドキュメントデザイナー for Office の「XA / OPROARTS」を選択します。
続く画面では「OK」「Get Started」をクリックします。
Excelシート内に1ラベルのデザインを作成します。
アドインの画面で「フィールドを追加」欄に「住所、会社名、氏名」と入力し、「+」をクリックしてフィールドを追加します。
追加したフィールドをExcelのラベルデザイン内に配置します。
繰り返ししたい範囲を選択し、繰り返し定義タブ（左から2番目のタブ）に移動して、「繰返し」をクリックします。
タグが埋め込まれたセルを選択し、「右方向に繰り返す数」をデフォルト値の1から2に変更します。
住所のセルは、文字列が長くなることが予想されるため、フォントサイズを小さく設定します。
アップロードタブ（一番右のタブ）へ移動し、「アップロードフォームを開く」をクリックします。
OPROARTSサーバー内での管理に使用するテンプレート名などを設定します。
「Excelブック」に、作成・アドイン設定したExcelファイルを選択し、「作成」をクリックします。
「配備」をクリックします。
もう一度「配備」をクリックします。

ViewFramerの設定

ViewFramerでSalesforceのレコードとExcelテンプレートを紐づける設定を行います。

ビューの設定

ViewFramerのビュータブで「新規」ボタンをクリックします。
Salesforceへのログインが促されるため、認証情報を入力してログインします。

💡

補足

次回以降この画面が表示された場合は、「現在のセッション情報を使用する」をクリックしてください。
ビューの名前を入力し、「次へ」ボタンをクリックします。
使用するオブジェクトとして今回は、「キャンペーンメンバー」を選択します。
帳票に出力する項目を指定します。「住所」「会社名」「氏名」の3項目を出力項目とします。
住所については、項目ビルダーで以下の数式を使用し、「郵便番号」「都道府県」「市区郡」「町名・番地」の値を結合して出力します。
```
'〒' || CampaignMember.PostalCode || ' ' || CampaignMember.State || CampaignMember.City || CampaignMember.Street
```
会社名については、キャンペーンメンバーレコードの「会社名（取引先）」項目の値を、氏名については「名前」項目の値をそのまま出力します。
「出力条件設定」タブで、取得するレコードの条件を指定します。
今回は、キャンペーン詳細画面から帳票を出力した際に、そのキャンペーンに紐づくメンバーのみを出力するように設定します。
「キャンペーンメンバー」の「キャンペーン」項目が、パラメータ CampaignId と等しくなるように指定します。
```
CampaignMember.Campaign = {CampaignId}
```
パラメータ CampaignIdには、帳票出力ボタンを押した画面のキャンペーンレコードのIDが自動的に設定されます。
これにより、該当キャンペーンに紐づくメンバーのみが出力されます。
条件指定が完了したら、「保存」ボタンをクリックします。

マッピングの設定

ViewFramerの「マッピング」タブを開き、「新規」ボタンをクリックします。
マッピングの名前を入力します。
帳票タイプは「一覧型」を指定します。

⚠️

注意

「ビューの編集を許可する」のチェックを外すと、マッピングで使用したビューが後から編集不可になります。
作成したビューを選択し、「取得」ボタンをクリックします。
ビューの項目をExcelテンプレートに紐づけられるようになります。
画面右下の「次へ」をクリックすると、Salesforceへのログインを求められます。
・ログイン済みの場合は、「現在のセッション情報を継続する」をクリックします。
・未ログインの場合は、「ログイン」をクリックしてSalesforceにログインします。
ログイン後、マッピング出力設定画面に移動します。
「Documentizer」タブを開き、作成したExcelテンプレートを選択します。
Excelテンプレート内のフィールド名とビューの出力項目が一致しているため、「自動マッピング」ボタンをクリックするだけで紐づけが完了します。
右下の「配備」ボタンをクリックすると設定は完了です。作成したマッピングをSalesforceから呼び出せるようになります。

Salesforce に Excel ファイル出力ボタンを設置する

キャンペーンレコードの詳細画面にExcelファイル出力ボタンを設置します。詳細画面に設置する出力ボタンの作成方法については、以下の記事をご参照ください。

Lightning Experienceの詳細ページ用　ボタン作成（ViewFramer）

Visualforceページの編集

基本的にリンク先の手順に沿って設定を行いますが、ViewFramerからダウンロードしたVisualforceページについては、以下の2箇所を修正してください。
その他の設定は、上記記事と同様に設定します。

変更前

<apex:page standardController="CampaignMember" standardStylesheets="false"

変更後

<apex:page standardController="Campaign" standardStylesheets="false"

②パラメータ CampaignIdの変更

変更前

CampaignId:'{!JSENCODE(CampaignMember.CampaignId)}',

変更後

CampaignId:'{!JSENCODE(Campaign.Id)}',

出力結果の確認

設置した出力ボタンをクリックし、Excelファイルが正しく出力されることを確認します。
キャンペーンメンバーの情報がラベル形式で繰り返し出力されていれば、設定は正常に完了しています。

出力対象となるキャンペーンメンバーの一覧は以下の通りです。

このセクションの記事

概要