【Salesforce】見積のPDF出力が期待どおりにならない時の表示条件と権限の見直し

Salesforceの見積機能でPDF出力を行う際、実際に出力されたPDFのレイアウトや表示項目が想定と異なるケースは少なくありません。特に、見積テンプレートの設定やユーザの権限、表示条件(条件式)が原因で意図しない出力になることがあります。本記事では、見積PDF出力が想定と違う場合に確認すべき表示条件と権限の見直しポイントを、具体的な手順とともに解説します。

1. 見積PDFの出力仕組みとよくある相違点

Salesforceの見積PDFは、見積テンプレートと呼ばれるレコードに基づいて生成されます。テンプレートにはPDFのレイアウト、表示する項目、条件式などが定義されており、見積レコードと紐づけて出力されます。よくある相違点としては、特定の項目がPDFに表示されない、レイアウトが崩れている、一部の見積だけ出力が異なる、などが挙げられます。これらの問題は主にテンプレートの表示条件設定、ユーザの権限設定、またはレコードタイプの違いに起因します。

見積テンプレートの基本構造

見積テンプレートは、見積オブジェクトのレコード詳細画面の関連リスト「見積テンプレート」から作成・編集できます。テンプレート内では、項目の配置、書式、条件式を使用した表示制御が可能です。条件式は「表示条件」項目に数式として記述し、その結果がTRUEの場合のみ対象の項目やセクションがPDFに表示されます。

よくある相違点の例

• 見積明細の数量や単価が出力されない
• 特定のユーザだけ割引額が表示されない
• 一部の見積のみ税額が正しく計算されていない
• PDFのヘッダーやフッターが出力されるべきレコードで出力されない

2. 表示条件の設定を確認する手順

PDF出力が想定と違う場合、最初に確認すべきはテンプレートの表示条件です。以下の手順で設定を確認してください。

1. 見積オブジェクトの詳細画面から、関連リスト「見積テンプレート」を開きます。
2. 問題が発生しているテンプレートのレコード名をクリックして開きます。
3. 「表示条件」項目に設定されている条件式を確認します。条件式が空白の場合は常に表示されます。条件式が設定されている場合、その数式が期待通りにTRUE/FALSEを返すか確認してください。
4. 確認のために、実際の見積レコードを開き、条件式で参照している項目の値が条件を満たしているか確認します。例えば、条件式が「Status__c = ‘Approved’」の場合、見積のステータスが「Approved」である必要があります。
5. 必要に応じて条件式を修正し、テンプレートを保存してから再度PDF出力を試してください。条件式の修正にはシステム管理者権限、またはテンプレートの編集権限が必要です。

条件式の記述ミスは、コンパイルエラーとして保存時に検出される場合が多いですが、論理エラー(意図した条件と逆の結果になるなど)は検出されません。そのため、複数の見積レコードでテストすることを推奨します。

3. 権限設定の見直しポイント

権限設定もPDF出力に大きな影響を与えます。特に、オブジェクト権限、項目レベルセキュリティ、レコードタイプの権限が原因で表示/非表示が変わる場合があります。

オブジェクト権限の確認

見積オブジェクトに対する読み取り権限がない場合、PDF自体が出力されません。しかし、読み取り権限があっても、特定の項目に対する項目レベルセキュリティ(FLS)で「読み取り不可」に設定されていると、その項目はPDFに表示されません。この場合、該当ユーザのプロファイルまたは権限セットでFLSを確認してください。

項目レベルセキュリティの確認

項目レベルセキュリティは、プロファイルまたは権限セットごとに、各項目の参照・編集の可否を設定します。PDF出力に必要な項目が「参照不可」になっていないか確認します。確認手順は、対象ユーザのプロファイル設定で「項目レベルセキュリティ」セクションを開き、見積オブジェクトの各項目の権限を参照してください。

レコードタイプとページ割り当ての確認

レコードタイプが異なる場合、使用する見積テンプレートが変わることがあります。また、同じテンプレートでも、レコードタイプに応じて表示条件の動作が変わる可能性があります。見積レコードのレコードタイプを確認し、テンプレートがそのレコードタイプに正しく割り当てられているか確認してください。

4. 失敗パターンと対応例

以下の表に、よくある失敗パターンとその原因、対応方法をまとめました。

パターン	原因	対応
PDFに項目が表示されない	テンプレートの表示条件で除外されている、または項目がテンプレートに配置されていない	テンプレート編集画面で表示条件と項目配置を確認し、必要に応じて修正
特定のユーザだけPDFが異なる	ユーザの権限設定(FLSなど)の違い	ユーザのプロファイル・権限セットの項目レベルセキュリティを確認し、権限を調整
一部の見積のみ出力がおかしい	レコードタイプの違いや条件式の影響	見積レコードのレコードタイプとテンプレートの割り当てを確認。条件式を見直す
PDFのレイアウトが崩れる	テンプレートのHTML/CSSが破損している、またはフォントサイズ指定が不適切	テンプレートの内容を再編集し、プレビューで確認。必要に応じて元のテンプレートに戻す

5. 管理者に依頼する際の伝え方

権限やテンプレートの編集権限がない場合、管理者に依頼することになります。その際、以下の情報を伝えるとスムーズに対応してもらえます。

• 問題が発生している見積レコードのID(URLの末尾)
• 使用している見積テンプレートの名称
• 期待するPDFと実際のPDFのスクリーンショット(差分が分かるもの)
• エラーメッセージが表示される場合はその内容
• 発生するユーザや条件(特定のユーザだけ、特定のレコードタイプだけなど)

管理者はこれらの情報を基に、テンプレートの設定や権限を調査し、修正することができます。また、権限変更が他の機能に影響を与える可能性があるため、事前に影響範囲を確認することをおすすめします。

6. よくある質問

Q. テンプレート編集は誰でもできますか?

A. 通常はシステム管理者権限、または「見積テンプレートの管理」権限を持つユーザのみが編集できます。一般ユーザは編集できませんので、必要な場合は管理者に依頼してください。

Q. 表示条件に数式を使う場合の注意点は何ですか?

A. 数式の構文エラーは保存時に検出されますが、論理エラーは検出されません。数式内で参照する項目が正しいか、データ型が適切か、必要に応じて数式ヘルパーを使用するなどして確認してください。また、参照関係が複数オブジェクトにまたがる場合は、パフォーマンスに影響することがあります。

Q. 出力されたPDFで画像が表示されないのですが?

A. テンプレートに画像のプレースホルダーが正しく設定されているか確認してください。画像は見積レコードに添付されたファイル、または静的リソースとして参照できます。テンプレートの設定で画像の参照パスが正しいか、URLが有効か確認してください。

7. まとめ

見積PDF出力が想定と異なる場合、まずテンプレートの表示条件を確認し、次に権限設定(オブジェクト権限、項目レベルセキュリティ、レコードタイプ)を見直すことが重要です。条件式は意図した通りに動作しているか、複数のレコードでテストしてください。権限が原因の場合は管理者と連携し、適切な設定変更を依頼しましょう。これらの手順を踏むことで、多くの問題は解決できます。問題が解決しない場合は、Salesforceのサポートに問い合わせることも検討してください。

📑

PDFトラブル・操作完全解決データベース 閲覧エラー、編集・結合、パスワード解除など、PDFに関するあらゆる困りごとを網羅しています。

🔐

会社アカウント・認証トラブル完全解決データベース 職場または学校アカウント、MFA、Authenticator、VPN、権限、会社ポリシーで止まる問題を横断的に確認できます。