一.概要
FineReportは、Excelのデータを書込ページにインポートすることをサポートしています。
二.インポートの方法
現在サポートされているインポート方法は次のとおりです。
次の表に、各方法の説明と詳細なドキュメントリンクを示されます。
インポートの方法 | 説明 |
一般インポート | 事前定義されたインポートボタン機能は、設定されたインポートロジックに従ってインポートを実行します。これは、上書きインポートに相当します。 |
複数回インポート | クリア、上書き、差分の3つの方法があります。さまざまなシナリオとニーズに適用できます。 |
カスタマイズ | インポートする列と行を自由に設定でき、シートごとに異なるインポート属性を設定できます。 |
一括インポート | 管理ポータルを介してExcelをインポートすると、プレビュープロセスが不要になり、インポートとともにデータの送信を実現します。大量のデータを含むインポートに適しています。 |
三.インポート機能に対応できるシーン
ExcelおよびFanruanテンプレートは高度に自由化されているため、すべてのシーンとの互換性を保証することはできません。現在対応できるシーンと対応できていないシーンを以下に示されます。
1.対応できるシーン
シーン | 例図 | |
1 | ヘッダー部に横方向拡張がない単一行ヘッダー | |
2 | ヘッダー部に横方向拡張がある単一行ヘッダー | |
3 | インポート領域の上部にタイトルまたはその他の固定内容がある | |
4 | インポート領域の下部に固定内容がある 注:これらの内容がExcelに存在しない場合は、直接インポートできる。これらの内容がExcelにも存在する場合は、カスタムインポートの行選択インポート機能によりデータを正常にインポートできる。 | |
5 | 拡張セルのないフリー帳票 |
2.インポート機能に対応できないシーン
注:テンプレートプレビュー時のスタイルがExcelのスタイルとまったく同じである場合、位置マッチングがトリガーされ、すべての形式がサポートされています。次のシーンが対応されていないという前提は、位置マッチングが失敗していることです。
番号 | シーン | 例図 |
1 | 多階層ヘッダー | |
2 | ヘッダー部に複数の横方向拡張がある | |
3 | インポート領域に複数行の拡張行がある | |
4 | 1つの親セルは導入領域の複数の子セルに対応する | |
5 | インポート領域は複数のデータセットで構成されている |
四.設定仕様(重要)
一般的なExcelインポートの問題について、以下にテンプレート設定の基本仕様をまとめます。
1.インポート領域にデータフィールドがある場合は、リスト表示に設定する必要があります。現在、インポートはリストのみをサポートしています。
2.インポート領域のセルには、拡張可能と設定される必要があります。バックグラウンドプログラムの判断に支障をきたす可能性があるため、他の部分を拡張として設定することはお勧めしません。
3.インポート領域のヘッダーに横方向拡張があり、インポート領域は縦方向に拡張される場合、横・縦方向拡張形式のインポートを有効にする必要があります。
4.Microsoft Excel 2007以降をできるかぎり使用してください。他社製品およびMicrosoft Excel下位バージョンとの互換性は保証されません。
5.テンプレートのインポート領域のヘッダー部分は、Excelのヘッダー部分と一致するように設計することをお勧めします。
五.ご注意
1.Excelをインポートする場合、ウィジェット自体によって設定された検証ルールは作動しません。帳票書き込み属性設定のデータ検証機能を使用して設定できます。
2.テンプレートに式が設定されているセルには、ExcelをインポートされたときにExcelのデータで上書きされた場合、式の連動計算はトリガーできなくなります。
3.インポートするデータ量(行*列)が10万を超える場合は、一括インポートの使用をご検討ください。
4. 10.0.19.2バージョン(2021.10.15jar)以降、インポートしたテンプレートに集計計算式(max、sumなど)があり、且つデータ量が多い場合、スマート運用保守のスマートリリース機能がトリガーされ(サーバーの負荷が高すぎます。保護メカニズムが起動されました。もう一度試してください。)、Excelのインポートが異常に終わることがあります。その場合、数式を簡略化するか、数式を拡張行に配置しないようにするか、テクニカルサポートに連絡できます。
5.すべてのExcelをインポートできないという問題が発生した場合は、ネットワークの制限によりファイルのアップロード要求がブロックされているかどうかを確認できます。たとえば、nginxのclient_max_body_size設定がデフォルトで1Mとなる場合、ファイルのアップロードとExcelのインポートに影響し、1Mを超えるファイルをアップロードすることはできません。
6.画像のインポートはサポートされていません。