Excelファイルの取込

レポートデザイナからExcelファイル(xlsx)を開き、指定したシートの内容を帳票デザインとして取り込むことができます。

インストールフォルダ内の example/xlsx_import 以下に、取り込み機能のサンプルファイルが配置されています。

取込方法

[新しい帳票]ウィザードの[Excelファイル(xlsx)から取込]ボタンを押すか、 メニューの[ファイル]>[Excelファイル(xlsx)から取込]を選択すると、取り込むxlsxファイルを選択するダイアログが表示されます。

xlsxファイルを選択すると、シート一覧が表示されるので、取り込むシートを選んで[取込]ボタンをクリックします。

帳票の構造定義

RapidReportの帳票は、1つ以上のグループおよびコンテントからなるツリー構造を持ちます。 取り込むxlsxファイル内の、A列(左端)のセルにコメントを挿入することで、生成される帳票の構造を制御することができます。

  • セルにコメントを埋め込むと、その場所でコンテントが分割されます
  • コメントの内容は、コンテントの[見出し]に設定されます
  • コメントの内容に detail と記述すると、[明細]チェックの付いたグループの子コンテントとして生成されます

取込可能な内容

以下の内容を取り込むことができます。

取込内容 生成する内容/要素 詳細
用紙/印刷設定 対応するプロパティ 余白設定
用紙サイズ(A3, A4, A5, B4, B5)指定
※ それ以外の用紙サイズが設定されていた場合は A4 となります
縦横の向き設定
拡大・縮小率
※ Excelの「ページ設定」の内容のみ取込可能
プリンタドライバの設定等は取込不可です
セル内容、スタイル [テキスト(text)]要素
[フィールド(field)]要素
フォント、サイズ、色、下線、太字、斜体指定
水平・垂直アライメント指定
均等割り付け
改行して全体を表示
縮小して全体を表示
※セル内容が ## (シャープ2つ)で始まる場合は[フィールド]要素、
それ以外ならば[テキスト]要素が生成されます(詳しくは後述)
セルの罫線 [直線(line)]要素 線の太さ、線の色
線スタイル(破線、点線、二重線)
※ オートシェイプの線は未対応です
セルの塗りつぶし [矩形(rect)]要素 塗りつぶし色
円(オートシェイプ) [円(circle)]要素 線の色は黒のみ
線のスタイルは実線のみ
線の太さは1ポイントのみ
画像 [画像(image)]要素 BMP, GIF, JPEG, PNG形式

動的に内容が決まる要素の指定方法

[フィールド]要素、動的な[画像]要素、[バーコード]要素のような、 実行時に出力内容が動的に決定される要素については、セルに対して以下のように特殊な指定を行うことで生成可能となります。

指定方法 生成される要素
##... [フィールド]要素
#IMAGE#... 動的な[画像]要素
#BARCODE#... [バーコード]要素

それぞれの指定方法について、詳しく説明します。

[フィールド]要素

セルに ## (シャープ2つ)から始まる値が入っている場合は[フィールド]要素が生成されます。

## 以降に、式を記述することができます。

 ##.kingaku
 ##sum.kingaku
 ##(* .tanka .suryo)
 ##current_time

式の後に ; (セミコロン)を書くと、書式文字列を記述できます。

 ##.kingaku;#,##0
 ##current_time;yyyy年MM月dd日

※ セルの書式設定の表示形式は取込むことができません。

動的な[画像]要素

セルに #IMAGE# から始まる値が入っている場合は動的な[画像]要素が生成されます。

※ 固定の画像を利用する場合は、単にシートへ画像を張り付けてください。

#IMAGE#の後に、キーと式を ; (セミコロン)で区切って記述できます。
以下の例では、キー=image 、 式=.image_id となります。

 #IMAGE#image;.image_id

[バーコード]要素

セルに #BARCODE# から始まる値が入っている場合は[バーコード]要素が生成されます。

#BARCODE# 以降に、バーコード種類と式を ; (セミコロン)で区切って記述できます。
以下の例では、バーコード種類=ean8、式=.CD となります。

 #BARCODE#ean8;.CD

さらに、 ; (セミコロン)区切りで、書式文字列を記述できます。
以下の例では、8桁のゼロ埋めを行ってからバーコード化します。

  #BARCODE#ean8;.CD;00000000

※ セルの書式設定の表示形式は取込むことができません。

既知の不具合

取り込み元のxlsxファイルを編集する際に、画像やオートシェイプを複数選択した状態でコピーペーストを行うと、 その画像やオートシェイプのサイズが正しく取り込めなくなる場合があります。

この現象が発生する場合は、以下の回避方法をお試しください。

  • 画像やオートシェイプをコピーする場合は、1つだけ選択してコピーする
  • 画像やオートシェイプを含むセル・行・列の範囲選択をしてコピーする場合は、貼り付け後に画像やオートシェイプを削除する