PDF出力時、テンプレートファイルはWord(.docx)で作成してください。
差し込み項目の書式設定
日付・日付/時間、通貨、数値項目の書式設定について、以下を参照してください。
日付・日付/時間項目の書式設定
ページ番号/総ページ数
ページ番号、総ページ数は、以下の差し込み項目をフッターまたはヘッダーに使用してください。Wordのフィールドコードはサポートされません。
ページ番号・・・{!pagenumber()}
総ページ数・・・{!pagecount()}
行間
Wordのテンプレートファイルの「段落」>「インデントと行間隔」の「1ページの行数を指定時に文字をグリッド線に合わせる」はチェックオフにしてください。チェックオンのとき、テンプレートとPDFで大幅に行間が異なる出力結果になります。通常、Wordテンプレートの行間よりPDFは少し狭く出力されます。
表
罫線
- 余分な罫線が出力される場合、該当の罫線の色を白に設定してください。アプリケーションでは、SalesforceのVisualforceのPDF生成機能を利用してHtml→PDF化しており、Html上では正しく表示されるものの、VisualforceでPDF変換時、期待通りならない場合があります。Visualforceの仕様上によるものとなりますので、対応不可となります。
- 表罫線が出力されない場合、表プロパティより罫線を再度設定してください。Wordのテンプレート上では隣接するセルの罫線が表示されており、該当のセルの罫線が設定されていない場合があります。
行高さ
表の行高さが正しく出力されない場合、表プロパティより行の高さを指定してください。
セル内文字位置
セル内の文字の垂直方向位置を設定時、表プロパティと段落を設定してください。
セル内の文字を中央揃え(垂直方向)
- 表プロパティ＞セルタブより、垂直方向の配置を中央揃えに設定
- 段落＞インデントと行間隔タブより、行間を1行に設定
セル内の文字を下揃え
- 表プロパティ＞セルタブより、垂直方向の配置を下揃えに設定
- 段落＞インデントと行間隔タブより、行間を固定値にし、間隔の数値を適宜調整
セルのサイズ
表のプロパティ>表タブ内のオプションより、「自動的にセルのサイズを変更する」をチェックオフにしてください。
レイアウト
他のアプリケーションからコピーして貼り付けた表は、出力時にレイアウトが崩れる場合があります。コピーしたレイアウトが崩れる場合、テンプレートファイルより新規で表を作成してください。
左右で異なるレイアウト
左右で異なるレイアウトの場合、一つの表を作成し、セル分割、表罫線の表示/非表示により設定してください。表を左右に並べたり、表の横に文字を表示することはできません。
レイアウト例（セル分割・罫線表示/非表示）
出力結果
縞模様レイアウト
子オブジェクトの表を縞模様で出力する場合、子オブジェクト行を2行設定してください。例えば、1行目の背景が青、2行目の背景が白の場合、奇数行は青、偶数行は白の背景で出力されます。または、テーブルデザインより書式を設定します。
フォント
PDF出力時、フォントはすべてArial Unicode MSフォントで出力されます。Arial Unicode MSフォントでは、太字や斜体の書式はサポートされません。Wordのテンプレートに設定したフォントは適用されません。SalesforceでPDFの帳票を作成する－Office File Creator PDF編－でPDFのサンプルファイルをダウンロードすることができます。
画像 (会社ロゴ・印影など)
テンプレートファイルに会社ロゴなどの画像を含めることができます。画像の考慮事項を以下に示します。
オブジェクトは不可
図形やテキストボックスなどのオブジェクトは対応していません。オブジェクトが出力されない、背景色が正しく出力されない、出力に時間がかかるなどの問題があります。オブジェクトを右クリックし、「図として保存」より画像に保存し、オブジェクトを画像に差し替えてください。
文字の上に画像は不可
文字の上に画像を重ねて出力することはできません。以下の手順により、文字+画像のキャプチャ画像をテンプレートに設定してください。
- 手動でWordテンプレートファイルをPDFで保存
- PDFを開き、対象の文字と画像を200～400％に拡大し、スクリーンキャプチャを画像で保存
- 画像をテンプレートに挿入
*キャプチャ取得時、原寸では文字や画像がぼやけるため拡大して取得します。但し、画像サイズが大きすぎると出力エラーになるため、適宜拡大率を調整してください。
テンプレートサンプル
ダウンロード サンプルテンプレートファイル
制限事項
- 改ページの際、表の罫線が前ページの最下行、または次ページの先頭行の罫線が切れて出力される場合があります。
- Wordのフィールドコードはサポートされません。
- Wordのタブによる空白スペースはサポートされません。
- 他のアプリケーションからコピーして貼り付けた表は、出力時にレイアウトが崩れる場合があります。コピーしたレイアウトが崩れる場合、テンプレートファイルより新規で表を作成してください。
- 表を左右に並べたり、表の横に文字を表示することはできません。左右で異なるレイアウトの場合、一つの表を作成し、セル分割、表罫線の表示/非表示により設定してください。
- フォントはすべてArial Unicode MSフォントで出力されます。Arial Unicode MSフォントでは、太字や斜体の書式はサポートされません。
- 外字はサポートされません。
- Wordの透かし文字はサポートされません。
- 図形やテキストボックスなどのオブジェクトはサポートされません。
- 文字の上に画像を重ねて出力することはできません。手動でWordテンプレートファイルをPDFで保存後、対象の文字と画像を200～400%に拡大し、スクリーンキャプチャを保存します。保存した画像をテンプレートに設定してください。
参考
SalesforceでPDFの帳票を作成する－Office File Creator PDF編－
トラブルシューティング
PDF出力時、余分な罫線が表示されます。
該当の罫線の色を白に設定してください。アプリケーションでは、SalesforceのVisualforceのPDF生成機能を利用してHtml→PDF化しており、Html上では正しく表示されるものの、VisualforceでPDF変換時、期待通りならない場合があります。Visualforceの仕様上によるものとなりますので、対応不可となります。
PDF出力時、罫線が表示されません。
表プロパティより罫線を再度設定してください。Wordのテンプレート上では隣接するセルの罫線が表示されており、該当のセルの罫線が設定されていない場合があります。
PDF出力時、子レコードの改ページの区切りで表の罫線が切れて出力されます。
こちらは仕様となります。SalesforceのVisualforceのPDF生成機能によりPDF出力しており、改ページ位置はVisualforceの機能で自動判定されます。自動判定時、改ページ間の表の罫線出力はOFC側での調整は不可となります。
Office File Creator Proでは、設定により罫線が切れることなく出力されます。
PDF出力時、1ページのテンプレートが2ページで出力されます。
ページ設定より、上下の余白を小さくしてください。
PDF出力時、行の高さが低く出力されます。
表プロパティより行の高さを指定してください。
表の文字位置(垂直方向)を中央揃えに設定していますが、PDFは下揃えで出力されます。
セル内の文字の垂直方向位置を設定時、表プロパティと段落を設定してください。
- 表プロパティ＞セルタブより、垂直方向の配置を中央揃えに設定
- 段落＞インデントと行間隔タブより、行間を1行に設定
表の文字位置(垂直方向)を下揃えに設定していますが、PDFは中央揃えで出力されます。
セル内の文字の垂直方向位置を設定時、表プロパティと段落を設定してください。
- 表プロパティ＞セルタブより、垂直方向の配置を下揃えに設定
- 段落＞インデントと行間隔タブより、行間を固定値にし、間隔の数値を適宜調整
Wordテンプレートの表に差し込み項目を設定時、セル内の文字が折り返されず表が横に伸びてしまいます。
表のプロパティ>表タブ内のオプションより、「自動的にセルのサイズを変更する」をチェックオフにしてください。
PDF出力時、Wordのタブスペースにより文字の先頭位置を揃えていますが、正しい位置で出力されません。
Wordのタブによる空白スペースはサポートされません。色なしの罫線の表を作成することで先頭位置を揃えることができます。
PDF出力時、文字が左右、上下にずれて出力されます。
一つの表を作成し、表内に文字を配置してください。レイアウトはセル分割、表罫線の表示・非表示により設定してください。
PDF出力時、透かし文字が出力されません。
Wordの透かし文字は対応していません。
PDF出力時、会社名の上に会社印の画像を重ねていますが、画像がずれて出力されます。
文字の上に画像を重ねて出力することはできません。手動でWordテンプレートファイルをPDFで保存後、対象の文字と画像を200～400%に拡大し、スクリーンキャプチャを保存します。保存した画像をテンプレートに設定してください。
*キャプチャ取得時、原寸では文字や画像がぼやけるため拡大して取得します。但し、画像サイズが大きすぎると出力エラーになるため、適宜拡大率を調整してください。
PDF出力時、会社のロゴ画像が出力されません。
画像ではなく、オブジェクトの可能性があります。図形やテキストボックスなどのオブジェクトはサポートされません。オブジェクトを右クリックし、「図として保存」より画像に保存し、オブジェクトを画像に置き換えてください。
PDF出力時、図形が出力されません。
図形やテキストボックスなどのオブジェクトはサポートされません。
PDF出力時、テキストボックスが出力されません。
図形やテキストボックスなどのオブジェクトはサポートされません。
PDF出力時、レイアウトが崩れます。
PDF出力には対応していないパターンが考えられます。以下をご確認ください。
- Wordのタブによる空白スペースはサポートされません。
- 表を左右に並べたり、表の横に文字を表示することはできません。左右で異なるレイアウトの場合、一つの表を作成し、セル分割、表罫線の表示・非表示により設定してください。
- 他のアプリケーションからコピーして貼り付けた表は、出力時にレイアウトが崩れる場合があります。コピーしたレイアウトが崩れる場合、テンプレートファイルより新規で表を作成してください。
- 図形やテキストボックスなどのオブジェクトはサポートされません。
- 文字の上に画像を重ねて出力することはできません。手動でWordテンプレートファイルをPDFで保存後、対象の文字と画像を200～400%に拡大し、スクリーンキャプチャを保存します。保存した画像をテンプレートに設定してください。
PDF出力時、日本語の文字が出力されません。
テンプレートレコードの「PDFに全角文字を含む」が”含む”であること、「PDFデフォルトフォント」が”Arial Unicode MS”になっていることを確認してください。または、出力文字が外字であることが考えられます。外字の出力は対応しておりません。
PDF出力時、「内部サーバーエラーが発生しました。」のエラーメッセージが表示されます。
OFC_Templateレコードページの「PDFプレビュー」ボタンよりプレビュー画面のエラーメッセージをご確認ください。プレビューの場合、より詳細なエラーメッセージが表示されます。
PDF出力時、「common.apex.runtime.impl.ExecutionException: id: xxxxx Invalid integer: 0.99999..」のエラーメッセージが表示されます。
テンプレートファイルがMicrosoft Officeデスクトップ版以外で作成されている可能性があります。テンプレートファイルはMicrosoft Officeデスクトップ版で作成してください。他のアプリケーションで作成されたテンプレートファイルは、対応していません。
PDF出力時、「common.apex.runtime.impl.ExecutionException: id:xxxx Attempt to de-reference a null object: execute=write:curElem=r row=4」のエラーメッセージが表示されます。
Office File Creatorでは対応していないテンプレートファイルのパターンが考えられます。対応方法としては以下があげられます。
- テキストのフォントを「標準」に変更する
- レイアウトの複雑な個所をシンプルなもの変更にする
- 図形を削除する