11. 制限事項

アプリケーション利用時の各種制限事項です。

テンプレートファイルの制限

テンプレートレイアウト

すべてのレイアウトや出力パターンに対応していません。複雑なレイアウトはサポートされません。Sandboxでご利用のテンプレート、出力内容でご確認ください。

テンプレートファイルサイズ

テンプレートファイルサイズは、1MB以内にしてください。Officeファイルは複数のXMLで構成され、ZIPファイルで圧縮されており、圧縮前のファイルサイズ上限は4MBです。

テンプレート作成アプリケーション

テンプレートファイルはMicrosoft Officeデスクトップ版で作成してください。
オンライン版、Googleスプレッドシート、Googleドキュメントなど、他のアプリケーションで作成されたテンプレートはサポートされません。

Office機能

Office機能は、サポートされません。一部使用可能なOffice機能もありますが、すべてのテンプレートに対応していません。複雑なパターンはサポートされません。

使用可能なOffice機能

ファイル形式	詳細
Excel	Excel関数、データの入力規則、条件付き書式、テーブル、図形は使用可能。
Word	テーブル、テキストボックス、透かし文字、図形、フィールドコードは使用可能。
PowerPoint	テーブル、テキストボックス、図形は使用可能。
PDF	テーブルは使用可能。 ※テキストボックス、透かし文字、図形、フィールドコードは使用不可。

*テーブルはレイアウトのみ、集計機能除く。

使用可能なOffice機能の補足

すべてのテンプレートに対応していません。複雑なレイアウトはサポートされません。
ファイルを開く際、「'XXX.xlsx'の一部の内容に問題が見つかりました。可能な限り内容を回復しますか?」等のエラーメッセージが表示される場合、テンプレートのOffice機能を削除してください。
Office機能はサポート対象外です。Sandboxでご利用のテンプレート、出力内容でご確認ください。

Salesforceのガバナ制限

アプリケーション利用時、Salesforceの制限に抵触する可能性のある主な制限です。

主な制限一覧

種別	制限	値
Apex ガバナ制限	ヒープの合計サイズ	6MB
Apex ガバナ制限	Salesforceサーバーの最大CPU時間	10,000ミリ秒（10秒）
Visualforce の制限	VisualforceページがPDFとして表示される場合の、表示前のHTML応答の最大サイズ	15MB 未満
	PDFとして表示されるVisualforceページの最大PDFファイルサイズ	60MB
	PDFとして表示されるVisualforceページに含まれる全画像の最大合計サイズ	30MB

制限に抵触するパターンの例

子レコード数が100件以上
テンプレート、レコード値に大量の文字が含まれる
テンプレートに高画質の画像が含まれる

文字数について

出力文字数は、テンプレートファイルの構造＋レコード値合わせて合計600万文字（約6MB）が上限です。Excel/Word/PowerPointファイルは複数のXMLファイルで構成されます。PDFは基となるデータとしてHtmlを生成します。これらXMLタグ、Htmlタグもすべて文字数としてカウントされます。子レコード出力時は、レコード値に加え、XMLタグ・Htmlタグも比例して増加します。上限を超えると、「Apex heap size too large」のエラーが発生します。

回避方法

子レコードの検索条件を設定し、複数のファイルに分けて出力してください。
テンプレート内に画像が含まれる場合、解像度を下げてください。
Excelの場合、テンプレートの未使用の行、列を削除してください。何らかの理由により空白セルが使用セルと認識され、大量に不要な行、列が保存されている場合があります。
Excelの場合、非表示で不要なシートが無いか確認し、不要なシートは削除してください。
PDFの場合、テンプレートファイルの図形、テキストボックスなどのオブジェクトは削除してください。オブジェクトは対応していません。

参考

Apex ガバナ制限

Visualforce の制限

Salesforceのサブクエリ制限 (Ver.1のみ対象)

Ver.1で子オブジェクトにロングテキストエリア項目の差し込み項目が含まれる場合、Salesforceのサブクエリ制限が適用されます。

テンプレートに子オブジェクトのロングテキストエリア/リッチテキストエリア項目の差し込み項目が含まれる場合、子レコード数は約50～200レコードが上限です。
レコード数の上限数は、項目の長さ、項目数によって異なります。
これら制限は、レコード値の文字数に関わらず、ロングテキストエリア/リッチテキストエリア項目が含まれる場合、適用されます。
上限を超えた場合、出力処理を中断し、「Aggregate query has too many rows for direct assignment」のエラーメッセージを表示します。

Salesforceヘルプ

集計クエリで直接割り当てられる行数が多すぎるが、200 行未満である

※アプリケーションでは、各種処理の関係上、Salesforceヘルプに記載のあるFor Loopの使用で回避することはできません。

回避方法

Ver.2を使用します。Ver.2では、サブクエリ制限エラー発生時、エラーが発生した子レコードを別の方法で取得することにより、サブクエリの制限がなくなりました。
子レコードの出力条件を設定し、複数回に分けて出力します。

オブジェクト/項目/レコード件数制限

ファイル出力時の制限です。ガバナ制限などのSalesforceの制限に抵触しない範囲内で出力が可能です。

オブジェクト/項目/レコード上限数

種別	制限
差し込み項目数	アプリケーションでは差し込み項目数の制限はありません。
子オブジェクト数 (関連オブジェクト)	アプリケーションでは子オブジェクト数の制限はありません。
子レコード件数	アプリケーションではレコード件数の制限はありません。 *子オブジェクトにロングテキストエリア項目の差し込み項目が含まれる場合、Salesforceのサブクエリ制限が適用されます。
一括ファイル出力数	アプリケーションの出力ファイル数の制限はありません。1ファイルごとにトランザクションは分割されるため、出力数によるガバナ制限はありません。
画像レコード出力制限 (OFC Pro)	1画像のファイルサイズ上限は、4.28MBです。 1ファイルの画像出力数に制限はありません。 1 画像の合計サイズが4.28MBを超える場合、1トランザクションにつき4.28MBを上限として分割されるため、Salesforceのヒープサイズ、CPU時間のガバナ制限には抵触しません。画像の合計サイズに比例して、出力時間がかかります。画像の合計サイズが10MBを超える場合、数十秒かかります。

子レコード最大件数目安

サンプルテンプレートで検証した最大件数目安は480件です。テンプレート、レコード値、項目数によって子レコードの最大件数は異なりますので、Sandboxでご利用のテンプレート、出力内容で確認してください。

最大件数目安 (サンプルテンプレート: Word出力)

子レコード数	出力結果
480件	成功。
490件	ヒープサイズのガバナ制限エラーが発生。