[toc]
概要
このページでは、帳票DX for Salesforceで PDF 帳票のレイアウトを作成する方法をご紹介します。
ヘッダー明細型の「見積書」を例に、白紙からのレイアウト作成手順を詳しく説明します。
前提条件
本記事の内容は、【帳票DX for Salesforce ユーザガイド(3)】帳票作成の1~4までの設定が完了していることを前提としています。
PDF レイアウト作成方法の選択
「レイアウト」ボタンをクリックすると、PDFレイアウトを作成する方法を選択できます。
| 作成方法 | 説明 | バージョン |
|---|---|---|
| 白紙から作成 | 空白のレイアウトからデザインを開始します。 | すべてのバージョン |
| ローカルのPDFファイルから作成 | 既存のPDFファイルをベースにレイアウトを作成します。 | v1.90.0以降 |
| マイテンプレート | XAバケット内の既存テンプレートをベースに作成します。 | v1.90.0以降 |
本記事では「白紙から作成」の手順を説明します。
その他の方法については、【帳票DX for Salesforce】レイアウトを既存テンプレート・ローカルのPDFから作成する方法を参照してください。
操作手順
ステップ1:XAデザイナーを開く
-
帳票設定の画面で「レイアウト」ボタンをクリックします。
「白紙から作成」を選択します。
XAデザイナーの画面に遷移します。
画面右側に設定レコードで定義した主オブジェクトと明細オブジェクトが表示されます。
ステップ2:TableRegionを設置
- 明細のある帳票を作成する場合は、TableRegionを設置します。
-
TableRegionのアイコンをクリックし、レイアウト上をクリックします。
💡補足配置した直後はマウスカーソルが「+」の形になっていますが、キーボードの「Esc」を押すか、「要素の選択/移動/変形」ツール(カーソルマーク)をクリックして、元のカーソルに戻すことができます。
-
表示されたTableRegionのサイズを調整します。
「detail」が明細を表現する領域です。明細の数分、この領域が繰り返されます。
ステップ3:TableRegionのバンド設定
- TableRegionで使用するバンドをチェックして設定します。
- TableRegionをダブルクリックします。
- 「要素」タブに移動します。
-
使用するバンドをクリックします。
-
「table header」「column header」「table footer」などにチェックを付けます。
💡補足各バンドの役割については、【XA】TableRegionと各バンドの動きを参照してください。
-
各バンドのサイズを調整します。
縦の罫線の設定
TableRegionで使用する縦線の設定は、以下の方法で行えます。
追加: カーソルを最上部の横線付近に当て、表示された「+」をクリックします。
削除: カーソルを内部の縦線付近に当て、表示されたゴミ箱のアイコンをクリックします。
不可視: カーソルを内部の縦線付近に当て、表示された目のアイコンをクリックします。
バンド毎に縦線を不可視にできます。 不可視の場合、レイアウト設定画面上では点線で表示されます。
ステップ4:各バンドに要素を配置
-
デザイナー上で各バンドに要素を配置します。
配置できる要素には、Text、Shape、Line、Path、Image、TableRegionの6種類があります。
-
ツールバーから配置したい要素を選択し、レイアウト上をクリックして配置します。
-
レイアウト上に置いたTextをダブルクリックして、中身の文字列を編集します。
例: Textで文字列「見積書」を設置 -
Textをクリックして「要素」タブを選択すると、スタイル設定があります。 文字の大きさなどを変更することができます。
ステップ5:動的要素(データ)を設置
Salesforceから取得したデータを出力する動的要素を設置します。
- 「データセット」タブをクリックします。
- 設定レコードで定義した主オブジェクトと明細オブジェクトが表示されます。
-
各項目の「▶」ボタンをクリックして、項目を表示します。
-
項目をレイアウト上にドラッグ&ドロップして設置します。
データセット設定の編集
各データセットの鉛筆マークをクリックすると、データセット設定を編集できます。 以下の設定が可能です。
CSV タブ
このタブの内容は変更しないようご注意ください。
出力項目タブ
「+」ボタンをクリックして式を作成することができます。
例: Salesforceから取得した取引先名のデータに「御中」を文字列結合する場合
- 項目や関数をクリックして「式」枠内に挿入します。
-
「式」枠内で直接文字列を入力することも可能です。固定の文字列は半角シングルクォーテーションで囲みます。
-
式の設定が完了したら、チェックマークをクリックして保存します。
出力詳細タブ
出力フォーマット、ソート順、グループ順、出力条件を指定することができます。
例: Salesforceの「金額」項目を出力する際に ¥#,##0 形式で指定する
データセット設定が完了したら、「適用して閉じる」ボタンをクリックします。
動的要素の入れ替え
出力項目で作成した式と設置済みの動的要素を入れ替えたい場合は、以下の手順を実施してください。
- 入れ替えたい動的要素をクリックします。
- 「要素」タブに移動します。
- 「データ」タブを選択します。
-
「項目」の選択リストをクリックします。
-
作成した式を選択します。
レイアウト上の表記も変わっていることを確認してください。すべて設置したレイアウトがこちらです。
ステップ6:TableRegionとデータセットを紐づける
- TableRegionとデータセットを紐づけます。
- TableRegionをダブルクリックします。
- 「要素」タブに移動します。
-
「データセットとバンドグループの設定」をクリックします。
- データセット(主オブジェクトと明細オブジェクト)が表示されるので、明細オブジェクトを選択します。
-
「適用して閉じる」ボタンをクリックします。
ステップ7:レイアウトを保存
レイアウトを保存します。
次のステップ
PDFレイアウトの作成が完了したら、帳票を出力します。
詳しくは、【帳票DX for Salesforce ユーザガイド(9)】帳票出力(ヘッダー明細・一覧)を参照してください。